DocumentationAEM 6.4Guide de Communities

Connexion aux réseaux sociaux avec Facebook et Twitter social-login-with-facebook-and-twitter

Last update: Thu May 04 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

Créé pour :

  • Admin
CAUTION
AEM 6.4 a atteint la fin de la prise en charge étendue et cette documentation n’est plus mise à jour. Pour plus d’informations, voir notre période de support technique. Rechercher les versions prises en charge here.

La connexion à Social permet de proposer à un visiteur du site l’option de connexion à l’aide de son compte Facebook ou Twitter. Par conséquent, inclure les données Facebook ou Twitter autorisées dans leur profil de membre AEM.

socialloginweretail

Présentation de la connexion aux réseaux sociaux social-login-overview

Pour inclure la connexion sociale, il est obligatoire de créer des applications Facebook et Twitter personnalisées.

Bien que l’exemple we-retail fournisse des exemples d’applications Facebook et Twitter et de services cloud, ils ne sont pas disponibles sur un site web de production.

Les étapes requises sont les suivantes :

  1. Activation de l’authentification OAuth sur toutes les instances de publication AEM.

    Si OAuth n’est pas activé, les tentatives de connexion échouent.

  2. Créer une application sociale et un service cloud.

  3. Activer connexion sociale pour un site communautaire.

Il existe deux concepts de base :

  1. Portée (autorisations) indique les données que l’application est autorisée à demander.

  2. Champs (params) spécifie les données réelles demandées à l’aide des paramètres d’URL.

Connexion à facebook facebook-login

Version de l’API facebook facebook-api-version

La connexion sociale et l’exemple de Facebook we-retail ont été développés lorsque l’API Facebook Graph était la version 1.0.
Depuis AEM version 6.4 GA et AEM 6.3 SP1, la connexion sociale a été mise à jour pour fonctionner avec la nouvelle version de l’API Facebook Graph 2.5.

NOTE
Pour les versions d’AEM plus anciennes, si vous rencontrez une exception dans les journaux Impossible d’extraire un jeton à partir de celui-ci, effectuez une mise à niveau vers le dernier CFP pour cette version AEM.

Pour obtenir des informations sur la version de l’API Facebook Graph, voir la section Modification de l’API facebook.

Création d’une application Facebook create-a-facebook-app

Une application Facebook correctement configurée est requise pour activer la connexion sociale Facebook.

Pour créer une application Facebook, suivez les instructions de Facebook indiquées dans https://developers.facebook.com/apps/. Les modifications apportées à leurs instructions ne sont pas répercutées dans les informations suivantes.

En règle générale, à partir de l’API Facebook v2.7 :

  • Ajout d’une nouvelle application Facebook :

    • Pour Plateforme, choisissez Site Web .
      • Pour URL du site, saisissez https://<server>:<port>.
    • Pour Nom d’affichage, saisissez un titre à utiliser comme titre du service de connexion Facebook.
    • Pour Catégorie, choix recommandé Applications pour les pages, mais peut être n'importe quoi.
    • Ajouter un produit : Connexion à facebook
      • Pour URI de redirection OAuth valides, saisissez https://<server>:<port>.
NOTE
Pour le développement, http://localhost:4503 fonctionne.

Une fois l’application créée, localisez la variable ID de l’application et Secret de l’application paramètres. Ces informations sont requises pour configurer la variable Service cloud facebook.

Création d’un Cloud Service Facebook Connect create-a-facebook-connect-cloud-service

Le Adobe de l’application OAuth Granite et du fournisseur instance, instanciée par la création d’une configuration de service cloud, identifie l’application Facebook et le ou les groupes de membres auxquels les nouveaux utilisateurs sont ajoutés.

  1. Sur l’instance d’auteur AEM, connectez-vous avec les droits d’administrateur.

  2. Dans la navigation globale, sélectionnez Outils > Cloud Services > Configuration de la connexion à Facebook Social.

  3. Sélectionner la configuration chemin du contexte.

    Chemin du contexte doit être identique au chemin de configuration cloud sélectionné lors de la création/modification d’un site de communauté.

  4. Vérifiez si votre chemin d’accès au contexte est activé pour créer des services cloud en-dessous.

  5. Accédez à Outils > Général > Navigateur de configuration. Sélectionnez votre contexte et modifiez les propriétés. Activez les configurations cloud si elles ne sont pas encore activées.

    config-properties

  6. Créez/modifiez la configuration du service cloud Facebook.

    fbsocialloginconfigpng

    • Titre (Obligatoire) Saisissez un titre d’affichage qui identifie l’application Facebook. Il est recommandé d’utiliser le même nom que celui saisi lors de la Nom d’affichage pour l’application Facebook.
    • ID d’application/clé API (Obligatoire) Saisissez le ID de l’application pour l’application Facebook. Cela identifie la variable Adobe de l’application OAuth Granite et du fournisseur instance créée à partir de la boîte de dialogue.
    • Secret de l’application (Obligatoire) Saisissez le Secret de l’application pour l’application Facebook.
    • Création d’utilisateurs Si cette case est cochée, la connexion à l’aide d’un compte Facebook crée une entrée utilisateur AEM et l’ajoute en tant que membre au ou aux groupes d’utilisateurs sélectionnés. La valeur par défaut est cochée (vivement recommandé).
    • Masquage des ID utilisateur: Laissez désélectionné.
    • Courrier électronique d’étendue: L’ID de courrier électronique de l’utilisateur doit être récupéré à partir de Facebook.
    • Ajouter aux groupes d’utilisateurs Sélectionnez Ajouter un groupe d’utilisateurs pour en choisir un ou plusieurs. groupes de membres pour le site de la communauté sur lequel les utilisateurs seront ajoutés.
    note note
    NOTE
    Les groupes peuvent être ajoutés ou supprimés à tout moment. Mais les appartenances des utilisateurs existants ne seront pas affectées. L’adhésion automatique s’applique uniquement aux nouveaux utilisateurs créés après la mise à jour de ce champ. Pour les sites où les utilisateurs anonymes sont désactivés, choisissez d’ajouter des utilisateurs au groupe de membres de communauté correspondant destiné à ce site de communauté fermé.
    • Sélectionner ENREGISTRER.
    • Publication.

Le résultat est un Adobe de l’application OAuth Granite et du fournisseur qui ne nécessite aucune modification supplémentaire, sauf si vous ajoutez une portée supplémentaire (autorisations). La portée par défaut est les autorisations standard pour la connexion à Facebook. Si une portée supplémentaire est souhaitée, il est nécessaire de modifier directement la configuration OSGI. Si des modifications sont effectuées directement via le système/la console, évitez de modifier vos configurations de service cloud à partir de l’interface utilisateur tactile afin d’éviter tout écrasement.

Fournisseur OAuth Facebook AEM Communities aem-communities-facebook-oauth-provider

Le fournisseur AEM Communities étend la variable Adobe de l’application OAuth Granite et du fournisseur instance.

Ce fournisseur devra être modifié pour :

  • Autoriser les mises à jour des utilisateurs

  • Ajouter des champs supplémentaires dans la portée

    • Tous les champs autorisés par défaut ne sont pas inclus par défaut.

Si des modifications sont nécessaires, sur chaque instance de publication AEM :

  1. Connectez-vous avec les privilèges d’administrateur.

  2. Accédez au Console web. Par exemple, http://localhost:4503/system/console/configMgr.

  3. Recherchez le fournisseur OAuth Facebook AEM Communities.

  4. Sélectionnez l’icône en forme de crayon à ouvrir pour modification.

    fboauthquet_png

    • Identifiant du fournisseur OAuth

      (Obligatoire) La valeur par défaut est soco-facebook. Ne modifiez pas.

    • Configuration du Cloud Service

      La valeur par défaut est /etc/cloudservices/facebookconnect. Ne modifiez pas.

    • Configuration du service de fournisseur OAuth

      La valeur par défaut est /apps/social/facebookprovider/config/. Ne modifiez pas.

    • Activation des balises

      Ne modifiez pas.

    • Chemin d’accès utilisateur

      Emplacement dans le référentiel où les données utilisateur sont stockées. Pour un site de communauté, pour garantir aux membres les autorisations d’afficher le profil de l’autre, le chemin doit être le chemin par défaut. /home/users/community.

    • Activer les champs

      Si cette case est cochée, les champs répertoriés sont spécifiés dans la demande à Facebook pour l’authentification et les informations de l’utilisateur. La valeur par défaut est désélectionnée.

    • Champs

      Lorsque les champs sont activés, les champs suivants sont inclus lors de l’appel de l’API Facebook Graph. Les champs doivent être autorisés dans la portée définie dans la configuration du service cloud. Les champs supplémentaires peuvent nécessiter l’approbation de Facebook. Reportez-vous à la section Autorisations de connexion Facebook de la documentation Facebook. Les champs par défaut ajoutés en tant que paramètres sont les suivants :

      • id
      • name
      • first_name
      • last_name
      • link
      • paramètres régionaux
      • picture
      • timezone
      • updated_time
      • vérifié
      • email

    Si un champ est ajouté ou modifié, mettez à jour la configuration du gestionnaire de synchronisation par défaut correspondant pour corriger le mappage.

    • Mettre à jour l’utilisateur
      Si cette case est cochée, actualise les données utilisateur dans le référentiel à chaque connexion afin de refléter les modifications de profil ou les données supplémentaires demandées. La valeur par défaut est désélectionnée.

Étapes suivantes next-steps

Les étapes suivantes sont les mêmes pour Facebook et Twitter :

Connexion à twitter twitter-login

Création d’une application Twitter create-a-twitter-app

Une application Twitter configurée est requise pour activer la connexion sociale Twitter.

Suivez les dernières instructions pour créer une application Twitter à l’adresse https://apps.twitter.com.

En général :

  1. Saisissez un Nom qui identifiera votre application Twitter aux utilisateurs de votre site web.

  2. Saisissez un Description.

  3. Pour site web - saisissez https://<server>/.

  4. Pour URL de callback - saisissez https://<server>/.

    note note
    NOTE
    Il n’est pas nécessaire de spécifier le port.
    Pour le développement, https://127.0.0.1/ fonctionne.

  5. Une fois l’application créée, localisez la variable Clé du client (API) et Secret du client (API). Ces informations seront nécessaires pour configurer la variable Service cloud twitter.

Autorisations permissions

Dans la section Autorisations de la gestion des applications Twitter :

  • Accès: Sélectionner Read only.

    • Les autres options ne sont pas prises en charge

  • Autorisations supplémentaires: Si vous le souhaitez Request email addresses from users.

    • Si cette option n’est pas sélectionnée, le profil utilisateur dans AEM n’inclut pas son adresse électronique.
    • Les instructions de twitter indiquent les étapes supplémentaires à suivre.

La seule requête REST envoyée pour la connexion sociale est : Compte GET/vérification des informations d’identification.

Création d’un Cloud Service Twitter Connect create-a-twitter-connect-cloud-service

Le Adobe de l’application OAuth Granite et du fournisseur instance, instanciée par la création d’une configuration de service cloud, identifie l’application Twitter et le ou les groupes de membres auxquels les nouveaux utilisateurs sont ajoutés.

  1. Sur l’instance d’auteur, connectez-vous avec les privilèges d’administrateur.

  2. Dans la navigation globale, sélectionnez Outils > Cloud Services > Configuration de la connexion à Twitter Social.

  3. Choisissez la chemin du contexte configuration.

    Le chemin d’accès au contexte doit être identique au chemin de configuration du cloud que vous avez sélectionné lors de la création/modification d’un site de communauté.

  4. Vérifiez si votre chemin d’accès au contexte est activé pour créer des services cloud en-dessous.

  5. Accédez à Outils > Général > Navigateur de configuration. Sélectionnez votre contexte et modifiez les propriétés. Activez les configurations cloud si elles ne sont pas encore activées.

    twitterconfigpropng

  6. Créez/modifiez la configuration du service cloud Twitter.

    twittersocialloginpng

    • Titre (Obligatoire) Saisissez un titre d’affichage qui identifie l’application Twitter. Il est recommandé d’utiliser le même nom que celui saisi lors de la Nom d’affichage pour l’application Twitter.

    • Clé client (Obligatoire) Saisissez le Clé du client (API) pour l’application Twitter. Cela identifie la variable Adobe de l’application OAuth Granite et du fournisseur instance créée à partir de la boîte de dialogue.

    • Secret du client (Obligatoire) Saisissez le Secret du client (API) pour l’application Twitter.

    • Création d’utilisateurs Si cette case est cochée, la connexion à l’aide d’un compte Twitter crée une entrée utilisateur AEM et l’ajoute en tant que membre au ou aux groupes d’utilisateurs sélectionnés. La valeur par défaut est cochée (vivement recommandé).

    • Masquage des ID utilisateur Laissez désélectionné.

    • Ajouter aux groupes d’utilisateurs Sélectionnez Ajouter un groupe d’utilisateurs pour en choisir un ou plusieurs. groupes de membres pour le site de la communauté sur lequel les utilisateurs seront ajoutés.

    note note
    NOTE
    Les groupes peuvent être ajoutés ou supprimés à tout moment. Mais les appartenances des utilisateurs existants ne seront pas affectées. L’adhésion automatique s’applique uniquement aux nouveaux utilisateurs créés après la mise à jour de ce champ. Pour les sites où les utilisateurs anonymes sont désactivés, ajoutez des utilisateurs au groupe de membres de communauté correspondant destiné à ce site de communauté fermé.

  7. Sélectionner ENREGISTRER et Publier.

Le résultat est un Adobe de l’application OAuth Granite et du fournisseur qui ne nécessite pas d’autres modifications. La portée par défaut est les autorisations standard pour la connexion à Twitter.

Fournisseur OAuth Twitter AEM Communities aem-communities-twitter-oauth-provider

La configuration AEM Communities étend la variable Adobe de l’application OAuth Granite et du fournisseur instance. Ce fournisseur devra être modifié pour autoriser les mises à jour des utilisateurs.

Si des modifications sont nécessaires, sur chaque instance de publication AEM :

  1. Connectez-vous avec les privilèges d’administrateur.

  2. Accédez au Console web.

    Par exemple, http://localhost:4503/system/console/configMgr.

  3. Recherchez le fournisseur OAuth Twitter AEM Communities.

  4. Sélectionnez l’icône en forme de crayon à ouvrir pour modification.

    twitteroauth_png

    • Identifiant du fournisseur OAuth (Obligatoire)

      La valeur par défaut est soco-twitter. Ne modifiez pas.

    • Configuration du Cloud Service

      La valeur par défaut est conf. Ne modifiez pas.

    • Configuration du service de fournisseur OAuth

      La valeur par défaut est /apps/social/twitterprovider/config/. Ne modifiez pas.

    • Chemin d’accès utilisateur

      Emplacement dans le référentiel où les données utilisateur sont stockées. Pour un site de communauté, pour garantir aux membres les autorisations d’afficher le profil de l’autre, le chemin doit être le chemin par défaut. /home/users/community.

    • Activation des paramètres ne pas modifier

    • Paramètres d’URL ne pas modifier

    • Mettre à jour l’utilisateur

      Si cette case est cochée, actualise les données utilisateur dans le référentiel à chaque connexion afin de refléter les modifications de profil ou les données supplémentaires demandées. La valeur par défaut est désélectionnée.

Étapes suivantes next-steps-1

Les étapes suivantes sont les mêmes pour Facebook et Twitter :

Activation de la connexion aux réseaux sociaux enable-social-login

Console AEM Communities Sites aem-communities-sites-console

Une fois qu’un service cloud est configuré, il peut être activé pour le paramètre Social Login approprié pour un site de communauté à l’aide de la variable Gestion des utilisateurs Sous-panneau Paramètres lors du site de la communauté création ou gestion.

  1. Sélectionnez le contexte de configuration de votre site dans lequel vous avez enregistré vos configurations de connexion sociale.

  2. Dans l’onglet Général , définissez les configurations cloud.

    managesites_png

  3. Sous l’onglet Paramètres , activez Connexions aux réseaux sociaux et enregistrez.

    usermgmt_png

Test de la connexion aux réseaux sociaux test-social-login

  • Assurez-vous que Gestionnaire d’authentification OAuth Adobe a été activé sur toutes les instances de publication.
  • Assurez-vous que les services cloud ont été publiés
  • S’assurer que le site de la communauté a été publié
  • Lancer le site publié dans un navigateur Par exemple, http://localhost:4503/content/sites/engage/en.html
  • Sélectionner Connexion
  • Sélectionnez Connexion à Facebook ou Connexion à Twitter
  • Si vous n’êtes pas encore connecté à Facebook ou Twitter, connectez-vous avec les informations d’identification appropriées.
  • Il peut être nécessaire d’accorder une autorisation en fonction de la boîte de dialogue affichée par l’application Facebook ou Twitter.
  • Notez que la barre d’outils située en haut de la page est mise à jour pour refléter la connexion réussie.
  • Sélectionner Profil: la page Profil affiche l’avatar, le prénom et le nom de l’utilisateur. Il affiche également les informations du profil Facebook ou Twitter en fonction des champs/paramètres autorisés.

AEM des configurations OAuth de Platform aem-platform-oauth-configurations

Gestionnaire d’authentification OAuth Adobe adobe-granite-oauth-authentication-handler

Le Adobe Granite OAuth Authentication Handler n’est pas activé par défaut et doit être activé sur toutes les instances de publication AEM.

Pour activer le gestionnaire d’authentification lors de la publication, ouvrez simplement la configuration OSGi et enregistrez-la :

  • Connexion avec droits d’administrateur
  • Accédez au Console web
    Par exemple, http://localhost:4503/system/console/configMgr
  • Localiser Adobe Granite OAuth Authentication Handler
  • Sélectionnez cette option pour ouvrir la configuration à modifier.
  • Sélectionnez Enregistrer.

chlimage_1-489

CAUTION
Veillez à ne pas confondre le gestionnaire d’authentification avec une instance Facebook ou Twitter de Adobe de l’application OAuth Granite et du fournisseur.

chlimage_1-490

Adobe de l’application OAuth Granite et du fournisseur adobe-granite-oauth-application-and-provider

Lorsqu’un service cloud pour Facebook ou Twitter est créé, une instance de Adobe Granite OAuth Authentication Handler est créée.

Pour localiser l’instance créée pour une application Facebook ou Twitter :

  1. Connectez-vous avec les privilèges d’administrateur.

  2. Accédez au Console web.

    Par exemple, http://localhost:4503/system/console/configMgr.

  3. Localisez l’application et le fournisseur OAuth Adobe Granite.

    • Localisez l’instance où ID client correspond à ID de l’application

    chlimage_1-491

    A l’exception des propriétés suivantes, conservez les autres propriétés de la configuration inchangées :

    • ID de configuration

      (Obligatoire) Les identifiants de configuration OAuth doivent être uniques. Généré automatiquement lors de la création du service cloud.

    • ID client

      (Obligatoire) ID d’application fourni lors de la création du service cloud.

    • Secret client

      (Obligatoire) Le secret d’application fourni lors de la création du service cloud.

    • Portée

      (Facultatif) Vous pouvez demander au fournisseur une autre portée pour ce qui est autorisé. La portée par défaut couvre les autorisations nécessaires pour fournir l’authentification sociale et les données de profil.

    • Identifiant du fournisseur

      (Obligatoire) L’identifiant du fournisseur pour AEM Communities est défini lors de la création du service cloud. Ne modifiez pas. Pour Facebook Connect, la valeur est soco-facebook. Pour Twitter Connect, la valeur est soco-twitter.

    • Groupes

      (Recommandé) Un ou plusieurs groupes de membres auxquels sont ajoutés les utilisateurs créés. Pour AEM Communities, il est recommandé de répertorier le groupe de membres pour le site de la communauté.

    • URL de rappel

      (Facultatif) URL configurée avec les fournisseurs OAuth pour rediriger le client. Utilisez une URL relative pour utiliser l’hôte de la requête d’origine. Laissez vide pour utiliser l’URL demandée d’origine à la place. Le suffixe "/callback/j_security_check" est automatiquement ajouté à cette URL .

    note note
    NOTE
    Le domaine du rappel doit être enregistré auprès du fournisseur (Facebook ou Twitter).

Pour chaque configuration du gestionnaire d’authentification OAuth, deux configurations supplémentaires sont créées dans l’instance :

  • Gestionnaire de synchronisation par défaut Apache Jackrabbit Oak (org.apache.jackrabbit.oak.spi.security.authentication.external.impl.DefaultSyncHandler) - Aucune modification n’y est requise, mais vous pouvez examiner les mappages des champs utilisateur comment les champs Facebook sont mappés à un noeud de profil utilisateur CQ. Notez également que "Nom du gestionnaire de synchronisation" correspond à l’ID de configuration de la configuration du fournisseur OAuth.
  • Module de connexion externe Apache Jackrabbit Oak (org.apache.jackrabbit.oak.spi.security.authentication.external.impl.ExternalLoginModuleFactory) - Aucune modification n’y est requise, mais vous pouvez remarquer que "Nom du fournisseur d’identité" et "Nom du gestionnaire de synchronisation" sont identiques et pointent respectivement vers les configurations OAuth et du gestionnaire de synchronisation correspondantes.

Pour plus d’informations, voir Authentification avec le module de connexion externe Apache Oak.

Performances de conversion des utilisateurs OAuth oauth-user-traversal-performance

Pour les sites de la communauté qui voient des centaines de milliers d’utilisateurs s’enregistrer à l’aide de leur connexion Facebook ou Twitter, les performances transversales de la requête effectuée lorsqu’un visiteur du site utilise sa connexion sociale peuvent être améliorées en ajoutant l’index Oak suivant.

Si des avertissements transversaux s’affichent dans les journaux, il est recommandé d’ajouter cet index.

Sur une instance d’auteur, connectez-vous avec les privilèges d’administrateur :

  1. À partir de la navigation globale : select Outils, CRX/DE Lite.

  2. Créez un index nommé ntBaseLucene-oauth à partir d’une copie de ntBaseLucene :

    • Sous le noeud /oak:index
    • Sélectionner le noeud ntBaseLucene
    • Sélectionnez Copie
    • Sélectionner /oak:index
    • Sélectionner Coller
    • Renommez Copie de ntBaseLucene en ntBaseLucene-oauth.

  3. Modifiez les propriétés du noeud ntBaseLucene-oauth :

    • indexPath: /oak:index/ntBaseLucene-oauth
    • name: oauthid-123xxxx
    • reindex: true
    • reindexCount: 1

  4. Sous le noeud /oak:index/ntBaseLucene-oauth/indexRules/nt:base/properties :

    • Supprimez tous les noeuds enfants, à l’exception de cqTags.

    • Renommez cqTags en oauthid-123xxxx.

    • Modification des propriétés du noeud oauthid-123xxxx

      • name: oauthid-123xxxx

    • Sélectionnez Enregistrer tout.

* Pour le name oauthid-123, remplacer 123 avec Facebook ID de l’application ou Twitter Clé du client (API) qui correspond à la valeur de la variable ID client dans le Adobe de l’application OAuth Granite et du fournisseurconfiguration.

chlimage_1-492

Pour plus d’informations et d’outils, reportez-vous à la section Requêtes et indexation Oak.

Configuration du Dispatcher dispatcher-configuration

Voir Configuration de Dispatcher pour Communities.

recommendation-more-help
5d37d7b0-a330-461b-814d-068612705ff6