Configurer la connexion sociale avec Alipay (Native)

Le connecteur officiel Logto pour la connexion sociale Alipay dans les applications natives sur appareils mobiles.

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 Native fonctionne en étroite collaboration avec le SDK Logto sur les plateformes mobiles. Il tire parti du workflow 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 "mobile application" (移动应用) comme "App type" (应用类型). Pour construire une application iOS, un "Bundle ID" unique est requis. De plus, une "application signature" (应用签名) et un "application package name" (应用包名) sont requis pour les applications Android.
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 tapant l'APPID de l'application mobile 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 voir les capacités que vous venez d'ajouter à l'étape 5 s'activer.
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 les contenus 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 le noyau Logto. Le connector_id peut être trouvé sur la barre supérieure de la page de 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 à utiliser 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 du remplissage 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 Native

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. Vous n'avez pas besoin de supprimer 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 "Créer et configurer des applications Alipay".

Types de configuration

Nom	Type	Valeurs énumérées
appId	string	N/A
privateKey	string	N/A
signType	enum string	'RSA' | 'RSA2'

Activer la connexion native Alipay dans votre application

iOS

Nous supposons que vous avez intégré le Logto iOS SDK dans votre application. Dans ce cas, les choses sont assez simples, et vous n'avez même pas besoin de lire la documentation du SDK Alipay :

1. Ajoutez LogtoSocialPluginAlipay à votre projet Xcode

Ajoutez le framework :

ℹ️ Remarque

Le plugin inclut le "minimalist SDK" (极简版 SDK) d'Alipay. Vous pouvez directement utiliser import AFServiceSDK une fois le plugin importé.

2. Ajoutez le plugin à vos options d'initialisation LogtoClient

let logtoClient = LogtoClient(
  useConfig: config,
  socialPlugins: [LogtoSocialPluginAlipay(callbackScheme: "your-scheme")]
)

Où callbackScheme est l'un des custom URL Schemes qui peut naviguer vers votre application.

Android

Nous supposons que vous avez intégré le Logto Android SDK dans votre application. Dans ce cas, les choses sont assez simples, et vous n'avez même pas besoin de lire la documentation du SDK Alipay :

1. Téléchargez le "minimalist SDK" d'Alipay et ajoutez-le à votre projet

Téléchargez le "minimalist SDK" d'Alipay (极简版 SDK) depuis Logto 3rd-party Social SDKs dans le dossier app/libs de votre projet :

project-path/app/libs/alipaySdk-15.7.9-20200727142846.aar

2. Ajoutez le "minimalist SDK" d'Alipay en tant que dépendance

Ouvrez votre fichier build.gradle :

project-path/app/build.gradle

Ajoutez la dépendance :

dependencies {
  // ...
  implementation(files("./libs/alipaySdk-15.7.9-20200727142846.aar"))  // kotlin-script
  // or
  implementation files('./libs/alipaySdk-15.7.9-20200727142846.aar')  // groovy-script
}

Tester le connecteur natif Alipay

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

Une fois le connecteur natif Alipay activé, vous pouvez construire et exécuter votre application 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