Устранение неполадок провижининга SCIM

Эта страница содержит решения распространённых проблем, с которыми вы можете столкнуться при настройке и использовании провижининга SCIM в Grafana.

Проблемы с провижинингом пользователей

Ошибка: “invalid namespace”

Причина: URL конечной точки SCIM имеет неправильный формат.

Решение: проверьте, что ваш URL соответствует правильному формату:

Bash
https://{$GRAFANA_URL}/apis/scim.grafana.app/v0alpha1/namespaces/{$STACK_ID}/Users

Где:

  • {$GRAFANA_URL} — это ваш URL Grafana (формат поддомена)
  • {$STACK_ID} — это ID вашего стека Grafana:
    • Grafana Cloud: формат типа stack-123 (находится в вашем дашборде Grafana Cloud)
    • Локальная установка: используйте default или название организации

Проблемы с аутентификацией

Ошибка: “HTTP 403 Forbidden”

Причина: либо неправильный токен, либо недостаточные разрешения.

Решение:

  1. Проверьте токен: сгенерируйте новый токен на странице сведений о сервисной учётной записи
  2. Проверьте разрешения: убедитесь, что сервисная учётная запись имеет роль Editor или Admin в экземпляре Grafana

Ошибка: “HTTP 401 Unauthorized”

Причина: недействительный или истёкший токен аутентификации.

Решение: сгенерируйте новый токен на странице сведений о сервисной учётной записи в Grafana.

Проблемы со входом

Ошибка: “User sync failed”

Причина: поле уникального идентификатора пользователя настроено неправильно в утверждениях SAML.

Решение: добавьте требуемое утверждение SAML в зависимости от вашего провайдера идентификации:

Утверждение SAML Провайдер идентификации Значение
userUID Entra ID objectId
userUID Okta user.getInternalProperty("id")

Дальнейшие шаги