Compartilhar via

Como adicionar um URI de redirecionamento ao seu aplicativo

Para autenticar um usuário, seu aplicativo deve enviar uma solicitação de login para o ponto de extremidade de autorização do Microsoft Entra, especificando um URI de redirecionamento como parâmetro. O URI de redirecionamento é um recurso de segurança crítico que garante que o servidor de autenticação do Microsoft Entra envie apenas códigos de autorização e tokens de acesso para o destinatário pretendido.

Pré-requisitos

Adicionar um URI de redirecionamento

Um URI de redirecionamento é onde a plataforma de identidade da Microsoft envia tokens de segurança após a autenticação. Os URIs de redirecionamento são configurados nas configurações de plataforma no Centro de administração do Microsoft Entra. Para aplicativos Web e de página única, você precisa especificar um URI de redirecionamento manualmente. Para plataformas móveis e de área de trabalho , você seleciona entre URIs de redirecionamento gerados.

Siga estas etapas para definir as configurações com base em sua plataforma ou dispositivo de destino:

  1. No centro de administração do Microsoft Entra, em Registros de aplicativos, selecione seu aplicativo.

  2. Em Gerenciar, selecione Autenticação.

  3. Em Configurações de plataforma, selecione Adicionar uma plataforma.

  4. Em Configurar plataformas, selecione o mosaico do tipo de aplicação (plataforma) para configurar as respetivas definições.

    Captura de tela do painel Configuração da plataforma no portal do Azure.

    Plataforma Definições de configuração Exemplo
    Teia Insira o URI de Redirecionamento para um aplicativo Web executado em um servidor. As URLs de logout do canal de comunicação frontal também podem ser adicionadas https://contoso.com/auth-response ou
    http://localhost:3000/auth-response se você executar seu aplicativo localmente.
    Aplicativo de página única Insira um URI de Redirecionamento para aplicativos do lado do cliente usando JavaScript, Angular, React.jsou Blazor WebAssembly. As URLs de logout do canal de comunicação frontal também podem ser adicionadas https://contoso.com/auth-response ou
    http://localhost:3000/auth-response se você executar seu aplicativo localmente.
    iOS/macOS Insira o Bundle ID do aplicativo, que gera um URI de redirecionamento para você. Localize-o em Definições de Criação ou em Xcode em Info.plist. com.microsoft.identityapp.ciam.MSALiOS.
    Andróide Insira o nome do pacote do aplicativo, que gera um URI de redirecionamento para você. Localize-o no ficheiro AndroidManifest.xml . Também gere e introduza o Hash de assinatura. Nome do pacote:
    • com.azuresamples.msalandroidapp
    A assinatura tem:
    • aB1cD2eF-3gH4iJ5kL6-mN7oP8qR=.
    Aplicações móveis e de ambiente de trabalho Selecione esta plataforma para aplicativos de desktop ou aplicativos móveis que não usam MSAL ou um intermediário. Selecione um URI de Redirecionamento sugerido ou especifique um ou mais URIs de redirecionamento personalizados https://login.microsoftonline.com/common/oauth2/nativeclient

  5. Selecione Configurar para concluir a configuração da plataforma.

Restrições de URI de redirecionamento

Existem algumas restrições no formato dos URIs de redirecionamento que adiciona a um registo de aplicação. Para obter detalhes sobre estas restrições, veja Restrições e limitações do URI de Redirecionamento (URL de resposta).

Conteúdo relacionado