Документация Grafana Документация GlaberGraph Настройка Настройка управления доступом Настройка провижининга SCIM Настройка SCIM с Okta

Настройка SCIM с Okta

В этом руководстве объясняется, как настроить провижининг SCIM с Okta для автоматизации управления пользователями и командами в Grafana.

Предварительные условия

Перед настройкой SCIM с Okta убедитесь, что у вас есть:

• Grafana Enterprise или платная учётная запись Grafana Cloud с включённым провижинингом SCIM.
• Доступ администратора как к Grafana, так и к Okta
• Аутентификация SAML, настроенная с Okta
• Функция SCIM, включённая в Grafana

Настройка SCIM в Grafana

Чтобы включить провижининг SCIM в Grafana, создайте сервисную учётную запись и сгенерируйте токен доступа, который будет использоваться для аутентификации запросов SCIM от Okta.

Создание сервисной учётной записи

1. Перейдите в Administration > Users and access > Service accounts
2. Нажмите Add service account
3. Создайте сервисную учётную запись с именем (например, “SCIM provisioning”).
4. В выпадающем списке Roles выберите следующие роли для сервисной учётной записи:
   • User administration — требуется для синхронизации пользователей (создание, чтение, обновление и удаление пользователей в организации)
   • Teams — требуется для синхронизации групп (создание, чтение, обновление и удаление команд, а также управление членством в командах)
5. Создайте новый токен для сервисной учётной записи и сохраните его в надёжном месте. Этот токен будет использоваться в конфигурации Okta.

Настройка SCIM в Okta

Настройте как аутентификацию SAML, так и провижининг SCIM в Okta, чтобы включить автоматизированную синхронизацию пользователей и команд с Grafana. Начните с создания приложения SAML, затем включите и настройте провижининг SCIM для этого приложения.

Включение провижининга SCIM

1. Перейдите на вкладку General вашей интеграции приложения SAML в Okta
2. Включите провижининг SCIM
   • Появится новая вкладка провижининга

Настройка параметров провижининга

Чтобы включить провижининг пользователей через SCIM, настройте параметры интеграции SCIM в Grafana, указав URL коннектора, режим аутентификации и поддерживаемые действия провижининга. Выполните следующие шаги, чтобы завершить интеграцию.

Настройка интеграции SCIM

На вкладке Integration настройте:

• SCIM Connector base URL:

  Вы можете скопировать полный базовый URL коннектора SCIM непосредственно из интерфейса SCIM по адресу Administration > Authentication > SCIM. Он отображается как Tenant URL в интерфейсе. Ваш домен стека и ID стека также можно найти в интерфейсе SCIM.

  В качестве альтернативы вы можете создать URL вручную:

  • Для экземпляров Grafana Cloud:
    Copy

    https://{stack-name}.grafana.net/apis/scim.grafana.app/v0alpha1/namespaces/stacks-{stack-id}

    Замените {stack-name} и {stack-id} на имя и ID вашего стека Grafana Cloud.
  • Для самостоятельно размещённых экземпляров:
    Copy

    https://{your-grafana-domain}/apis/scim.grafana.app/v0alpha1/namespaces/default

    Замените {your-grafana-domain} на домен вашего экземпляра Grafana (например, grafana.yourcompany.com).

• Unique identifier field: userName

• Supported provisioning actions:

  • Import New Users and Profile Updates
  • Push New Users
  • Push Profile Updates

• Authentication Mode: HTTP Header

• Authorization: Bearer {your-grafana-service-account-token}

• Нажмите Test Connector Configuration, а затем сохраните конфигурацию

На вкладке To App включите:

• Create Users
• Update User Attributes
• Deactivate Users

После завершения настройки:

1. Протестируйте коннектор SCIM в Okta
2. Назначьте тестового пользователя приложению
3. Проверьте, что пользователь провижинен в Grafana