Impostare una home page personalizzata per le app pubblicate tramite il proxy applicazione di Azure ADSet a custom home page for published apps by using Azure AD Application Proxy

In questo articolo viene illustrato come configurare le app per indirizzare gli utenti a una home page personalizzata.This article discusses how to configure apps to direct users to a custom home page. Quando si pubblica un'applicazione con Proxy dell'applicazione, si imposta un URL interno ma a volte non è la pagina che gli utenti dovrebbero vedere per prima.When you publish an application with Application Proxy, you set an internal URL but sometimes that's not the page your users should see first. Impostare una home page personalizzata in modo che gli utenti visualizzino la pagina corretta quando accedono alle app.Set a custom home page so that your users go to the right page when they access the apps. Gli utenti vedranno la home page personalizzata impostata sia che accedano all'app dal riquadro di accesso di Azure Active Directory che dall'icona di avvio delle app di Office 365.Your users will see the custom home page that you set, whether they access the app from the Azure Active Directory Access Panel or the Office 365 app launcher.

Quando gli utenti avviano le app, per impostazione predefinita vengono indirizzati all'URL del dominio radice dell'app pubblicata.When users launch the app, they're directed by default to the root domain URL for the published app. La pagina di destinazione viene impostata in genere sull'URL della home page.The landing page is typically set as the home page URL. Usare il modulo PowerShell di Azure AD per definire l'URL della home page personalizzata quando si desidera che gli utenti dell'app arrivino ad una pagina specifica all'interno dell'app.Use the Azure AD PowerShell module to define custom home page URLs when you want app users to land on a specific page within the app.

Ecco un esempio del motivo per cui una società potrebbe impostare una home page personalizzata:Here's one example of why a company would set a custom home page:

Nota

Quando si fornisce agli utenti l'accesso alle app pubblicate, le app vengono visualizzate nel pannello di accesso di Azure AD e nell'icona di avvio delle app di 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.

Prima di iniziareBefore you start

Prima di impostare l'URL della home page, tenere presente i requisiti presenti:Before you set the home page URL, keep in mind the following requirements:

  • Assicurarsi che il percorso specificato sia un percorso di sottodominio dell'URL del dominio radice.Ensure that the path you specify is a subdomain path of the root domain URL.

    Se l'URL del dominio radice è https://apps.contoso.com/app1/, l'URL della home page configurato deve iniziare con https://apps.contoso.com/app1/.If the root-domain URL is, for example, https://apps.contoso.com/app1/, the home page URL that you configure must start with https://apps.contoso.com/app1/.

  • Se si apporta una modifica all'app pubblicata, la modifica potrebbe reimpostare il valore dell'URL della home page.If you make a change to the published app, the change might reset the value of the home page URL. Quando si decide di aggiornare l'app è quindi necessario verificare ed eventualmente aggiornare l'URL della home page.When you update the app in the future, you should recheck and, if necessary, update the home page URL.

Cambiare la home page nel portale di AzureChange the home page in the Azure portal

  1. Accedere al portale di Azure come amministratore.Sign in to the Azure portal as an administrator.
  2. Passare ad Azure Active Directory > Registrazioni per l'app e scegliere l'applicazione dall'elenco.Navigate to Azure Active Directory > App registrations and choose your application from the list.
  3. Selezionare Proprietà dalle impostazioni.Select Properties from the settings.
  4. Aggiornare il campo URL della home page con il nuovo percorso.Update the Home page URL field with your new path.

    Fornire nuovi URL della home page

  5. Selezionare SalvaSelect Save

Modificare la home page con PowerShellChange the home page with PowerShell

Installare il modulo Azure AD PowerShellInstall the Azure AD PowerShell module

Prima di definire l'URL di una home page personalizzata tramite PowerShell è necessario installare il modulo Azure AD PowerShell.Before you define a custom home page URL by using PowerShell, install the Azure AD PowerShell module. È possibile scaricare il pacchetto da PowerShell Gallery, che usa l'endpoint API Graph.You can download the package from the PowerShell Gallery, which uses the Graph API endpoint.

Per installare il pacchetto, seguire questa procedura:To install the package, follow these steps:

  1. Aprire una finestra di PowerShell standard ed eseguire questo comando:Open a standard PowerShell window, and then run the following command:

     Install-Module -Name AzureAD
    

    Se il comando non viene eseguito come amministratore, usare l'opzione -scope currentuser.If you're running the command as a non-admin, use the -scope currentuser option.

  2. Durante l'installazione selezionare Y per installare due pacchetti da Nuget.org. Sono necessari entrambi i pacchetti.During the installation, select Y to install two packages from Nuget.org. Both packages are required.

Trovare il valore ObjectID dell'appFind the ObjectID of the app

Ottenere il valore ObjectID dell'app e quindi cercare l'app tramite la relativa home page.Obtain the ObjectID of the app, and then search for the app by its home page.

  1. Nella stessa finestra di PowerShell importare il modulo di Azure AD.In the same PowerShell window, import the Azure AD module.

    Import-Module AzureAD
    
  2. Accedere al modulo di Azure AD come amministratore del tenant.Sign in to the Azure AD module as the tenant administrator.

    Connect-AzureAD
    
  3. Individuare l'app in base all'URL della home page.Find the app based on its home page URL. È possibile trovare l'URL nel portale passando ad Azure Active Directory > Applicazioni aziendali > Tutte le applicazioni.You can find the URL in the portal by going to Azure Active Directory > Enterprise applications > All applications. Questo esempio usa sharepoint-iddemo.This example uses sharepoint-iddemo.

    Get-AzureADApplication | where { $_.Homepage -like “sharepoint-iddemo” } | fl DisplayName, Homepage, ObjectID
    
  4. Viene visualizzato un risultato simile a quello illustrato di seguito.You should get a result that's similar to the one shown here. Copiare il GUID di ObjectID da usare nella sezione successiva.Copy the ObjectID GUID to use in the next section.

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

Aggiornare l'URL della home pageUpdate the home page URL

Creare l'URL della home page e aggiornare l'applicazione con tale valore.Create the home page URL, and update your application with that value. Continuare a usare la stessa finestra di PowerShell per eseguire questi comandi.Continue using the same PowerShell window to run these commands. In alternativa, se si usa una nuova finestra di PowerShell, accedere di nuovo al modulo di Azure AD usando Connect-AzureAD.Or, if you're using a new PowerShell window, sign in to the Azure AD module again using Connect-AzureAD.

  1. Verificare che l'app sia corretta e sostituire 8af89bfa-eac6-40b0-8a13-c2c4e3ee22a4 con il valore di ObjectID copiato nella sezione precedente.Confirm that you have the correct app, and replace 8af89bfa-eac6-40b0-8a13-c2c4e3ee22a4 with the ObjectID that you copied in the preceding section.

    Get-AzureADApplication -ObjectId 8af89bfa-eac6-40b0-8a13-c2c4e3ee22a4.
    

    Ora che è stata verificata l'app, è possibile aggiornare la home page come indicato di seguito.Now that you've confirmed the app, you're ready to update the home page, as follows.

  2. Creare un oggetto applicazione vuoto per le modifiche da apportare.Create a blank application object to hold the changes that you want to make. Questa variabile contiene i valori che si desidera aggiornare.This variable holds the values that you want to update. Non viene creato nulla in questo passaggio.Nothing is created in this step.

    $appnew = New-Object “Microsoft.Open.AzureAD.Model.Application”
    
  3. Impostare l'URL della home page sul valore desiderato.Set the home page URL to the value that you want. Il valore deve essere un percorso di sottodominio dell'app pubblicata.The value must be a subdomain path of the published app. Se ad esempio si modifica l'URL della home page da https://sharepoint-iddemo.msappproxy.net/ a https://sharepoint-iddemo.msappproxy.net/hybrid/, gli utenti vengono indirizzati direttamente alla home page personalizzata.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/”
    
  4. Eseguire l'aggiornamento usando il GUID (ObjectID) copiato in "Passaggio 1: trovare il valore ObjectID dell'app".Make the update by using the GUID (ObjectID) that you copied in "Step 1: Find the ObjectID of the app."

    Set-AzureADApplication -ObjectId 8af89bfa-eac6-40b0-8a13-c2c4e3ee22a4 -Homepage $homepage
    
  5. Verificare che la modifica sia stata completata riavviando l'app.To confirm that the change was successful, restart the app.

    Get-AzureADApplication -ObjectId 8af89bfa-eac6-40b0-8a13-c2c4e3ee22a4
    

Nota

Le modifiche apportate all'app possono reimpostare l'URL della home page.Any changes that you make to the app might reset the home page URL. Se l'URL della home page si reimposta, ripetere la procedura in questa sezione per impostarlo di nuovo.If your home page URL resets, repeat the steps in this section to set it back.

Passaggi successiviNext steps