Configura l'autenticazione necessaria per testare l'API Knowledge Base o collegare un'Applicazione.
Le richieste API Knowledge Base utilizzano l'autenticazione bearer token. Utilizza un token utente autenticato per test a breve termine oppure configura un Account tecnico per un'Applicazione o integrazione.
Prima di iniziare
Assicurati che:
- La tua organizzazione ha accesso a Knowledge Base.
- Hai accesso alle risorse API necessarie per il tuo flusso di lavoro.
- Tu possa accedere a Adobe Developer Console se stai configurando un'integrazione applicazione.
L'accesso API non sostituisce le autorizzazioni Knowledge Base. L'identità autenticata deve avere accesso alle raccolte, documenti e operazioni richiesti dall'Applicazione.
Scegli un metodo di autenticazione
Utilizza il metodo di autenticazione che corrisponde alla tua fase di sviluppo.
| Caso d'uso | Autenticazione |
|---|---|
| Richieste di test o esplorazione dell'API | Bearer token utente autenticato |
| Creazione di un'Applicazione o integrazione | Account tecnico |
Bearer token utente
Un bearer token utente autenticato è utile per testare le richieste API, incluse le richieste effettuate tramite il riferimento API.
Il token rappresenta l'utente connesso ed è valido per 24 ore. Le richieste effettuate con il token hanno lo stesso accesso Knowledge Base disponibile a quell'utente.
Dopo aver ottenuto un bearer token utente, includilo con ogni richiesta:
Authorization: Bearer <access-token>
Puoi anche utilizzare il token con il riferimento API interattivo Knowledge Base per testare gli endpoint disponibili.
Inizia con un'operazione che recupera una risorsa a cui hai già accesso. Una risposta con esito positivo conferma che il token è accettato e l'identità autenticata può accedere a quella risorsa.
Non creare un'integrazione applicazione persistente basata su un bearer token utente.
Account tecnico
Usa un account tecnico per le applicazioni e le integrazioni che devono eseguire l'autenticazione senza una sessione utente interattiva.
Gli account tecnici vengono configurati tramite Adobe Developer Console. Segui la procedura di configurazione dell'account tecnico per creare le credenziali richieste dalla tua applicazione.
Dopo aver creato l'account tecnico, torna a questa pagina per convalidare l'accesso all'API Knowledge Base.
Informazioni sulle autorizzazioni API
L'autenticazione stabilisce l'identità che effettua la richiesta API. L’autorizzazione determina cosa può fare tale identità.
Ad esempio, un'identità autenticata potrebbe essere in grado di recuperare una raccolta ma non un'altra, oppure potrebbe non avere accesso a una risorsa di livello amministratore.
Se l'autenticazione riesce ma un'operazione viene rifiutata, verifica che l'identità autenticata abbia l'autorizzazione per accedere alla risorsa richiesta prima di considerare la risposta come un errore di autenticazione.
Convalida l'accesso API
Dopo aver configurato l'autenticazione:
- Ottieni un token di accesso.
- Invia una richiesta a una risorsa a cui l'identità autenticata può accedere.
- Conferma che l'API restituisce la risposta prevista.
- Continua con il flusso di lavoro di introduzione all'API.
