Alipay を使用してソーシャルログインを設定する (Set up social login with Alipay (Native))

モバイルデバイスのネイティブアプリ向け、Logto 公式の Alipay ソーシャルサインインコネクターです。

ヒント:

このガイドは、Logto コネクターについての基本的な理解があることを前提としています。未経験の方は、コネクターガイドを参照して始めてください。

はじめに

Alipay Native コネクターは、モバイルプラットフォーム上の Logto SDK と密接に連携します。Alipay の OAuth 2.0 認証 (Authentication) ワークフローを活用し、Alipay ユーザーが面倒な登録プロセスを経ずに、公開されている Alipay ユーザープロファイルを使って他のアプリにサインインできるようにします。

Alipay 開発者アカウントの登録

Alipay 開発者アカウントを登録してください（まだお持ちでない場合）。

Alipay アプリの作成と設定

Alipay コンソールに、先ほど登録したアカウントでサインインします。
「マイアプリケーション」(我的应用) パネルの「Web & モバイルアプリ」(网页&移动应用) タブに移動します。
「アプリを作成」(立即创建) ボタンをクリックして、アプリケーションの設定を開始します。
「アプリケーション名」(应用名称) に命名規則に従って名前を入力し、「アプリケーションアイコン」(应用图标) をアップロードします。「アプリタイプ」(应用类型) には「モバイルアプリケーション」(移动应用) を選択してください。iOS アプリを作成する場合は、一意の「Bundle ID」が必要です。また、Android アプリの場合は「アプリケーション署名」(应用签名) と「アプリケーションパッケージ名」(应用包名) も必要です。
アプリケーションの作成が完了したら、概要ページに移動します。ここで「機能を追加」(添加能力) をクリックし、「サードパーティアプリ認可」(第三方应用授权)、「会員情報の取得」(获取会员信息)、「App Alipay ログイン」(App 支付宝登录) を追加して、Alipay サインインを有効にします。
Alipay カスタマーセンターにアクセスし、Alipay 開発者アカウントでサインインします。トップバーの「アカウントセンター」(账号中心) をクリックし、サイドバー下部にある「APPID バインディング」(APPID 绑定) へ進みます。手順 4 で作成したモバイルアプリの APPID を入力して「バインディングを追加」(添加绑定) します。
「App Alipay ログイン」の「署名」ボタンをクリックし、ガイドに従って署名プロセスを完了します。この手順が完了すると、手順 5 で追加した機能が有効になります。
Alipay オープンプラットフォームのコンソールページに戻り、「開発情報」(开发信息) セクションの「インターフェース署名方式（鍵/証明書）」(接口加签方式（密钥/证书）) を見つけます。「設定」(设置) ボタンをクリックすると、署名方式の設定ページに移動します。「公開鍵」(公钥) が推奨される署名モードです。生成した公開鍵ファイルの内容をテキスト入力欄に貼り付けてください。
Alipay コンソールページ下部の「設定」(设置) ボタンをクリックして「認可リダイレクト URI」(授权回调地址) を設定します。${your_logto_origin}/callback/${connector_id} が Logto コアで使用されるデフォルトのリダイレクト URI です。connector_id は Logto 管理コンソールのコネクター詳細ページのトップバーで確認できます。
すべての手順が完了したら、Alipay コンソールページ右上の「審査提出」(提交审核) をクリックします。審査が承認されれば、スムーズな Alipay サインインフローを利用できます。

注記:

ローカルマシンで openssl を使ってキーペアを生成するには、以下のコードスニペットをターミナルで実行してください。

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

Alipay アプリ設定サイトで公開鍵を入力する際は、public.pem のヘッダーとフッターを削除し、改行をすべて削除して、残りの内容を「公開鍵」入力欄に貼り付けてください。

Logto Alipay Native コネクター設定

Alipay コンソールワークスペースの「マイアプリケーション」(我的应用) パネルで「Web & モバイルアプリ」(网页&移动应用) タブをクリックすると、すべてのアプリケーションの APPID を確認できます。
前述の手順 7 で、秘密鍵と公開鍵を含むキーペアをすでに生成しています。
Logto コネクター設定を入力します：
- appId フィールドには、手順 1 で取得した APPID を入力します。
- privateKey フィールドには、手順 2 で生成した秘密鍵ファイルの内容を入力します。必ずすべての改行を '\n' に置き換えてください。秘密鍵ファイルのヘッダーやフッターを削除する必要はありません。
- signType フィールドには、手順 7 の「公開鍵」署名モードに従い 'RSA2' を入力します。

設定タイプ

Name	Type	Enum values
appId	string	N/A
privateKey	string	N/A
signType	enum string	'RSA' / 'RSA2'

iOS

アプリに Logto iOS SDK を統合済みであることを前提とします。この場合、非常にシンプルで、Alipay SDK のドキュメントを読む必要もありません：

1. LogtoSocialPluginAlipay を Xcode プロジェクトに追加

フレームワークを追加します：

注記:

このプラグインには Alipay の「ミニマリスト SDK」(极简版 SDK) が含まれています。プラグインをインポートすれば、import AFServiceSDK を直接利用できます。

2. プラグインを LogtoClient の初期化オプションに追加

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

ここで callbackScheme は、カスタム URL スキームの一つで、アプリに遷移できるものです。

Android

アプリに Logto Android SDK を統合済みであることを前提とします。この場合、非常にシンプルで、Alipay SDK のドキュメントを読む必要もありません：

1. Alipay「ミニマリスト SDK」をダウンロードしてプロジェクトに追加

Logto 3rd-party Social SDKs から Alipay「ミニマリスト SDK」(极简版 SDK) をダウンロードし、プロジェクトの app/libs フォルダに配置します：

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

2. Alipay「ミニマリスト SDK」を依存関係に追加

build.gradle ファイルを開きます：

project-path/app/build.gradle

依存関係を追加します：

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

Alipay ネイティブコネクターのテスト

以上です。サインアップ・サインインでソーシャルコネクターを有効化するのを忘れずに。

Alipay ネイティブコネクターが有効化されると、アプリをビルドして動作を確認できます。

参考資料

Alipay ドキュメント - アクセス準備 - アプリの作成方法

Alipay ドキュメント - Web & モバイルアプリ - アプリの作成

はじめに​

Alipay 開発者アカウントの登録​

Alipay アプリの作成と設定​

Logto Alipay Native コネクター設定​

設定タイプ​

アプリで Alipay ネイティブサインインを有効化する​

iOS​

Android​

Alipay ネイティブコネクターのテスト​

参考資料​