公共证书端点

最近更新： 2024年9月11日

创建对象：

  • 开发人员

本指南介绍如何使用公共证书端点安全地检索组织Adobe应用程序的公共证书。 它包括一个示例API调用和详细说明，帮助开发人员验证和验证数据交换。

快速入门

在继续之前，请查看快速入门指南以了解成功调用API所需了解的重要信息，包括所需的标头以及如何读取示例API调用。

API路径

以下信息是使用mTLS服务API所需的基本API路径。 这些资源包括平台网关URL、API的基本路径以及用于检索公共证书的完整路径的示例。

  • 平台网关URL： https://platform.adobe.io/
  • 此API的基本路径： /data/core/mtls
  • 完整路径示例： https://platform.adobe.io/data/core/mtls/v1/certificate/public-certificate

检索您的公共证书

您可以通过向/v1/certificate/public-certificate端点发出GET请求来检索贵组织的任何Adobe应用程序的公共证书。

API格式

GET /v1/certificate/public-certificate

在检索公共证书时，可以使用以下可选查询参数。

查询参数描述示例
page指定请求结果的开始页面。page=5
limit每页要检索的公共证书的最大数目。limit=20

请求

返回与您的组织关联的公共证书的请求示例，请参见下面的可折叠部分。

示例请求
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并列出组织的公共证书。

成功响应的示例
{
   "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
      }
   }
}
属性描述
certCommonName证书的公共名称(CN)，通常表示证书颁发到的服务器或实体的名称或身份。
publicCertificate字符串格式的实际公共证书，用于验证和加密通信。
expiryDate公共证书到期的日期和时间，格式为ISO 8601 (UTC)。