Wie behebe ich OAuth-Authentifizierungs- und Autorisierungsfehler beim Verbinden einer Integration?
OAuth-Autorisierungsfehler treten auf, wenn ein externer Anbieter die Autorisierungsanfrage einer Anwendung nicht abschließen oder akzeptieren kann.
Diese Fehler können während der ersten Verbindung, beim Erneuern des Zugriffs oder beim Ausführen einer Operation auftreten, die zusätzliche Berechtigungen erfordert.
Häufige OAuth-bezogene Fehler
Zugriff verweigert
Die Autorisierungsanfrage wurde vom Anbieter abgelehnt, storniert oder durch die Richtlinien des Anbieters blockiert.
Ungültiger Scope
Die Anwendung hat eine Berechtigung angefordert, die ungültig, nicht unterstützt oder für das externe Konto nicht verfügbar ist.
Unzureichender Scope
Die vorhandene Autorisierung umfasst nicht die für die angeforderte Operation erforderliche Berechtigung.
Ungültiger Grant
Ein Autorisierungscode oder Token kann abgelaufen, widerrufen, ungültig oder für den Anbieter inakzeptabel sein.
Ungültiger Client
Der Anbieter konnte die Client-Anmeldeinformationen oder die Konfiguration der Anwendung nicht validieren.
Redirect-URI-Mismatch
Die Autorisierungs-Callback-Adresse stimmt nicht mit der Adresse überein, die beim externen Anbieter registriert ist.
Genehmigung des Administrators erforderlich
Der Anbieter verlangt, dass ein Administrator den angeforderten Zugriff autorisiert.
So beheben Sie OAuth-Fehler
Schritt 1: Identifizieren Sie den Fehler.
Notieren Sie die genaue Nachricht oder den Fehlercode, der während der Autorisierung angezeigt wird.
Schritt 2: Bestätigen Sie das richtige externe Konto.
Stellen Sie sicher, dass Sie sich bei dem gewünschten Konto oder der Organisation anmelden.
Schritt 3: Überprüfen Sie die angeforderten Berechtigungen.
Bestimmen Sie, ob das Konto berechtigt ist, den erforderlichen Zugriff zu gewähren.
Schritt 4: Überprüfen Sie die Einschränkungen des Administrators.
Einige Organisationen schränken den Zugriff auf Drittanbieteranwendungen ein oder erfordern die Zustimmung eines Administrators.
Schritt 5: Starten Sie den Autorisierungsfluss neu.
Wenn die Autorisierungssitzung abgelaufen oder unterbrochen wurde, beginnen Sie den Verbindungsprozess erneut.
Schritt 6: Überprüfen Sie die Einschränkungen des Browsers.
Stellen Sie sicher, dass die Authentifizierungsseite des Anbieters und der Redirect-Flow abgeschlossen werden können.
Schritt 7: Überprüfen Sie die Verfügbarkeit des externen Dienstes.
Ein Ausfall oder ein Authentifizierungsereignis kann die Autorisierung unterbrechen.
Schritt 8: Erneuern Sie die Autorisierung, wenn dies erforderlich ist.
Wenn vorhandene Anmeldeinformationen abgelaufen oder widerrufen wurden, verwenden Sie das unterstützte Verbindungsverfahren, um eine neue Autorisierung zu erstellen.
Schritt 9: Testen Sie die beabsichtigte Operation.
Nachdem die Autorisierung erfolgreich war, bestätigen Sie, dass die erforderliche Funktionalität funktioniert.
Kann ich selbst einen ungültigen Client- oder Redirect-URI-Fehler beheben?
Diese Fehler betreffen oft die Konfiguration auf Anwendungsebene und nicht die individuellen Benutzerberechtigungen.
Wenn die Verbindung von Polyosync verwaltet wird und das Problem weiterhin besteht, wenden Sie sich an den Support.
Wenn Sie eine benutzerdefinierte Integration konfigurieren, überprüfen Sie die registrierten Anwendungseinstellungen des Anbieters.
Sollte ich einen OAuth-Autorisierungscode mit dem Support teilen?
Nein.
Autorisierungscodes, Zugriffstoken, Aktualisierungstoken, Clientgeheimnisse und andere Anmeldeinformationen müssen vertraulich behandelt werden.
Welche Informationen sind nützlich für die Fehlersuche?
Geben Sie den Integrationsnamen, den Fehlercode, den ungefähren Zeitstempel und den Punkt an, an dem die Autorisierung fehlgeschlagen ist.
Empfohlener Ansatz
Identifizieren Sie, ob das Problem den Benutzerzustimmung, die Berechtigungen des Anbieters, die abgelaufene Autorisierung oder die Anwendungsconfiguration betrifft, bevor Sie Änderungen vornehmen.