Créer un point de terminaison privé managé pour Azure Data Explorer

Les points de terminaison privés managés sont nécessaires pour se connecter aux ressources Azure hautement protégées. Il s’agit de connexions privées unidirectionnel qui permettent à Azure Data Explorer de se connecter à d’autres services protégés. Dans cet article, vous allez découvrir comment créer un point de terminaison privé managé et le connecter à votre source de données.

Prérequis

• Un abonnement Azure. Créez un compte Azure gratuit.
• Un cluster Azure Data Explorer qui n’est pas injecté dans un réseau virtuel.
• Un hub d’événements ou un objet blob stockage Azure dans un abonnement inscrit auprès du fournisseur de ressources Microsoft.Network. Pour plus d’informations, consultez Inscrire un abonnement au fournisseur de ressources.

Créer un point de terminaison privé managé à l’aide du portail Azure

Vous pouvez créer un point de terminaison privé managé à l’aide du portail que votre cluster doit utiliser lors de l’accès à votre stockage.

1. Dans le portail Azure, accédez à votre cluster, puis sélectionnez Mise en réseau.

2. Sélectionnez Points de terminaison privés managés, puis sélectionnez Ajouter.

   

3. Dans le volet Nouveau point de terminaison privé managé, renseignez les détails de la ressource avec les informations suivantes, puis sélectionnez Suivant.

   

   Paramètre	Valeur suggérée	Description du champ
   Nom	mpeToStorage	Nom du point de terminaison privé managé
   Abonnement	Votre abonnement	Sélectionner l’abonnement Azure que vous souhaitez utiliser pour votre cluster
   Type de ressource	Microsoft.Storage/storageAccounts	Sélectionnez le type de ressources approprié que vous souhaitez pour votre source de données.
   Nom de la ressource	partager	Choisissez le cluster qui doit être utilisé comme destination pour le nouveau point de terminaison privé Azure
   Sous-ressource cible	objet BLOB	Sélectionnez la cible appropriée pour votre source de données.

4. Sélectionnez Créer pour créer la ressource de point de terminaison privé managé.

Créer un point de terminaison privé managé à l’aide de l’API REST

La création d’un point de terminaison privé managé nécessite un appel d’API unique au fournisseur de ressources Kusto. Vous pouvez établir un point de terminaison privé managé aux types de ressources suivants :

• Microsoft.Storage/storageAccounts (la sous-ressource peut être « blob » ou « dfs »)
• Microsoft.EventHub/namespaces (sous-ressource « namespace »)
• Microsoft.Devices/IoTHubs (sous-ressource « iotHub »)
• Microsoft.KeyVault/vaults (sous-ressource « vault »)
• Microsoft.Sql/servers (sous-ressource « sqlServer »)
• Microsoft.Kusto/clusters (sous-ressource « cluster »)
• Microsoft.DigitalTwins/digitalTwinsInstance (sous-ressource « digitaltwinsinstance »)

Dans l’exemple suivant, vous allez utiliser ARMclient dans PowerShell pour créer un point de terminaison privé managé à l’aide de l’API REST.

Conditions préalables pour utiliser l’API REST

1. Installez choco

2. Installez ARMClient

   choco install armclient
   

3. Se connecter à ARMClient

   armclient login
   

Créer un point de terminaison privé managé vers Azure Event Hubs

Utilisez l’appel d’API REST suivant pour activer le point de terminaison privé managé sur un service Event Hubs :

1. Exécutez la commande suivante pour créer un point de terminaison privé managé sur un service Event Hubs :

   # Replace the <...> placeholders with the correct values
   armclient PUT /subscriptions/<subscriptionIdADX>/resourceGroups/<resourceGroupNameADX>/providers/Microsoft.Kusto/clusters/<clusterName>/managedPrivateEndpoints/<newMpeName>?api-version=2022-02-01 @"
   {
       'properties': {
           'privateLinkResourceId':'/subscriptions/<subscriptionIdEventHub>/resourceGroups/<resourceGroupNameEventHub>/providers/Microsoft.EventHub/namespaces/<EventHubNamespace>',
           'groupId':'namespace',
           'requestMessage':'Please Approve.'
       }
   }
   "@
   

2. Vérifiez la réponse.

   {
     "id": "/subscriptions/<subscriptionIdADX>/resourceGroups/<resourceGroupNameADX>/providers/Microsoft.Kusto/Clusters/<clusterName>/ManagedPrivateEndpoints/<newMpeName>",
     "name": "<clusterName>/<newMpeName>",
     "type": "Microsoft.Kusto/Clusters/ManagedPrivateEndpoints",
     "location": "DummyLocation",
     "properties": {
       "privateLinkResourceId": "/subscriptions/<subscriptionIdEventHub>/resourceGroups/<resourceGroupNameEventHub>/providers/Microsoft.EventHub/namespaces/<EventHubNamespace>",
       "groupId": "namespace",
       "requestMessage": "Please Approve.",
       "provisioningState": "Creating"
     }
   }
   

Créer un point de terminaison privé managé sur un compte Stockage Azure

Utilisez l’appel d’API REST suivant pour activer le point de terminaison privé managé vers un objet blob Stockage Azure :

1. Exécutez la commande suivante pour créer un point de terminaison privé managé vers Event Hubs :

   #replace the <...> placeholders with the correct values
   armclient PUT /subscriptions/<subscriptionIdADX>/resourceGroups/<resourceGroupNameADX>/providers/Microsoft.Kusto/clusters/<clusterName>/managedPrivateEndpoints/<newMpeName>?api-version=2022-02-01 @"
   {
       'properties': {
           'privateLinkResourceId':'/subscriptions/<subscriptionIdStorage>/resourceGroups/<resourceGroupNameStorage>/providers/Microsoft.Storage/storageAccounts/<storageAccountName>',
           'groupId':'blob',
           'requestMessage':'Please Approve.'
       }
   }
   "@
   

2. Vérifiez la réponse.

   {
     "id": "/subscriptions/<subscriptionIdADX>/resourceGroups/<resourceGroupNameADX>/providers/Microsoft.Kusto/Clusters/<clusterName>/ManagedPrivateEndpoints/<newMpeName>",
     "name": "<clusterName>/<newMpeName>",
     "type": "Microsoft.Kusto/Clusters/ManagedPrivateEndpoints",
     "location": "DummyLocation",
     "properties": {
       "privateLinkResourceId": "/subscriptions/<subscriptionIdStorage>/resourceGroups/<resourceGroupNameStorage>/providers/Microsoft.Storage/storageAccounts/<storageAccountName>",
       "groupId": "blob",
       "requestMessage": "Please Approve.",
       "provisioningState": "Creating"
     }
   }
   

Procédure pour vérifier la progression

Pour vérifier la progression de la migration du point de terminaison privé managé, utilisez la commande suivante :

1. Exécutez la commande suivante :

   #replace the <...> placeholders with the correct values
   armclient GET /subscriptions/<subscriptionIdADX>/resourceGroups/<resourceGroupNameADX>/providers/Microsoft.Kusto/clusters/<clusterName>/managedPrivateEndpoints/<newMpeName>?api-version=2022-02-01
   

2. Vérifiez la réponse.

   {
     "id": "/subscriptions/<subscriptionIdADX>/resourceGroups/<resourceGroupNameADX>/providers/Microsoft.Kusto/Clusters/<clusterName>/ManagedPrivateEndpoints/<newMpeName>",
     "name": "<clusterName>/<newMpeName>",
     "type": "Microsoft.Kusto/Clusters/ManagedPrivateEndpoints",
     "location": "DummyLocation",
     "properties": {
       "privateLinkResourceId": "/subscriptions/02de0e00-8c52-405c-9088-1342de78293d/resourceGroups/<resourceGroupNameADX>/providers/Microsoft.<service>/<...>/<name>",
       "groupId": "<groupId>",
       "requestMessage": "Please Approve.",
       "provisioningState": "Succeeded"
     },
     "systemData": {
       "createdBy": "<UserName>",
       "createdByType": "User",
       "createdAt": "2022-02-05T08:29:54.2912851Z",
       "lastModifiedBy": "chrisqpublic@contoso.com",
       "lastModifiedByType": "User",
       "lastModifiedAt": "2022-02-05T08:29:54.2912851Z"
     }
   }
   

Approuver le point de terminaison privé managé

Quelle que soit la méthode utilisée pour créer le point de terminaison privé managé, vous devez approuver la création sur la ressource cible. L’exemple suivant montre l’approbation d’un point de terminaison privé managé vers un service Event Hubs.

1. Dans le portail Azure, accédez à votre service Event Hubs, puis sélectionnez Mise en réseau.

2. Sélectionnez Connexions des points de terminaison privés, sélectionnez le point de terminaison privé managé que vous avez créé, puis sélectionnez Approuver.

   

3. Dans la colonne État de connexion, vérifiez que le point de terminaison privé managé est approuvé.

   

Votre cluster peut désormais se connecter à la ressource via la connexion de point de terminaison privé managé.

Contenu connexe

• Résolution des problèmes des points de terminaison privés dans Azure Data Explorer