Copiar página

Não está autenticado. Qualquer mudança que fizer será assinalada como anónimo. You may want to Log In if you already have an account. Também pode Inscrever-se para obter uma nova conta.

<h2>Requisitos OAuth (Web e Desktop)</h2>Em algumas ferramentas que o OAuth foi implementado, especialmente aquelas que são a nível de servidor, será necessário criar e configurar uma &quot;conta de serviço&quot;. O processo para configurar uma aplicação web e uma aplicação desktop é parecido, com exceção de algumas etapas, que serão explicitamente diferenciadas neste manual. <img class="editor-inline-macro" src="/plugins/servlet/confluence/placeholder/macro?definition=e3RvY30&amp;locale=pt_PT&amp;version=2" data-macro-name="toc"> Portal Azure - Microsoft (Web e Desktop)<hr /> 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:<h3>Acessar o Azure Portal</h3><ul><li>Navegue para <a href="https://portal.azure.com/">Azure Portal</a>.</li><li>Faça login com sua conta Microsoft.</li></ul><h3>Criar um Novo Diretório ou Selecionar o Existente</h3><ul><li>No painel do Azure, selecione Azure Active Directory no menu lateral.</li><li>Se necessário, crie um novo diretório ou selecione um já existente.</li></ul><h3>Registrar um Aplicativo no Azure Active Directory</h3><ul><li>No menu lateral do Azure Active Directory, clique em Registros de Aplicativos.</li><li>Clique em Novo Registro.</li></ul><img class="confluence-embedded-image" width="500" src="/plugins/servlet/confluence/placeholder/unknown-attachment?locale=pt_PT&amp;version=2" title="image2024-9-16 9:12:33.png" data-resource-id="PHJpOmF0dGFjaG1lbnQgcmk6ZmlsZW5hbWU9ImltYWdlMjAyNC05LTE2IDk6MTI6MzMucG5nIiAvPg=="><ul><li>Preencha as informações necessárias:<ul><li>Nome da Aplicação</li><li>Tipos de Conta Suportados</li><li>URI de Redirecionamento</li></ul></li><li>Clique em Registrar.</li></ul><h3>Obter o ID do Aplicativo (Client ID)</h3><ul><li>Após registrar o aplicativo, vá para a página de Visão Geral.</li><li>O ID do Aplicativo (Client ID) será exibido, que é o equivalente ao &quot;ID do Cliente&quot; no Google.</li><li>Anote esse valor, pois será necessário para implementar o OAuth no código da sua aplicação.</li></ul><img class="confluence-embedded-image" width="500" src="/plugins/servlet/confluence/placeholder/unknown-attachment?locale=pt_PT&amp;version=2" title="image2024-9-16 10:11:5.png" data-resource-id="PHJpOmF0dGFjaG1lbnQgcmk6ZmlsZW5hbWU9ImltYWdlMjAyNC05LTE2IDEwOjExOjUucG5nIiAvPg=="><h3>Criar um Segredo de Cliente </h3><ul><li>No menu lateral do registro da aplicação, clique em Certificados e Segredos.</li><li>Na seção de Segredos de Cliente, clique em Novo Segredo de Cliente.</li></ul><img class="confluence-embedded-image" width="500" src="/plugins/servlet/confluence/placeholder/unknown-attachment?locale=pt_PT&amp;version=2" title="image2024-9-16 10:7:20.png" data-resource-id="PHJpOmF0dGFjaG1lbnQgcmk6ZmlsZW5hbWU9ImltYWdlMjAyNC05LTE2IDEwOjc6MjAucG5nIiAvPg=="><ul><li>Defina uma descrição e a validade do segredo (1 ano, 2 anos, etc.).</li><li>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.</li></ul><h3>Configurar Permissões de API (Escopos)</h3><ul><li>No menu lateral, clique em Permissões de API.</li><li>Clique em Adicionar uma Permissão.</li><li>Selecione Microsoft Graph (ou outra API que sua aplicação precise acessar).</li><li>Escolha as permissões necessárias (ex.: &quot;User.Read&quot; para ler o perfil do usuário).</li><li>Defina se essas permissões serão delegadas ou permissões de aplicativo.</li><li>Após selecionar as permissões, clique em Adicionar Permissões.</li></ul><img class="confluence-embedded-image" width="500" src="/plugins/servlet/confluence/placeholder/unknown-attachment?locale=pt_PT&amp;version=2" title="image2024-9-16 10:5:12.png" data-resource-id="PHJpOmF0dGFjaG1lbnQgcmk6ZmlsZW5hbWU9ImltYWdlMjAyNC05LTE2IDEwOjU6MTIucG5nIiAvPg=="><h3>Conceder Consentimento Administrativo (se necessário)</h3><ul><li>Se você criou o aplicativo e é o administrador do Office365:<ul><li>Vá para Permissões de API no portal do Azure.</li><li>Clique em Conceder consentimento administrativo para [Nome do aplicativo].</li></ul></li><li>Se você não for o administrador do Office365: <ul><li> Envie o seguinte link ao administrador, substituindo o client_id pelo ID do seu aplicativo: <a href="https://login.microsoftonline.com/common/adminconsent?client_id=SEU_CLIENT_ID&amp;state=12345&amp;redirect_uri=https://login.microsoftonline.com/common/oauth2/nativeclient">https://login.microsoftonline.com/common/adminconsent?client_id=SEU_CLIENT_ID&amp;state=12345&amp;redirect_uri=https://login.microsoftonline.com/common/oauth2/nativeclient</a></li><li>O administrador deve abrir o link, revisar as permissões e, se concordar, conceder o consentimento.</li></ul></li></ul><hr /><h2>Configurar o URI de Redirecionamento </h2> <ul><li>Na página de detalhes do aplicativo, clique em &quot;Authentication&quot; no menu lateral esquerdo.</li><li>Na seção Redirect URIs, você verá um campo para inserir o URI de Redirecionamento.</li></ul>Exemplos de URIs de redirecionamento:<ul><li>Para um ambiente local de desenvolvimento (Desktop):<ul><li><code><a href="https://localhost:3000/callback">https://localhost:3000/callback</a></code></li><li><code><a href="https://localhost:4200/auth-response">https://localhost:4200/auth-response</a></code></li></ul></li><li>Para uma aplicação web em produção:<ul><li><code><a href="https://minha-aplicacao.com/callback">https://minha-aplicacao.com/callback</a></code></li><li><code><a href="https://meusistema.com/auth/callback">https://meusistema.com/auth/callback</a></code></li></ul></li></ul>No trecho abaixo, temos configurações relacionadas a uma aplicação Web, que não se aplicam se for uma aplicação Desktop:<hr /><h3>Adicionar o URI de Redirecionamento (Web)</h3><div> </div><ul><li>Clique no botão &quot;Add a platform&quot; (Adicionar uma plataforma).</li><li>Escolha a plataforma adequada (geralmente &quot;Web&quot; para aplicações web).</li><li>Na seção &quot;Redirect URIs&quot;, insira o URI de redirecionamento.</li><li>Se houver mais URIs, você pode adicioná-los.</li></ul>Salvar as Configurações<ul><li>Depois de adicionar o URI, clique no botão &quot;Save&quot; no topo da página para salvar suas configurações.</li></ul><h3>Montar a Requisição de Autenticação (Web)</h3>Para iniciar o fluxo OAuth, você precisará redirecionar o usuário para a URL de autorização da Microsoft: <ul style="list-style-type: square;"><li><a>https://login.microsoftonline.com/{tenant_id}/oauth2/v2.0/authorize</a></li></ul>Substitua <code>{tenant_id}</code> pelo Directory ID que você copiou.Parâmetros comuns:<ul><li><code>client_id</code>: O ID da aplicação (Client ID).</li><li><code>response_type</code>: Geralmente será <code>code</code> para o código de autorização.</li><li><code>redirect_uri</code>: O URI de redirecionamento configurado anteriormente.</li><li><code>scope</code>: As permissões solicitadas, separadas por espaço (ex.: <code>User.Read</code>).</li><li><code>state</code>: Um valor opcional para proteger contra falsificação de solicitação.</li></ul><hr /><h2>Trocar o Código de Autorização por um Token</h2>Após o usuário conceder permissão e ser redirecionado para o URI de redirecionamento com um código de autorização, você pode fazer uma requisição POST para o token endpoint: <ul style="list-style-type: square;"><li><a>https://login.microsoftonline.com/{tenant_id}/oauth2/v2.0/token</a></li></ul>Parâmetros da requisição POST:<ul><li><code>client_id</code>: O ID da aplicação.</li><li><code>grant_type</code>: <code>authorization_code</code>.</li><li><code>code</code>: O código de autorização recebido.</li><li><code>redirect_uri</code>: O mesmo URI de redirecionamento usado na etapa anterior.</li><li><code>client_secret</code>: A chave secreta da aplicação (gerada anteriormente).</li><li><code>scope</code>: As permissões solicitadas (por exemplo, <code>User.Read</code>).</li></ul><h3>Testar o Token</h3>Com o token de acesso retornado, você poderá fazer requisições autenticadas às APIs da Microsoft, como a Microsoft Graph.Exemplo de requisição para obter detalhes do usuário autenticado: GET <a href="https://graph.microsoft.com/v1.0/me">https://graph.microsoft.com/v1.0/me</a> Authorization: Bearer {access_token}Se necessário, use o token de atualização para renovar o token de acesso sem pedir uma nova autenticação ao usuário.  <hr />