Configurare le specifiche di autenticazione per le origini self-service (Batch SDK)
Le specifiche di autenticazione definiscono il modo in cui gli utenti di Adobe Experience Platform possono connettersi all’origine.
L'array authSpec
contiene informazioni sui parametri di autenticazione necessari per connettere un'origine ad Experience Platform. Qualsiasi origine può supportare più tipi diversi di autenticazione.
Specifiche di autenticazione
Origini self-service (Batch SDK) supporta i codici di aggiornamento OAuth 2 e l’autenticazione di base. Consulta le tabelle seguenti per indicazioni sull’utilizzo di un codice di aggiornamento OAuth 2 e di un’autenticazione di base
Codice di aggiornamento OAuth 2
Un codice di aggiornamento OAuth 2 consente l’accesso sicuro a un’applicazione generando un token di accesso temporaneo e un token di aggiornamento. Il token di accesso ti consente di accedere in modo sicuro alle risorse senza dover fornire altre credenziali, mentre il token di aggiornamento ti consente di generare un nuovo token di accesso, una volta scaduto il token di accesso.
code language-json |
---|
|
table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 6-row-3 7-row-3 8-row-3 9-row-3 10-row-3 11-row-3 12-row-3 13-row-3 14-row-3 15-row-3 16-row-3 17-row-3 layout-auto | ||
---|---|---|
Proprietà | Descrizione | Esempio |
authSpec.name |
Visualizza il nome del tipo di autenticazione supportato. | oAuth2-refresh-code |
authSpec.type |
Definisce il tipo di autenticazione supportato dall'origine. | oAuth2-refresh-code |
authSpec.spec |
Contiene informazioni sullo schema, il tipo di dati e le proprietà dell’autenticazione. | |
authSpec.spec.$schema |
Definisce lo schema utilizzato per l’autenticazione. | http://json-schema.org/draft-07/schema# |
authSpec.spec.type |
Definisce il tipo di dati dello schema. | object |
authSpec.spec.properties |
Contiene informazioni sulle credenziali utilizzate per l’autenticazione. | |
authSpec.spec.properties.description |
Visualizza una breve descrizione delle credenziali. | |
authSpec.spec.properties.type |
Definisce il tipo di dati delle credenziali. | string |
authSpec.spec.properties.clientId |
L’ID client associato all’applicazione. L’ID client viene utilizzato insieme al segreto client per recuperare il token di accesso. | |
authSpec.spec.properties.clientSecret |
Il segreto client associato all’applicazione. Il segreto client viene utilizzato insieme all’ID client per recuperare il token di accesso. | |
authSpec.spec.properties.accessToken |
Il token di accesso autorizza l’accesso sicuro all’applicazione. | |
authSpec.spec.properties.refreshToken |
Il token di aggiornamento viene utilizzato per generare un nuovo token di accesso, alla scadenza del token. | |
authSpec.spec.properties.expirationDate |
Definisce la data di scadenza del token di accesso. | |
authSpec.spec.properties.refreshTokenUrl |
URL utilizzato per recuperare il token di aggiornamento. | |
authSpec.spec.properties.accessTokenUrl |
URL utilizzato per recuperare il token di aggiornamento. | |
authSpec.spec.properties.requestParameterOverride |
Consente di specificare i parametri delle credenziali da ignorare durante l'autenticazione. | |
authSpec.spec.required |
Visualizza le credenziali necessarie per l'autenticazione. | accessToken |
Autenticazione di base
L’autenticazione di base è un tipo di autenticazione che ti consente di accedere all’applicazione utilizzando una combinazione del nome utente dell’account e della password dell’account.
code language-json |
---|
|
table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 6-row-3 7-row-3 8-row-3 9-row-3 10-row-3 layout-auto | ||
---|---|---|
Proprietà | Descrizione | Esempio |
authSpec.name |
Visualizza il nome del tipo di autenticazione supportato. | Basic Authentication |
authSpec.type |
Definisce il tipo di autenticazione supportato dall'origine. | BasicAuthentication |
authSpec.spec |
Contiene informazioni sullo schema, il tipo di dati e le proprietà dell’autenticazione. | |
authSpec.spec.$schema |
Definisce lo schema utilizzato per l’autenticazione. | http://json-schema.org/draft-07/schema# |
authSpec.spec.type |
Definisce il tipo di dati dello schema. | object |
authSpec.spec.description |
Visualizza ulteriori informazioni specifiche per il tipo di autenticazione. | |
authSpec.spec.properties |
Contiene informazioni sulle credenziali utilizzate per l’autenticazione. | |
authSpec.spec.properties.username |
Il nome utente dell’account associato all’applicazione. | |
authSpec.spec.properties.password |
La password dell'account associata all'applicazione. | |
authSpec.spec.required |
Specifica i campi obbligatori come valori obbligatori da immettere in Experience Platform. | username |
Autenticazione chiave API api-key-authentication
L’autenticazione tramite chiave API è un metodo sicuro per accedere alle API, fornendo una chiave API e altri parametri di autenticazione rilevanti nelle richieste. A seconda delle informazioni API specifiche, puoi inviare la chiave API come parte dell’intestazione della richiesta, dei parametri della query o del corpo.
I seguenti parametri sono generalmente necessari quando si utilizza l’autenticazione con chiave API:
host
authKey1
authKey2
authKeyN
code language-json |
---|
|
Comportamento di autenticazione
È possibile utilizzare il parametro restAttributes
per definire la modalità di inclusione della chiave API nella richiesta. Ad esempio, nell'esempio seguente, l'attributo headerParamName
indica che X-Auth-Key1
deve essere inviato come intestazione.
"restAttributes": {
"headerParamName": "X-Auth-Key1"
}
Ogni chiave di autenticazione (ad esempio authKey1
, authKey2
e così via) può essere associata a restAttributes
per determinare la modalità di invio come richieste.
Se authKey1
ha "headerParamName": "X-Auth-Key1"
. L'intestazione della richiesta deve quindi includere X-Auth-Key:{YOUR_AUTH_KEY1}
. Inoltre, il nome della chiave e headerParamName
non devono necessariamente essere uguali. Ad esempio:
authKey1
può avereheaderParamName: X-Custom-Auth-Key
. Ciò significa che l'intestazione della richiesta utilizzeràX-Custom-Auth-Key
invece diauthKey1
.authKey1
può invece avereheaderParamName: authKey1
. Ciò significa che il nome dell’intestazione della richiesta rimane invariato.
Esempio di formato API
GET /data?X-Auth-Key1={YOUR_AUTH_KEY1}&X-Auth-Key2={YOUR_AUTH_KEY2}
Esempio di specifica di autenticazione
Di seguito è riportato un esempio di specifica di autenticazione completata che utilizza un'origine MailChimp Members.
code language-json |
---|
|
Passaggi successivi
Con le specifiche di autenticazione compilate, puoi procedere alla configurazione delle specifiche di origine per l’origine che desideri integrare in Experience Platform. Per ulteriori informazioni, vedere il documento sulla configurazione delle specifiche di origine.