Добавление сертификата удостоверяющего центра в Azure API Management

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

Azure API Management позволяет отправлять и устанавливать сертификаты ЦС на компьютере в доверенных корневых и промежуточных хранилищах сертификатов. Используйте эту функцию, если службам требуется пользовательский сертификат ЦС.

В этой статье показано, как управлять сертификатами ЦС экземпляра службы управления API на портале Azure. Например, если вы используете самозаверяющие сертификаты клиентов, можно передать свои доверенные корневые сертификаты в службу "Управление API".

Это важно

Если ваш экземпляр API Management находится на одном из v2 уровней, вы можете настроить только сведения о сертификатах ЦС в авторизационных данных бэкенда. Дополнительные сведения см. в руководстве по серверным службам.

Сертификаты ЦС, загруженные в Управление API, могут использоваться для проверки сертификатов только управляемым шлюзом этого сервиса. Если вы используете самостоятельно размещенный шлюз, вы можете узнать, как создать пользовательский сертификат ЦС для самостоятельно размещенного шлюза далее в этой статье.

Примечание.

В настоящее время эта функция недоступна в рабочих областях.

Это важно

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

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

Примечание.

Мы рекомендуем использовать модуль Az PowerShell Azure для взаимодействия с Azure. Сведения о начале работы см. в разделе Install Azure PowerShell. Сведения о миграции в модуль Az PowerShell см. в статье Migrate Azure PowerShell из AzureRM в Az.

Загрузить сертификат удостоверяющего центра

Выполните следующие действия, чтобы загрузить новый сертификат ЦС. Если вы еще не создали экземпляр службы управления API, см. статью "Создание экземпляра службы управления API".

  1. Перейдите к экземпляру Azure API Management в портале Azure.

  2. В меню слева в разделе "Безопасность" выберите "Сертификаты". На странице "Сертификаты" выберите сертификаты> ЦС+ Добавить.

  3. В окне Загрузить сертификат ЦС выберите значок файла и найдите сертификат .cer. В поле "Магазин" выберите хранилище сертификатов. Вам нужен только открытый ключ, а пароль указывать необязательно.

    Скриншот, показывающий шаги по добавлению сертификата ЦС в портале Azure.

  4. Нажмите кнопку "Добавить " в нижней части окна и нажмите кнопку "Сохранить". Эта операция может занять несколько минут.

Примечание.

Вы также можете отправить сертификат ЦС с помощью New-AzApiManagementSystemCertificate команды PowerShell.

Удаление сертификата ЦС

Выберите сертификат и нажмите кнопку "Удалить " в меню ... .

Создание настраиваемого ЦС для локального шлюза

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

Используйте REST API центра сертификации шлюза для создания пользовательских ЦС и управления ими для локального шлюза. Чтобы создать пользовательский центр сертификации, сделайте следующее:

  1. Добавьте PFX-файл сертификата в экземпляр службы управления API.
  2. Используйте REST API Центра сертификации шлюза - создание или обновление, чтобы связать сертификат с самоуправляемым шлюзом.

Limits

В настоящее время управление API ограничивает количество сертификатов удостоверяющего центра до 10 на один экземпляр.

Связанный контент

  • Last updated on