Autenticación authentication
Información general
Edge Network Server API administra la recopilación de datos autenticados y no autenticados, según el origen de los eventos y el dominio de recopilación de API.
Para cada solicitud, Server API comprueba la configuración de la secuencia de datos access type. Con esta configuración, los clientes pueden configurar un conjunto de datos para aceptar datos autenticados o tanto datos autenticados como no autenticados. De forma predeterminada, se aceptan ambos tipos de datos.
Para obtener más información sobre la configuración del tipo de acceso a la secuencia de datos, consulte la documentación sobre cómo crear y configurar una secuencia de datos.
A continuación se muestra un resumen del comportamiento, basado en la configuración del conjunto de datos Access Type y el extremo en el que se recibe la solicitud.
Las llamadas de API procedentes de un servidor privado en server.adobedc.net siempre se deben autenticar.
Requisitos previos prerequisites
Antes de realizar llamadas a Server API, asegúrese de cumplir los siguientes requisitos previos:
- Tiene una cuenta de organización con acceso a Adobe Experience Platform.
- Su cuenta de Experience Platform tiene habilitados los roles
developeryuserpara el perfil de producto de la API de Adobe Experience Platform. Póngase en contacto con el Admin Console de 🔗 para habilitar estos roles en su cuenta. - Tiene un Adobe ID. Si no tienes un Adobe ID, ve a Adobe Developer Console y crea una nueva cuenta.
Recopilar credenciales credentials
Para realizar llamadas a las API de Platform, primero debe completar el tutorial de autenticación. Al completar el tutorial de autenticación, se proporcionan los valores de cada uno de los encabezados necesarios en todas las llamadas a la API de Experience Platform, como se muestra a continuación:
- Autorización: Portador
{ACCESS_TOKEN} - x-api-key:
{API_KEY} - x-gw-ims-org-id:
{ORG_ID}
Los recursos de Experience Platform se pueden aislar en zonas protegidas virtuales específicas. En las solicitudes a las API de Platform, puede especificar el nombre y el ID de la zona protegida en la que se realizará la operación. Son parámetros opcionales.
- x-sandbox-name:
{SANDBOX_NAME}
Todas las solicitudes que contienen una carga útil (POST, PUT, PATCH) requieren un encabezado de tipo de medios adicional:
- Tipo de contenido:
application/json
Configurar permisos de escritura del conjunto de datos dataset-write-permissions
Para configurar los permisos de escritura del conjunto de datos, vaya al Admin Console, busque el perfil de producto adjunto a la clave de API y establezca los siguientes permisos:
- En la sección Zonas protegidas, seleccione la zona protegida de la secuencia de datos.
- En la sección Administración de datos, seleccione el permiso Administrar conjuntos de datos.
Solución de errores de autorización troubleshooting-authorization
EXEG-0500-401Este mensaje de error se muestra en cualquiera de las siguientes situaciones:
- Falta el valor del encabezado
authorization. - El valor del encabezado
authorizationno incluye el tokenBearerrequerido. - El token de autorización proporcionado tiene un formato no válido.
- La secuencia de datos requiere autenticación, pero en la solicitud faltan los encabezados obligatorios.
EXEG-0501-401Este mensaje de error se muestra en cualquiera de las siguientes situaciones:
- A la llamada de API le falta el encabezado
x-user-tokennecesario. - El token de usuario proporcionado tiene un formato no válido.
EXEG-0502-401EXEG-0503-401EXEG-0504-401Este mensaje de error se muestra en cualquiera de las siguientes situaciones:
- La cuenta de desarrollador no tiene acceso al contexto de producto de Adobe Experience Platform.
- La cuenta de empresa aún no tiene derecho a Adobe Experience Platform.
EXEG-0505-401acp.foundation.EXEG-0506-401WRITE a la zona protegida de Experience Platform en la que se define la secuencia de datos.