Поделиться через

Переход на новый портал разработчика

  • Статья

В этой статье описаны шаги, которые необходимо выполнить для миграции с устаревшего портала на новый портал разработчика в службе управления API.

Это важно

Используемая версия портала разработчика устарела, поэтому для нее теперь доступны только обновления безопасности. Вы по-прежнему можете использовать его в обычном режиме до прекращения его поддержки в октябре 2023 года, когда он будет удален изо всех служб Управления API.

Портал разработчика службы управления API

ОБЛАСТЬ ПРИМЕНЕНИЯ: Разработчик | Базовый | Стандартный | Премия

Улучшения на новом портале разработчика

Новый портал разработчика решает множество ограничений устаревшего портала. В нем есть визуальный редактор с перетаскиванием для редактирования содержимого и отдельная панель для дизайнеров для оформления веб-сайта. Страницы, настройки и конфигурация сохраняются в качестве ресурсов Azure Resource Manager в службе управления API, что позволяет автоматизировать развертывание портала. Наконец, база кода портала является открытым исходным кодом, поэтому ее можно расширить с помощью пользовательских функций.

Переход на новый портал разработчика

Новый портал разработчика несовместим с устаревшим порталом, и автоматическая миграция невозможна. Потребуется вручную восстановить содержимое (страницы, текст, мультимедийные файлы) и настроить внешний вид нового портала. Точные шаги зависят от настроек и сложности портала. Ознакомьтесь с руководством по порталу разработчика . Оставшаяся конфигурация, например список API, продуктов, пользователей, поставщиков удостоверений, автоматически предоставляется на обоих порталах.

Это важно

Если вы запускали новый портал разработчика ранее и не вносили никаких изменений, сбросьте содержимое по умолчанию, чтобы обновить его до последней версии.

При миграции с устаревшего портала помните о следующих изменениях:

  • Если вы предоставляете портал разработчика через личный домен, назначьте домен новому порталу разработчика. Используйте параметр портала разработчика из раскрывающегося списка на портале Azure.

  • Примените политику CORS к API, чтобы включить интерактивную консоль тестирования.

  • При внедрении пользовательского CSS для стиля портала необходимо воспроизвести стили с помощью встроенной панели дизайна. Внедрение CSS не допускается на новом портале.

  • Вы можете внедрить пользовательский JavaScript только в локальную версию нового портала.

  • Если управление API находится в виртуальной сети и обеспечивает доступ к Интернету с помощью шлюза приложений, см. эту статью документации для получения точных шагов по настройке. Вам нужно:

    • Включите подключение к конечной точке управления API.
    • Включите подключение к новой конечной точке портала.
    • Отключите выбранные правила брандмауэра веб-приложения.

  • Если вы изменили шаблоны уведомлений по электронной почте по умолчанию, чтобы включить явно определенный нерекомендуемый URL-адрес портала, измените их, чтобы использовать параметр URL-адреса портала или указать новый URL-адрес портала. Если шаблоны используют встроенный параметр URL-адреса портала, изменения не требуются.

  • Проблемы и приложения не поддерживаются на новом портале разработчика.

  • Прямая интеграция с Facebook, Microsoft, Twitter и Google в качестве поставщиков удостоверений не поддерживается на новом портале разработчика. Вы можете интегрироваться с этими поставщиками с помощью Azure AD B2C.

  • При использовании делегирования измените URL-адрес возврата в приложениях и используйте конечную точку API Получить общий токен доступа вместо конечной точки генерации URL для единого входа.

  • Если вы используете Microsoft Entra ID в качестве провайдера идентификации:

    • Измените URL-адрес возврата в приложении, чтобы указать на новый домен портала разработчика.
    • Измените суффикс возвращаемого URL-адреса в приложении с /signin-aad на /signin.

  • Если вы используете Azure AD B2C в качестве поставщика удостоверений:

    • Измените URL-адрес возврата в приложении, чтобы указать на новый домен портала разработчика.
    • Измените суффикс возвращаемого URL-адреса в приложении с /signin-aad на /signin.
    • Включите Имя, Фамилию и Идентификатор объекта пользователя в утверждения приложения.

  • Если вы используете OAuth 2.0 в интерактивной консоли тестирования, измените URL-адрес возврата в приложении, чтобы указать на новый домен портала разработчика и изменить суффикс:

    • От /docs/services/[serverName]/console/oauth2/authorizationcode/callback до /signin-oauth/code/callback/[serverName] для потока выдачи кода авторизации.
    • От /docs/services/[serverName]/console/oauth2/implicit/callback до /signin-oauth/implicit/callback для неявного процесса предоставления доступа.

  • Если вы используете OpenID Connect в интерактивной консоли тестирования, измените URL-адрес возврата в приложении, чтобы указать новый домен портала разработчика и изменить суффикс:

    • От /docs/services/[serverName]/console/openidconnect/authorizationcode/callback до /signin-oauth/code/callback/[serverName] для потока выдачи кода авторизации.
    • От /docs/services/[serverName]/console/openidconnect/implicit/callback до /signin-oauth/implicit/callback для неявного процесса предоставления доступа.

Дальнейшие действия

См. дополнительные сведения о портале разработчика: