DocumentazioneExperience PlatformRaccolta dati

[Alpha]{class="badge informative"}

edgeCredentials (Server SDK)

Ultimo aggiornamento: 30 ottobre 2026

Creato per:

  • Developer

L’oggetto edgeCredentials contiene le credenziali server-to-server OAuth utilizzate dal server SDK per l’autenticazione con Adobe. SDK scambia le credenziali di un token di accesso, quindi utilizza il token per inviare eventi all’API server di Edge Network autenticata. Questa proprietà è obbligatoria. Il SDK Web non utilizza questa proprietà perché un browser non può mantenere privato un client segreto.

Consulta Autenticazione per scoprire come creare credenziali in Adobe Developer Console e come SDK la utilizza.

Proprietà properties

Proprietà
Tipo
Obbligatorio
Descrizione
clientId
Stringa
Sì
L’ID client delle credenziali server-to-server OAuth. SDK lo invia anche nell’intestazione x-api-key delle richieste autenticate.
clientSecret
Stringa
Sì
Segreto client delle credenziali.
scopes
Array di stringhe
Sì
Ambiti elencati per le credenziali in Adobe Developer Console. Includere almeno un ambito.
imsHost
Stringa
No
Host del servizio Adobe Identity Management (IMS) che emette i token di accesso. Impostazione predefinita: ims-na1.adobelogin.com. Modificala solo se Adobe ti indica di farlo.

Esempio di codice

Impostare l’oggetto edgeCredentials quando si chiama configure. Leggi i valori dalle variabili di ambiente o da un gestore dei segreti invece di inserirli nel codice sorgente.

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 questo esempio, la variabile di ambiente ADOBE_SCOPES contiene un elenco di ambiti separati da virgole, ad esempio l’elenco visualizzato da Adobe Developer Console per le credenziali.

Convalida ed errori errors

  • Se edgeCredentials manca, configure rifiuta con un errore che indica che SDK richiede edgeCredentials.
  • Se clientId, clientSecret o scopes è mancante o vuoto, configure rifiuta con un errore che assegna un nome alla proprietà mancante.
  • configure non controlla se le credenziali sono valide. SDK richiede un token di accesso la prima volta che invia un evento autenticato. Se Adobe rifiuta le credenziali, il metodo rifiuta con un errore il cui messaggio include Failed to acquire an IMS access token.

SDK sostituisce clientSecret con [REDACTED] nei registri di debug e nella configurazione restituita da getLibraryInfo.

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