Impostare una home page personalizzata per le app pubblicate tramite il proxy applicazione di Azure AD

Questo articolo illustra come configurare le app in modo che indirizzino gli utenti a una home page personalizzata quando gli utenti accedono alle app dal pannello di accesso di Azure Active Directory (Azure AD) e dall'icona di avvio delle app di Office 365.

Quando gli utenti avviano le app, per impostazione predefinita vengono indirizzati all'URL del dominio radice dell'app pubblicata. La pagina di destinazione viene impostata in genere sull'URL della home page. Ad esempio, per l'applicazione back-end http://ExpenseApp, l'URL viene pubblicato come https://expenseApp-contoso.msappproxy.net. Per impostazione predefinita, l'URL della home page è impostato su https://expenseApp-contoso.msappproxy.net.

Tramite il modulo Azure AD PowerShell è possibile definire URL della home page personalizzata per i casi in cui si vuole che gli utenti accedano a una pagina specifica all'interno dell'app, ad esempio https://expenseApp-contoso.msappproxy.net/login/login.aspx.

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.

Prima di iniziare

Prima di impostare l'URL della home page, tenere presente quanto segue:

  • Assicurarsi che il percorso specificato sia un percorso di sottodominio dell'URL del dominio radice.

    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/.

  • Se si apporta una modifica all'app pubblicata, la modifica potrebbe reimpostare il valore dell'URL della home page. Quando si decide di aggiornare l'app è quindi necessario verificare ed eventualmente aggiornare l'URL della home page.

Cambiare la home page nel portale di Azure

  1. Accedere al portale di Azure come amministratore.
  2. Passare ad Azure Active Directory > Registrazioni per l'app e scegliere l'applicazione dall'elenco.
  3. Selezionare Proprietà dalle impostazioni.
  4. Aggiornare il campo URL della home page con il nuovo percorso.
  5. Selezionare Salva

Modificare la home page con PowerShell

Installare il modulo Azure AD PowerShell

Prima di definire l'URL di una home page personalizzata tramite PowerShell è necessario installare un pacchetto non standard del modulo Azure AD PowerShell. È possibile scaricare il pacchetto da PowerShell Gallery, che usa l'endpoint API Graph.

Per installare il pacchetto, seguire questa procedura:

  1. Aprire una finestra di PowerShell standard ed eseguire questo comando:

     Install-Module -Name AzureAD -RequiredVersion 1.1.23.0
    

    Se il comando non viene eseguito come amministratore, usare l'opzione -scope currentuser.

  2. Durante l'installazione selezionare Y per installare due pacchetti da Nuget.org. Sono necessari entrambi i pacchetti.

Trovare il valore ObjectID dell'app

Ottenere il valore ObjectID dell'app e quindi cercare l'app tramite la relativa home page.

  1. Aprire PowerShell e importare il modulo di Azure AD.

    Import-Module AzureAD
    
  2. Accedere al modulo di Azure AD come amministratore del tenant.

    Connect-AzureAD
    
  3. Individuare l'app in base all'URL della home page. È possibile trovare l'URL nel portale passando ad Azure Active Directory > Applicazioni aziendali > Tutte le applicazioni. Questo esempio usa sharepoint-iddemo.

    Get-AzureADApplication | where { $_.Homepage -like “sharepoint-iddemo” } | fl DisplayName, Homepage, ObjectID
    
  4. Viene visualizzato un risultato simile a quello illustrato di seguito. Copiare il GUID di ObjectID da usare nella sezione successiva.

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

Aggiornare l'URL della home page

Nello stesso modulo PowerShell usato per il passaggio 1, procedere come segue:

  1. Verificare che l'app sia corretta e sostituire 8af89bfa-eac6-40b0-8a13-c2c4e3ee22a4 con il valore GUID (ObjectID) copiato nel passaggio precedente.

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

    Ora che è stata verificata l'app, è possibile aggiornare la home page come indicato di seguito.

  2. Creare un oggetto applicazione vuoto per le modifiche da apportare.

    Nota

    Questa è solo una variabile che dovrà contenere i valori da aggiornare, perciò non è stato effettivamente creato nulla.

    $appnew = New-Object “Microsoft.Open.AzureAD.Model.Application”
    
  3. Impostare l'URL della home page sul valore desiderato. Il valore deve essere un percorso di sottodominio dell'app pubblicata. 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 verranno indirizzati direttamente alla home page personalizzata.

    $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".

    Set-AzureADApplication -ObjectId 8af89bfa-eac6-40b0-8a13-c2c4e3ee22a4 -Homepage $homepage
    
  5. Verificare che la modifica sia stata completata riavviando l'app.

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

Le modifiche apportate all'app possono reimpostare l'URL della home page. In questo caso, ripetere il passaggio 2.

Passaggi successivi