Partilhar via

Definir uma home page personalizada para aplicativos publicados usando o proxy de aplicativo do Microsoft Entra

Este artigo descreve como configurar um aplicativo para direcionar um usuário para uma home page personalizada. Quando você publica um aplicativo com proxy de aplicativo, define uma URL interna, mas às vezes essa não é a página que um usuário deve ver primeiro. Defina uma home page personalizada para que os usuários obtenham a página correta ao acessar o aplicativo. Os utilizadores veem a home page personalizada que definiu, independentemente de acederem à aplicação a partir do Microsoft Entra My Apps ou do iniciador de aplicações do Microsoft 365.

Quando um usuário inicia o aplicativo, ele é direcionado para a URL do domínio raiz do aplicativo publicado por padrão. A página de destino é normalmente definida como o URL da página inicial. Use o módulo Microsoft Entra PowerShell para definir uma URL de home page personalizada quando quiser que um usuário do aplicativo chegue a uma página específica dentro do aplicativo.

Aqui está um cenário que explica por que sua empresa definiria uma página inicial personalizada:

  • Dentro da sua rede corporativa, um usuário vai para https://ExpenseApp/login/login.aspx entrar e acessar seu aplicativo.
  • Como tens outros recursos (como imagens) que o proxy da aplicação precisa aceder no nível superior da estrutura de pastas, publicas a aplicação com https://ExpenseApp como a URL interna.
  • O URL externo predefinido é https://ExpenseApp-contoso.msappproxy.net, que não direciona um utilizador externo para a página de início de sessão.
  • Em vez disso, você deseja definir https://ExpenseApp-contoso.msappproxy.net/login/login.aspx como o URL da página inicial, para que um usuário externo veja a página de entrada primeiro.

Nota

Quando você concede aos usuários acesso a aplicativos publicados, os aplicativos aparecem em Meus Aplicativos e no inicializador de aplicativos do Office 365.

Antes de começar

Antes de definir o URL da página inicial, tenha estes requisitos em mente:

  • O caminho especificado deve ser um caminho de subdomínio da URL do domínio raiz.

    Por exemplo, se a URL do domínio raiz for https://apps.contoso.com/app1/, a URL da home page configurada deverá começar com https://apps.contoso.com/app1/.

  • Se você fizer uma alteração no aplicativo publicado, a alteração poderá redefinir o valor do URL da página inicial. Quando atualizar a aplicação no futuro, deve verificar novamente e, se necessário, atualizar o URL da página inicial.

Você pode definir a URL da home page por meio do centro de administração do Microsoft Entra ou usando o PowerShell.

Alterar a home page no centro de administração do Microsoft Entra

Para alterar o URL da home page da sua aplicação através do centro de administração do Microsoft Entra, siga estes passos:

  1. Entre no centro de administração do Microsoft Entra como pelo menos um Administrador de Aplicativos.
  2. Selecione seu nome de usuário no canto superior direito. Verifique se você está conectado a um diretório que usa proxy de aplicativo. Se você precisar alterar diretórios, selecione Alternar diretório e escolha um diretório que use proxy de aplicativo.
  3. Navegue até Entra ID>Registros de Aplicações. A lista de aplicativos registrados é exibida.
  4. Escolha seu aplicativo na lista. É apresentada uma página com os detalhes da aplicação registada.
  5. Em Gerenciar, selecione Marca.
  6. Atualize o URL da página inicial com o novo caminho.
  7. Selecione Salvar. Captura de ecrã da página de Marca e Propriedades de uma aplicação registada com o campo URL da Página Inicial realçado.

Alterar a página inicial com o PowerShell

Para configurar a home page de um aplicativo usando o PowerShell, você precisa:

  1. Instale o módulo Microsoft Entra PowerShell.
  2. Encontre o valor ObjectId do aplicativo.
  3. Atualize a URL da página inicial do aplicativo usando comandos do PowerShell.

Instalar o módulo Microsoft Entra PowerShell

Antes de definir uma URL de home page personalizada usando o PowerShell, instale o módulo Microsoft Entra PowerShell. Você pode baixar o pacote da Galeria do PowerShell, que usa o ponto de extremidade da API do Graph.

Para instalar o pacote, siga estes passos:

  1. Abra uma janela padrão do PowerShell e execute o seguinte comando:

    Install-Module -Name Microsoft.Graph

    Se você estiver executando o comando sem direitos administrativos, use a -Scope CurrentUser opção.

  2. Durante a instalação, selecione Y para instalar dois pacotes do Nuget.org. Ambos os pacotes são obrigatórios.

Encontre o ObjectId do aplicativo

Você obtém o ObjectId do aplicativo pesquisando o aplicativo por seu nome de exibição ou página inicial.

  1. Na mesma janela do PowerShell, importe o módulo Microsoft Entra.

    Import-Module -Name Microsoft.Graph

  2. Entre no módulo Microsoft Entra como administrador do locatário.

    Connect-Entra -Scopes 'Application.Read.All'

  3. Encontre o aplicativo. Este exemplo usa o PowerShell para localizar o ObjectId pesquisando o aplicativo com um nome para exibição de SharePoint.

    Get-EntraApplication | Where-Object { $_.DisplayName -eq "SharePoint" } | Format-List DisplayName, IdentifierUris, ObjectId

    Você deve obter um resultado semelhante ao mostrado aqui. Copie o GUID ObjectId para usar na próxima seção.

    DisplayName       : SharePoint
IdentifierUris    : https://sharepoint-iddemo.msappproxy.net/
ObjectId          : aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb

    Como alternativa, você pode simplesmente puxar a lista de todos os aplicativos, pesquisar a lista para o aplicativo com um nome de exibição específico ou página inicial e copiar o ObjectId do aplicativo assim que o aplicativo for encontrado.

    Get-EntraApplication | Format-List DisplayName, IdentifierUris, ObjectId

Atualizar o URL da página inicial

Crie o URL da página inicial e atualize seu aplicativo com esse valor. Continue usando a mesma janela do PowerShell ou, se estiver usando uma nova janela do PowerShell, entre no módulo Microsoft Entra novamente usando o Connect-Entra. Em seguida, siga estes passos:

  1. Crie uma variável para manter o ObjectId valor copiado.

    $objguid = "<object id>"

  2. Confirme se você tem o aplicativo correto executando o seguinte comando. A saída deve ser idêntica à saída que você viu na seção anterior (Encontre o ObjectId do aplicativo).

    Get-EntraApplication -ObjectId $objguid | Format-List DisplayName, IdentifierUris, ObjectId

  3. Defina o URL da página inicial com o valor desejado. O valor deve ser um caminho de subdomínio do aplicativo publicado. Por exemplo, se alterar o URL da página inicial de https://sharepoint-iddemo.msappproxy.net/ para https://sharepoint-iddemo.msappproxy.net/hybrid/, os utilizadores da aplicação irão diretamente para a página inicial personalizada.

    Utilize este comando:

    Set-EntraApplication -ApplicationId $objguid -IdentifierUris 'https://sharepoint-iddemo.msappproxy.net/hybrid/'

  4. Para confirmar que a alteração foi bem-sucedida, execute o seguinte comando da etapa 2 novamente.

    Get-EntraApplication -ObjectId $objguid | Format-List DisplayName, IdentifierUris, ObjectId

    Para o nosso exemplo, a saída agora deve aparecer da seguinte maneira:

    DisplayName       : SharePoint
IdentifierUris    : https://sharepoint-iddemo.msappproxy.net/hybrid/
ObjectId          : bbbbbbbb-1111-2222-3333-cccccccccccc

  5. Reinicie o aplicativo para confirmar se a página inicial aparece como a primeira tela, conforme o esperado.

Nota

Quaisquer alterações feitas no aplicativo podem redefinir o URL da página inicial. Se o URL da página inicial for redefinido, repita as etapas nesta seção para defini-la novamente.

Próximos passos

  • Last updated on