Introduzione
Panoramica overview
Questa pagina descrive come eseguire l’autenticazione e iniziare a utilizzare il Adobe Experience Platform Destination SDK. Include istruzioni su come ottenere le credenziali di autenticazione Adobe I/O, il nome di una sandbox e l’autorizzazione di controllo dell’accesso per l’authoring della destinazione.
Terminologia terminology
Questa guida utilizza concetti specifici di Platform, ad esempio organizzazione e sandbox. Consulta il glossario di Experience Platform per le definizioni di questi termini. Per informazioni sui termini direttamente correlati a questa funzionalità, consultare il glossario di Destination SDK.
Ottenere le credenziali di autenticazione richieste obtain-authentication-credentials
Destination SDK utilizza il gateway Adobe I/O per l'autenticazione. Per effettuare chiamate API agli endpoint Destination SDK, devi fornire determinate intestazioni nelle chiamate API. Collabora con il team di Adobi Exchange per configurare l'autenticazione per te in Adobe Developer Console.
Per effettuare correttamente le chiamate agli endpoint API Destination SDK, segui l'esercitazione di autenticazione di Experience Platform. Avvia l'esercitazione dal passaggio "Generate an API key, organization ID, and client secret" (Genera una chiave API, un ID organizzazione e un segreto client). Il team di Adobe Exchange gestirà i passaggi precedenti per te. Il completamento del tutorial di autenticazione fornisce i valori per ciascuna delle intestazioni richieste nelle chiamate API Destination SDK, come mostrato di seguito:
x-api-key: {API_KEY}, noto anche come ID clientx-gw-ims-org-id: {ORG_ID}, noto anche come ID organizzazioneAuthorization: Bearer {ACCESS_TOKEN}. Il token di accesso ha una scadenza di 24 ore, espressa in millisecondi, pertanto dovrai aggiornarlo. Per aggiornare il token di accesso, ripeti i passaggi descritti nel tutorial sull’autenticazione.
Proprietà della destinazione e sandbox destination-ownership
Tutte le risorse in Experience Platform sono isolate in specifiche sandbox virtuali. Le richieste di Destination SDK richiedono intestazioni che specificano il nome della sandbox in cui si svolge l’operazione:
x-sandbox-name: {SANDBOX_NAME}
Il team di Adobi Exchange fornisce il nome della sandbox, che è necessario utilizzare nelle chiamate agli endpoint API Destination SDK.
Controllo degli accessi basato sul ruolo (RBAC) rbac
Per utilizzare gli endpoint API Destination SDK descritti nella documentazione di riferimento, è necessario disporre dell'autorizzazione per il controllo degli accessi Authoring delle destinazioni. Collabora con il team di Adobi Exchange per ottenere questa autorizzazione in Adobe Admin Console.
Per ulteriori informazioni, leggere i seguenti Experienci Platform di documenti di controllo dell'accesso:
Considerazioni aggiuntive additional-considerations
- Per le destinazioni prodotte/pubbliche, tutte le modifiche apportate alle configurazioni di destinazione, sia che si crei o modifichi una configurazione di destinazione, devono essere riviste e approvate da Adobe. Le modifiche vengono applicate alle destinazioni solo al termine della revisione. Questo non si applica alle destinazioni private che sono disponibili solo per te.
- Solo gli utenti che appartengono alla stessa organizzazione e hanno accesso alla sandbox possono modificare la configurazione di destinazione.
Passaggi successivi next-steps
Seguendo i passaggi descritti in questo articolo, hai ottenuto le credenziali di autenticazione per Adobe I/O, un nome di sandbox e l’autorizzazione di controllo dell’accesso per l’authoring della destinazione. Successivamente, puoi impostare una destinazione utilizzando Destination SDK.
-
Leggi le seguenti guide di configurazione, a seconda del tipo di destinazione:
-
Per tutte le operazioni, consulta la documentazione API di authoring delle destinazioni.
-
Utilizza la raccolta Postman API per l'authoring delle destinazioni per configurare la tua destinazione utilizzando gli endpoint API di Destination SDK. Per iniziare a utilizzare Postman, consulta i passaggi per importare ambienti e raccolte e una guida video per la creazione dell'ambiente Postman.