Autenticación authentication
Información general
El 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, la variable Server API verifica la secuencia de datos access type configuración. 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 al flujo de datos, consulte la documentación sobre cómo creación y configuración de una secuencia de datos.
A continuación se muestra un resumen del comportamiento basado en el conjunto de datos Access Type y el punto final en el que se recibe la solicitud.
Llamadas de API procedentes de un servidor privado en server.adobedc.net
siempre debe estar autenticado.
Requisitos previos prerequisites
Antes de poder 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 el
developer
yuser
funciones habilitadas para el perfil de producto de la API de Adobe Experience Platform. Póngase en contacto con su Admin Console para habilitar estas funciones en su cuenta. - Tiene un Adobe ID. Si no dispone de un Adobe ID, vaya al Consola de Adobe Developer y cree 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 a Admin Console, busque el perfil de producto adjunto a la clave de API y establezca los siguientes permisos:
- En el Zonas protegidas , seleccione la zona protegida de la secuencia de datos.
- En el Administración de datos , seleccione la Administrar conjuntos de datos permiso.
Solución de errores de autorización troubleshooting-authorization
EXEG-0500-401
Este mensaje de error se muestra en cualquiera de las siguientes situaciones:
- El
authorization
falta el valor del encabezado. - El
authorization
el valor del encabezado no incluye el valor requeridoBearer
token. - 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-401
Este mensaje de error se muestra en cualquiera de las siguientes situaciones:
- Falta el requerido en la llamada de API
x-user-token
encabezado. - El token de usuario proporcionado tiene un formato no válido.
EXEG-0502-401
EXEG-0503-401
EXEG-0504-401
Este 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-401
acp.foundation
Ámbito de IMS.EXEG-0506-401
WRITE
acceso a la zona protegida del Experience Platform en la que se define el conjunto de datos.