DocumentaciónExperience PlatformGuía de gobernanza de datos

Extremo de certificado público

Last update: Wed May 14 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Creado para:

  • Desarrollador
NOTE
Adobe ya no admite la descarga estática de certificados mTLS públicos. Utilice esta API para recuperar certificados válidos para sus integraciones. Ahora se requiere la recuperación automatizada para evitar interrupciones en el servicio.

En esta guía se explica cómo utilizar el extremo de certificados públicos para recuperar de forma segura certificados públicos para las aplicaciones de Adobe de su organización. Incluye una llamada de API de ejemplo e instrucciones detalladas para ayudar a los desarrolladores a autenticarse y verificar los intercambios de datos.

Introducción

Antes de continuar, revisa la guía de introducción para obtener detalles importantes acerca de los encabezados requeridos y cómo interpretar las llamadas de API de ejemplo.

Rutas de API paths

La siguiente información son las rutas de API esenciales que necesitará para utilizar la API del servicio mTLS. Estas incluyen la dirección URL de la puerta de enlace de la plataforma, la ruta base para la API y un ejemplo de una ruta completa para recuperar un certificado público.

  • URL de puerta de enlace de PLATFORM: https://platform.adobe.io/
  • Ruta de acceso base para esta API: /data/core/mtls
  • Ejemplo de ruta de acceso completa: https://platform.adobe.io/data/core/mtls/v1/certificate/public-certificate

Recuperación de certificados públicos list

Realice una petición GET al extremo /v1/certificate/public-certificate para recuperar los certificados públicos de cualquiera de las aplicaciones Adobe de su organización.

Formato de API

GET /v1/certificate/public-certificate

Los siguientes parámetros de consulta opcionales se pueden utilizar al recuperar los certificados públicos.

Parámetros de consulta
Descripción
Ejemplo
page
Especifica desde qué página comenzarán los resultados de la solicitud.
page=5
limit
Número máximo de certificados públicos que desea recuperar por página.
limit=20

Solicitud

En la sección contraíble siguiente se muestra una solicitud de ejemplo para devolver los certificados públicos asociados a su organización.

Solicitud de ejemplo
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}'

Respuesta

Una respuesta correcta devuelve el estado HTTP 200 y enumera los certificados públicos de su organización.

Una respuesta correcta de muestra
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
Propiedad Descripción
certCommonName El nombre común (CN) del certificado, que suele representar el nombre o la identidad del servidor o entidad al que se emite el certificado.
publicCertificate El certificado público real en formato de cadena, que se utiliza para autenticar y cifrar comunicaciones.
expiryDate La fecha y hora en que caducará el certificado público, con formato ISO 8601 (UTC).

Automatización del ciclo vital de certificados certificate-lifecycle-automation

Adobe automatiza el ciclo de vida de los certificados mTLS públicos para garantizar la continuidad y reducir las interrupciones del servicio.

  • Los certificados se vuelven a emitir 60 días antes del vencimiento.
  • Los certificados se revocan 30 días antes de la caducidad.
NOTE
Estas escalas de tiempo se acortarán con el tiempo de acuerdo con las directrices del foro CA/B, cuyo objetivo es reducir la duración del certificado a un máximo de 47 días.

Debe actualizar las integraciones para que admitan la recuperación automatizada a través de la API. No confíe en las descargas manuales de certificados ni en las copias estáticas, ya que pueden dar lugar a certificados caducados o revocados.

Pasos siguientes

Después de recuperar los certificados públicos mediante la API, actualice las integraciones para llamar regularmente a este punto de conexión antes de que los certificados caduquen. Para probar esta llamada de forma interactiva, visite la página de referencia de la API MTLS. Para obtener instrucciones más amplias sobre las integraciones basadas en certificados, consulte Información general sobre el cifrado de datos en Adobe Experience Platform o Información general sobre el control de datos.

recommendation-more-help
834e0cae-2761-454a-be4d-62f0fd4b4456