Test und Problembehebung - Google, GitHub und Facebook
Die Integration testen
Öffne den Anmeldebildschirm in einem privaten Fenster und prüfe, dass der Button jedes aktivierten Anbieters sichtbar ist. Melde dich damit auf einem Testkonto an, bestätige, dass du angemeldet zum Panel zurückkehrst, und - falls das Konto die Zwei-Faktor-Verifizierung aktiviert hat - dass das Panel nach dem zweiten Faktor gefragt hat. Teste auch die Registrierung: Ein neues Konto, das über einen adressbestätigenden Anbieter angelegt wird, sollte sofort Zugang zum Panel bekommen, ohne Bildschirm zur E-Mail-Verifizierung.
Typische Probleme
Der Button eines Anbieters erscheint nicht auf dem Anmeldebildschirm
Ein Anbieter ist nur sichtbar, wenn sein Schalter aktiv ist und beide OAuth-Schlüssel in den Plattformeinstellungen gesetzt sind. Ein fehlender Schlüssel und ein ausgeschalteter Anbieter ergeben genau dasselbe Bild - kein Button, keine Fehlermeldung, denn aus Sicht eines Besuchers existiert der Anbieter schlicht nicht. Der direkte Aufruf seiner Adresse endet mit 404, nicht mit 403.
DockRay fragt nach einem Passwort, nachdem man sich mit Facebook anmelden wollte
Das ist beabsichtigtes Verhalten, kein Fehler. Facebook garantiert keine bestätigte E-Mail-Adresse, deshalb hängt DockRay eine Facebook-Anmeldung nie allein über die Adresse an ein bestehendes Konto an - sonst genügte es, dort ein Profil mit einer fremden Adresse anzulegen, um in ein fremdes Konto zu gelangen. Wer ein bestehendes Konto unter dieser Adresse besitzt, muss sich mit dem Passwort anmelden (oder über Google oder GitHub, falls dort verknüpft) und erst dann bewusst aus dem Panel die Facebook-Anmeldung verbinden, sofern diese Option verfügbar ist.
Die Anmeldung schlägt mit einem Fehler „fehlende E-Mail-Adresse" fehl
Das passiert, wenn das Profil beim Anbieter keine sichtbare Adresse hat - etwa GitHub mit einer in den Datenschutzeinstellungen verborgenen Adresse, oder Facebook ohne bestätigte Adresse im Profil. DockRay legt nie ein Konto ohne E-Mail-Adresse an, denn ein solches Konto hätte keinen Weg zu einem Passwort-Reset oder zu Benachrichtigungen. Die Lösung liegt beim Anbieter: dort in den Kontoeinstellungen eine Adresse sichtbar machen oder hinzufügen.
Die Konsole des Anbieters meldet eine nicht übereinstimmende Redirect-URI
Die in der Konsole des Anbieters eingetragene Redirect URI muss genau der entsprechen, die das DockRay-Panel in den Plattformeinstellungen anzeigt. Die häufigste Ursache einer Abweichung ist ein Tippfehler, ein fehlendes HTTPS-Schema oder eine Adresse, die für eine andere Umgebung eingetragen wurde als die, von der aus du die Anmeldung tatsächlich testest.
Ein Konto meldet sich trotz korrekter Authentifizierung beim Anbieter nicht an
Der Anbieter beweist nur die Identität - über den Zugang entscheidet der Kontostatus in DockRay. Ein deaktivierter Nutzer kann sich auf keinem Weg anmelden, auch nicht über einen Anbieter, der korrekt bestätigt hat, wer er ist.
Es funktioniert weiterhin nicht
Arbeite die Checkliste zur Fehlerbehebung durch, und wenn das nicht hilft, schreib uns. Nenne den Projektnamen, die Version der Integration und ungefähr die Uhrzeit des Tests: das verkürzt den Weg zur Antwort.