Raccorder la connexion Facebook

Pour que les utilisateurs de votre service s'inscrivent avec un compte Facebook, vous enregistrez d'abord ce service auprès de Facebook et vous récupérez un App ID et un App secret.

Cette page indique l'ordre dans lequel récupérer l'App ID et l'App secret. La manière de placer les deux valeurs récupérées dans WEEGLOO se trouve dans Placer l'App ID et l'App secret dans WEEGLOO.

Récupérer l'App ID et l'App secret chez Facebook

Connectez-vous avec votre compte Facebook, puis suivez dans l'ordre les quatre étapes ci-dessous. Ce que vous faites ici n'entraîne aucun coût.

1

Créer l'application

Si vous avez déjà une application en cours d'utilisation et que son écran Use cases comporte la ligne Facebook Login, vous pouvez la réutiliser telle quelle au lieu d'en créer une nouvelle. Dans ce cas, passez cette étape et allez à Ajouter l'autorisation e-mail.

Vous passez tour à tour par cinq écrans : App details, Use cases, Business, Requirements et Overview.

  1. Ouvrez l'écran de la liste des applications (https://developers.facebook.com/apps (s'ouvre dans un nouvel onglet)).

  2. Cliquez sur Create App.

    L'écran Apps sans aucune application. Au centre figurent l'indication No apps yet et le bouton Create App

  3. Dans App name, saisissez un nom que vous reconnaîtrez plus tard (par exemple Le Dressing Douillet).

  4. Dans App contact email, saisissez l'adresse qui recevra les demandes. C'est l'adresse que Facebook utilise pour vous contacter au sujet de cette application.

  5. Cliquez sur Next.

    L'étape App details de l'écran que l'on remplit étape par étape. Les champs App name et App contact email sont présents, et le bouton Next se trouve en bas à droite

  6. Cochez Authenticate and request data from users with Facebook Login.

  7. Cliquez sur Next.

    L'étape Use cases de l'écran que l'on remplit étape par étape. Parmi les six éléments, Authenticate and request data from users with Facebook Login est coché

  8. Choisissez l'option I don’t want to connect a business portfolio yet. Le portefeuille d'entreprise peut être ajouté plus tard, comme l'indique l'explication à l'écran.

  9. Cliquez sur Next.

    L'étape Business de l'écran que l'on remplit étape par étape. L'option I don’t want to connect a business portfolio yet. et l'indication qu'il n'y a aucune entreprise sont visibles

  10. Lisez le contenu de l'écran Requirements, puis cliquez sur Next. Vous n'avez rien à saisir.

    L'étape Requirements de l'écran que l'on remplit étape par étape. Business verification et App Review sont listés sous Publishing requirements

  11. Sur le dernier écran, Overview, vérifiez ce que vous avez choisi jusque-là et créez l'application.

2

Ajouter l'autorisation e-mail

Lorsqu'un utilisateur se connecte avec Facebook, WEEGLOO récupère aussi son adresse e-mail et l'enregistre sur le membre. Dans un même Space, une adresse e-mail ne permet de s'inscrire qu'une seule fois. Si vous n'ajoutez pas l'autorisation email, Facebook ne transmet pas l'adresse e-mail : ne sautez donc pas cette étape.

  1. Si l'écran de l'application n'est pas ouvert, cliquez, dans l'écran de la liste des applications (https://developers.facebook.com/apps (s'ouvre dans un nouvel onglet)), sur l'application à utiliser pour la connexion.

  2. Dans le menu de gauche, cliquez sur Use cases.

  3. Cliquez sur Customize, sur la ligne Facebook Login.

  4. À gauche, cliquez sur Permissions and features.

  5. Cliquez sur + Add, sur la ligne email.

    La liste Permissions and features. Sur la ligne email, Status ne porte aucune mention et Action contient le bouton + Add, tandis que la ligne public_profile affiche Ready for testing

  6. Vérifiez que le Status des deux lignes email et public_profile affiche bien Ready for testing.

    La même liste. Sur les deux lignes email et public_profile, Status affiche Ready for testing

3

Enregistrer l'adresse de connexion

  1. Si l'écran Customize use case n'est pas ouvert, cliquez, dans l'écran de la liste des applications (https://developers.facebook.com/apps (s'ouvre dans un nouvel onglet)), sur l'application à utiliser pour la connexion. Ensuite, dans Use cases du menu de gauche, cliquez sur Customize, sur la ligne Facebook Login.

  2. À gauche, cliquez sur Settings.

  3. Collez l'adresse ci-dessous dans le champ Valid OAuth Redirect URIs. Choisissez votre Space et l'identifiant est renseigné.

    Space
    https://auth.weegloo.com/v1/spaces/{spaceId}/login/oauth2/code/facebook

    Si vous ne savez pas quel est votre Space et que vous avez confié le raccordement à un agent IA, vous pouvez aussi le lui demander. Demandez dans la fenêtre de conversation « Donne-moi l'adresse de redirection à enregistrer pour la connexion Facebook » et vous recevez l'adresse complète.

    Redirect URI Validator, en haut du même écran, n'est pas l'endroit où l'on enregistre l'adresse. Saisissez une adresse dans Redirect URI to check et cliquez sur Check URI pour la contrôler.

  4. Cliquez sur Save Changes.

    L'écran Settings. Redirect URI Validator figure en haut, et le champ Valid OAuth Redirect URIs se trouve en bas, dans Client OAuth settings

4

Copier l'App ID et l'App secret

L'App ID et l'App secret se trouvent sur l'écran des paramètres de base de l'application.

Un bandeau rouge Currently ineligible for submission peut apparaître en haut de cet écran. Il signale que les champs App icon, Privacy policy URL et Category sont vides. Ces trois éléments sont nécessaires au moment de soumettre la demande de validation, et non pour raccorder la connexion maintenant.

  1. Si l'écran de l'application n'est pas ouvert, cliquez, dans l'écran de la liste des applications (https://developers.facebook.com/apps (s'ouvre dans un nouvel onglet)), sur l'application à utiliser pour la connexion.

  2. Dans le menu de gauche, cliquez sur App settings.

  3. Cliquez sur Basic.

  4. Copiez la valeur inscrite dans App ID.

  5. Cliquez sur Show, placé à droite d'App secret.

  6. Copiez la valeur qui apparaît.

    L'écran Basic, dans App settings. La valeur App ID est visible, App secret est masqué par des points et le bouton Show se trouve à droite

Vous pouvez revoir les deux valeurs sur cet écran à tout moment. Pour App secret, il suffit de cliquer sur Show : même si vous quittez l'écran sans avoir noté la valeur, vous n'avez pas besoin d'en créer une nouvelle. App secret est toutefois une valeur secrète : ne la communiquez à personne et ne l'inscrivez nulle part en public.

Ajouter comme Tester les personnes qui feront un essai

Le raccordement à WEEGLOO n'a pas à attendre la validation. Dès que vous placez l'App ID et l'App secret dans WEEGLOO, la connexion fonctionne immédiatement.

L'application que vous venez de créer n'a toutefois pas encore été validée, et tant qu'elle ne l'est pas, seul le compte qui l'a créée peut se connecter. Pour qu'une autre personne puisse elle aussi essayer de se connecter, ajoutez-la à l'application comme Tester.

  1. Dans le menu de gauche, dépliez App roles et cliquez sur Roles.

  2. Cliquez sur Add People, en haut à droite.

    L'écran App roles. Les onglets All roles, Administrators, Developers, Testers et Analytics Users sont présents, et le bouton Add People se trouve en haut à droite

  3. Choisissez Tester.

  4. Dans le champ en dessous, saisissez le nom ou l'identifiant Facebook de la personne à ajouter, puis cliquez sur Add.

    La fenêtre Add people to your app. Parmi Administrator, Developer, Tester et Analytics User, Tester est sélectionné, et un champ de recherche de personne se trouve en dessous

Le menu Test users, juste en dessous, ne fonctionne pas.

Pour ouvrir à tous vos utilisateurs, vous passez par la validation

Pour que n'importe quel utilisateur puisse se connecter, et pas seulement les personnes ajoutées comme Tester, vous devez passer par la validation de Facebook. Lorsque vous êtes prêt, dépliez Review dans le menu de gauche et ouvrez App Review. Les autorisations email et public_profile ajoutées plus haut y figurent sous Not submitted. Vérifiez que ces deux autorisations sont les bonnes, puis cliquez sur Next, en bas à droite, pour passer à la procédure de soumission.

L'écran App Review, sous Review. email et public_profile figurent dans la liste Not submitted

Plusieurs étapes suivent encore après Next, et cette page vous accompagne seulement jusqu'au début de la soumission. Le reste de la procédure et les critères de validation figurent dans la documentation Meta (s'ouvre dans un nouvel onglet). Une fois la validation obtenue, n'importe quel utilisateur peut dès lors se connecter avec cette application.

Placer l'App ID et l'App secret dans WEEGLOO

Vous avez maintenant l'App ID et l'App secret en main. Voici dans quel champ du studio de contenu chacune de ces deux valeurs se place.

Écran de FacebookStudio de contenu
App IDApp ID
App secretApp secret

À partir d'ici, le chemin diffère selon la manière dont vous avez travaillé jusqu'à présent.

Si vous configuriez directement dans le studio de contenu, procédez ainsi.

  1. Revenez à l'activation d'une connexion sociale dans Connexion des membres du service.
  2. Activez Facebook.
  3. Saisissez l'App ID dans le champ App ID de l'étape Step 2.
  4. Saisissez l'App secret dans le champ App secret.
  5. Cliquez sur Enregistrer.

Si vous avez confié le raccordement à un agent IA et qu'il vous a demandé d'aller chercher l'App ID et l'App secret, collez telles quelles les deux valeurs récupérées dans la fenêtre de conversation et poursuivez ce que vous faisiez. L'agent prend en charge la suite de la configuration.

Et ensuite

  • Connexion des membres du service : placez les valeurs récupérées dans le studio de contenu et terminez le reste de la configuration de la connexion des membres.
  • Rôles et autorisations des membres : créez le ServiceUserRole qui définit ce qu'un membre inscrit peut voir et écrire.
  • Auth API : traite les spécifications techniques comme le format des requêtes, nécessaires pour rattacher la connexion au code de votre site.