DocumentationExperience PlatformCollecte de données

[Alpha]{class="badge informative"}

edgeCredentials (Server SDK)

Dernière mise à jour : 30 octobre 2026

Créé pour :

  • Developer

L’objet edgeCredentials contient les informations d’identification de serveur à serveur OAuth que le serveur SDK utilise pour s’authentifier avec Adobe. Le SDK échange les informations d’identification contre un jeton d’accès, puis utilise le jeton pour envoyer des événements à l’API du serveur Edge Network authentifiée. Cette propriété est obligatoire. Le SDK Web n’utilise pas cette propriété, car un navigateur ne peut pas garder un secret client privé.

Voir Authentification pour savoir comment créer des informations d’identification dans le Adobe Developer Console et comment le SDK les utilise.

Propriétés properties

Propriété
Type
Obligatoire
Description
clientId
Chaîne
Oui
L’ID client de vos informations d’identification de serveur à serveur OAuth. Le SDK l’envoie également dans l’en-tête x-api-key des requêtes authentifiées.
clientSecret
Chaîne
Oui
Le Secret client de vos informations d’identification.
scopes
Tableau de chaînes
Oui
Les Portées répertoriées pour vos informations d’identification dans le Adobe Developer Console. Incluez au moins une portée.
imsHost
Chaîne
Non
L’hôte Adobe Identity Management Service (IMS) qui émet des jetons d’accès. La valeur par défaut est ims-na1.adobelogin.com. Modifiez-la uniquement si Adobe vous le demande.

Exemple de code

Définissez l’objet edgeCredentials lors de l’appel de configure. Lisez les valeurs des variables d’environnement ou d’un gestionnaire de secrets au lieu de les placer dans le code source.

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(",")
  }
});

Dans cet exemple, la variable d’environnement ADOBE_SCOPES contient une liste de portées séparées par des virgules, telle que la liste affichée par le Adobe Developer Console pour vos informations d’identification.

Validation et erreurs errors

  • Si edgeCredentials est manquant, configure le rejette avec une erreur indiquant que le SDK requiert edgeCredentials.
  • Si la propriété clientId, clientSecret ou scopes est manquante ou vide, configure la rejette avec une erreur qui nomme la propriété manquante.
  • configure ne vérifie pas si les informations d’identification sont valides. Le SDK demande un jeton d’accès la première fois qu’il envoie un événement authentifié. Si Adobe rejette les informations d’identification, cette méthode les rejette avec une erreur dont le message inclut Failed to acquire an IMS access token.

Le SDK remplace clientSecret par [REDACTED] dans ses journaux de débogage et dans la configuration que getLibraryInfo renvoie.

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