Configurar login social com Alipay (Nativo)

O conector oficial do Logto para login social do Alipay em aplicativos nativos para dispositivos móveis.

dica

Neste guia, assumimos que você tem conhecimento básico sobre Conectores (Connectors) do Logto. Se não tiver, confira o guia Configurar conectores para começar.

Introdução

O conector Alipay Nativo funciona em estreita colaboração com o Logto SDK em plataformas móveis. Ele aproveita o fluxo de autenticação OAuth 2.0 do Alipay e permite que os usuários do Alipay façam login em outros aplicativos usando perfis públicos de usuários do Alipay sem passar por um processo de registro complicado.

Registrar conta de desenvolvedor Alipay

Registre uma conta de desenvolvedor Alipay se você ainda não tiver uma.

Criar e configurar aplicativo Alipay

1. Faça login no console do Alipay com a conta que você acabou de registrar.
2. Vá para a aba "Web & Mobile Apps" (网页&移动应用) no painel "My Application" (我的应用).
3. Clique no botão "Create an App" (立即创建) para começar a configurar seu aplicativo.
4. Nomeie seu aplicativo em "Application Name" (应用名称) seguindo as convenções de nomenclatura e faça upload do seu "Application Icon" (应用图标), certifique-se de escolher "mobile application" (移动应用) como "App type" (应用类型). Para construir um aplicativo iOS, é necessário um "Bundle ID" exclusivo. Além disso, "application signature" (应用签名) e "application package name" (应用包名) são necessários para aplicativos Android.
5. Após terminar de criar o aplicativo, chegamos à página de Visão Geral, onde devemos clicar em "add ability" (添加能力) para adicionar "Third-party application authorization" (第三方应用授权), "Get member information" (获取会员信息) e "App Alipay login" (App 支付宝登录) antes de habilitar o login do Alipay.
6. Vá para o Centro de Atendimento ao Cliente do Alipay e faça login com a conta de desenvolvedor Alipay. Clique em "Account Center" (账号中心) na barra superior e vá para "APPID binding" (APPID 绑定), cuja entrada pode ser encontrada na parte inferior da barra lateral. "Add binding" (添加绑定) digitando o APPID do aplicativo móvel que você acabou de criar no passo 4.
7. Clique no botão "Sign" de "App Alipay login" e conclua o processo de assinatura seguindo o guia. Após concluir esta etapa, espera-se que as habilidades que você acabou de adicionar no passo 5 entrem em ação.
8. Volte para a página do console da plataforma aberta do Alipay e você encontrará "Interface signing method" (接口加签方式（密钥/证书）) na seção "development information" (开发信息). Clique no botão "set up" (设置) e você estará em uma página de configuração do método de assinatura. "Public Key" (公钥) é o modo de assinatura preferido, e preencha os conteúdos do arquivo de chave pública que você gerou na caixa de entrada de texto.
9. Configure "Authorization Redirect URI" (授权回调地址) clicando no botão "set up" (设置) na parte inferior da página do console do Alipay. ${your_logto_origin}/callback/${connector_id} é o URI de redirecionamento padrão usado no núcleo do Logto. O connector_id pode ser encontrado na barra superior da página de detalhes do conector do Logto Admin Console.
10. Após concluir todas essas etapas, volte para o canto superior direito da página do console do Alipay e clique em "Submit for review" (提交审核). Uma vez que a revisão seja aprovada, você estará pronto para um fluxo de login suave com o Alipay.

ℹ️ Nota

Você pode usar openssl para gerar pares de chaves em sua máquina local executando o seguinte trecho de código no terminal.

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

Ao preencher a chave pública no site de configuração do aplicativo Alipay, você precisa remover o cabeçalho e o rodapé de public.pem, excluir todos os caracteres de nova linha e colar o restante do conteúdo na caixa de entrada de texto para "public key".

Configurar as configurações do conector Logto Alipay Nativo

1. No espaço de trabalho do console Alipay, vá para o painel "My application" (我的应用) e clique na aba "Web & Mobile Apps" (网页&移动应用), você pode encontrar o APPID de todos os aplicativos.
2. No passo 7 da parte anterior, você já gerou um par de chaves incluindo uma chave privada e uma chave pública.
3. Preencha as configurações do conector Logto:
   • Preencha o campo appId com o APPID que você obteve no passo 1.
   • Preencha o campo privateKey com o conteúdo do arquivo de chave privada mencionado no passo 2. Certifique-se de usar '\n' para substituir todos os caracteres de nova linha. Você não precisa remover o cabeçalho e o rodapé no arquivo de chave privada.
   • Preencha o campo signType com 'RSA2' devido ao modo de assinatura Public key que escolhemos no passo 7 de "Criar e Configurar Aplicativos Alipay".

Tipos de configuração

Nome	Tipo	Valores Enum
appId	string	N/A
privateKey	string	N/A
signType	enum string	'RSA' | 'RSA2'

Habilitar login nativo do Alipay no seu aplicativo

iOS

Assumimos que você integrou o Logto iOS SDK no seu aplicativo. Nesse caso, as coisas são bem simples, e você nem precisa ler a documentação do SDK do Alipay:

1. Adicione LogtoSocialPluginAlipay ao seu projeto Xcode

Adicione o framework:

ℹ️ Nota

O plugin inclui o "minimalist SDK" do Alipay (极简版 SDK). Você pode usar diretamente import AFServiceSDK uma vez que o plugin seja importado.

2. Adicione o plugin às opções de inicialização do seu LogtoClient

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

Onde callbackScheme é um dos custom URL Schemes que pode navegar para o seu aplicativo.

Android

Assumimos que você integrou o Logto Android SDK no seu aplicativo. Nesse caso, as coisas são bem simples, e você nem precisa ler a documentação do SDK do Alipay:

1. Baixe o "minimalist SDK" do Alipay e adicione-o ao seu projeto

Baixe o "minimalist SDK" do Alipay (极简版 SDK) de Logto 3rd-party Social SDKs para a pasta app/libs do seu projeto:

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

2. Adicione o "minimalist SDK" do Alipay como uma dependência

Abra seu arquivo build.gradle:

project-path/app/build.gradle

Adicione a dependência:

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

Testar o conector nativo do Alipay

É isso. Não se esqueça de Habilitar conector social na experiência de login.

Uma vez que o conector nativo do Alipay esteja habilitado, você pode construir e executar seu aplicativo para ver se funciona.

Referências

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