Настройка динамической регистрации клиента OAuth | Qlik Cloud Справка
Перейти к основному содержимому Перейти к дополнительному содержимому

Настройка динамической регистрации клиента OAuth

Последнее обновление: 2026-11-10

OAuth Dynamic Client Registration (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

Выполните следующие действия.

  1. В центре активности Администрирование откройте Настройки > Безопасность.

  2. Включите динамическую регистрацию клиентов.

    Когда DCR отключена, новые клиенты не могут быть зарегистрированы динамически. Существующие динамически зарегистрированные клиенты остаются работоспособными до тех пор, пока вы не удалите их вручную или не отзовете их одобрение.

  3. В списке Разрешенные методы аутентификации выберите методы аутентификации, которые могут использовать динамически зарегистрированные клиенты:

    • Секрет клиента: позволяет использовать конфиденциальные клиенты, такие как веб-приложения с защищенной серверной частью.

    • Секрет клиента + Нет: разрешает как конфиденциальные, так и публичные клиенты.

    • Отсутствует: разрешает общедоступные клиенты, такие как одностраничные приложения или нативные приложения.

    Приложения, пытающиеся зарегистрироваться с помощью метода, не разрешенного вашей политикой, отклоняются.

    Для получения дополнительных сведений об этих методах аутентификации см. следующий раздел Методы аутентификации.

Настройка DCR в клиентском приложении OAuth

После того как вы настроите DCR в Qlik Cloud, настройте подключение DCR в своем клиентском приложении OAuth. Параметры подключения различаются в зависимости от сценария использования.

Выполните следующие действия.

  1. Используйте URL-адрес подключения для вашего сценария использования при настройке подключения в клиентском приложении OAuth:

    Вариант использования Формат URL подключения
    Клиенты MCP или GenAI https://<tenant-id>.<region>.qlikcloud.com/api/ai/mcp

    Для получения дополнительной информации о конфигурации MCP см. раздел Подключение к Qlik серверу MCP.

    Другие клиентские приложения OAuth https://<tenant-id>.<region>.qlikcloud.com
  2. Ознакомьтесь с поведением утверждения и согласия для вновь зарегистрированных клиентов DCR:

    • Убедитесь, что новые клиенты DCR требуют явного одобрения клиента, прежде чем их можно будет использовать. В стороннем приложении предоставьте разрешение при появлении соответствующего запроса.

    • Первое одобренное подключение использует обязательное согласие.

    • После одобрения отредактируйте клиента в Qlik Cloud и измените его метод согласия на Trusted, если это соответствует вашей политике безопасности.

    Одобрение клиента устанавливает доверие на уровне клиента между вашим Qlik Cloud клиентом и клиентским приложением OAuth. После того как администратор клиента подключится, пройдет аутентификацию и одобрит запрос на согласие, другие пользователи смогут подключаться к Qlik Cloud через то же приложение OAuth без необходимости одобрять согласие со своей стороны.

    Метод согласия управляется для каждого клиента после утверждения. Для получения дополнительной информации см. раздел Создание клиентов OAuth и управление ими.

Методы аутентификации

При настройке параметров DCR вы можете указать, какие методы аутентификации разрешено использовать динамически зарегистрированным клиентам. Доступны следующие методы аутентификации:

  • Секрет клиента: Разрешает конфиденциальные клиентские приложения, выполняющие аутентификацию с использованием секрета клиента. Клиент получает секрет клиента при регистрации. Это включает в себя как client_secret_basic, так и client_secret_post методы аутентификации.

  • None: Разрешает общедоступные клиенты, которые не используют секрет клиента. Эти клиенты используют поток кода авторизации с PKCE (Proof Key for Code Exchange) для аутентификации.

По умолчанию динамически зарегистрированные клиенты используют метод аутентификации client_secret_basic, если при регистрации не указано иное.

Управление множеством регистраций от поставщиков

Многие клиентские приложения OAuth динамически регистрируют единственный OAuth-клиент с помощью Qlik Cloud. Пользователи приложения используют общий OAuth-клиент.

Некоторые клиентские приложения OAuth динамически регистрируют несколько клиентов OAuth, по одному на пользователя. Это поведение наблюдалось у:

  • Anthropic Claude

  • Antigravity

Если вы видите много клиентов DCR от одного и того же вендора, проверьте, как это клиентское приложение OAuth регистрирует клиентов и доступен ли вариант с общим коннектором. Чтобы удалить ненужные клиенты DCR массово, см. Удаление клиентов OAuth.

Claude и Claude Code поддерживают CIMD, что позволяет избежать проблемы множественной регистрации. См. Подключение Claude к MCP-серверу Qlik.

Пример доступа MCP

Один из сценариев использования DCR — это подключение клиентов OAuth для интеграций с сервером Qlik MCP. DCR не ограничивается MCP и может использоваться другими совместимыми клиентскими приложениями OAuth. Для подключений на основе MCP администратор клиента обычно создает первое подключение и утверждает клиента перед тем, как другие пользователи выполнят подключение.

Инструкции по администрированию MCP и управлению подключением см. здесь:

Инструкции по управлению клиентами OAuth после их создания (включая работу с несколькими регистрациями поставщиков, массовое удаление и идентификацию клиентов DCR или CIMD) см. в разделе Управление клиентами OAuth.

Помогла ли вам эта страница?

Если вы обнаружили какую-либо проблему на этой странице или с ее содержанием — будь то опечатка, пропущенный шаг или техническая ошибка, сообщите нам об этом!