DocumentaciónExperience PlatformRecopilación de datos

[Alpha]{class="badge informative"}

edgeCredentials (SDK de servidor)

Última actualización: 30 de octubre de 2026

Creado para:

  • Developer

El objeto edgeCredentials contiene la credencial de servidor a servidor OAuth que SDK utiliza para autenticarse con Adobe. SDK intercambia las credenciales por un token de acceso y, a continuación, utiliza el token para enviar eventos a la API de servidor de Edge Network autenticada. Esta propiedad es necesaria. Web SDK no utiliza esta propiedad porque un explorador no puede mantener un secreto de cliente en privado.

Consulte Autenticación para obtener información sobre cómo crear una credencial en Adobe Developer Console y cómo la utiliza SDK.

Propiedades properties

Propiedad
Tipo
Requerido
Descripción
clientId
Cadena
Sí
El ID de cliente de su credencial de servidor a servidor OAuth. SDK también lo envía en el encabezado x-api-key de las solicitudes autenticadas.
clientSecret
Cadena
Sí
El Secreto de cliente de su credencial.
scopes
Matriz de cadenas
Sí
Los ámbitos enumerados para su credencial en Adobe Developer Console. Incluya al menos un ámbito.
imsHost
Cadena
No
Host del servicio Identity Management de Adobe (IMS) que emite tokens de acceso. El valor predeterminado es ims-na1.adobelogin.com. Cámbielo únicamente si Adobe le indica que lo haga.

Ejemplo de código

Establezca el objeto edgeCredentials cuando llame a configure. Lea los valores de las variables de entorno o de un administrador de secretos en lugar de colocarlos en el código fuente.

await alloy.configure({
  datastreamId: "ebebf826-a01f-4458-8cec-ef61de241c93",
  orgId: "ADB3LETTERSANDNUMBERS@AdobeOrg",
  edgeCredentials: {
    clientId: process.env.ADOBE_CLIENT_ID,
    clientSecret: process.env.ADOBE_CLIENT_SECRET,
    scopes: process.env.ADOBE_SCOPES.split(",")
  }
});

En este ejemplo, la variable de entorno ADOBE_SCOPES contiene una lista de ámbitos separados por comas, como la lista que Adobe Developer Console muestra para sus credenciales.

Validación y errores errors

  • Si falta edgeCredentials, configure rechaza con un error que indica que SDK requiere edgeCredentials.
  • Si clientId, clientSecret o scopes faltan o están vacíos, configure los rechaza con un error que nombra la propiedad que falta.
  • configure no comprueba si la credencial es válida. SDK solicita un token de acceso la primera vez que envía un evento autenticado. Si Adobe rechaza la credencial, ese método la rechaza con un error cuyo mensaje incluye Failed to acquire an IMS access token.

SDK reemplaza clientSecret por [REDACTED] en sus registros de depuración y en la configuración que devuelve getLibraryInfo.

recommendation-more-help
experience-platform-help-collection