CAとクライアント証明書

Apidogで証明書を追加・管理することで、リクエスト送信時の認証が可能になる。

相互TLS（mTLS）を使用するAPIに接続するには、クライアント証明書をApidogに追加する必要がある。相互TLSは、クライアントとサーバーの両方が証明書で身元を確認する必要がある認証方式だ。両者の身元が確認されると、暗号化された接続が確立される。

また、カスタムCA証明書をApidogに追加することもできる。APIが内部証明書レジストリに登録された証明書を使用している場合、Apidogから送信されたリクエストは「SSL Error: Self signed certificate」で失敗する。カスタムCA証明書を追加することで、SSL検証をオフにすることなくAPIにリクエストを送信できる。

証明書の管理

Apidog設定で、インストールされた証明書の表示、新規証明書の追加、証明書の削除ができる。

右上の設定アイコンを選択

証明書タブを選択

CA証明書の追加

リクエスト送信時の「自己署名証明書」エラーを避けるため、カスタムCA証明書をApidogに追加する。

CA証明書の横のトグルをオンにする

CA証明書のPEMファイルを選択（PEMファイルには複数のCA証明書を含めることができる）

クライアント証明書の追加

相互TLS認証を使用するAPIにリクエストを送信するには、クライアント証明書をApidogに追加する。

「証明書を追加」を選択

証明書のホストドメインを入力（プロトコルは含めない）ホストフィールドはパターンマッチングをサポート。*.example.com を入力すると、すべてのexample.comサブドメインで同じクライアント証明書が使用される

（オプション）ドメインに関連付けるカスタムポート番号を入力。指定しない場合、ApidogはデフォルトのHTTPSポート（443）を使用

証明書のCRTファイルとKeyファイル、またはPFXファイルを選択

クライアント証明書の生成時にパスフレーズを使用した場合は入力。使用していない場合は空欄のまま

「追加」を選択

各クライアント証明書は特定のドメインに対応している。より多くのドメインにリクエストを送信するには、各ドメインに適切な証明書を追加する。同じドメインに複数の証明書を追加しないこと。同じドメインに複数の証明書を追加した場合、Apidogは最後に追加された証明書を使用する。

証明書の編集

追加後の証明書は編集できない。変更するには、まず証明書を削除し、新しい証明書を生成してApidogに追加する。

証明書の削除

Apidogからのリクエスト送信に不要になった証明書は削除できる。

CA証明書を削除するには、証明書の横にある削除アイコンを選択

クライアント証明書を削除するには、証明書の横にある削除アイコンを選択

証明書の使用

クライアント証明書を追加した後、Apidogで使用するための追加手順は不要だ。設定されたドメインにHTTPSリクエストを行うと、Apidogは自動的にクライアント証明書をリクエストと共に送信する。証明書はOpenSSLの処理を使用して送信され、Apidogは証明書を変更しない。

HTTPリクエストの場合、Apidogは証明書を送信しない。

CAとクライアント証明書

証明書の管理#

CA証明書の追加#

クライアント証明書の追加#

証明書の編集#