Configurer la connexion sociale avec Alipay (Web)

Le connecteur officiel Logto pour la connexion sociale Alipay dans les applications web.

astuce

Dans ce guide, nous supposons que vous avez des connaissances de base sur les Connecteurs Logto. Si ce n'est pas le cas, consultez le guide Configurer les connecteurs pour commencer.

Commencer

Le connecteur Alipay Web est conçu pour les applications Web de bureau. Il tire parti du flux d'Authentification OAuth 2.0 d'Alipay et permet aux utilisateurs d'Alipay de se connecter à d'autres applications en utilisant des profils utilisateurs publics Alipay sans passer par un processus d'enregistrement fastidieux.

Enregistrer un compte développeur Alipay

Enregistrez un compte développeur Alipay si vous n'en avez pas.

Créer et configurer une application Alipay

1. Connectez-vous à la console Alipay avec le compte que vous venez de créer.
2. Allez dans l'onglet "Web & Mobile Apps" (网页&移动应用) dans le panneau "My Application" (我的应用).
3. Cliquez sur le bouton "Create an App" (立即创建) pour commencer à configurer votre application.
4. Nommez votre application dans "Application Name" (应用名称) en suivant les conventions de nommage et téléchargez votre "Application Icon" (应用图标), assurez-vous de choisir "web application" (网页应用) comme "App type" (应用类型).
5. Après avoir terminé la création de l'application, nous arrivons à la page d'aperçu, où nous devons cliquer sur "add ability" (添加能力) pour ajouter "Third-party application authorization" (第三方应用授权), "Get member information" (获取会员信息) et "App Alipay login" (App 支付宝登录) avant d'activer la connexion Alipay.
6. Allez au Centre Client Alipay, et connectez-vous avec le compte développeur Alipay. Cliquez sur "Account Center" (账号中心) dans la barre supérieure et allez à "APPID binding" (APPID 绑定), dont l'entrée se trouve en bas de la barre latérale. "Add binding" (添加绑定) en saisissant l'APPID de l'application web que vous venez de créer à l'étape 4.
7. Cliquez sur le bouton "Sign" de "App Alipay login", et terminez le processus de signature en suivant le guide. Après avoir terminé cette étape, vous devriez trouver les capacités que vous venez d'ajouter à l'étape 5 activées.
8. Revenez à la page de la console de la plateforme ouverte Alipay, et vous pouvez trouver "Interface signing method" (接口加签方式（密钥/证书）) dans la section "development information" (开发信息). Cliquez sur le bouton "set up" (设置), et vous vous retrouverez sur une page de configuration de la méthode de signature. "Public Key" (公钥) est le mode de signature préféré, et remplissez le contenu du fichier de clé publique que vous avez généré dans la zone de saisie de texte.
9. Configurez "Authorization Redirect URI" (授权回调地址) en cliquant sur le bouton "set up" (设置) en bas de la page de la console Alipay. ${your_logto_origin}/callback/${connector_id} est l'URI de redirection par défaut utilisé dans Logto core. Le connector_id peut être trouvé sur la barre supérieure de la page des détails du connecteur de la console d'administration Logto.
10. Après avoir terminé toutes ces étapes, revenez dans le coin supérieur droit de la page de la console Alipay, et cliquez sur "Submit for review" (提交审核). Une fois l'examen approuvé, vous êtes prêt à profiter d'un flux de connexion Alipay fluide.

ℹ️ Remarque

Vous pouvez utiliser openssl pour générer des paires de clés sur votre machine locale en exécutant le code suivant dans le terminal.

openssl genrsa -out private.pem 2048
openssl rsa -in private.pem -outform PEM -pubout -out public.pem

Lors de la saisie de la clé publique sur le site de configuration de l'application Alipay, vous devez supprimer l'en-tête et le pied de page de public.pem, supprimer tous les caractères de nouvelle ligne, et coller le reste du contenu dans la zone de saisie de texte pour "public key".

Configurer les paramètres du connecteur Logto Alipay Web

1. Dans l'espace de travail de la console Alipay, allez dans le panneau "My application" (我的应用) et cliquez sur l'onglet "Web & Mobile Apps" (网页&移动应用), vous pouvez trouver l'APPID de toutes les applications.
2. À l'étape 7 de la partie précédente, vous avez déjà généré une paire de clés comprenant une clé privée et une clé publique.
3. Remplissez les paramètres du connecteur Logto :
   • Remplissez le champ appId avec l'APPID que vous avez obtenu à l'étape 1.
   • Remplissez le champ privateKey avec le contenu du fichier de clé privée mentionné à l'étape 2. Assurez-vous d'utiliser '\n' pour remplacer tous les caractères de nouvelle ligne et ne supprimez pas l'en-tête et le pied de page dans le fichier de clé privée.
   • Remplissez le champ signType avec 'RSA2' en raison du mode de signature Public key que nous avons choisi à l'étape 7 de "Create And Configure Alipay Apps".
   • Remplissez le champ charset avec 'gbk' ou 'utf8'. Vous pouvez laisser ce champ vide car il est OPTIONNEL. La valeur par défaut est 'utf8'.
   • Remplissez le champ scope avec 'auth_base' ou 'auth_user'. Vous pouvez laisser ce champ vide car il est OPTIONNEL. La valeur par défaut est 'auth_user'. Vous pouvez consulter la différence entre les différentes valeurs.

Types de configuration

Nom	Type	Valeurs énumérées
appId	string	N/A
privateKey	string	N/A
signType	enum string	'RSA' | 'RSA2'
charset	enum string (OPTIONAL)	'gbk' | 'utf8' | undefined
scope	enum string (OPTIONAL)	'auth_user' | 'auth_base'

Tester le connecteur web Alipay

C'est tout. N'oubliez pas de Activer le connecteur social dans l'expérience de connexion.

Une fois le connecteur web Alipay activé, vous pouvez construire et exécuter votre application web pour voir si cela fonctionne.

Références

• Alipay Docs - Access Preparation - How to create an app
• Alipay Docs - Web & Mobile Apps - Create an app