公開証明書エンドポイント

最終更新日： 2025年10月14日

トピック：
Data Governance

作成対象：

Developer

NOTE

Adobeでは、パブリック mTLS証明書の静的ダウンロードがサポートされなくなりました。このAPIを使用して、統合の有効な証明書を取得します。サービスの中断を回避するには、自動取得が必要になりました。

このガイドでは、公開証明書エンドポイントを使用して、組織のAdobe アプリケーションの公開証明書を安全に取得する方法について説明します。サンプル API呼び出しと、開発者がデータ交換を認証および検証するための詳細な手順が含まれています。

はじめに

続行する前に、必須ヘッダーに関する重要な詳細とサンプル API呼び出しの解釈方法については、入門ガイドを参照してください。

API パス paths

次の情報は、mTLS サービス APIを使用するために必要な基本的なAPI パスです。これには、プラットフォームゲートウェイ URL、APIのベースパス、公開証明書を取得するための完全なパスの例が含まれます。

PLATFORM ゲートウェイ URL: https://platform.adobe.io/
このAPIのベースパス：/data/core/mtls
完全なパスの例：https://platform.adobe.io/data/core/mtls/v1/certificate/public-certificate

公開証明書を取得 list

組織のすべてのAdobe アプリケーションの公開証明書を取得するには、/v1/certificate/public-certificate エンドポイントにGET リクエストを行います。

API 形式

GET /v1/certificate/public-certificate

公開証明書を取得する際には、次のオプションのクエリパラメーターを使用できます。

クエリパラメーター

説明

例

page

リクエストの結果を開始するページを指定します。

page=5

limit

ページごとに取得する公開証明書の最大数。

limit=20

リクエスト

組織に関連付けられている公開証明書を返すサンプルリクエストは、以下の折りたたみ可能なセクションに表示されます。

リクエストのサンプル

code language-shell

curl -X GET https://platform.adobe.io/data/core/mtls/v1/certificate/public-certificate
 -H 'Authorization: Bearer {ACCESS_TOKEN}' \
 -H 'Content-Type: application/json' \
 -H 'x-gw-ims-org-id: {ORG_ID}' \
 -H 'x-api-key: {API_KEY}'

応答

応答が成功すると、HTTP ステータス 200が返され、組織の公開証明書が一覧表示されます。

成功した応答のサンプル

code language-json

{
   "results":[
      {
         "certCommonName":"Adobe Experience Platform",
         "publicCertificate":"-----BEGIN CERTIFICATE-----\nMIIDQTCCAimgAwIBAgITBmyfACAfma......KJY5u89CjAwj\n-----END CERTIFICATE-----",
         "expiryDate":"2024-07-17T21:27:57.434Z"
      }
   ],
   "total":0,
   "count":0,
   "_links":{
      "next":{
         "href":"string",
         "templated":true
      },
      "prev":{
         "href":"string",
         "templated":true
      },
      "page":{
         "href":"string",
         "templated":true
      }
   }
}

table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto
プロパティ	説明
`certCommonName`	証明書の共通名（CN）。通常、証明書が発行されるサーバーまたはエンティティの名前またはIDを表します。
`publicCertificate`	通信の認証と暗号化に使用される文字列形式の実際の公開証明書。
`expiryDate`	公開証明書の有効期限が切れる日時（形式：ISO 8601）（`yyyy-MM-dd'T'HH:mm:ss'Z'`）。

証明書のライフサイクルの自動化 certificate-lifecycle-automation

Adobeは、パブリック mTLS証明書のライフサイクルを自動化して、継続性を確保し、サービスの中断を減らします。

証明書は、有効期限の60日前に再発行されます。
証明書は、有効期限の30日前に失効します。

NOTE

これらのタイムラインは、CA/B フォーラムのガイドラインに従って時間の経過に伴って短縮されます。このガイドラインは、証明書の有効期間を最大47日に短縮することを目的としています。

API経由の自動取得をサポートするには、統合を更新する必要があります。手動による証明書のダウンロードや静的コピーは、期限切れや失効した証明書につながる可能性があるため、利用しないでください。

次の手順

APIを使用して公開証明書を取得した後、証明書の有効期限が切れる前に、統合を更新してこのエンドポイントを定期的に呼び出します。この呼び出しを対話的にテストするには、MTLS API リファレンスページにアクセスしてください。証明書ベースの統合に関する詳細なガイダンスについては、Data encryption in Adobe Experience Platform overviewまたはData Governance overviewを参照してください。

recommendation-more-help

experience-platform-help-data-governance