Configurar login social com Alipay (Nativo)

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

dica:

Este guia assume que você tem um entendimento básico dos Conectores (Connectors) do Logto. Para aqueles que não estão familiarizados, consulte o guia de Conectores para começar.

Primeiros passos

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

Registrar conta de desenvolvedor Alipay

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

Criar e configurar aplicativo Alipay

Faça login no console do Alipay com a conta que você acabou de registrar.
Vá para a guia "Web & Mobile Apps" (网页&移动应用) no painel "My Application" (我的应用).
Clique no botão "Create an App" (立即创建) para começar a configurar seu aplicativo.
Nomeie seu aplicativo em "Application Name" (应用名称) seguindo as convenções de nomenclatura e faça upload do "Application Icon" (应用图标), certifique-se de escolher "mobile application" (移动应用) como "App type" (应用类型). Para construir um aplicativo iOS, um "Bundle ID" exclusivo é necessário. Além disso, "application signature" (应用签名) e "application package name" (应用包名) são necessários para aplicativos Android.
Após terminar de criar o aplicativo, vá para a página Overview, onde você deve 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.
Vá para o Alipay Customer Center 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.
Clique no botão "Sign" de "App Alipay login" e conclua o processo de assinatura seguindo o guia. Após concluir esta etapa, você deverá ver as habilidades que acabou de adicionar no passo 5 funcionando.
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 para configurar o método de assinatura. "Public Key" (公钥) é o modo de assinatura preferido, e preencha o conteúdo do arquivo de chave pública que você gerou na caixa de texto.
Configure o "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 Logto core. O connector_id pode ser encontrado na barra superior da página de detalhes do conector no Logto Admin Console.
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 Alipay suave.

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é do public.pem, excluir todos os caracteres de nova linha e colar o restante do conteúdo na caixa de texto para "public key".

Configurar as definições do conector Logto Alipay Native

No workspace do console Alipay, vá para o painel "My application" (我的应用) e clique na guia "Web & Mobile Apps" (网页&移动应用), onde você pode encontrar o APPID de todos os aplicativos.
No passo 7 da parte anterior, você já gerou um par de chaves incluindo uma chave privada e uma chave pública.
Preencha as configurações do conector Logto:
- Preencha o campo appId com o APPID obtido no passo 1.
- Preencha o campo privateKey com o conteúdo do arquivo de chave privada mencionado no passo 2. Por favor, CERTIFIQUE-SE de usar '\n' para substituir todos os caracteres de nova linha. Não é necessário 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 escolhido 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'

iOS

Assumimos que você já integrou o Logto iOS SDK em 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" (极简版 SDK) do Alipay. Você pode usar diretamente import AFServiceSDK após importar o plugin.

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 até seu aplicativo.

Android

Assumimos que você já integrou o Logto Android SDK em 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 ao seu projeto

Baixe o "minimalist SDK" do Alipay (极简版 SDK) em 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 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 no cadastro e login.

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

Referências

Documentação Alipay - Preparação de acesso - Como criar um aplicativo

Documentação Alipay - Web & Mobile Apps - Criar um aplicativo

Primeiros passos​

Registrar conta de desenvolvedor Alipay​

Criar e configurar aplicativo Alipay​

Configurar as definições do conector Logto Alipay Native​

Tipos de configuração​

Habilitar login nativo do Alipay em seu aplicativo​

iOS​

Android​

Testar o conector nativo do Alipay​

Referências​