DokumentationExperience PlatformDatenerfassung

[Alpha]{class="badge informative"}

edgeCredentials (Server-SDK)

Letzte Aktualisierung: 30. Oktober 2026

Erstellt für:

  • Developer

Das edgeCredentials-Objekt enthält die OAuth-Server-zu-Server-Anmeldedaten, die der SDK-Server für die Authentifizierung bei Adobe verwendet. Die SDK tauscht die Anmeldeinformationen gegen ein Zugriffstoken aus und verwendet dann das Token, um Ereignisse an die authentifizierte Edge Network-Server-API zu senden. Diese Eigenschaft ist erforderlich. Die Web-SDK verwendet diese Eigenschaft nicht, da ein Browser ein Client-Geheimnis nicht geheim halten kann.

Unter Authentifizierung erfahren Sie, wie Sie eine Berechtigung in der Adobe Developer Console erstellen und wie die SDK sie verwendet.

Eigenschaften properties

Eigenschaft
Typ
Erforderlich
Beschreibung
clientId
Zeichenfolge
Ja
Die Client-ID Ihrer OAuth Server-zu-Server-Anmeldedaten. Die SDK sendet sie auch im x-api-key-Header authentifizierter Anfragen.
clientSecret
Zeichenfolge
Ja
Das Client-Geheimnis Ihrer Berechtigung.
scopes
Zeichenfolgen-Array
Ja
Die Bereiche, die für Ihre Berechtigung in der Adobe Developer Console aufgeführt sind. Mindestens einen Bereich einschließen.
imsHost
Zeichenfolge
Nein
Der Adobe Identity Management Service (IMS)-Host, der Zugriffstoken ausgibt. Die Standardeinstellung ist ims-na1.adobelogin.com. Ändern Sie sie nur, wenn Adobe Sie dazu anweist.

Code-Beispiel

Legen Sie das edgeCredentials fest, wenn Sie configure aufrufen. Lesen Sie die Werte aus Umgebungsvariablen oder aus einem Geheimnis-Manager, anstatt sie im Quell-Code zu platzieren.

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

In diesem Beispiel enthält die Umgebungsvariable ADOBE_SCOPES eine kommagetrennte Liste von Bereichen, z. B. die Liste, die Adobe Developer Console für Ihre Berechtigung anzeigt.

Validierung und Fehler errors

  • Wenn edgeCredentials fehlt, wird configure mit einem Fehler zurückgewiesen, der besagt, dass die SDK edgeCredentials erfordert.
  • Wenn clientId, clientSecret oder scopes fehlt oder leer ist, lehnt configure mit einem Fehler ab, der die fehlende Eigenschaft benennt.
  • configure überprüft nicht, ob die Berechtigung gültig ist. Die SDK fordert ein Zugriffs-Token an, wenn sie zum ersten Mal ein authentifiziertes Ereignis sendet. Wenn Adobe die Berechtigung ablehnt, lehnt diese Methode sie mit einem Fehler ab, dessen Meldung Failed to acquire an IMS access token enthält.

SDK ersetzt clientSecret in seinen Debug-Protokollen und in der Konfiguration, die getLibraryInfo zurückgibt, durch [REDACTED].

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