Zum Hauptinhalt springen

Soziale Anmeldung mit Facebook einrichten

Der offizielle Logto Connector für die Facebook-Sozialanmeldung.

tipp:

In diesem Leitfaden gehen wir davon aus, dass du grundlegende Kenntnisse über Logto Connectors hast. Falls nicht, schaue dir den Leitfaden Connectors konfigurieren an, um loszulegen.

Erste Schritte

Der Facebook-Connector bietet eine prägnante Möglichkeit für deine Anwendung, das OAuth 2.0-Authentifizierungssystem von Facebook zu nutzen.

Ein Facebook-Entwicklerkonto registrieren

Registriere dich als Facebook-Entwickler, falls du noch keines hast.

Eine Facebook-App einrichten

  1. Besuche die Seite Apps.
  2. Klicke auf deine bestehende App oder erstelle eine neue, falls nötig.
    • Der ausgewählte App-Typ liegt bei dir, sollte aber das Produkt Facebook Login haben.
  3. Auf der App-Dashboard-Seite scrolle zum Abschnitt "Produkt hinzufügen" und klicke auf die Schaltfläche "Einrichten" auf der Karte "Facebook Login".
  4. Überspringe die Facebook Login Schnellstartseite und klicke auf die Seitenleiste -> "Produkte" -> "Facebook Login" -> "Einstellungen".
  5. Auf der Seite Facebook Login Einstellungen fülle ${your_logto_origin}/callback/${connector_id} in das Feld "Gültige OAuth-Weiterleitungs-URIs" ein. Die connector_id findest du in der oberen Leiste der Logto Admin Console Connector-Detailseite. Zum Beispiel:
    • https://logto.dev/callback/${connector_id} für die Produktion
    • https://localhost:3001/callback/${connector_id} für Tests in der lokalen Umgebung
  6. Klicke auf die Schaltfläche "Änderungen speichern" in der unteren rechten Ecke.

Den Connector-JSON zusammenstellen

  1. Auf der Facebook-App-Dashboard-Seite klicke auf die Seitenleiste -> "Einstellungen" -> "Grundlegend".
  2. Du siehst die "App-ID" und das "App-Geheimnis" auf dem Panel.
  3. Klicke auf die Schaltfläche "Anzeigen" neben dem Eingabefeld für das App-Geheimnis, um dessen Inhalt zu kopieren.
  4. Fülle die Logto-Connector-Einstellungen aus:
    • Fülle das Feld clientId mit dem String aus App-ID.
    • Fülle das Feld clientSecret mit dem String aus App-Geheimnis.
    • Fülle das Feld scope mit einer durch Kommas oder Leerzeichen getrennten Liste von Berechtigungen als String aus. Wenn du keinen Scope angibst, ist der Standard-Scope email,public_profile.

Anmeldung mit Facebook-Testbenutzern testen

Du kannst die Konten der Test-, Entwickler- und Admin-Benutzer verwenden, um die Anmeldung mit der zugehörigen App sowohl im Entwicklungs- als auch im Live-App-Modus zu testen.

Du kannst die App auch direkt live schalten, sodass sich jeder Facebook-Nutzer mit der App anmelden kann.

  • Auf der App-Dashboard-Seite klicke auf die Seitenleiste -> "Rollen" -> "Testbenutzer".
  • Klicke auf die Schaltfläche "Testbenutzer erstellen", um einen Testbenutzer zu erstellen.
  • Klicke auf die Schaltfläche "Optionen" des bestehenden Testbenutzers, und du siehst weitere Operationen, z. B. "Name und Passwort ändern".

Facebook-Anmeldeeinstellungen veröffentlichen

Normalerweise können sich nur die Test-, Admin- und Entwickler-Benutzer mit der zugehörigen App im Entwicklungsmodus anmelden.

Um normalen Facebook-Nutzern die Anmeldung mit der App in der Produktionsumgebung zu ermöglichen, musst du möglicherweise deine Facebook-App in den Live-Modus schalten, abhängig vom App-Typ. Zum Beispiel hat die reine Business-Typ-App keinen "Live"-Schalter, aber es wird deine Nutzung nicht blockieren.

  1. Auf der Facebook-App-Dashboard-Seite klicke auf die Seitenleiste -> "Einstellungen" -> "Grundlegend".
  2. Fülle die Felder "Datenschutzrichtlinien-URL" und "Benutzerdatenlöschung" auf dem Panel aus, falls erforderlich.
  3. Klicke auf die Schaltfläche "Änderungen speichern" in der unteren rechten Ecke.
  4. Klicke auf die "Live"-Schaltfläche in der oberen Leiste der App.

Konfigurationstypen

NameTyp
clientIdstring
clientSecretstring
scopestring

Referenzen