Configurare le identità gestite per il cluster Esplora dati di Azure

Aggiungere un'identità assegnata dal sistema usando il portale di Azure

Accedere al portale di Azure.

Nuovo cluster di Azure Esplora dati

1. Creare un cluster Esplora dati di Azure

2. Nella scheda Sicurezza , in Identità assegnata dal sistema, selezionare Sì. Per rimuovere l'identità assegnata dal sistema, selezionare No.

3. Selezionare Avanti: Tag > o Rivedi e crea per creare il cluster.

   

Cluster Esplora dati di Azure esistente

1. Aprire un cluster di Azure Esplora dati esistente.

2. Selezionare Impostazioni>Identità nel riquadro sinistro del portale.

3. Nel riquadro Identità , nella scheda Assegnata dal sistema :

   1. Spostare il dispositivo di scorrimento Stato su Sì.
   2. Seleziona Salva.
   3. Nella finestra popup selezionare Sì.

   

4. Dopo alcuni minuti, la schermata mostra:

   • ID oggetto - Usato per le chiavi gestite dal cliente
   • Autorizzazioni : selezionare le assegnazioni di ruolo pertinenti

   

Aggiungere un'identità assegnata dal sistema usando C#

Prerequisiti

Per configurare un'identità gestita usando il client C# di Azure Esplora dati:

• Installare il pacchetto NuGet di Azure Esplora dati.
• Installare il pacchetto NuGet Azure.Identity per l'autenticazione.
• Creare un'applicazione Microsoft Entra e un'entità servizio in grado di accedere alle risorse. Aggiungere l'assegnazione di ruolo nell'ambito della sottoscrizione e ottenere l'oggetto , e Directory (tenant) IDobbligatorioApplication IDClient Secret.

Creare o aggiornare il cluster

1. Creare o aggiornare il cluster usando la Identity proprietà :

   var tenantId = "xxxxxxxx-xxxxx-xxxx-xxxx-xxxxxxxxx"; //Directory (tenant) ID
   var clientId = "xxxxxxxx-xxxxx-xxxx-xxxx-xxxxxxxxx"; //Application ID
   var clientSecret = "PlaceholderClientSecret"; //Client Secret
   var subscriptionId = "xxxxxxxx-xxxxx-xxxx-xxxx-xxxxxxxxx";
   var credentials = new ClientSecretCredential(tenantId, clientId, clientSecret);
   var resourceManagementClient = new ArmClient(credentials, subscriptionId);
   var resourceGroupName = "testrg";
   var subscription = await resourceManagementClient.GetDefaultSubscriptionAsync();
   var resourceGroup = (await subscription.GetResourceGroupAsync(resourceGroupName)).Value;
   var clusters = resourceGroup.GetKustoClusters();
   var clusterName = "mykustocluster";
   var clusterData = new KustoClusterData(
       ___location: AzureLocation.CentralUS,
       sku: new KustoSku(KustoSkuName.StandardE8adsV5, KustoSkuTier.Standard) { Capacity = 5 }
   ) { Identity = new ManagedServiceIdentity(ManagedServiceIdentityType.SystemAssigned) };
   await clusters.CreateOrUpdateAsync(WaitUntil.Completed, clusterName, clusterData);
   

2. Eseguire il comando seguente per verificare se hai creato o aggiornato con successo il cluster con un'identità.

   clusterData = (await clusters.GetAsync(clusterName)).Value.Data;
   

   Se il risultato contiene ProvisioningState con il Succeeded valore , il cluster è stato creato o aggiornato e ha le proprietà seguenti:

   var principalGuid = clusterData.Identity.PrincipalId.GetValueOrDefault();
   var tenantGuid = clusterData.Identity.TenantId.GetValueOrDefault();
   

   PrincipalId e TenantId vengono sostituiti con GUID. La TenantId proprietà identifica il tenant di Microsoft Entra a cui appartiene l'identità. PrincipalId è un identificatore univoco per la nuova identità del cluster. In Microsoft Entra ID, l'entità servizio ha lo stesso nome assegnato all'istanza del servizio app o di Funzioni di Azure.

Aggiungere un'identità assegnata dal sistema usando un modello di Azure Resource Manager

È possibile usare un modello di Azure Resource Manager per automatizzare la distribuzione delle risorse di Azure. Per altre informazioni sulla distribuzione in Azure Esplora dati, vedere Creare un cluster e un database di Azure Esplora dati usando un modello di Azure Resource Manager.

Quando si aggiunge il tipo assegnato dal sistema, si indica ad Azure di creare e gestire l'identità per il cluster. È possibile creare qualsiasi risorsa di tipo Microsoft.Kusto/clusters con un'identità includendo la proprietà seguente nella definizione della risorsa:

{
   "identity": {
      "type": "SystemAssigned"
   }
}

Ad esempio:

{
   "identity": {
      "type": "SystemAssigned",
      "tenantId": "<TENANTID>",
      "principalId": "<PRINCIPALID>"
   }
}

Quando si crea il cluster, sono disponibili le proprietà aggiuntive seguenti:

{
    "identity": {
        "type": "SystemAssigned",
        "tenantId": "<TENANTID>",
        "principalId": "<PRINCIPALID>"
    }
}

<TENANTID> e <PRINCIPALID> vengono sostituiti con GUID. La TenantId proprietà identifica il tenant di Microsoft Entra a cui appartiene l'identità. PrincipalId è un identificatore univoco per la nuova identità del cluster. In Microsoft Entra ID, l'entità servizio ha lo stesso nome assegnato all'istanza del servizio app o di Funzioni di Azure.

Rimuovere un'identità assegnata dal sistema usando il portale di Azure

1. Accedere al portale di Azure.

2. Selezionare Impostazioni>Identità nel riquadro sinistro del portale.

3. Nel riquadro Identità , nella scheda Assegnata dal sistema :

   1. Spostare il dispositivo di scorrimento Stato su Disattivato.
   2. Seleziona Salva.
   3. Nella finestra popup selezionare Sì per disabilitare l'identità assegnata dal sistema. Il riquadro Identità ripristina la stessa condizione di prima dell'aggiunta dell'identità assegnata dal sistema.

   

Rimuovere un'identità assegnata dal sistema usando C#

Eseguire il codice seguente per rimuovere l'identità assegnata dal sistema:

var cluster = (await clusters.GetAsync(clusterName)).Value;
var clusterPatch = new KustoClusterPatch(clusterData.Location)
{
    Identity = new ManagedServiceIdentity(ManagedServiceIdentityType.None)
};
await cluster.UpdateAsync(WaitUntil.Completed, clusterPatch);

Rimuovere un'identità assegnata dal sistema usando un modello di Azure Resource Manager

Eseguire il codice seguente per rimuovere l'identità assegnata dal sistema:

{
   "identity": {
      "type": "None"
   }
}

Aggiungere un'identità assegnata dall'utente usando il portale di Azure

1. Accedere al portale di Azure.

2. Creare una risorsa di identità gestita assegnata dall'utente.

3. Aprire un cluster di Azure Esplora dati esistente.

4. Selezionare Impostazioni>Identità nel riquadro sinistro del portale.

5. Nella scheda Assegnata dall'utente selezionare Aggiungi.

6. Cercare l'identità creata in precedenza e selezionarla. Selezionare Aggiungi.

   

Aggiungere un'identità assegnata dall'utente usando C#

Prerequisiti

Per configurare un'identità gestita usando il client C# di Azure Esplora dati:

• Installare il pacchetto NuGet di Azure Esplora dati.
• Installare il pacchetto NuGet Azure.Identity per l'autenticazione.
• Creare un'applicazione Microsoft Entra e un'entità servizio in grado di accedere alle risorse. Aggiungere l'assegnazione di ruolo nell'ambito della sottoscrizione e ottenere l'oggetto , e Directory (tenant) IDobbligatorioApplication IDClient Secret.

Creare o aggiornare il cluster

1. Creare o aggiornare il cluster usando la Identity proprietà :

   var tenantId = "xxxxxxxx-xxxxx-xxxx-xxxx-xxxxxxxxx"; //Directory (tenant) ID
   var clientId = "xxxxxxxx-xxxxx-xxxx-xxxx-xxxxxxxxx"; //Application ID
   var clientSecret = "PlaceholderClientSecret"; //Client Secret
   var subscriptionId = "xxxxxxxx-xxxxx-xxxx-xxxx-xxxxxxxxx";
   var credentials = new ClientSecretCredential(tenantId, clientId, clientSecret);
   var resourceManagementClient = new ArmClient(credentials, subscriptionId);
   var resourceGroupName = "testrg";
   var subscription = await resourceManagementClient.GetDefaultSubscriptionAsync();
   var resourceGroup = (await subscription.GetResourceGroupAsync(resourceGroupName)).Value;
   var clusters = resourceGroup.GetKustoClusters();
   var clusterName = "mykustocluster";
   var userIdentityResourceId = new ResourceIdentifier($"/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/<identityName>");
   var clusterData = new KustoClusterData(
       ___location: AzureLocation.CentralUS,
       sku: new KustoSku(KustoSkuName.StandardE8adsV5, KustoSkuTier.Standard) { Capacity = 5 }
   )
   {
       Identity = new ManagedServiceIdentity(ManagedServiceIdentityType.UserAssigned)
       {
           UserAssignedIdentities = { { userIdentityResourceId, new UserAssignedIdentity() } }
       }
   };
   await clusters.CreateOrUpdateAsync(WaitUntil.Completed, clusterName, clusterData);
   

2. Esegui il comando seguente per verificare se hai creato o aggiornato correttamente il cluster con un Identity.

   clusterData = (await clusters.GetAsync(clusterName)).Value.Data;
   

   Se il risultato contiene ProvisioningState con il Succeeded valore , il cluster è stato creato o aggiornato e ha le proprietà seguenti:

   var userIdentity = clusterData.Identity.UserAssignedIdentities[userIdentityResourceId];
   var principalGuid = userIdentity.PrincipalId.GetValueOrDefault();
   var clientGuid = userIdentity.ClientId.GetValueOrDefault();
   

   PrincipalId è un identificatore univoco per l'identità usata dall'amministrazione di Microsoft Entra. ClientId è un identificatore univoco per la nuova identità dell'applicazione usata per specificare l'identità da usare durante le chiamate di runtime.

Aggiungere un'identità assegnata dall'utente usando un modello di Azure Resource Manager

È possibile usare un modello di Azure Resource Manager per automatizzare la distribuzione delle risorse di Azure. Per altre informazioni sulla distribuzione in Azure Esplora dati, vedere Creare un cluster e un database di Azure Esplora dati usando un modello di Azure Resource Manager.

È possibile creare qualsiasi risorsa di tipo Microsoft.Kusto/clusters con un'identità assegnata dall'utente includendo la proprietà seguente nella definizione della risorsa. Sostituire <RESOURCEID> con l'ID risorsa dell'identità desiderata:

{
   "identity": {
      "type": "UserAssigned",
      "userAssignedIdentities": {
         "<RESOURCEID>": {}
      }
   }
}

Ad esempio:

{
    "apiVersion": "2019-09-07",
    "type": "Microsoft.Kusto/clusters",
    "name": "[variables('clusterName')]",
    "___location": "[resourceGroup().___location]",
    "identity": {
        "type": "UserAssigned",
        "userAssignedIdentities": {
            "[resourceId('Microsoft.ManagedIdentity/userAssignedIdentities', variables('identityName'))]": {}
        }
    },
    "dependsOn": [
        "[resourceId('Microsoft.ManagedIdentity/userAssignedIdentities', variables('identityName'))]"
    ]
}

Quando si crea il cluster, sono disponibili le proprietà aggiuntive seguenti:

{
   "identity": {
      "type": "UserAssigned",
      "userAssignedIdentities": {
         "<RESOURCEID>": {
            "principalId": "<PRINCIPALID>",
            "clientId": "<CLIENTID>"
         }
      }
   }
}

PrincipalId è un identificatore univoco per l'identità usata dall'amministrazione di Microsoft Entra. ClientId è un identificatore univoco per la nuova identità dell'applicazione usata per specificare l'identità da usare durante le chiamate di runtime.

Rimuovere un'identità gestita assegnata dall'utente usando il portale di Azure

1. Accedere al portale di Azure.

2. Selezionare Impostazioni>Identità nel riquadro sinistro del portale.

3. Selezionare la scheda Assegnato dall'utente.

4. Cercare l'identità creata in precedenza e selezionarla. Selezionare Rimuovi.

   

5. Nella finestra popup selezionare Sì per rimuovere l'identità assegnata dall'utente. Il riquadro Identità ripristina la stessa condizione di prima dell'aggiunta dell'identità assegnata dall'utente.

Rimuovere un'identità assegnata dall'utente usando C#

Eseguire il codice seguente per rimuovere l'identità assegnata dall'utente:

var cluster = (await clusters.GetAsync(clusterName)).Value;
var clusterUpdate = new KustoClusterPatch(clusterData.Location)
{
    Identity = new ManagedServiceIdentity(ManagedServiceIdentityType.UserAssigned)
    {
        UserAssignedIdentities = { { userIdentityResourceId, null } }
    }
};
await cluster.UpdateAsync(WaitUntil.Completed, clusterUpdate);

Rimuovere un'identità assegnata dall'utente usando un modello di Azure Resource Manager

Eseguire il codice seguente per rimuovere l'identità assegnata dall'utente:

{
   "identity": {
      "type": "UserAssigned",
      "userAssignedIdentities": {
         "<RESOURCEID>": null
      }
   }
}