Como a experiência de login é a primeira interação que um usuário pode ter com seu complemento, é importante que ele possa concluir o fluxo da forma mais contínua possível. Leia as seções abaixo para conhecer as várias APIs de login, o parâmetro de consulta relacionado a login, como lidar com bloqueadores de pop-up e um plano de teste que você pode usar durante o desenvolvimento para garantir que está seguindo as práticas recomendadas.
Detalhes da implementação do SSO
O OAuth 2.0 do Google é compatível com muitas pilhas do OAuth 2.0. É altamente recomendável implementar a autorização do lado do servidor, já que essa é a opção de segurança mais alta e aceita o uso dos parâmetros de consulta do iframe.
Consulte as orientações técnicas no site do Google Identity ao implementar o Login do Google. Siga as diretrizes da promoção de marca de login do Google. Os arquivos Sketch, SVG e EPS são fornecidos para download.
Testes de login
Use o plano de teste de complementos para verificar se ele atende aos padrões necessários e é capaz de lidar com casos extremos conhecidos antes de enviá-lo para revisão. Esses testes refletem com precisão a lista de verificação de requisitos do complemento do Google Sala de Aula e dão instruções detalhadas sobre como verificar se o complemento atende a esses requisitos. Esses são os mesmos testes usados para testar o aplicativo durante a publicação.
Parâmetros de consulta de login
O Google Sala de Aula oferece o parâmetro de consulta login_hint
para facilitar o login repetido. Consulte a seção de parâmetros relacionados ao login da página de parâmetros de consulta do iframe para mais informações. O exemplo de código pode ser encontrado no
tutorial sobre processar visitas repetidas dos nossos tutoriais para desenvolvedores.
Gerenciar bloqueadores de pop-up
O login no complemento é facilitado pela janela da caixa de diálogo de login. Ela exibe a tela do seletor de contas e permite que o usuário conceda permissões do OAuth. O bloqueador de pop-ups de um usuário final pode impedi-lo de concluir o fluxo de login.
Figura 1. Exemplo de uma tela do seletor de contas.
Para resolver esse problema, forneça ao usuário final um botão para clicar e ignorar o bloqueador de pop-ups. Essa interação permite que a caixa de diálogo de login seja mostrada para que o usuário final possa continuar com o fluxo de login. Verifique se o botão fornecido segue as diretrizes da promoção de marca de login.
Siga as instruções de login dos nossos tutoriais para desenvolvedores e implemente um botão de login com a marca do Google que pode ser clicado para acionar a caixa de diálogo de login.
Login com várias contas
Um navegador com várias contas conectadas ao mesmo tempo pode interromper o fluxo do usuário do complemento. Os usuários finais podem sair de todas as Contas do Google no navegador atual ou abrir o Google Sala de Aula em uma janela anônima do Chrome antes de fazer login com a conta correta e repetir a operação.
Se um usuário incorreto fizer login no complemento devido ao problema de login múltiplo,
suas chamadas para a API de complementos do Google Sala de Aula podem falhar com um
erro InvalidAddOnToken
. Se você receber esse erro, instrua
o usuário a sair de todas as outras contas no navegador ou abrir
o Google Sala de Aula em uma janela anônima do Chrome.