Defina uma página inicial personalizada para aplicativos publicados usando o proxy de aplicativo do Microsoft Entra.

Este artigo descreve como configurar aplicativos para direcionar os usuários para uma página inicial personalizada. Ao publicar um aplicativo com proxy de aplicativo, defina uma URL interna, mas, às vezes, essa não é a página que o 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 usuários veem a home page personalizada definida, independentemente de acessarem o aplicativo do Microsoft Entra My Apps ou do inicializador de aplicativos do Microsoft 365.

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

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

• Dentro da rede corporativa, os usuários acessam https://ExpenseApp/login/login.aspx para se conectar e acessar seu aplicativo.
• Como você tem outros recursos (como imagens) que o proxy de aplicativos precisa acessar no nível superior da estrutura de pastas, publique o aplicativo com https://ExpenseApp como a URL interna.
• A URL externa padrão é https://ExpenseApp-contoso.msappproxy.net, que não direciona um usuário externo para a página de entrada.
• Em vez disso, você deseja definir https://ExpenseApp-contoso.msappproxy.net/login/login.aspx como a URL da página inicial, para que um usuário externo veja a página de entrada primeiro.

Antes de começar

Antes de definir a URL da home page, tenha esses requisitos em mente:

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

  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, essa alteração poderá redefinir o valor da URL da home page. Quando você decidir atualizar o aplicativo no futuro, você deverá verificar novamente e, se necessário, atualizar a URL da home page.

Você pode definir a URL da página inicial por meio do centro de administração do Microsoft Entra ou utilizando o PowerShell.

Alterar a página inicial no centro de administração do Microsoft Entra

Para alterar a URL da página inicial do seu aplicativo por meio do centro de administração do Microsoft Entra, siga estas etapas:

1. Entre no Centro de administração do Microsoft Entra pelo menos como um Administrador de Aplicativo.
2. Escolha o nome de usuário no canto superior direito. Verifique se você está conectado a um diretório que usa o proxy de aplicativo. Se for necessário alterar diretórios, escolha Mudar diretório e escolha um diretório que usa o proxy de aplicativo.
3. Navegue para Entra ID>registros do aplicativo. A lista de aplicativos registrados é exibida.
4. Escolha o aplicativo na lista. É exibida uma página mostrando os detalhes do aplicativo registrado.
5. Em Gerenciar, selecione Identidade Visual.
6. Atualize o campo URL da home page com o novo caminho.
7. Clique em Salvar.

Alterar a home page com o PowerShell

Para configurar a página inicial de um aplicativo usando o PowerShell, você precisa:

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

Instalar o módulo do Microsoft Entra PowerShell

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

Para instalar o pacote, siga estas etapas:

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

   Install-Module -Name Microsoft.Graph
   

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

2. Durante a instalação, selecione Y para instalar dois pacotes do Nuget.org. Os dois pacotes são necessários.

Localizar o ObjectID do aplicativo

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

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

   Import-Module -Name Microsoft.Graph
   

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

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

3. Encontrar o aplicativo. Este exemplo usa o PowerShell para localizar o ObjectId pesquisando o aplicativo com um nome de 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 do 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 apenas transferir a lista de todos os aplicativos, pesquisar na lista o aplicativo com um nome de exibição ou home page específicos e copiar o ObjectId do aplicativo quando ele for encontrado.

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

Atualizar a URL da home page

Crie a URL da página inicial e atualize o aplicativo com esse valor. Continue usando a mesma janela do PowerShell ou, se estiver usando uma nova janela do PowerShell, entre no módulo do Microsoft Entra novamente usando o Connect-Entra. Depois, execute estas etapas:

1. Crie uma variável para manter o valor ObjectId 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 (Localize o ObjectID do aplicativo).

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

3. Defina a URL da home page como o valor desejado. O valor deve ser um caminho de subdomínio do aplicativo publicado. Por exemplo, se você alterar o URL da página inicial de https://sharepoint-iddemo.msappproxy.net/ para https://sharepoint-iddemo.msappproxy.net/hybrid/, os usuários do aplicativo vão diretamente para a página inicial personalizada.

   Use este comando:

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

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

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

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

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

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

Próximas etapas

• Habilitar acesso remoto ao SharePoint com o proxy de aplicativo do Microsoft Entra
• Tutorial: adicionar um aplicativo local para acesso remoto por meio do proxy de aplicativo no Microsoft Entra ID