O Google OAuth 2.0 é um produto gratuito e de código aberto que oferece uma solução de identidade federada para conectar usuários a aplicativos de vários tipos, tanto dentro quanto fora das instituições. A estrutura flexível de provedor de módulo de SSO da plataforma de vídeo foi projetada para oferecer suporte a uma ampla variedade de soluções de identidade, permitindo a integração completa do Google OAuth 2.0 à sua infraestrutura.
Este documento tem como objetivo orientar os usuários sobre como integrar a plataforma de vídeo, como aplicativo, ao sistema OAuth 2.0 da API do Google. Depois de configurado, os usuários poderão dar consentimento e autorizar a plataforma de vídeo a acessar as informações básicas de sua conta do Google para fazer login na plataforma de vídeo como usuário novo ou existente.
Configuração
A configuração envolve adicionar um URI de redirecionamento da plataforma de vídeo ao seu projeto no Console de APIs do Google e, em seguida, obter o arquivo de metadados JSON, que contém todas as informações necessárias para configurar o lado da plataforma de vídeo. Com o arquivo JSON, configurar a plataforma de vídeo consiste basicamente em informar alguns parâmetros e fazer um login de teste. Depois de verificar que o SSO está funcionando, a etapa final é ativar a autenticação para todos os usuários da sua instituição.
Em algumas etapas, <organization> deve ser substituído pelo DNS curinga da organização associada à plataforma de vídeo. Por exemplo, para “https://hudson.yuja.com”, <organization> seria substituído por “hudson”.
Adicionar um URI de redirecionamento da plataforma de vídeo ao Console de APIs do Google
Para obter instruções sobre como criar projetos no Console de APIs do Google, consulte: https://developers.google.com/identity/sign-in/web/devconsole-project
- No Console de APIs do Google, escolha ou crie um projeto associado à plataforma de vídeo. Adicione o seguinte valor a URIs de redirecionamento autorizados: https://<organization>.yuja.com/D/OauthAuthentication
- Baixe o arquivo de metadados JSON no Console de APIs do Google. Ele contém os parâmetros necessários para configurar a YuJa.
Configurar a integração com o Google OAuth na plataforma de vídeo
- Faça login na sua Zona da YuJa como Gerente de TI e acesse Painel de administrador → Integrações.
- Em Selecione uma API para configurar, selecione SSO - Google OAuth 2.0.
- Insira os seguintes parâmetros de configuração:
Parâmetro
Valor
ID do cliente
O ID do cliente obtido no Console de APIs do Google.
https://console.developers.google.com
Também encontrado nos dados JSON do seu projeto, como o valor do atributo “client_id”.
Segredo do cliente
O segredo do cliente obtido no Console de APIs do Google. https://console.developers.google.com
Também encontrado nos dados JSON do seu projeto, como o valor do atributo “client_secret”.
URI de autenticação
Encontrado nos dados JSON do seu projeto, como o valor do atributo “auth_uri”.
URI de token
Encontrado nos dados JSON do seu projeto, como o valor do atributo “token_uri”.
- Clique em Criar configuração.
- Clique em Ok na caixa de diálogo de confirmação.
- Para testar se a configuração está correta, clique em Testar login OAuth. Isso deve abrir uma nova guia e redirecionar para o Google, que cuida da autenticação e do consentimento do usuário.
- Se nenhum usuário do Google estiver conectado no momento, insira credenciais de login válidas e clique em Login. Caso contrário, escolha uma conta do Google.
- Clique em Permitir para dar à plataforma de vídeo o consentimento para acessar as informações básicas do usuário.
- Você deve ser redirecionado de volta à plataforma de vídeo, conectado como um novo usuário.
Fazer login como um novo usuário pode desconectar a conta original. Se isso acontecer, saia da conta recém-criada, faça login novamente como Gerente de TI e volte para Painel de administrador → Integrações → SSO – Google OAuth 2.0.
- Depois de verificar que o SSO por OAuth funciona, você pode ativar o novo esquema de autenticação para a sua organização clicando em Ativar.
Ative o novo esquema de autenticação somente depois de realizar um login de teste com sucesso e quando estiver pronto para disponibilizá-lo a todos os usuários da sua organização.
(Opcional) Integração dupla com LTI
Se a sua organização habilitou tanto o LTI quanto o acesso por SSO do Google OAuth, você pode vincular as duas integrações. Por padrão, um usuário que faz login por LTI e por OAuth recebe uma conta separada da plataforma de vídeo para cada login. Se o seu provedor de LTI estiver configurado para autenticar os usuários com as credenciais da conta do Google, é possível vincular as duas contas, pois o provedor de LTI fornecerá à plataforma de vídeo um identificador exclusivo do usuário no sistema OAuth.
- Configure o seu LMS para passar um parâmetro LTI personalizado chamado lis_person_sourcedid, que contém o valor de SSO usado para correspondência. Pode ser um e-mail, um ID de funcionário ou outro campo. A plataforma de vídeo usará esse recurso para vincular os dois métodos de login à mesma conta.
- Obtenha o nome do atributo cujo valor corresponde ao identificador exclusivo usado pelo provedor de LTI. Os valores possíveis são determinados pela API do Google. Como a plataforma de vídeo solicita apenas as informações básicas de perfil de um usuário específico, o único atributo válido seria 'email'.
- Insira esse valor em Painel de administrador → Integrações → Selecione uma API para configurar → SSO - Google OAuth 2.0 → Atributo de ligação e selecione Salvar integração cruzada.
- Agora, ao fazer login pela primeira vez via Google OAuth, o sistema da plataforma de vídeo procurará um vínculo com uma conta LTI usando o valor do atributo de ligação. Se encontrar, a conta do Google será vinculada à conta existente. Caso contrário, uma nova conta será provisionada normalmente. Todos os logins após o primeiro continuarão vinculados à conta da plataforma de vídeo criada ou encontrada no primeiro login.
Uso
Depois que o Console de APIs do Google e a plataforma de vídeo estiverem configurados corretamente e o SSO por OAuth tiver sido ativado, os usuários que acessarem o domínio da plataforma de vídeo da sua organização serão autenticados pelo Google OAuth 2.0, em vez do login padrão da plataforma de vídeo. É fácil verificar se tudo foi feito corretamente seguindo as etapas abaixo:
- Acesse a Zona da plataforma de vídeo da organização.
- Pressione Login. Isso deve redirecionar o usuário ao Google, onde ele selecionará a conta a ser usada e dará consentimento para que a plataforma de vídeo acesse suas informações básicas.
- Depois de autorizado, o usuário deve ser redirecionado de volta à plataforma de vídeo e estar conectado com sucesso.