Dokumentation Experience Platform Data Governance-Handbuch

Endpunkt des öffentlichen Zertifikats

Last update: Tue Dec 31 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Themen:
Data Governance

Erstellt für:

Entwickler

In diesem Handbuch wird erläutert, wie Sie mit dem öffentlichen Zertifikatendpunkt öffentliche Zertifikate für die Adobe-Programme Ihres Unternehmens sicher abrufen können. Er enthält einen Beispiel-API-Aufruf und detaillierte Anweisungen, die Entwicklern bei der Authentifizierung und Überprüfung des Datenaustauschs helfen.

Erste Schritte

Bevor Sie fortfahren, lesen Sie den Abschnitt Erste Schritte. Dort erhalten Sie wichtige Informationen darüber, wie Sie die API aufrufen und die erforderlichen Kopfzeilen sowie Beispiele für API-Aufrufe lesen können.

API-Pfade paths

Im Folgenden finden Sie die wesentlichen API-Pfade, die Sie für die Verwendung der mTLS-Service-API benötigen. Dazu gehören die Platform-Gateway-URL, der Basispfad für die API und ein Beispiel für einen vollständigen Pfad zum Abrufen eines öffentlichen Zertifikats.

PLATFORM-Gateway-URL: https://platform.adobe.io/
Basispfad für diese API: /data/core/mtls
Beispiel für einen vollständigen Pfad: https://platform.adobe.io/data/core/mtls/v1/certificate/public-certificate

Abrufen Ihrer öffentlichen Zertifikate list

Sie können die öffentlichen Zertifikate für alle Adobe-Programme Ihres Unternehmens abrufen, indem Sie eine GET-Anfrage an den /v1/certificate/public-certificate-Endpunkt stellen.

API-Format

GET /v1/certificate/public-certificate

Die folgenden optionalen Abfrageparameter können beim Abrufen Ihrer öffentlichen Zertifikate verwendet werden.

Abfrageparameter

Beschreibung

Beispiel

page

Gibt an, auf welcher Seite die Ergebnisse Ihrer Anfrage beginnen sollen.

page=5

limit

Die maximale Anzahl öffentlicher Zertifikate, die pro Seite abgerufen werden sollen.

limit=20

Anfrage

Eine Beispielanfrage zum Zurückgeben der mit Ihrer Organisation verknüpften öffentlichen Zertifikate finden Sie unten im ausblendbaren Abschnitt.

Beispielanfrage

code language-shell

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}'`

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}'

Antwort

Bei einer erfolgreichen Antwort wird der HTTP-Status 200 zurückgegeben und die öffentlichen Zertifikate für Ihre Organisation aufgelistet.

Beispiel für eine erfolgreiche Antwort

code language-json

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 } } }`

{
   "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
Eigenschaft	Beschreibung
`certCommonName`	Der allgemeine Name (CN) des Zertifikats, der normalerweise den Namen oder die Identität des Servers oder der Entität darstellt, für die das Zertifikat ausgestellt wird.
`publicCertificate`	Das eigentliche öffentliche Zertifikat in einem Zeichenfolgenformat, das zum Authentifizieren und Verschlüsseln der Kommunikation verwendet wird.
`expiryDate`	Datum und Uhrzeit des Ablaufs des öffentlichen Zertifikats, formatiert in ISO 8601 (UTC).

Nächste Schritte

Nach dem Lesen dieses Handbuchs wissen Sie jetzt, wie Sie Ihre öffentlichen Zertifikate mit der Adobe Experience Platform-API abrufen können. Weitere Informationen zur Verwaltung von Kundendaten, um die Einhaltung von Vorschriften und organisatorischen Richtlinien sicherzustellen, finden Sie unter Data Governance - Übersicht.

recommendation-more-help

834e0cae-2761-454a-be4d-62f0fd4b4456