Настройка динамической регистрации клиента OAuth
Последнее обновление: 20.10.2026Динамическая регистрация клиентов OAuth (DCR) — это возможность OAuth на уровне клиента, которая позволяет совместимым клиентским приложениям OAuth динамически регистрировать клиентов OAuth. В данном контексте совместимое клиентское приложение OAuth — это приложение, которое поддерживает протокол OAuth 2.0 DCR и соответствует требованиям политики вашего клиента.
Основным сценарием использования DCR является подключение клиентов серверов Model Context Protocol (MCP), но его также можно использовать для других совместимых сторонних приложений.
Другие способы подключения к MCP-клиенту см. в Выбор способа создания клиента OAuth.
Публикация и согласие — это отдельные элементы управления:
-
Публикация ограничивает возможность использования клиента OAuth другими арендаторами в том же регионе.
-
Способ получения согласия (Обязательный или Доверенный) определяет, выводится ли пользователям запрос во время авторизации.
Подробнее о ручной настройке и поведении согласия, включая ограничения на публикацию, см. Создание клиентов OAuth и Создание клиентов OAuth и управление ими.
Предварительные требования и предостережения
Предварительные требования:
-
Вы являетесь администратором клиента в Qlik Cloud.
Предостережения:
-
Когда DCR включен, совместимые клиентские приложения OAuth могут запрашивать регистрацию клиента OAuth в вашем клиенте в соответствии с вашей политикой DCR. Проверьте разрешенные методы аутентификации и процесс утверждения перед включением DCR в рабочей среде.
-
Клиентам, созданным с помощью DCR, изначально назначаются области действия user_default, mcp:execute и offline_access. Чтобы узнать больше об этих областях, см. полный список областей на Портале разработчиков Qlik в разделе Области.
-
Неутвержденные клиенты DCR автоматически удаляются через один час. Если ни один администратор клиента не одобрит клиент в стороннем приложении в течение этого периода, клиент удаляется, и пользователям потребуется создать подключение заново.
Настройка параметров DCR
Настройте параметры динамической регистрации клиентов, чтобы контролировать, как клиентские приложения OAuth могут регистрировать клиенты OAuth в вашем клиенте.
Настройка DCR в Qlik Cloud
Выполните следующие действия.
-
В центре активности Администрирование откройте Настройки > Безопасность.
-
Включите динамическую регистрацию клиентов.
Когда DCR отключен, новые клиенты не могут быть зарегистрированы динамически. Существующие динамически зарегистрированные клиенты остаются работоспособными до тех пор, пока вы не удалите их вручную или не отзовете их одобрение.
-
В списке Разрешенные методы аутентификации выберите методы аутентификации, которые могут использовать динамически зарегистрированные клиенты:
-
Секрет клиента: разрешает использование конфиденциальных клиентов, таких как веб-приложения с защищенным бэкендом.
-
Секрет клиента + Нет: разрешает как конфиденциальных, так и публичных клиентов.
-
Нет: разрешает общедоступные клиенты, такие как одностраничные приложения или нативные приложения.
Приложения, пытающиеся зарегистрироваться с помощью метода, не разрешенного вашей политикой, отклоняются.
Дополнительные сведения об этих методах аутентификации см. в следующем разделе Методы аутентификации.
-
Настройка DCR в клиентском приложении OAuth
После настройки DCR в Qlik Cloud настройте подключение DCR в своем клиентском приложении OAuth. Параметры подключения различаются в зависимости от сценария использования.
Выполните следующие действия.
-
Используйте URL-адрес подключения для вашего сценария использования при настройке подключения в клиентском приложении OAuth:
Вариант использования Формат URL-адреса подключения Клиенты MCP или GenAI https://<tenant-id>.<region>.qlikcloud.com/api/ai/mcp Для получения дополнительных сведений о конфигурации MCP см. Подключение к Qlik серверу MCP.
Другие клиентские приложения OAuth https://<tenant-id>.<region>.qlikcloud.com -
Ознакомьтесь с поведением одобрения и согласия для недавно зарегистрированных клиентов DCR:
-
Убедитесь, что новые клиенты DCR требуют явного одобрения клиента, прежде чем их можно будет использовать. В стороннем приложении предоставьте разрешение при появлении запроса.
-
Первое одобренное подключение использует обязательное согласие.
-
После утверждения отредактируйте клиента в Qlik Cloud и измените метод предоставления согласия на Trusted, если это соответствует вашей политике безопасности.
Одобрение клиента устанавливает доверие на уровне клиента между вашим Qlik Cloud клиентом и клиентским приложением OAuth. После того как администратор клиента подключится, пройдет аутентификацию и одобрит запрос согласия, другие пользователи смогут подключаться к Qlik Cloud через то же приложение OAuth без необходимости подтверждения согласия со своей стороны.
Способ получения согласия настраивается для каждого клиента после одобрения. Для получения дополнительной информации см. раздел Создание клиентов OAuth и управление ими.
-
Методы аутентификации
При настройке параметров DCR вы можете указать, какие методы аутентификации разрешено использовать динамически зарегистрированным клиентам. Доступны следующие методы проверки подлинности:
-
Секрет клиента: разрешает конфиденциальным клиентам аутентифицироваться с помощью секрета клиента. Клиент получает секрет клиента при регистрации. Это включает в себя как методы аутентификации client_secret_basic, так и client_secret_post.
-
Нет: разрешает использование общедоступных клиентов, не использующих секрет клиента. Эти клиенты используют поток кода авторизации с PKCE (Proof Key for Code Exchange) для аутентификации.
По умолчанию динамически зарегистрированные клиенты используют метод аутентификации client_secret_basic, если при регистрации не указано иное.
Управление несколькими регистрациями от поставщиков
Многие клиентские приложения OAuth динамически регистрируют одного клиента OAuth в Qlik Cloud. Пользователи приложения используют один и тот же OAuth-клиент.
Некоторые клиентские приложения OAuth динамически регистрируют несколько клиентов OAuth, по одному на пользователя. Такое поведение наблюдалось с:
-
Anthropic Claude
-
Антигравитация
Если вы видите множество DCR-клиентов от одного и того же поставщика, проверьте, как это клиентское приложение OAuth регистрирует клиентов и доступна ли опция общего коннектора. Для массового удаления ненужных клиентов DCR см. Удаление клиентов OAuth.
Claude и Claude Code поддерживают CIMD, что позволяет избежать проблемы множественной регистрации. См. Подключение к Claude.
Пример доступа к MCP
Один из сценариев использования DCR — онбординг клиентов OAuth для Qlik интеграций с серверами MCP. DCR не ограничивается MCP и может использоваться другими совместимыми клиентскими приложениями OAuth. Для подключений на основе MCP администратор клиента обычно создает первое подключение и одобряет клиент, прежде чем подключатся другие пользователи.
Рекомендации по администрированию MCP и подключению см.:
Инструкции по управлению клиентами OAuth после их создания — включая обработку нескольких регистраций поставщиков, массовое удаление и идентификацию клиентов DCR или CIMD — см. в Управление клиентами OAuth.