Exercício – Conectar um aplicativo ASP.NET Core ao Microsoft 365

  • 5 minutos

Neste exercício, você trabalhará com um aplicativo ASP.NET Core e o conectará ao Microsoft 365. Você usará um assembly .NET Core chamado Microsoft.Identity.Web para permitir que os usuários entrem em seu aplicativo com suas contas do Microsoft 365. O nome e a imagem do perfil deles serão mostrados usando o SDK do .NET Core do Microsoft Graph.

Configurar e executar o aplicativo de exemplo

Este exercício facilita a criação de um aplicativo Web básico. Para obter o código inicial do aplicativo que você usará, navegue até https://github.com/microsoftdocs/mslearn-m365-microsoftgraph-dotnetcorerazor e escolha uma das seguintes opções:

  • Se você usar o Git, clone o projeto usando o comando clonar git:

    git clone https://github.com/microsoftdocs/mslearn-m365-microsoftgraph-dotnetcorerazor.git

  • Se você não usa Git, selecione o botão Código seguido por Baixar ZIP. Extraia o ficheiro *.zip para o seu computador.

Uma vez que você tenha o aplicativo em seu computador, siga estas etapas para que o aplicativo seja aberto em seu editor de código.

  1. Vá para a pasta com o código-fonte do aplicativo e selecione uma das seguintes opções, dependendo do seu editor de código.

    • Visual Studio (versão 2019 16.11.0 ou superior)

      Clique duas vezes em MicrosoftGraph-DotNetCoreRazor.sln na pasta mslearn-m365-microsoftgraph-dotnetcorerazor/Begin para abrir o projeto.

    • Visual Studio Code ou outro editor de códigos

      Abra a pasta mslearn-m365-microsoftgraph-dotnetcorerazor/Begin no seu editor de códigos.

  2. No seu editor de códigos, abra o arquivo appsettings.json e reserve alguns minutos para conferir algumas das configurações.

  3. Alterar o valor da propriedade Scopes para o seguinte, de modo a permitir o acesso à leitura do perfil e presença de um usuário, configurações de caixa de correio (para informações de fuso horário) e calendários.

    user.read presence.read mailboxsettings.read calendars.read

  4. Salve o arquivo appsettings.json antes de continuar.

  5. Para adicionar os valores ClientId e ClientSecret do Microsoft Entra ID, irá utilizar os segredos da aplicação ASP.NET Core.

  6. Abra uma janela de terminal na raiz da pasta mslearn-m365-microsoftgraph-dotnetcorerazor/Begin e execute os seguintes comandos, substituindo YOUR_APP_ID por sua ID do Aplicativo (cliente) do portal do Azure e YOUR_APP_SECRET pelo segredo do aplicativo que você criou.

    dotnet user-secrets init
dotnet user-secrets set "AzureAd:ClientId" "YOUR_APP_ID"
dotnet user-secrets set "AzureAd:ClientSecret" "YOUR_APP_SECRET"

    Importante

    Em um aplicativo de produção você pode armazenar informações confidenciais em um local seguro, como o Azure Key Vault.

  7. Esse projeto usa os seguintes assemblies da plataforma de identidade da Microsoft e do Microsoft Graph:

    • Microsoft.Identity.Web: usado para solicitar e gerenciar tokens de acesso.
    • Microsoft.Identity.Web.UI: fornece à interface do usuário para entrar e sair.
    • Microsoft.Identity.Web.MicrosoftGraph: fornece injeção de dependência para o Microsoft Graph SDK.

  8. Execute a seguinte etapa com base no seu editor de códigos:

    • Visual Studio

      Clique em F5 para compilar e executar o projeto.

    • Visual Studio Code ou outro editor de códigos

      Abra uma janela de terminal na pasta Começar e execute o seguinte comando:

      dotnet run

    Importante

    Se você receber um aviso de que o certificado do localhost não é confiável, consulte Confiar no certificado de desenvolvimento HTTPS ASP.NET Core no Windows e macOS para obter instruções sobre como usar a CLI do .NET Core para confiar no certificado de desenvolvimento. Se você estiver executando no Visual Studio e ainda não tiver aprovado um certificado de desenvolvedor em seu computador, poderá ser necessário aprovar um certificado.

  9. Abra um navegador e navegue até https://localhost:5001.

    Dica

    Se você utiliza o Microsoft 365 em seu trabalho diário e está planejando fazer este exercício em um locatário de desenvolvimento (o quais é sugerido), você pode achar útil trabalhar em modo privado ou "anônimo" no navegador. Você pode até optar por usar um navegador ou perfil de navegador diferente do que normalmente usa na produção.

  10. Entre com sua conta do Microsoft 365.

  11. Depois de entrar com sucesso, você será solicitado a dar seu consentimento para as permissões necessárias. Selecione a caixa de seleção para dar o consentimento da sua organização às permissões e, em seguida, selecione o botão Aceitar.

  12. Você deverá ver o aplicativo exibir uma mensagem de boas-vindas com seu nome de usuário e imagem do perfil.

  13. Feche o navegador e pressione CTRL+C janela do terminal para interromper o servidor.

    Observação

    Se você abriu o projeto no Visual Studio, poderá fechar o navegador ou selecionar SHIFT+F5 no Visual Studio para interromper o servidor. Se ainda estiver aberta, feche a janela do terminal que o Visual Studio criou.