Partilhar via

Exemplos de código da plataforma de identidade da Microsoft para autenticação e autorização

Esses exemplos de código são criados e mantidos pela Microsoft para demonstrar o uso de nossas bibliotecas de autenticação com a plataforma de identidade da Microsoft. Cenários comuns de autenticação e autorização são implementados em vários tipos de aplicativos, linguagens de desenvolvimento e estruturas.

  • Inicie sessão de utilizadores em aplicações Web e forneça acesso autorizado a APIs Web protegidas.
  • Proteja uma API da Web exigindo um token de acesso para executar operações de API.

Cada exemplo de código inclui um arquivo de README.md descrevendo como criar o projeto (se aplicável) e executar o aplicativo de exemplo. Os comentários no código ajudam a entender como essas bibliotecas são usadas no aplicativo para executar autenticação e autorização usando a plataforma de identidade.

Amostras e guias

Use as guias para classificar os exemplos por tipo de aplicativo ou sua linguagem/estrutura preferida.

Aplicativos de página única

Estes exemplos mostram como escrever um aplicativo de página única protegido com a plataforma de identidade da Microsoft. Estas amostras usam uma das variantes de MSAL.js.

Idioma/
Plataforma		 Exemplo(s) de código
no GitHub		 Autenticação
bibliotecas		 Fluxo de autenticação Início Rápido Guia de Aprendizagem
Reagir • Autenticação de utilizadores MSAL Reagir Código de autorização com PKCE Início rápido Tutoriais
Angular • Autenticação de utilizadores MSAL Angular Código de autorização com PKCE Início rápido Tutoriais
Javascript • Autenticação de utilizadores
• Ligue para o Microsoft Graph
• Chamar API web do Node.js
• Implantar no Armazenamento do Azure e no Serviço de Aplicativos		 MSAL.js Código de autorização com PKCE Início rápido
Blazor WebAssembly (estrutura para desenvolvimento de aplicações web) • Autenticação de utilizadores
• Ligue para o Microsoft Graph
• Implantar no Serviço de Aplicativo do Azure		 MSAL.js Código de autorização com PKCE Início rápido

Aplicações Web

Os exemplos a seguir ilustram aplicações web que efetuam a autenticação dos utilizadores. Alguns exemplos também demonstram a aplicação chamando o Microsoft Graph ou a sua própria API web com a identidade do utilizador.

Língua / Plataforma Exemplo(s) de código no GitHub Bibliotecas de Auth Fluxo de autenticação Início Rápido Guia de Aprendizagem
ASP.NET • Exemplo de treinamento do Microsoft Graph
• Inicie sessão dos utilizadores e chame o Microsoft Graph com permissões restritas de administrador		 • MSAL.NET
• Microsoft.Identity.Web
• Cenários avançados de cache de token		 • Conexão OpenID
• Código de autorização
• Em nome de (OBO)		 Início rápido
ASP.NET Núcleo • Autenticação de utilizadores
• Ligue para o Microsoft Graph
• Personalize o cache de tokens
• Use o contexto de autenticação do Acesso Condicional para executar a autenticação reforçada
• Gráfico de chamadas (multilocatário)
• Chamar APIs REST do Azure
• Proteja a API da Web
• Proteja a API web multicliente
• Use funções do aplicativo para controle de acesso
• Use grupos de segurança para controle de acesso
• Implantar no Armazenamento do Azure e no Serviço de Aplicativos
• Migração dos Serviços de Federação do Ative Directory para o Microsoft Entra		 Microsoft.Identity.Web • Conexão OpenID
• Código de autorização
• Fluxo em Nome de Outrem (OBO)		 Início rápido Tutoriais
Blazor • Autenticação de utilizadores
• Ligue para o Microsoft Graph
• Chamar a API web		 MSAL.NET Fluxo híbrido
Spring Java • Autenticação de utilizadores
• Ligue para o Microsoft Graph
• Use funções do aplicativo para controle de acesso
• Utilização de Grupos para controlo de acessos
• Proteja uma API web
• Implantar no Serviço de Aplicativo do Azure		 MSAL Java Código de autorização Tutoriais
Java Servlets • Autenticação de utilizadores
• Ligue para o Microsoft Graph
• Use funções do aplicativo para controle de acesso
• Use grupos de segurança para controle de acesso
• Implantar no Serviço de Aplicativo do Azure		 MSAL Java Código de autorização Início rápido
Node.js Express • Autenticação de utilizadores
• Aplicação Web Express construída com MSAL Node e plataforma de identidade Microsoft
• Ligue para o Microsoft Graph
• Ligue para o Microsoft Graph via proxy BFF
• Use funções do aplicativo para controle de acesso
• Use grupos de segurança para controle de acesso
• Implantar no Serviço de Aplicativo do Azure		 Nó MSAL • Código de autorização
• Proxy BFF (Backend-for-Frontend)		 Início rápido Tutoriais
Python Flask (framework de desenvolvimento web em Python) • Autenticação de utilizadores
• Modelo para entrar no Microsoft Entra ID e, opcionalmente, chamar uma API downstream (Microsoft Graph)		 MSAL Python Código de autorização Início rápido Tutoriais
Python Django • Autenticação de utilizadores MSAL Python Código de autorização
Rubi • Inicie sessão como utilizador e aceda ao Microsoft Graph OmniAuth OAuth2 Código de autorização

API Web

Os exemplos a seguir mostram como proteger uma API da Web com a plataforma de identidade da Microsoft e como chamar uma API downstream da API da Web.

Idioma/
Plataforma		 Exemplo(s) de código
no GitHub		 Autenticação
bibliotecas		 Fluxo de autenticação Início Rápido Guia de Aprendizagem
ASP.NET • Ligue para o Microsoft Graph MSAL.NET Em nome de (OBO) Início rápido
ASP.NET Núcleo • Controle de acesso (rotas protegidas) com a plataforma de identidade Microsoft MSAL.NET Em nome de (OBO) Início rápido Tutoriais
Java • Proteja sua API da Web Java Spring Boot com a plataforma de identidade da Microsoft MSAL Java Em nome de (OBO)
Node.js • Proteja uma API Web Node.js Nó MSAL Portador da autorização

Ambiente de Trabalho

Os exemplos a seguir mostram aplicações cliente públicas de desktop que acedem à API do Microsoft Graph ou à sua própria API da Web em nome do utilizador. Além do exemplo Desktop (Console) com Web Authentication Manager (WAM), todos esses aplicativos cliente usam a Microsoft Authentication Library (MSAL).

Idioma/
Plataforma		 Exemplo(s) de código
no GitHub		 Autenticação
bibliotecas		 Fluxo de autenticação Início Rápido Guia de Aprendizagem
Núcleo do .NET • Ligue para o Microsoft Graph
• Invocar o Microsoft Graph com cache de tokens
• Chame o Microsoft Graph com HTML personalizado da interface do usuário da Web
• Ligue para o Microsoft Graph com um navegador da Web personalizado
• Assinar utilizadores via fluxo de código do dispositivo
• Aceda ao Microsoft Graph assinando utilizadores com nome de utilizador e palavra-passe		 MSAL.NET • Código de autorização com PKCE
• Código do dispositivo
• Credenciais de senha do proprietário do recurso
Java • Ligue para o Microsoft Graph MSAL Java Autenticação integrada do Windows
Node.js • Autenticação de utilizadores Nó MSAL Código de autorização com PKCE Início rápido Tutoriais
Píton • Autenticação de utilizadores MSAL Python Credenciais de palavra-passe do proprietário do recurso
Windows Presentation Foundation (WPF) • Inicie sessão como utilizador e aceda ao Microsoft Graph
• Início de sessão do utilizador do Windows Presentation Foundation (WPF), acesso protegido à API Web (Microsoft Graph)
• Inicie sessão de utilizadores e chame ASP.NET API Web Core
• Inicie sessão como utilizador e aceda ao Microsoft Graph		 MSAL.NET Código de autorização com PKCE Início rápido Tutoriais

Móvel

Os exemplos a seguir mostram aplicativos móveis cliente público que acessam a API do Microsoft Graph. Esses aplicativos cliente usam a Microsoft Authentication Library (MSAL).

Idioma/
Plataforma		 Exemplo(s) de código
no GitHub		 Autenticação
bibliotecas		 Fluxo de autenticação Início Rápido Guia de Aprendizagem
Núcleo do .NET • Ligue para o Microsoft Graph usando MAUI
• Chame o Microsoft Graph usando MAUI com intermediário		 MSAL.NET Código de autorização com PKCE
iOS • Utilize o Microsoft Graph nativo MSAL iOS [en] Código de autorização com PKCE Início rápido Tutoriais
Java • Inicie sessão como utilizador e aceda ao Microsoft Graph MSAL Android Código de autorização com PKCE Início rápido Tutoriais
Kotlin • Inicie sessão como utilizador e aceda ao Microsoft Graph MSAL Android Código de autorização com PKCE

Serviço / daemónio

Os exemplos a seguir mostram um aplicativo que acessa a API do Microsoft Graph com sua própria identidade (sem usuário).

Idioma/
Plataforma		 Exemplo(s) de código
no GitHub		 Autenticação
bibliotecas		 Fluxo de autenticação Início Rápido Guia de Aprendizagem
.NET • Aplicativo de console .NET que acessa uma API da Web protegida
• Multilocatário com endpoint da plataforma de identidade da Microsoft		 MSAL.NET Concessão de credenciais de cliente Início rápido Tutoriais
Núcleo do .NET • Ligue para o Microsoft Graph
• Chamar a API web
• Usando identidade gerenciada para chamar MSGraph
• Usando identidade gerenciada para chamar uma API
• Papel de trabalhador chamando uma API		 Microsoft.Identity.Web Concessão de credenciais de cliente
Java • Chame o Microsoft Graph com Chave Secreta
• Ligue para o Microsoft Graph com certificado		 MSAL Java Concessão de credenciais de cliente Início rápido
Node.js • Ligue para o Microsoft Graph com segredo Nó MSAL Concessão de credenciais de cliente Início rápido Tutoriais
Píton • Ligue para o Microsoft Graph com segredo
• Ligue para o Microsoft Graph com certificado		 MSAL Python Concessão de credenciais de cliente Início rápido

Sem navegador (sem interface de utilizador)

O exemplo a seguir mostra um aplicativo cliente público em execução em um dispositivo sem um navegador da Web. O aplicativo pode ser uma ferramenta de linha de comando, um aplicativo em execução no Linux ou Mac ou um aplicativo IoT. O exemplo apresenta um aplicativo acessando a API do Microsoft Graph, no nome de um usuário que entra interativamente em outro dispositivo (como um telefone celular). Este aplicativo cliente usa a Microsoft Authentication Library (MSAL).

Idioma/
Plataforma		 Exemplo(s) de código
no GitHub		 Autenticação
bibliotecas		 Fluxo de autenticação Início Rápido Guia de Aprendizagem
Núcleo do .NET • Invoque a API protegida de um dispositivo somente de texto MSAL.NET Código do dispositivo
Java • Inicie sessão de utilizadores e invoque a API protegida num dispositivo somente de texto MSAL Java Código do dispositivo
Píton • Ligue para o Microsoft Graph MSAL Python Código do dispositivo

Azure Functions como APIs Web

Os exemplos a seguir mostram como proteger uma Função do Azure usando HttpTrigger e expondo uma API da Web com a plataforma de identidade da Microsoft e como chamar uma API downstream da API da Web.

Idioma/
Plataforma		 Exemplo(s) de código
no GitHub		 Autenticação
bibliotecas		 Fluxo de autenticação Início Rápido Guia de Aprendizagem
Píton • API web da função Python Azure protegida pelo Microsoft Entra ID MSAL Python Código de autorização

Aplicações Microsoft Teams

O exemplo a seguir ilustra a aplicação Microsoft Teams Tab que faz login dos utilizadores. Além disso, ele demonstra como chamar a API do Microsoft Graph com a identidade do usuário usando a biblioteca de autenticação da Microsoft (MSAL).

Idioma/
Plataforma		 Exemplo(s) de código
no GitHub		 Autenticação
bibliotecas		 Fluxo de autenticação Início Rápido Guia de Aprendizagem
Node.js • Aplicação Teams Tab: início de sessão único (SSO) e chamada Microsoft Graph Nó MSAL Em nome de (OBO)

SaaS multi-arrendatário

Os exemplos a seguir mostram como configurar seu aplicativo para aceitar entradas de qualquer locatário do Microsoft Entra. Configurar seu aplicativo para ser multilocatário significa que você pode oferecer um aplicativo SaaS (Software as a Service ) para muitas organizações, permitindo que seus usuários possam entrar em seu aplicativo após fornecer consentimento.

Idioma/
Plataforma		 Exemplo(s) de código
no GitHub		 Autenticação
bibliotecas		 Fluxo de autenticação Início Rápido Guia de Aprendizagem
ASP.NET Núcleo • ASP.NET aplicação Web Core MVC chama a API do Microsoft Graph
• Aplicação ASP.NET Core MVC chama API da web ASP.NET Core		 MSAL.NET • Conexão OpenID
• Código de autorização

Conteúdos relacionados

Se você quiser se aprofundar em mais código de exemplo, consulte:

  • Last updated on