Einrichtung und Konfiguration - Google, GitHub und Facebook

Was diese Integration macht

Die soziale Anmeldung erlaubt es, sich bei DockRay über Google, GitHub oder Facebook statt mit einem Passwort anzumelden - kostenlos, für jedes Konto. Der Button eines Anbieters erscheint auf dem Anmelde- und dem Registrierungsbildschirm nur dann, wenn dieser Anbieter im Panel einen vollständigen Satz OAuth-Schlüssel hat und eingeschaltet ist. Ein deaktivierter oder nicht konfigurierter Anbieter antwortet mit 404, nicht mit 403 - eine Adresse, die niemand angekündigt hat, muss nicht verraten, dass sie nach Eintragen der Schlüssel funktionieren würde.

Wer die Anbieter konfiguriert

OAuth-Schlüssel trägt ausschließlich der Superadmin von Dock in den Plattformeinstellungen ein - eine globale Einstellung, gemeinsam für alle Konten, genau wie die Stripe-Schlüssel. Abonnenten sehen diesen Bildschirm nie und können keine eigene OAuth-Anwendung anschließen.

Was du beim Anbieter vorbereitest

Lege für jeden Anbieter, den du aktivieren möchtest, in dessen Entwicklerkonsole (Google Cloud Console, GitHub-Entwicklereinstellungen, Meta for Developers) eine OAuth-Anwendung an und erzeuge ein Paar Client-ID / Client-Secret. Das DockRay-Panel berechnet und zeigt für jeden Anbieter eine kopierfertige Rückkehradresse - füge sie exakt in das Feld Redirect URI in der Konsole des Anbieters ein. Eine Abweichung zwischen dieser Adresse und dem, was die Anwendung tatsächlich verarbeitet, ist der häufigste Grund, warum die Anmeldung über einen bestimmten Anbieter nicht funktioniert.

Im Panel einschalten

Füge in den Plattformeinstellungen Client-ID und Client-Secret des Anbieters ein und schalte ihn ein. Das Secret wird verschlüsselt gespeichert und kehrt nach dem Speichern nie ins Formular zurück - ein leeres Feld bei der nächsten Bearbeitung bedeutet „aktuelles Secret behalten", nicht „löschen". Ein Anbieter wird auf dem Anmeldebildschirm erst sichtbar, wenn sein Schalter aktiv und beide Schlüssel gesetzt sind - eines ohne das andere genügt nicht.

Anmelde- und Rückkehradressen

Für jeden Anbieter stellt DockRay ein vorhersehbares Paar von Routen bereit:

/auth/{provider}           Weiterleitung zum Anbieter
/auth/{provider}/callback  Rückkehr und Abschluss der Anmeldung

Genau diese callback-Adresse, berechnet für die aktuelle Umgebung (Produktion oder Staging), zeigt das Panel kopierfertig für die Konsole des Anbieters an - sie muss weder von Hand zusammengesetzt noch das Schema erraten werden.

Der erste Test

Öffne den Anmeldebildschirm in einem privaten Fenster und prüfe, dass der Button des aktivierten Anbieters sichtbar ist. Melde dich damit auf einem Testkonto an - du solltest angemeldet zum Panel zurückkehren, und falls das Konto eine Zwei-Faktor-Prüfung verlangt, solltest du genau wie bei der Passwortanmeldung danach gefragt werden.