Configurazione e dettagli tecnici di OAuth2.0

grant\_type=authorization\_code&code=AUTHORIZATION\_CODE&redirect\_uri=REDIRECT\_URI&client\_id=CLIENT\_ID&client\_secret=CLIENT\_SECRET```.


### 5. Risposta del token di accesso:


Se il codice di autorizzazione è valido, il server di autorizzazione risponde con un token di accesso e, facoltativamente, un token di aggiornamento. Il token di accesso viene utilizzato dal client per autenticarsi quando effettua richieste all'API protetta per conto dell'utente.


Esempio di risposta al token:


`{"access_token": "ACCESS_TOKEN", "token_type": "Bearer", "expires_in": 3600, "refresh_token": "REFRESH_TOKEN", "scope": "SCOPE"}`


:::(Warning) (Services Not Using `expires_in`)

:::


### 6. Accesso al server delle risorse:


Tulip può ora utilizzare il token di accesso ottenuto per effettuare richieste autorizzate al Resource Server (API) per conto dell'utente. Il token di accesso è solitamente incluso nell'intestazione Authorization della richiesta HTTP.


Esempio di richiesta API`: GET /api/resourceAuthorization: Portatore ACCESS_TOKEN`


## Gestione della scadenza dei token con i token di aggiornamento


I server di autorizzazione di solito impostano date di scadenza per i token per regolare l'accesso, con finestre di scadenza variabili a seconda del sistema interfacciato. Tuttavia, i token di breve durata rappresentano una sfida, poiché l'autenticazione costante dell'utente disturba l'esperienza dell'utente nelle applicazioni Tulip.


Per risolvere questo problema, OAuth supporta i token di aggiornamento. Pur essendo facoltativi, sono altamente raccomandati in quanto semplificano l'esperienza dell'utente consentendo a Tulip di aggiornare i token senza problemi, senza richiedere l'intervento manuale degli operatori.


### Come Tulip gestisce l'aggiornamento dei token


Quando Tulip rileva che un token di accesso è scaduto, tenta automaticamente di utilizzare il token di aggiornamento associato per ottenere un nuovo token. L'obiettivo primario è ridurre al minimo la riautenticazione degli utenti. Le fasi seguenti illustrano la logica eseguita da Tulip:


![Token Refresh Flow](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/image%28399%29.png)


1. **Rilevamento della scadenza:**
2. Tulip identifica un token scaduto in base all'attributo `expires_in` ricevuto nel [passaggio 5](/r230/docs/oauth20-configuration-and-technical-details#5-access-token-response) del flusso di autenticazione.


:::(Warning) (Services Not Using `expires_in`)

:::


1. **Tentativo di flusso di token:**
2. Tulip avvia il flusso di token utilizzando il tipo di sovvenzione `refresh_token`, sostituendo il tipo di sovvenzione utilizzato nel flusso di autenticazione iniziale.
3. **Convalida del token:**
4. Se si ottiene un nuovo token, Tulip lo memorizza e procede all'esecuzione della funzione connettore richiesta dall'utente.


	* In caso di successo, i dati vengono forniti al runtime dell'applicazione Tulip.
	* Se il nuovo token fallisce con un errore di OAuth, Tulip ritenta il processo fino a 5 volte, tornando ogni volta al punto 1.
	* Se il nuovo token fallisce con qualsiasi altro errore, viene visualizzato un errore nel runtime del lettore.
5. **Gestione dell'assenza di token:**
6. Se non viene fornito un nuovo token, Tulip chiede all'utente del lettore di sottoporsi all'autenticazione, avviando l'intero processo di autenticazione.
7. Al termine, viene eseguita la funzione connettore e vengono restituiti i dati.


Implementando i token di aggiornamento, Tulip garantisce un'esperienza utente più fluida gestendo in modo intelligente la scadenza e il rinnovo dei token, riducendo al minimo le interruzioni del flusso di lavoro.


## Ulteriori letture


* [Introduzione agli host del connettore Tulip](/r230/docs/introduction-to-tulip-connector-hosts-1)
* [Snapshotting del connettore](/r230/docs/connector-snapshotting)
* [OAuth2.0 spiegato](/r230/docs/oauth20-explained)