Configuração do oAuth no console Google/microsoft

Requisitos oAuth

Em algumas ferramentas que o OAuth foi implementado são exigidos alguns pré-requisitos essenciais para seu funcionamento, são eles conta serviço , ID de serviço e o arquivo da chave privada(arquivo p12), para provedor Google, para provedores microsoft temos os seguintes requisitos: ID do cliente e segredo do cliente.

Os requisitos podem ser gerados pelo console Google quando o e-mail usado for um e-mail do provedor e também pelo portal da Azure quando o e-mail for microsoft.

Console Google

No Google Cloud Console, o OAuth é configurado para autenticar e autorizar usuários ou sistemas em APIs do Google ou em serviços de terceiros. Aqui estão os passos principais para configurar o OAuth no Google Cloud Console:

Acessar o Google Cloud Console

Navegue para Google Cloud Console.
Se ainda não estiver logado, faça login com sua Conta Google.

Criar um Novo Projeto

No painel do Google Cloud Console, clique no ícone de seleção de projetos no topo da página.
Clique em Novo Projeto.
Nomeie o projeto (por exemplo, "OAuth Project").
Clique em Criar.

Habilitar a API Necessária

No menu lateral, vá até APIs e serviços ativados > +Ativar APIs e serviços.

Busque pela API que sua aplicação precisa usar (por exemplo, Google Drive API ou Gmail API).

Clique na API correspondente e, na página da API, clique em Ativar.

Configurar a Tela de Permissão OAuth

No menu lateral, clique em API e Serviços > Tela de permissão OAuth.
Escolha entre os tipos de usuários:
- Interno: Apenas disponível para usuários do Google Workspace dentro da sua organização.
- Externo: Disponível para qualquer pessoa com uma Conta Google.
Complete os detalhes necessários:Clique em Salvar e Continuar após preencher todos os campos.
- Nome da Aplicação.
- E-mail de Suporte.
- Domínios Autorizados (URLs da sua aplicação que vão interagir com o OAuth).
- Escopos OAuth: Selecione os escopos que você deseja solicitar dos usuários. Isso define quais permissões você está pedindo (exemplo: acesso ao Gmail).

Criar Credenciais OAuth

No menu lateral, vá para API e Serviços > Credenciais.
Clique no botão Criar Credenciais e selecione ID do Cliente OAuth.

Escolha o tipo de aplicativo:
- Aplicativo Web: Se a sua aplicação for uma aplicação web.
- Outros: Se for um serviço ou aplicação desktop.
Se for Aplicativo Web, forneça o(s) URI(s) de redirecionamento autorizados:
- O URI de redirecionamento é o URL onde o Google redirecionará o usuário após a autenticação.
Clique em Criar.

Obter o ID do Cliente e Chave Secreta

Após a criação das credenciais, você verá uma tela com o ID do Cliente e a Chave Secreta.
Copie essas credenciais ou faça o download delas para usar no código da sua aplicação.

Gerar e Configurar o Token de Acesso

Use o ID do Cliente e a Chave Secreta para redirecionar os usuários ao endpoint de autenticação do Google e obter o token de autorização.
Troque o token de autorização por um token de acesso. Esse token será usado para fazer requisições às APIs autorizadas.

Usar o Token de Acesso

No código da sua aplicação, use o token de acesso para fazer chamadas autenticadas à API ativada (por exemplo, Gmail API, Drive API, etc.).
O token de atualização também será gerado, permitindo que você obtenha novos tokens de acesso sem que o usuário precise autenticar novamente.

Criar uma Conta de Serviço

Se você precisa de uma conta de serviço para atuar em nome de usuários dentro de um domínio Google Workspace, siga estes passos adicionais:
- Vá para API e Serviços > Credenciais e clique em Criar Credenciais > Conta de Serviço.
- Nomeie a conta e conclua o processo de criação.
- Ative a delegação em toda a organização (Domain-wide Delegation) se necessário, para que a conta de serviço possa atuar em nome de usuários dentro da organização.
- Gere a chave privada (formato JSON ou p12) e a use no seu código para autenticação.

Portal Azure

Para gerar os requisitos para o OAuth no provedor Microsoft (Azure Active Directory), você precisará configurar uma aplicação no Azure Portal e seguir alguns passos similares aos usados no Google Cloud Console. Aqui está o passo a passo:

Acessar o Azure Portal

Navegue para Azure Portal.
Faça login com sua conta Microsoft.

Criar um Novo Diretório ou Selecionar o Existente

No painel do Azure, selecione Azure Active Directory no menu lateral.
Se necessário, crie um novo diretório ou selecione um já existente.

Registrar um Aplicativo no Azure Active Directory

No menu lateral do Azure Active Directory, clique em Registros de Aplicativos.
Clique em Novo Registro.
Preencha as informações necessárias:
- Nome da Aplicação: Dê um nome à aplicação (ex.: "OAuth App").
- Tipos de Conta Suportados: Escolha se o aplicativo será para contas da sua organização (apenas) ou para qualquer conta Microsoft (multi-tenant).
- URI de Redirecionamento: Informe o URI de redirecionamento onde o usuário será enviado após a autenticação (ex.: https://minha-aplicacao.com/oauth2callback).
Clique em Registrar.

Obter o ID do Aplicativo (Client ID)

Após registrar o aplicativo, vá para a página de Visão Geral.
O ID do Aplicativo (Client ID) será exibido, que é o equivalente ao "ID do Cliente" no Google.
Anote esse valor, pois será necessário para implementar o OAuth no código da sua aplicação.

Criar um Segredo de Cliente

No menu lateral do registro da aplicação, clique em Certificados e Segredos.
Na seção de Segredos de Cliente, clique em Novo Segredo de Cliente.
Defina uma descrição e a validade do segredo (1 ano, 2 anos, etc.).
Após a criação, o Segredo de Cliente (Client Secret) será exibido apenas uma vez. Copie-o imediatamente, pois você precisará dele no código da aplicação.

Configurar Permissões de API (Escopos)

No menu lateral, clique em Permissões de API.
Clique em Adicionar uma Permissão.
Selecione Microsoft Graph (ou outra API que sua aplicação precise acessar).
Escolha as permissões necessárias (ex.: "User.Read" para ler o perfil do usuário).
Defina se essas permissões serão delegadas (agindo em nome do usuário autenticado) ou permissões de aplicativo (agindo como a própria aplicação, geralmente usado com contas de serviço).
Após selecionar as permissões, clique em Adicionar Permissões.

Conceder Consentimento Administrativo (se necessário)

Se sua aplicação precisar de permissões que requerem consentimento de administrador (como permissões para toda a organização), você precisará conceder esse consentimento.
Clique em Conceder Consentimento Administrativo para as permissões definidas.

Configurar o URI de Redirecionamento

Certifique-se de que o URI de Redirecionamento está configurado corretamente para receber o token de autorização.
Esse URI deve ser idêntico ao que foi registrado na etapa de registro do aplicativo.

Testar o Fluxo OAuth

Agora, você pode começar a testar o fluxo OAuth.
Redirecione os usuários para o URL de autenticação OAuth da Microsoft: https://login.microsoftonline.com/{tenant-id}/oauth2/v2.0/authorize
- Substitua {tenant-id} pelo ID do diretório (disponível na página "Visão Geral" do Azure AD).
- Inclua no URL os parâmetros necessários, como o Client ID, escopos e o URI de Redirecionamento.
O usuário será redirecionado para a tela de login da Microsoft e, após a autenticação, o código de autorização será enviado para o URI de redirecionamento.
Esse código de autorização pode então ser trocado por um token de acesso no endpoint de token da Microsoft: https://login.microsoftonline.com/{tenant-id}/oauth2/v2.0/token

Usar o Token de Acesso

Com o token de acesso obtido, você pode fazer chamadas autenticadas às APIs que você configurou permissões, como o Microsoft Graph.
Se necessário, use o token de atualização para renovar o token de acesso sem pedir uma nova autenticação ao usuário.