Creazione integrazioni supporta tipi di autorizzazione standard, tra cui chiavi API, token di connessione, nome utente e password e OAuth 2.0. Tuttavia, in base alle esigenze e ai workflow dell’organizzazione, l’autorizzazione standard potrebbe non essere sufficiente. Ecco perché lo strumento di creazione integrazioni supporta anche un tipo di integrazione di sola autenticazione personalizzato che funziona con le soluzioni di autenticazione e autorizzazione della tua organizzazione.
Questo articolo include i seguenti argomenti:
- Informazioni sull’autorizzazione personalizzata
- Configurazione dell’autorizzazione personalizzata
- Creazione dell’integrazione dati
- Verifica dell’autorizzazione personalizzata
Informazioni sull’autorizzazione personalizzata
L’integrazione di sola autenticazione personalizzata richiede un token e la sua scadenza, che passa ai dati o all’integrazione principale per l’autorizzazione e quindi la richiesta dei dati.
Nel complesso, il flusso di autorizzazione personalizzato è il seguente:
- Richiesta di autorizzazione. L’integrazione di sola autenticazione configurata invia una richiesta al server, chiedendo l’autorizzazione a recuperare un token di accesso. Se il server autentica la richiesta (proveniente da agenti AI ), autorizza il recupero del token di accesso e, se disponibile, la data di scadenza.
- Gestione del token. Dopo che il server ha risposto con il token di accesso, l’integrazione memorizza due informazioni chiave: il parametro token stesso e il relativo parametro requiresIn, che determina per quanto tempo è valido il token.
- Passaggio del token all’integrazione dati. Questi due parametri (token e scadesIn) vengono passati al passaggio successivo, ovvero l’integrazione dei dati. Il token viene usato per autenticare le richieste successive effettuate dall’integrazione dei dati. Il token viene impostato e gestito internamente e non viene mai esposto ai dati della sessione o della conversazione.
- Richiesta di autorizzazione personalizzata per i dati. Con il token di accesso attivo, l’integrazione dei dati è ora autorizzata a recuperare i dati necessari, che vengono usati per arricchire la conversazione.
Il diagramma di flusso seguente illustra il flusso di autorizzazione personalizzato.
Configurazione dell’autorizzazione personalizzata
L’autorizzazione personalizzata viene configurata come parte del normale processo di creazione di un’integrazione in Creazione integrazioni.
Per configurare l’autorizzazione personalizzata nello strumento di creazione integrazioni
- Nel menu principale, fai clic su Integrazioni API .
- In alto a destra, fai clic su Aggiungi integrazione .
- Nella finestra Aggiungi integrazione :
- Nel campo Nome integrazione , assegna un nome descrittivo all’integrazione.
- (Facoltativo) Nel campo Descrizione , inserisci una descrizione dell’integrazione che ti aiuti a ricordare a cosa serve.
- Seleziona Imposta come integrazione “solo autenticazione” .
- Fai clic su Salva.
- Nella barra laterale sinistra, in Scenari , posiziona il cursore del mouse su Errore , seleziona il menu delle opzioni (
) e seleziona Elimina . Per l’autorizzazione personalizzata, sono necessari solo gli scenari Success. Non puoi eliminare gli scenari di fallback.
- Nella pagina Scenari di successo , crea due parametri di sessione (facendo clic sul pulsante + ) con i dettagli seguenti:
- token
- Chiave: token (deve essere scritto esattamente in questo modo)
- Query: Inserisci un valore che definisca il token. Ad esempio: data.access_token
- scadeIn
- Chiave: scadeIn (deve essere scritta esattamente in questo modo)
-
Query: Inserisci un valore che definisca la scadenza del token. Ad esempio: data.expires_in
La scadenza del token potrebbe non essere inclusa nella risposta dei dati. In tal caso, puoi codificare un valore (in secondi) a tua scelta. Ad esempio: 3600
Ti consigliamo vivamente di impostare una scadenza per i token. Se riscontri un errore durante il test, questo è il tempo necessario prima che venga emesso un nuovo token. Senza scadenza, il token è impostato a tempo indeterminato, il che significa che non potrai emetterne uno nuovo durante la risoluzione dei problemi.
- token
- Fai clic su Salva.
Creazione dell’integrazione dati
Quindi, crea l’integrazione dati che userà l’integrazione di sola autenticazione personalizzata creata nei passaggi precedenti. Procedi come faresti normalmente quando crei una nuova integrazione. Per informazioni, consulta Spiegazione di Integration Builder .
Per creare l’integrazione dati
- Nella barra laterale sinistra, in Ambienti , seleziona un ambiente (come Produzione).
- Nella scheda Autorizzazione , nel campo a discesa Tipo di autorizzazione , seleziona Personalizzata .
- Nel campo a discesa Integrazione autorizzazione API , seleziona l’integrazione di sola autenticazione personalizzata creata sopra.
- Seleziona la scheda Intestazioni e fai clic su Aggiungi intestazione .
- Compila i seguenti campi:
- Legenda: Autorizzazione
-
Valore: Portatore{{apiToken}} (deve essere scritto esattamente così)
- Fai clic su Salva.
Verifica dell’autorizzazione personalizzata
Dopo aver configurato l’integrazione di sola autenticazione personalizzata, ti consigliamo di testarla. Per informazioni, consulta Funzionalità di test .
StatusCode: null
Inoltre, durante il test dell’integrazione, potresti visualizzare il messaggio “statusCode: null”, come mostrato nell’immagine seguente:
Innanzitutto, verifica che l’integrazione di sola autenticazione personalizzata sia stata configurata correttamente in base ai passaggi precedenti .
Quindi, prendi nota del punto in cui si verifica l’errore. Se è nell’integrazione di autenticazione, è probabile che qualcosa non sia configurato correttamente oppure l’URL a cui stai effettuando la richiesta potrebbe essere errato. In questo caso, ti consigliamo di contattare i tecnici, in quanto potrebbero essere in grado di fornire maggiori informazioni sugli errori.
Se hai eseguito i passaggi precedenti e continui a riscontrare questo errore, attendi fino alla scadenza del token e riprova.
Se hai provato tutti questi passaggi per la risoluzione dei problemi e l’integrazione continua a non funzionare, contatta il tuo CSM per ulteriore assistenza.
Avvertenza sulla traduzione: questo articolo è stato tradotto usando un software di traduzione automatizzata per fornire una comprensione di base del contenuto. È stato fatto tutto il possibile per fornire una traduzione accurata, tuttavia Zendesk non garantisce l'accuratezza della traduzione.
Per qualsiasi dubbio sull'accuratezza delle informazioni contenute nell'articolo tradotto, fai riferimento alla versione inglese dell'articolo come versione ufficiale.