Funktionalitäten des Facebook-Login

• Registrierung im PEIQ PORTAL über einen bestehenden Facebook-Account

• Senken der Hemmschwelle, sich anzumelden, weil keine Daten eingegeben werden müssen

Inhaltsverzeichnis

Allgemeine Beschreibung

Mit OAuth beantragt eine Anwendung (in diesem Fall das PEIQ PORTAL) nach Authentifizierung des Benutzers bzw. der Benutzerin dessen bzw. deren Daten beim Server (in diesem Fall Facebook) und verarbeitet diese. Nach erfolgter Autorisierung seitens des bzw. der Benutzer:in in Facebook verwendet das PEIQ PORTAL Name und E-Mail-Adresse von Facebook, um ein lokales (= in der Datenbank des Online-PORTALs gespeichertes) Benutzer-Konto zu erstellen. Alle von Facebook übertragenen Daten können in der PEIQ PORTAL-Anwendung bearbeitet werden: Das Facebook-Konto und der PEIQ PORTAL-Account sind miteinander über eine ID verknüpft, sodass sich der oder die Benutzer:in zukünftig bequem mit Facebook im PEIQ PORTAL anmelden kann.

Registrierung über Facebook

Open

Registrierungsworkflow über Facebook

Wünscht ein:e Kund:in diese Funktion, wird auf der Registrieren-Seite von PEIQ PORTAL der Button "Mit Facebook anmelden" eingebaut. Beim erstmaligen Anmelden über Facebook muss der oder die Benutzer:in in Facebook das Online-PORTAL zunächst autorisieren, damit letzteres die Facebook-Daten nutzen darf, um in der Datenbank des Online-PORTALs eine:n lokale:n Benutzer:in mit Profilseite anzulegen. Hierfür werden folgende Benutzerdaten bei Facebook abgefragt und im Online-PORTAL verwendet:

• Name

• Vorname

• E-Mail-Adresse

Die übertragenen Benutzerdaten (außer der ID) können in PEIQ PORTAL nachträglich geändert werden. In den Account-Einstellungen erscheint unter “Verknüpfte Accounts” die Facebook-App. Diese kann durch den oder die Benutzer:in wieder entfernt werden.

Login über Facebook

Open

Login-Workflow über Facebook

Nach erfolgreicher Registrierung kann sich der bzw. die Benutzer:in über den Button "Mit Facebook anmelden" einloggen. Klickt der bzw. die Benutzer:in auf den Button und ist noch nicht auf Facebook angemeldet, wird diese:r zuerst auf die Facebook-Login-Seite weitergeleitet, um dort Benutzername und Passwort einzugeben.

Der bzw. die Benutzer:in kann zusätzlich (über die Passwort vergessen-Funktion) ein weiteres Passwort im PEIQ PORTAL vergeben. Damit steht ihm bzw. ihr ebenfalls der PEIQ PORTAL-Login zur Verfügung.

Verknüpfungen zwischen den Accounts

• Wenn ein:e Benutzer:in seine bzw. ihre Angaben (Name, E-Mail-Adresse etc.) in Facebook anpasst, werden diese nicht auf das PEIQ PORTAL übertragen. PEIQ PORTAL nutzt die Daten des Facebook-Kontos nur zum erstmaligen Anlegen des Profils bei der Registrierung. Angaben für das PEIQ PORTAL können in den Account-Einstellungen angepasst werden.

• Umgekehrt gelten auch Anpassungen, die in den Account-Einstellungen bzgl. (Vor-)Name und E-Mail-Adresse vorgenommen werden, nur für das PEIQ PORTAL. Die Angaben in Facebook sind davon unabhängig. Diese Anpassungen wirken sich allerdings nicht auf den Login-Prozess aus: Benutzer:innen können sich nach wie vor über die Funktion “Mit Facebook anmelden” im Online-PORTAL anmelden.

• Eine Verknüpfung zwischen PEIQ-Konto und Facebook-Konto ist auch nachträglich noch möglich, wenn sich ein:e Benutzer:in bereits über das PEIQ PORTAL registriert hat. Wichtig hierfür ist, dass für den PEIQ-Account und das Facebook-Konto die gleiche E-Mail-Adresse hinterlegt ist. In diesem Fall erkennt das PORTAL bei dem erstmaligen Login über Facebook, dass es sich hierbei um den bzw. die gleiche:n Benutzer:in handelt und verknüpft die beiden Accounts.

• Wenn ein:e Benutzer:in in den Account-Einstellungen unter “Verknüpfte Accounts” die Verknüpfung zum Facebook-Konto entfernt, ist ein späteres Anmelden über Facebook nicht mehr möglich. Der PEIQ-Account bleibt davon unberührt. Über die im PEIQ PORTAL hinterlegte E-Mail-Adresse ist eine Anmeldung nach wie vor möglich. Wichtig: Das Facebook-Konto ist weiterhin vorhanden und kann bei Bedarf erneut mit dem PEIQ-Account verknüpft werden.

Anleitung zum Setup

Die Registrierung und Anmeldung auf Basis von Facebook OpenGraph ist ein Feature im PEIQ PORTAL, welches pro Kundeninstallation aktiviert und deaktiviert werden kann. Falls das Feature im Online-PORTAL aktiviert werden soll, kann eine Anfrage an das PEIQ Support Team gestellt werden.

Welche Daten benötigt PEIQ für die Aktivierung des Facebook-Login-Features?

Zum Aktivieren des Facebook-Logins benötigt PEIQ folgende Daten: App ID und App Secret der konfigurierten Facebook-App.

Um eine Facebook-App einzurichten, wird ein Facebook-­Account benötigt, welcher einfach durch Registrierung unter www.facebook.de eingerichtet wird. Zum Anlegen einer Facebook-App muss die Developer-­Seite von Facebook angesteuert werden und eine Registrierung als Entwickler erfolgen. Danach kann die erste App (Typ: Web) erstellt werden. 

Nachdem die allgemeinen Einstellungen der Facebook App vorgenommen wurden, sind folgende Schritte durchzuführen:

• "Facebook Login" als Produkt hinzufügen

• Unter "Facebook Login > Einstellungen" … "Client-OAuth-Anmeldung", "HTTPS verwenden" und "Web-OAuth-Anmeldung" einschalten.

• Unter "Gültige OAuth Redirect URIs" abhängig von der PORTAL-Domain die richtige Redirect URL eintragen. Falls benötigt, analog dazu die Redirect URL für das Staging System eintragen. 

Muster: `https://{portal-domain}/oauth/connect/check-facebook`

Nachdem die App erstellt wurde, erfolgt der Erhalt der entsprechenden App ID und des App Secret. Beide müssen an PEIQ übermittelt werden, damit der Facebook-Login für das PORTAL eingerichtet werden kann.

FAQ

Verwandte Seiten

^{Nur für PEIQ-Mitarbeiter:innen}
https://peiq.atlassian.net/wiki/x/iYCwC