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

Artigo
02/26/2024

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 página inicial personalizada para que os usuários sejam direcionados para a página correta quando acessam o aplicativos. Um usuário vê a página inicial personalizada definida, independentemente de acessar a partir de Meus Aplicativos do Microsoft Entra ou do inicializador de aplicativos do Microsoft 365.

Quando os usuários iniciam o aplicativo, são direcionados por padrão para a URL de domínio raiz do aplicativo publicado. A página de aterrissagem é normalmente definida como a URL da home page. Use o módulo do PowerShell do Azure AD para definir URLs de página inicial personalizada quando desejar que os usuários do aplicativo acessem uma página específica no 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 leva os usuários até 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.

Observação

Quando você conceder aos usuários acesso a aplicativos publicados, os aplicativos são exibidos em Meus aplicativos e no Lançador de aplicativo do Office 365.

Antes de começar

Antes de definir a URL da página inicial, tenha em mente os seguintes requisitos:

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

Por exemplo, se a URL de domínio raiz for https://apps.contoso.com/app1/, a URL da página inicial que você configura 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:

Entre no Centro de administração do Microsoft Entra pelo menos como um Administrador de Aplicativo.
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.
Navegue até Identidade>Aplicativos>Registros do aplicativo. A lista de aplicativos registrados é exibida.
Escolha o aplicativo na lista. É exibida uma página mostrando os detalhes do aplicativo registrado.
Em Gerenciar, selecione Identidade Visual.
Atualize o campo URL da home page com o novo caminho.
Selecione Salvar.

Alterar a home page com o PowerShell

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

Instale o módulo do PowerShell do Azure AD.
Localize o valor do ObjectID do aplicativo.
Atualize a URL da página inicial do aplicativo usando comandos do PowerShell.

Instalar o módulo do Powershell do Azure AD

Antes de definir uma URL personalizada de página inicial usando o PowerShell, instale o módulo PowerShell do Azure AD. Baixe esse pacote da Galeria do PowerShell, que usa o ponto de extremidade de API do Graph.

Para instalar o pacote, siga estas etapas:

Abra uma janela padrão do PowerShell e, em seguida, execute o seguinte comando:
```
Install-Module -Name AzureAD
```
Se você estiver executando o comando sem direitos administrativos, use a opção -scope currentuser.
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.

Na mesma janela do PowerShell, importe o módulo do Microsoft Entra.
```
Import-Module AzureAD
```
Entre no módulo do Microsoft Entra como o administrador do locatário.
```
Connect-AzureAD
```
Encontrar o aplicativo. Este exemplo usa o PowerShell para localizar o ObjectId pesquisando o aplicativo com um nome de exibição de SharePoint.
```
Get-AzureADApplication | Where-Object { $_.DisplayName -eq "SharePoint" } | Format-List DisplayName, Homepage, ObjectId
```
Você deve obter um resultado semelhante ao mostrado aqui. Copie o GUID do ObjectID para usar na próxima seção.
```
DisplayName : SharePoint
Homepage    : https://sharepoint-iddemo.msappproxy.net/
ObjectId    : aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb
```
Como alternativa, você pode apenas efetuar pull da lista de todos os aplicativos, pesquisar na lista o aplicativo com um nome de exibição ou página inicial específica e copiar o ObjectId do aplicativo quando o aplicativo for encontrado.
```
Get-AzureADApplication | Format-List DisplayName, Homepage, 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-AzureAD. Depois, execute estas etapas:

Crie uma variável para manter o valor ObjectId copiado.
```
$objguid = "<object id>"
```
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-AzureADApplication -ObjectId $objguid | Format-List DisplayName, Homepage, ObjectId
```
Crie um objeto de aplicativo em branco para armazenar as alterações que você deseja fazer.
```
$appnew = New-Object "Microsoft.Open.AzureAD.Model.Application"
```
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.
```
$homepage = "https://sharepoint-iddemo.msappproxy.net/hybrid/"
```

Faça a atualização da página inicial.

Set-AzureADApplication -ObjectId $objguid -Homepage $homepage

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

Get-AzureADApplication -ObjectId $objguid | Format-List DisplayName, Homepage, ObjectId

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

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

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

Observação

Todas as alterações que você fizer no aplicativo poderão redefinir a URL da home page. Se a URL da página inicial for redefinida, repita as etapas nesta seção para defini-la novamente.

Compartilhar via