
Console Google
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).
Esses campos são gerados pelo console google, esse documento tem o objetivo de mostrar como gerar cada requisito.
Gerar requisitos pelo console google
Passo 1: Criar um projeto no Google Console
- Vá ao Google Developers Console
- Clique em “Criar Projeto”, nomeie-o e clique em “Criar”.
Passo 2: Criar uma conta de serviço
- Vá para “APIs e Serviços” > “Credenciais” e clique em “Criar Credenciais” > “Conta de Serviço”.
- Nomeie a conta e clique em “Concluído”.
Passo 3: Habilitar a delegação em toda a organização
- Ao criar a conta de serviço, habilite a “Delegação em toda a organização” (Domain-wide Delegation).
- Isso permite que a conta de serviço atue em nome de usuários dentro do domínio do Google Workspace.
Passo 4: Gerar chave privada
- Na aba de “Credenciais”, clique na conta de serviço criada e em “Adicionar chave”.
- Escolha o formato p12 (mais recomendado) e faça o download.
Passo 5: Configurar permissões no G Suite
- Entre como administrador do G Suite e autorize o cliente OAuth (ID da conta de serviço) para agir em nome dos usuários.
- Isso é feito no Admin Console do G Suite > “Segurança” > “Controles de API” > “Gerenciar delegação de acesso de cliente”.
Passo 6: Utilizar a conta de serviço
- No seu código, use a conta de serviço gerada para autenticar e enviar e-mails via Gmail API.
Microsoft (Office 365 via OAuth)
Passo 1: Criar aplicativo no Azure AD
- Vá ao portal do Azure.
- Navegue até “Azure Active Directory” > “Registros de aplicativo” e clique em “Novo registro”.
- Nomeie o aplicativo, escolha “Contas neste diretório” e clique em “Registrar”.
Passo 2: Configurar permissões
- Vá em “Permissões de API” e adicione permissões para enviar e-mails via Exchange Online, como
Mail.Send
oufull_access_as_app
para acesso completo.
Passo 3: Gerar ID de cliente e segredo do cliente
- No aplicativo criado, vá até “Certificados e Segredos” e clique em “Novo segredo do cliente”.
- Salve o valor gerado (este é o segredo do cliente).
- O ID do aplicativo pode ser encontrado na página de “Visão Geral”.
Passo 4: Obter consentimento do administrador
- Se o seu aplicativo for usado em uma organização, você precisará do consentimento do administrador do Office 365.
- Isso pode ser feito através de um link especial de consentimento que o administrador deve aprovar.
Passo 5: Utilizar OAuth no código
- No seu código, use o ID do cliente, segredo, e outros dados da API para gerar o token de acesso necessário para autenticação e envio de e-mails via Office 365 API.
Labels