Impostare una home page personalizzata per le app pubblicate usando il proxy dell'applicazione Microsoft Entra

Articolo
02/26/2024

Questo articolo illustra come configurare un'app per indirizzare un utente a una home page personalizzata. Quando si pubblica un'app con il proxy dell'applicazione, si imposta un URL interno, ma a volte questa non è la pagina visualizzata da un utente. Impostare una home page personalizzata in modo che un utente ottenga la pagina corretta quando accede all'app. Un utente visualizza la home page personalizzata impostata, indipendentemente dal fatto che accingano all'app dall'App personali Microsoft Entra o dall'icona di avvio delle app di Microsoft 365.

Quando un utente avvia l'app, per impostazione predefinita viene indirizzato all'URL del dominio radice per l'app pubblicata. La pagina di destinazione viene impostata in genere sull'URL della home page. Usare il modulo Azure AD PowerShell per definire un URL della home page personalizzato quando si vuole che un utente dell'app si trovi in una pagina specifica all'interno dell'app.

Ecco uno scenario che spiega perché l'azienda imposta una home page personalizzata:

All'interno della rete aziendale, un utente passa all'accesso https://ExpenseApp/login/login.aspx e all'accesso all'app.
Poiché si dispone di altri asset ,ad esempio immagini, che il proxy dell'applicazione deve accedere al livello superiore della struttura di cartelle, si pubblica l'app con https://ExpenseApp come URL interno.
L'URL esterno predefinito è https://ExpenseApp-contoso.msappproxy.net, che non porta un utente esterno alla pagina di accesso.
Si vuole impostare https://ExpenseApp-contoso.msappproxy.net/login/login.aspx invece come URL della home page, in modo che un utente esterno visualizzi prima la pagina di accesso.

Nota

Quando si concede agli utenti l'accesso alle app pubblicate, le app vengono visualizzate in App personali e nell'icona di avvio delle app di Office 365.

Prima di iniziare

Prima di impostare l'URL della home page, tenere presente i requisiti presenti:

Il percorso specificato deve essere un percorso di sottodominio dell'URL del dominio radice.

Ad esempio, 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.

È possibile impostare l'URL della home page tramite l'interfaccia di amministrazione di Microsoft Entra o tramite PowerShell.

Modificare la home page nell'interfaccia di amministrazione di Microsoft Entra

Per modificare l'URL della home page dell'app tramite l'interfaccia di amministrazione di Microsoft Entra, seguire questa procedura:

Accedere all'Interfaccia di amministrazione di Microsoft Entra almeno come amministratore applicazione.
Selezionare il nome utente nell'angolo superiore destro. Verificare di aver effettuato l'accesso a una directory che usa l'application proxy. Se è necessario cambiare directory, selezionare Cambia directory e scegliere una directory che usa il proxy di applicazione.
Passare a Identità>Applicazioni>Registrazioni app. Viene visualizzato l'elenco delle app registrate.
Scegliere l'app dall'elenco. Viene visualizzata una pagina che mostra i dettagli dell'app registrata.
In Gestisci selezionare Personalizzazione.
Aggiornare l'URL della home page con il nuovo percorso.
Seleziona Salva.

Modificare la home page con PowerShell

Per configurare la home page di un'app tramite PowerShell, è necessario:

Installare il modulo Azure AD PowerShell.
Trovare il valore ObjectId dell'app.
Aggiornare l'URL della home page dell'app usando i comandi di PowerShell.

Installare il modulo Azure AD PowerShell

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

Per installare il pacchetto, seguire questa procedura:

Aprire una finestra di PowerShell standard ed eseguire questo comando:
```
Install-Module -Name AzureAD
```
Se si esegue il comando senza diritti amministrativi, usare l'opzione -scope currentuser .
Durante l'installazione, selezionare Y per installare due pacchetti da Nuget.org. Entrambi i pacchetti sono necessari.

Trovare l'ObjectId dell'app

Ottieni l'ObjectId dell'app cercando l'app in base al nome visualizzato o alla home page.

Nella stessa finestra di PowerShell importare il modulo Microsoft Entra.
```
Import-Module AzureAD
```
Accedere al modulo Microsoft Entra come amministratore tenant.
```
Connect-AzureAD
```
Trovare l'app. Questo esempio usa PowerShell per trovare ObjectId cercando l'app con un nome visualizzato .SharePoint
```
Get-AzureADApplication | Where-Object { $_.DisplayName -eq "SharePoint" } | Format-List DisplayName, Homepage, ObjectId
```
Viene visualizzato un risultato simile a quello illustrato di seguito. Copiare il GUID ObjectId da usare nella sezione successiva.
```
DisplayName : SharePoint
Homepage    : https://sharepoint-iddemo.msappproxy.net/
ObjectId    : aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb
```
In alternativa, puoi semplicemente eseguire il pull dell'elenco di tutte le app, cercare l'app con un nome visualizzato o una home page specifica e copiare l'ObjectId dell'app dopo aver trovato l'app.
```
Get-AzureADApplication | Format-List DisplayName, Homepage, ObjectId
```

Aggiornare l'URL della home page

Creare l'URL della home page e aggiornare l'app con tale valore. Continuare a usare la stessa finestra di PowerShell o, se si usa una nuova finestra di PowerShell, accedere nuovamente al modulo Microsoft Entra usando Connect-AzureAD. Quindi segui questi passaggi.

Creare una variabile per contenere il ObjectId valore copiato.
```
$objguid = "<object id>"
```
Verificare di avere l'app corretta eseguendo il comando seguente. L'output deve essere identico all'output visualizzato nella sezione precedente (trovare l'ObjectId dell'app).
```
Get-AzureADApplication -ObjectId $objguid | Format-List DisplayName, Homepage, ObjectId
```
Creare un oggetto applicazione vuoto per le modifiche da apportare.
```
$appnew = New-Object "Microsoft.Open.AzureAD.Model.Application"
```
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 dell'app passano direttamente alla home page personalizzata.
```
$homepage = "https://sharepoint-iddemo.msappproxy.net/hybrid/"
```

Aggiornare la home page.

Set-AzureADApplication -ObjectId $objguid -Homepage $homepage

Per verificare che la modifica sia stata completata correttamente, eseguire di nuovo il comando seguente nel passaggio 2.

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

Per questo esempio, l'output dovrebbe ora essere visualizzato come segue:

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

Riavviare l'app per verificare che la home page venga visualizzata come prima schermata, come previsto.

Nota

Le modifiche apportate all'app possono reimpostare l'URL della home page. Se l'URL della home page si reimposta, ripetere la procedura in questa sezione per impostarlo di nuovo.

Condividi tramite