Проверка сертификата клиента на соответствие хранилищу доверенных сертификатов

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

В этом документе рассказывается, как проверить, что на маршрутизаторы Apigee Edge загружены правильные сертификаты клиента. Процесс проверки сертификатов основан на OpenSSL – базовом механизме, который используется NGINX на маршрутизаторах Apigee Edge.

При любом несоответствии сертификатов, отправленных клиентскими приложениями в составе запроса к API, и сертификатов, хранящихся в маршрутизаторах Apigee Edge, возникнет ошибка 400 Bad Request - SSL Certificate errors. Проверка сертификатов с помощью описанного в этом документе процесса поможет вам заранее выявлять такие проблемы и предотвращать ошибки сертификатов во время выполнения.

Подготовка

Прежде чем выполнять описанные в этом документе действия, убедитесь, что вы понимаете следующие темы:

  • Если вы не знакомы с библиотекой OpenSSL, прочитайте статью OpenSSL.
  • Если вы хотите использовать примеры командной строки в этом руководстве, установите или обновите клиент OpenSSL до последней версии.
  • Убедитесь, что сертификаты имеют формат PEM. Если нет, преобразуйте сертификаты в формат PEM.

Проверка сертификатов клиента на соответствие хранилищу доверенных сертификатов на маршрутизаторах Apigee

В этом разделе описаны шаги, которые позволяют убедиться, что сертификаты клиента идентичны сертификатам, хранящимся в хранилище доверенных сертификатов на маршрутизаторах Apigee Edge.

  1. Войдите в систему на одном из компьютеров маршрутизатора.
  2. Перейдите в папку /opt/nginx/conf.d, в которой сертификаты хранятся в хранилище доверенных сертификатов маршрутизаторов Apigee Edge.
  3. Укажите хранилище доверенных сертификатов, для которого вы хотите проверить клиентские сертификаты. Название хранилища доверенных сертификатов имеет следующий формат:
    org-env-virtualhost-client.pem

    Где:

    • org – название организации Apigee
    • env – название среды Apigee
    • virtualhost – имя виртуального хоста Apigee
    • Например, чтобы проверить следующее:

      • Организация: myorg
      • Среда: test
      • Виртуальный хост: secure

      Название хранилища доверенных сертификатов: myorg-test-secure-client.pem.

  4. Перенесите клиентский сертификат, который вы хотите проверить, с локальной машины в каталог /tmp на маршрутизаторе, используя scp, sftp или другую утилиту.

    Например, используйте команду scp следующим образом:

    scp client_cert.pem router-host:/tmp

    где router-host – название маршрутизатора.

  5. Чтобы проверить сертификат клиента с помощью OpenSSL, выполните следующие действия:
    openssl verify -trusted org-env-virtualhost-client.pem /tmp/client-cert.pem

    Где:

    • org – название организации Apigee
    • env – название среды Apigee
    • virtualhost – имя виртуального хоста Apigee
  6. Исправьте все ошибки, которые были возвращены командой выше.

    Если в хранилище доверенных сертификатов на маршрутизаторе Apigee Edge нет нужных сертификатов, удалите их и загрузите правильные сертификаты в формате PEM в хранилище доверенных сертификатов с помощью API для загрузки сертификатов в хранилище доверенных сертификатов.