Activer les connexions sociales

Principe

Facebook, Google ou GitHub évitent un mot de passe de plus. L’adresse e-mail fournie est rapprochée d’un utilisateur existant. S’il n’y en a pas, un Website User est créé, sauf si Signup est désactivé dans Website Settings. Un System Manager peut le passer en System User pour le bureau. La fiche est Social Login Key. Client ID et Client Secret s’y saisissent : Desktop, Integration, Authentication, Social Login Key. Si le site est en HTTPS, utiliser https://{{ yoursite }}.

Un site Frappe comme fournisseur

Site A https://sitea.com fournit la connexion, site B https://siteb.com l’utilise.

1. Sur A, nouvel OAuth Client. App Name identifie B.
2. Redirect URIs et Default Redirect URI : https://siteb.com/api/method/frappe.integrations.oauth2_logins.login_via_frappe.
3. À l’enregistrement, App Client ID et App Client Secret sont générés.
4. Sur B, nouvelle Social Login Key : ces deux valeurs, fournisseur Frappe, Base URL https://sitea.com.

Facebook, Google, GitHub

Facebook : application sur developers.facebook.com, Contact Email dans Settings, Basic. Valid OAuth redirect URIs : http://{{ yoursite }}/api/method/frappe.integrations.oauth2_logins.login_via_facebook. Rendre l’application publique dans Status & Review. App ID et App Secret vont dans Client ID et Client Secret.

Google : projet, APIs & Auth, Credentials, Create new Client ID, Web Application. Origine JavaScript http://{{ yoursite }}. Redirection http://{{ yoursite }}/api/method/frappe.integrations.oauth2_logins.login_via_google. La phrase publiée dit de copier Client ID et Client Secret dans le champ Client ID.

GitHub : Register new application. Homepage http://{{ yoursite }}. Callback http://{{ yoursite }}/api/method/frappe.integrations.oauth2_logins.login_via_github. Le Client ID va dans Desktop, Website, Setup, Social Login Keys. Le secret va dans Social Login Key, Client Secret.

Office 365

Sur portal.azure.com : Azure Active Directory, App Registration, New Application Registration. Comptes de n’importe quel annuaire (multitenant). Type Web app / API. Homepage http://{{ yoursite }}. Le callback publié est http://{{ yoursite }}//api/method/frappe.integrations.oauth2_logins.login_via_office365, avec deux barres obliques. Application (client) ID vers Client ID. Certificates & secrets : créer un secret et le copier. Fournisseur Office 365, Enable Social Login, Save. Token configuration : claim facultatif, Token Type ID, Email.

Point d’attention

Les URI d’exemple sont en http://, sauf le couple de sites Frappe en https://. Le callback Office 365 publié contient // avant api. Le chemin GitHub du Client ID n’est pas le même que celui du secret.