Добавление субъектов кластера для Azure Data Explorer
Обозреватель данных Azure — это быстрая и высокомасштабируемая служба для изучения данных журналов и телеметрии. Из этой статьи вы узнаете, как добавить субъекты кластера для Azure Data Explorer с помощью C#, Python или шаблона Azure Resource Manager (ARM).
Предварительные требования
Предварительные требования зависят от метода, используемого для добавления субъекта. Выберите соответствующую вкладку для предпочитаемого метода.
В следующем списке описаны предварительные требования для добавления субъекта кластера с помощью C#.
- Учетная запись Майкрософт или пользовательское удостоверение Azure Active Directory. Подписка Azure не обязательна.
- Кластер и база данных Azure Data Explorer. Создайте кластер и базу данных.
- Visual Studio 2022 Community Edition. Включите разработку в Azure во время установки Visual Studio.
- Приложение Azure AD и субъект-служба, которые могут получать доступ к ресурсам. Сохраните идентификатор каталога (клиента),идентификатор приложения и секрет клиента.
- Установите Microsoft.Azure.Management.kusto и Microsoft.Rest.ClientRuntime.Azure.Authentication.
Добавление субъекта кластера
Выполните следующий код, чтобы добавить субъект кластера:
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 = await ApplicationTokenProvider.LoginSilentAsync(tenantId, clientId, clientSecret);
var kustoManagementClient = new KustoManagementClient(credentials) { SubscriptionId = subscriptionId };
var resourceGroupName = "testrg";
//The cluster that is created as part of the Prerequisites
var clusterName = "mykustocluster";
var clusterPrincipalAssignmentName = "mykustoclusterprincipalassignment";
var principalId = "xxxxxxxx-xxxxx-xxxx-xxxx-xxxxxxxxx"; //User email, application ID, or security group name
var role = "AllDatabasesAdmin"; //AllDatabasesAdmin or AllDatabasesViewer
var tenantIdForPrincipal = "xxxxxxxx-xxxxx-xxxx-xxxx-xxxxxxxxx";
var principalType = "App"; //User, App, or Group
var clusterPrincipalAssignmentData = new ClusterPrincipalAssignment(
principalId: principalId, role: role, principalType: principalType, tenantId: tenantIdForPrincipal
);
await kustoManagementClient.ClusterPrincipalAssignments.CreateOrUpdateAsync(
resourceGroupName, clusterName, clusterPrincipalAssignmentName, clusterPrincipalAssignmentData
);
Параметр | Рекомендуемое значение | Описание поля |
---|---|---|
tenantId | xxxxxxxx-xxxxx-xxxx-xxxx-xxxxxxxxx | Идентификатор клиента. Также известен как идентификатор каталога. |
subscriptionId | xxxxxxxx-xxxxx-xxxx-xxxx-xxxxxxxxx | Идентификатор подписки, используемой для создания ресурсов. |
clientid | xxxxxxxx-xxxxx-xxxx-xxxx-xxxxxxxxx | Идентификатор клиента приложения, которое имеет доступ к ресурсам в клиенте. |
clientSecret | PlaceholderClientSecret | Секрет клиента приложения, которое имеет доступ к ресурсам в клиенте. |
имя_группы_ресурсов | testrg | Имя группы ресурсов, содержащей ваш кластер. |
clusterName | mykustocluster | Имя вашего кластера. |
principalAssignmentName | clusterPrincipalAssignment1 | Имя вашего ресурса субъекта кластера. |
principalId | xxxxxxxx-xxxxx-xxxx-xxxx-xxxxxxxxx | Идентификатор субъекта, который может быть адресом электронной почты пользователя, идентификатором приложения или именем группы безопасности. |
роль | AllDatabasesAdmin | Роль вашего субъекта кластера, которая может быть AllDatabasesAdmin, AllDatabasesMonitor или AllDatabasesViewer. |
tenantIdForPrincipal | xxxxxxxx-xxxxx-xxxx-xxxx-xxxxxxxxx | Идентификатор клиента субъекта. |
principalType | Приложение | Тип субъекта, например «Пользователь», «Приложение» или «Группа» |