トラストストアでクライアント証明書を検証する

ここに表示されているのは Apigee Edge のドキュメントです。
Go to the Apigee X のドキュメントに移動します。 info

このドキュメントでは、正しいクライアント証明書が Apigee Edge Router にアップロードされていることを確認する方法について説明します。 証明書の検証プロセスは OpenSSL に依存しています。これは、Apigee Edge Router の NGINX で使用される基盤となるメカニズムです。

API リクエストの一部としてクライアント アプリケーションから送信された証明書と、Apigee Edge Router に保存されている証明書が一致しない場合、 400 Bad Request - SSL Certificate エラーが発生します。このドキュメントで説明するプロセス を使用して証明書を検証すると、これらの問題を事前に検出し、実行時の証明書エラーを防ぐことができます。

始める前に

このドキュメントの手順を使用する前に、次のトピックを理解しておいてください。

  • OpenSSL ライブラリに慣れていない場合は、 OpenSSL をご覧ください。
  • このガイドのコマンドラインの例を使用する場合は、 OpenSSL クライアントの最新バージョンをインストールするか、最新バージョンに更新してください。
  • 証明書が PEM 形式であることを確認します。PEM 形式でない場合は、 証明書を PEM 形式に変換します。

Apigee Router のトラストストアに対してクライアント証明書を検証する

このセクションでは、クライアント証明書が Apigee Edge Router のトラストストアに保存されている証明書と同一であることを確認する手順について説明します。

  1. Router マシンにログインします。
  2. /opt/nginx/conf.d フォルダに移動します。このフォルダに、 Apigee Edge Router のトラストストアに証明書が保存されています。
  3. クライアント証明書を検証するトラストストアを特定します。 トラストストア名の形式は次のとおりです。 
    org-env-virtualhost-client.pem

    ここで、

    • org は Apigee 組織名です
    • env は Apigee 環境名です
    • virtualhost は Apigee 仮想ホスト名です

      • たとえば、次のものを検証するには、

      • 組織: myorg
      • 環境: test
      • 仮想ホスト: secure

      トラストストア名は myorg-test-secure-client.pem です。

  4. `scp`、`sftp`、その他のユーティリティを使用して、検証する実際のクライアント証明書をローカル マシンから Router の `/tmp` ディレクトリに転送します。

    たとえば、scp コマンドは次のように使用します。 

    scp client_cert.pem router-host:/tmp

    ここで、router-host は Router マシンの名前です。

  5. OpenSSL を使用して、次のようにクライアント証明書を検証します。 
    openssl verify -trusted org-env-virtualhost-client.pem /tmp/client-cert.pem

    ここで、

    • org は Apigee 組織名です
    • env は Apigee 環境名です
    • virtualhost は Apigee 仮想ホスト名です

  6. 上記のコマンドから返されたエラーを修正します。

    Apigee Edge Router のトラストストアに正しい証明書が含まれていない場合は、この トラストストアへの証明書のアップロード API を使用して、正しい証明書を PEM 形式でトラストストアにアップロードします。 トラストストアへの証明書のアップロード API を使用して、正しい証明書を PEM 形式でトラストストアにアップロードします。