設定 Alipay 社交登入 (Native)

Logto 官方連接器，用於行動裝置原生應用程式中的 Alipay 社交登入。

提示:

本指南假設你已對 Logto 連接器 (Connectors) 有基本了解。若不熟悉，請參閱連接器 (Connectors) 指南以開始使用。

開始使用

Alipay Native 連接器與 Logto SDK 在行動平台上緊密合作。它利用 Alipay 的 OAuth 2.0 驗證流程，讓 Alipay 使用者可以使用公開的 Alipay 使用者資料登入其他應用程式，而無需經過繁瑣的註冊過程。

註冊 Alipay 開發者帳戶

註冊 Alipay 開發者帳戶（如果你還沒有的話）。

建立並配置 Alipay 應用程式

使用剛註冊的帳戶登入 Alipay 控制台。
前往「我的應用」(我的应用) 面板中的「網頁 & 移動應用」(网页&移动应用) 標籤。
點擊「立即創建」(立即创建) 按鈕開始配置你的應用程式。
在「應用名稱」(应用名称) 中命名你的應用程式，並上傳「應用圖標」(应用图标)，確保選擇「移動應用」(移动应用) 作為「應用類型」(应用类型)。對於 iOS 應用程式，需要一個唯一的「Bundle ID」。此外，Android 應用程式需要「應用簽名」(应用签名) 和「應用包名」(应用包名)。
完成應用程式創建後，進入概覽頁面，點擊「添加能力」(添加能力) 以添加「第三方應用授權」(第三方应用授权)、「獲取會員信息」(获取会员信息) 和「App 支付寶登入」(App 支付宝登录)，然後啟用 Alipay 登入。
前往 Alipay 客戶中心，使用 Alipay 開發者帳戶登入。點擊頂部欄的「帳戶中心」(账号中心)，然後前往側邊欄底部的「APPID 綁定」(APPID 绑定)。輸入你在步驟 4 中創建的移動應用程式的 APPID，然後「添加綁定」(添加绑定)。
點擊「App 支付寶登入」的「簽署」按鈕，並按照指南完成簽署過程。完成此步驟後，你應該會看到在步驟 5 中添加的能力生效。
返回 Alipay 開放平台控制台頁面，你可以在「開發信息」(开发信息) 部分找到「接口加簽方式（密鑰/證書）」(接口加签方式（密钥/证书）)。點擊「設置」(设置) 按鈕，進入設置加簽方式的頁面。「公鑰」(公钥) 是首選的加簽模式，並在文本輸入框中填入你生成的公鑰文件的內容。
點擊 Alipay 控制台頁面底部的「設置」(设置) 按鈕，設置「授權回調地址」(授权回调地址)。${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 控制台工作區中，前往「我的應用」(我的应用) 面板，點擊「網頁 & 移動應用」(网页&移动应用) 標籤，你可以找到所有應用程式的 APPID。
在前一部分的步驟 7 中，你已經生成了一對密鑰，包括私鑰和公鑰。
填寫 Logto 連接器設置：
- 在 appId 欄位中填入你從步驟 1 獲得的 APPID。
- 在 privateKey 欄位中填入步驟 2 中提到的私鑰文件的內容。請確保使用 '\n' 替換所有換行符。你不需要移除私鑰文件中的標頭和尾部。
- 在 signType 欄位中填入 'RSA2'，因為我們在「建立並配置 Alipay 應用程式」的步驟 7 中選擇了 公鑰 加簽模式。

配置類型

名稱	類型	枚舉值
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 Schemes 之一。

Android

我們假設你已經在應用程式中整合了 Logto Android SDK。在這種情況下，事情非常簡單，你甚至不需要閱讀 Alipay SDK 文檔：

1. 下載 Alipay「極簡版 SDK」並將其添加到你的專案中

從 Logto 第三方社交 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 文檔 - 網頁 & 移動應用 - 創建應用程式

開始使用​

註冊 Alipay 開發者帳戶​

建立並配置 Alipay 應用程式​

設定 Logto Alipay Native 連接器設置​

配置類型​

在你的應用程式中啟用 Alipay 原生登入​

iOS​

Android​

測試 Alipay 原生連接器​

參考資料​