Definir uma home page personalizada para aplicativos publicados usando o Proxy de Aplicativo Azure ADSet a custom home page for published apps by using Azure AD Application Proxy

Este artigo discute como configurar um aplicativo para direcionar um usuário para uma página inicial personalizada.This article discusses how to configure an app to direct a user to a custom home page. Quando você publica um aplicativo com o Proxy de aplicativo, você define uma URL interna, mas, às vezes, isso não é a página de que um usuário deverá ver pela primeira vez.When you publish an app with Application Proxy, you set an internal URL, but sometimes that's not the page a user should see first. Defina uma home page personalizada para que um usuário obtém a página correta quando acessam o aplicativo.Set a custom home page so that a user gets the right page when they access the app. O usuário verá a home page personalizada que você defina, independentemente se eles acessam o aplicativo do painel de acesso do Azure Active Directory ou o lançador de aplicativo do Office 365.A user will see the custom home page that you set, regardless of whether they access the app from the Azure Active Directory Access Panel or the Office 365 app launcher.

Quando um usuário inicia o aplicativo, eles são direcionados por padrão para a URL do domínio raiz para o aplicativo publicado.When a user launches the app, they're directed by default to the root domain URL for the published app. A página de aterrissagem é normalmente definida como a URL da home page.The landing page is typically set as the home page URL. Use o módulo do PowerShell do Azure AD para definir uma URL da home page personalizada quando desejar que um usuário do aplicativo cheguem em uma página específica dentro do aplicativo.Use the Azure AD PowerShell module to define a custom home page URL when you want an app user to land on a specific page within the app.

Aqui está um cenário que explica por que sua empresa definiria uma página inicial personalizada:Here's one scenario that explains why your company would set a custom home page:

  • Dentro da rede corporativa, um usuário vai para https://ExpenseApp/login/login.aspx para entrar e acessar seu aplicativo.Inside your corporate network, a user goes to https://ExpenseApp/login/login.aspx to sign in and access your app.
  • Como você tem outros ativos (como imagens) que o Proxy de aplicativo precisa acessar no nível superior da estrutura de pasta, você publica o aplicativo com https://ExpenseApp como a URL interna.Because you have other assets (such as images) that Application Proxy needs to access at the top level of the folder structure, you publish the app with https://ExpenseApp as the internal URL.
  • A URL externa padrão é https://ExpenseApp-contoso.msappproxy.net, que não leva a um usuário externo para a página de entrada.The default external URL is https://ExpenseApp-contoso.msappproxy.net, which doesn't take an external user to the sign-in page.
  • Você deseja definir https://ExpenseApp-contoso.msappproxy.net/login/login.aspx como a URL da home page em vez disso, portanto, um usuário externo vê a página de entrada primeiro.You want to set https://ExpenseApp-contoso.msappproxy.net/login/login.aspx as the home page URL instead, so an external user sees the sign-in page first.

Observação

Quando você conceder aos usuários acesso a aplicativos publicados, os aplicativos são exibidos no painel de acesso do Azure AD e lançador de aplicativo do Office 365.When you give users access to published apps, the apps are displayed in the Azure AD Access Panel and the Office 365 app launcher.

Antes de começarBefore you start

Antes de definir a URL da página inicial, tenha em mente os seguintes requisitos:Before you set the home page URL, keep in mind the following requirements:

  • O caminho que você especifica deve ser um caminho de subdomínio da URL raiz do domínio.The path that you specify must be a subdomain path of the root domain URL.

    Por exemplo, se a URL do domínio raiz é https://apps.contoso.com/app1/, a URL da home page que você configura deve começar com https://apps.contoso.com/app1/.For example, if the root-domain URL is https://apps.contoso.com/app1/, the home page URL that you configure must start with 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.If you make a change to the published app, the change might reset the value of the home page URL. Quando você decidir atualizar o aplicativo no futuro, você deverá verificar novamente e, se necessário, atualizar a URL da home page.When you update the app in the future, you should recheck and, if necessary, update the home page URL.

Você pode definir a URL da home page no portal do Azure ou usando o PowerShell.You can set the home page URL either through the Azure portal or by using PowerShell.

Altere a home page no portal do AzureChange the home page in the Azure portal

Para alterar a URL da home page do seu aplicativo por meio do portal do Azure AD, siga estas etapas:To change the home page URL of your app through the Azure AD portal, follow these steps:

  1. Entre no Portal do Azure como administrador.Sign in to the Azure portal as an administrator.

  2. Selecione Azure Active Directorye então registros de aplicativo.Select Azure Active Directory, and then App registrations. É exibida a lista de aplicativos registrados.The list of registered apps appears.

  3. Escolha seu aplicativo na lista.Choose your app from the list. Aparece uma página mostrando os detalhes do aplicativo registrado.A page showing the details of the registered app appears.

  4. Sob Manage, selecione identidade visual.Under Manage, select Branding.

  5. Atualizar o URL da Home page com o novo caminho.Update the Home page URL with your new path.

    Página da identidade visual para um aplicativo registrado indicando que o campo de URL da Home Page

  6. Clique em Salvar.Select Save.

Alterar a home page com o PowerShellChange the home page with PowerShell

Para configurar a home page de um aplicativo usando o PowerShell, você precisa:To configure the home page of an app using PowerShell, you need to:

  1. Instale o módulo do PowerShell do Azure AD.Install the Azure AD PowerShell module.
  2. Localize o valor ObjectId do aplicativo.Find the ObjectId value of the app.
  3. Atualize a URL da home page do aplicativo usando comandos do PowerShell.Update the app's home page URL using PowerShell commands.

Instalar o módulo do Powershell do Azure ADInstall the Azure AD PowerShell module

Antes de definir uma URL personalizada de página inicial usando o PowerShell, instale o módulo PowerShell do Azure AD.Before you define a custom home page URL by using PowerShell, install the Azure AD PowerShell module. Baixe esse pacote da Galeria do PowerShell, que usa o ponto de extremidade de API do Graph. You can download the package from the PowerShell Gallery, which uses the Graph API endpoint.

Para instalar o pacote, siga estas etapas:To install the package, follow these steps:

  1. Abra uma janela padrão do PowerShell e, em seguida, execute o seguinte comando:Open a standard PowerShell window, and then run the following command:

    Install-Module -Name AzureAD
    

    Se você estiver executando o comando como um não administrador, use a opção -scope currentuser.If you're running the command as a non-admin, use the -scope currentuser option.

  2. Durante a instalação, selecione Y para instalar dois pacotes do Nuget.org. Ambos os pacotes são necessários.During the installation, select Y to install two packages from Nuget.org. Both packages are required.

Localizar a ObjectId do aplicativoFind the ObjectId of the app

Você pode obter a ObjectId do aplicativo por meio de pesquisa para o aplicativo por seu nome de exibição ou página inicial.You get the ObjectId of the app by searching for the app by its display name or home page.

  1. Na janela do PowerShell, importe o módulo do Azure AD.In the same PowerShell window, import the Azure AD module.

    Import-Module AzureAD
    
  2. Entre no módulo Azure AD como o administrador de locatários.Sign in to the Azure AD module as the tenant administrator.

    Connect-AzureAD
    
  3. Encontre o aplicativo.Find the app. Este exemplo usa o PowerShell para localizar a ObjectId por meio de pesquisa para o aplicativo com um nome de exibição de SharePoint.This example uses PowerShell to find the ObjectId by searching for the app with a display name of SharePoint.

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

    Você deve obter um resultado semelhante ao mostrado aqui.You should get a result that's similar to the one shown here. Copie o GUID do ObjectId para usar na próxima seção.Copy the ObjectId GUID to use in the next section.

    DisplayName : SharePoint
    Homepage    : https://sharepoint-iddemo.msappproxy.net/
    ObjectId    : 8af89bfa-eac6-40b0-8a13-c2c4e3ee22a4
    

    Como alternativa, você poderia apenas receber uma lista de todos os aplicativos, pesquise a lista para o aplicativo com um nome de exibição específico ou a home page e copiar ObjectId do aplicativo depois que o aplicativo for encontrado.Alternatively, you could just pull the list of all apps, search the list for the app with a specific display name or home page, and copy the app's ObjectId once the app is found.

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

Atualizar a URL da home pageUpdate the home page URL

Crie a URL da home page e atualizar seu aplicativo com esse valor.Create the home page URL, and update your app with that value. Continuar usando a mesma janela do PowerShell, ou se você estiver usando uma nova janela do PowerShell, entre no módulo do Azure AD novamente usando Connect-AzureAD.Continue using the same PowerShell window, or if you're using a new PowerShell window, sign in to the Azure AD module again using Connect-AzureAD. Depois, siga estas etapas:Then follow these steps:

  1. Crie uma variável para armazenar o valor de ID do objeto que você copiou na seção anterior.Create a variable to hold the ObjectId value you copied in the previous section. (Substitua o valor de ID do objeto usado para neste exemplo do SharePoint com o valor de ID de objeto do seu aplicativo.)(Replace the ObjectId value used for in this SharePoint example with your app's ObjectId value.)

    $objguid = "8af89bfa-eac6-40b0-8a13-c2c4e3ee22a4"
    
  2. Confirme se você tem o aplicativo correto, executando o comando a seguir.Confirm that you have the correct app by running the following command. A saída deve ser idêntica de saída que você viu na seção anterior (localizar a ObjectId do aplicativo).The output should be identical to the output you saw in the previous section (Find the ObjectId of the app).

    Get-AzureADApplication -ObjectId $objguid | Format-List DisplayName, Homepage, ObjectId
    
  3. Crie um objeto de aplicativo em branco para armazenar as alterações que você deseja fazer.Create a blank application object to hold the changes that you want to make.

    $appnew = New-Object "Microsoft.Open.AzureAD.Model.Application"
    
  4. Defina a URL da home page como o valor desejado.Set the home page URL to the value that you want. O valor deve ser um caminho de subdomínio do aplicativo publicado.The value must be a subdomain path of the published app. 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.For example, if you change the home page URL from https://sharepoint-iddemo.msappproxy.net/ to https://sharepoint-iddemo.msappproxy.net/hybrid/, app users go directly to the custom home page.

    $homepage = "https://sharepoint-iddemo.msappproxy.net/hybrid/"
    
  5. Faça a atualização da página inicial.Make the update of the home page.

    Set-AzureADApplication -ObjectId $objguid -Homepage $homepage
    
  6. Para confirmar que a alteração foi bem-sucedida, execute o seguinte comando da etapa 2 novamente.To confirm that the change was successful, run the following command from step 2 again.

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

    Para nosso exemplo, a saída agora deve aparecer da seguinte maneira:For our example, the output should now appear as follows:

    DisplayName : SharePoint
    Homepage    : https://sharepoint-iddemo.msappproxy.net/hybrid/
    ObjectId    : 8af89bfa-eac6-40b0-8a13-c2c4e3ee22a4
    
  7. Reinicie o aplicativo para confirmar que a home page é exibida como a primeira tela, conforme o esperado.Restart the app to confirm that the home page appears as the first screen, as expected.

Observação

Todas as alterações que você fizer no aplicativo poderão redefinir a URL da home page.Any changes that you make to the app might reset the home page URL. Se a URL da página inicial for redefinida, repita as etapas nesta seção para defini-la novamente.If your home page URL resets, repeat the steps in this section to set it back.

Próximas etapasNext steps