Vinculação de Conta do Google com a virada de aplicativo baseada em OAuth

A vinculação de apps do Google baseada no OAuth permite que os usuários vinculem as contas deles com facilidade e rapidez no sistema de autenticação às Contas do Google. Se o app for instalado no smartphone do usuário quando ele iniciar o processo de vinculação da conta, ele será virado para o app e receberá a autorização do usuário.

Essa abordagem oferece um processo de vinculação mais rápido e fácil, já que o usuário não precisa inserir novamente o nome de usuário e a senha para autenticação. Em vez disso, o App Flip usa as credenciais da conta do usuário no aplicativo. Depois de vincular a Conta do Google ao aplicativo, o usuário pode aproveitar as integrações que você desenvolveu.

Você pode configurar o App Flip em apps iOS e Android.

Figura 1. Vinculação de conta no smartphone de um usuário com o App Flip.

Requisitos

Para implementar o App Flip, você precisa atender aos seguintes requisitos:

• É preciso ter um app Android ou iOS.
• É necessário ter, gerenciar e manter um servidor OAuth 2.0 compatível com o fluxo de código de autorização do OAuth 2.0.

Observação: verifique se a implementação ou o provedor de OAuth2 é compatível com o fluxo do código de autorização e os URLs de redirecionamento do aplicativo Flip e client_ids, conforme descrito nos nossos guias.

设计准则

本部分介绍了应用快速关联帐号关联同意屏幕的设计要求和建议。Google 调用您的应用后，应用会向用户显示同意屏幕。

要求

1. 您必须告知用户用户帐号正在与 Google 关联，而不是与特定 Google 产品（例如 Google Home 或 Google 助理）关联。

建议

建议您执行以下操作：

1. 显示 Google 的隐私权政策。在同意屏幕上添加指向 Google 隐私权政策的链接。

2. 要共享的数据。使用简洁明了的语言向用户说明他们的 Google 需要哪些数据以及为何收集这些数据。

3. 明确的号召性用语。在同意屏幕上提供明确的号召性用语，例如“同意并关联”。这是因为用户需要了解他们需要与 Google 共享哪些数据，才能关联帐号。

4. 能够取消。如果用户不关联，则可以提供返回或取消的方式。

5. 能够解除关联。为用户提供解除关联的机制，例如他们在平台上的帐号设置网址。或者，您也可以添加指向 Google 帐号的链接，以便用户可以管理关联的帐号。

6. 能够更改用户帐号。推荐一种供用户切换帐号的方法。如果用户往往拥有多个帐号，这一点尤其有用。

   • 如果用户必须关闭同意屏幕才能切换帐号，请向 Google 发送一个可恢复错误，以便用户通过 OAuth 关联和隐式流程登录所需帐号。

7. 添加徽标。在同意屏幕上显示公司徽标。 根据样式指南放置徽标。如果您还希望显示 Google 的徽标，请参阅徽标和商标。

图 2.帐号关联同意屏幕设计准则。

Implementar o App Flip nos seus apps nativos

Para implementar o App Flip, é necessário modificar o código de autorização do usuário no seu app para aceitar um link direto do Google.

Para oferecer compatibilidade com o App Flip no seu app Android, siga as instruções no Guia de implementação do Android.

Para oferecer compatibilidade com o App Flip no seu app iOS, siga as instruções no guia de implementação do iOS.

Testar a virada de apps

O App Flip pode ser simulado com apps de amostra e de teste antes de os apps de produção verificados e de um servidor OAuth 2.0 funcionarem.

Durante o App Flip, um app do Google primeiro abre seu app, que solicita uma resposta do código de autorização do servidor OAuth 2.0. Na etapa final, a resposta é retornada ao Google app.

Pré-requisitos

Para simular um app do Google e acionar a intent que inicia o app, faça o download e instale a ferramenta de teste do App Flip para Android e iOS.

Faça o download e instale a amostra do Virar aplicativo para Android e iOS para simular seu aplicativo e selecionar um tipo de resposta OAuth 2.0.

Sequência de testes

1. Abra a App Flip Test Tool.
2. Pressione Try Flip! para iniciar o app App Flip Sample.
3. Selecione uma resposta usando os botões de opção no app de exemplo.
4. Pressione Send para retornar uma resposta OAuth 2.0 simulada à ferramenta de teste.
5. Verifique as mensagens de registro da ferramenta de teste para ver um auth_code ou detalhes do erro.

Teste de produção

O App Flip pode ser testado em produção após a conclusão do registro e a implementação do servidor OAuth 2.0.

Recomenda-se ter uma única Conta do Google e um endereço de e-mail específico para tarefas para testes automatizados.

É possível ver o estado da vinculação de contas usando contas vinculadas ao fazer login como titular da Conta do Google. Também é possível desvincular as contas entre testes repetidos aqui.

Como alternativa, é possível implementar RISC para desvincular e notificar o Google de maneira programática sobre a mudança.