Come posso risolvere gli errori di autenticazione e autorizzazione OAuth quando collego un'integrazione?
Gli errori di autorizzazione OAuth si verificano quando un fornitore esterno non può completare o accettare la richiesta di autorizzazione di un'applicazione.
Questi errori possono verificarsi durante la connessione iniziale, durante il rinnovo dell'accesso o durante l'esecuzione di un'operazione che richiede autorizzazioni aggiuntive.
Errori comuni relativi a OAuth
Accesso negato
La richiesta di autorizzazione è stata rifiutata, annullata o bloccata dalle politiche del fornitore.
Ambito non valido
L'applicazione ha richiesto un'autorizzazione che è non valida, non supportata o non disponibile per l'account esterno.
Ambito insufficiente
L'autorizzazione esistente non include l'autorizzazione richiesta per l'operazione richiesta.
Grant non valido
Un codice di autorizzazione o un token potrebbe essere scaduto, revocato, non valido o inaccettabile per il fornitore.
Client non valido
Il fornitore non è riuscito a convalidare le credenziali del client dell'applicazione o la configurazione.
Mismatch URI di reindirizzamento
L'indirizzo di callback di autorizzazione non corrisponde all'indirizzo registrato con il fornitore esterno.
Approvazione dell'amministratore richiesta
Il fornitore richiede che un amministratore autorizzi l'accesso richiesto.
Come risolvere gli errori OAuth
Passo 1: Identificare l'errore.
Annota il messaggio esatto o il codice di errore visualizzato durante l'autorizzazione.
Passo 2: Confermare il corretto account esterno.
Verifica di essere connesso all'account o all'organizzazione desiderata.
Passo 3: Rivedere le autorizzazioni richieste.
Determina se l'account è autorizzato a concedere l'accesso richiesto.
Passo 4: Controllare le restrizioni dell'amministratore.
Alcune organizzazioni limitano l'accesso alle applicazioni di terze parti o richiedono il consenso amministrativo.
Passo 5: Riavviare il flusso di autorizzazione.
Se la sessione di autorizzazione è scaduta o è stata interrotta, inizia nuovamente il processo di connessione.
Passo 6: Controllare le restrizioni del browser.
Assicurati che la pagina di autenticazione del fornitore e il flusso di reindirizzamento possano completarsi.
Passo 7: Verificare la disponibilità del servizio esterno.
Un'interruzione o un incidente di autenticazione possono interrompere l'autorizzazione.
Passo 8: Reautorizzare quando appropriato.
Se le credenziali esistenti sono scadute o sono state revocate, utilizza la procedura di connessione supportata per stabilire una nuova autorizzazione.
Passo 9: Testare l'operazione desiderata.
Dopo che l'autorizzazione ha avuto successo, conferma che la funzionalità richiesta funzioni.
Posso risolvere da solo un errore di client non valido o di URI di reindirizzamento?
Questi errori riguardano spesso la configurazione a livello di applicazione piuttosto che le autorizzazioni individuali dell'utente.
Se la connessione è gestita da Polyosync e il problema persiste, contatta il supporto.
Se stai configurando un'integrazione personalizzata, verifica le impostazioni dell'applicazione registrata del fornitore.
Dovrei condividere un codice di autorizzazione OAuth con il supporto?
No.
I codici di autorizzazione, i token di accesso, i token di aggiornamento, i segreti del client e altre credenziali devono rimanere riservati.
Quali informazioni sono utili per la risoluzione dei problemi?
Fornisci il nome dell'integrazione, il codice di errore, il timestamp approssimativo e il punto in cui l'autorizzazione è fallita.
Approccio consigliato
Identifica se il problema riguarda il consenso dell'utente, le autorizzazioni del fornitore, l'autorizzazione scaduta o la configurazione dell'applicazione prima di tentare modifiche.