OAuth 2.0: настройка нового прокси-сервера API

Вы просматриваете документацию по Apigee Edge.
Перейдите к документации по Apigee X. Информация

Если вы используете облачную версию Apigee Edge, то увидите, что в вашу организацию по умолчанию включен прокси-сервер oauth. Этот прокси-сервер предоставляет две конечные точки для создания токенов доступа и обновления. Чтобы узнать больше о конечных точках токенов OAuth, ознакомьтесь со статьей Конечные точки OAuth.

Тип предоставления учетных данных клиента определяет процедуру выдачи токенов доступа в обмен на учетные данные приложения. Эти учетные данные приложения представляют собой пару идентификатора клиента и секрета, которую Apigee Edge выдает для каждого приложения, зарегистрированного в организации. Подробнее о том, как реализовать тип предоставления доступа с кодом авторизации…

Как добавить OAuth 2.0 в новый прокси-сервер API

Вы можете легко добавить проверку OAuth в API при создании нового прокси-сервера API.

Edge

Чтобы добавить проверку OAuth в API с помощью интерфейса Edge:

  1. Войдите в аккаунт на сайте apigee.com/edge.
  2. На панели навигации слева выберите Develop > API Proxies (Разработка > Прокси API).
  3. Нажмите + Прокси.
  4. Чтобы создать обратный прокси-сервер, используйте мастер создания прокси-сервера. Подробнее о том, как создать простой прокси-сервер API…
  5. На странице Общие правила мастера установите переключатель рядом с пунктом OAuth v2.0.

Классическая версия Edge (частное облако)

Чтобы добавить проверку OAuth в API с помощью классического интерфейса Edge:

  1. Войдите в http://ms-ip:9000, где ms-ip – это IP-адрес или DNS-имя узла сервера управления.
  2. На панели навигации вверху страницы выберите API > Прокси API.
  3. Нажмите + API Proxy (Прокси API).
  4. Чтобы создать обратный прокси-сервер, используйте мастер создания прокси-сервера. Подробнее о том, как создать простой прокси-сервер API…
  5. На странице Безопасность мастера установите переключатель рядом с пунктом OAuth v2.0.

Если вы выберете этот вариант, к созданному прокси-серверу API будут прикреплены два правила: одно для проверки токенов доступа, а другое – для удаления токена доступа после проверки.

Обратите внимание, что флажок Продукт API публикации становится доступным и устанавливается автоматически. Установите этот флажок, если хотите, чтобы при создании нового прокси-сервера API автоматически генерировался продукт. Автоматически созданный продукт будет связан с новым прокси-сервером API. Если вы хотите связать новый API с существующим товаром, снимите флажок, чтобы не создавать лишний товар. Подробнее о продуктах API…

Как работать с прокси-сервером OAuth по умолчанию

Прокси-сервер OAuth предоставляет следующий URI конечной точки:

/oauth/client_credential/accesstoken

Опубликуйте этот URI для разработчиков, которым нужно получить токены доступа. Разработчики приложений настраивают свои приложения на вызов этой конечной точки, предоставляя пары идентификаторов клиента и секретов для получения токенов доступа.

Конечная точка токена учетных данных клиента по умолчанию доступна в сети по следующему URL:

https://{org_name}-{env_name}.apigee.net/oauth/client_credential/accesstoken

Например, если название вашей организации – "apimakers", URL будет выглядеть так:

https://apimakers-test.apigee.net/oauth/client_credential/accesstoken

Это URL, который разработчики используют для получения токенов доступа.

Вызов API

Когда вы получите токен доступа, вы сможете вызвать API с заголовком Authorization и токеном Bearer, как показано ниже:

curl -H "Authorization: Bearer <your access token>" http://myorg-myenv.apigee.net/myapi

Также ознакомьтесь со статьей Как подтверждать токены доступа.