Een aangepaste startpagina instellen voor gepubliceerde apps met behulp van de Microsoft Entra-toepassingsproxy

In dit artikel wordt beschreven hoe u een app configureert om een gebruiker naar een aangepaste startpagina te leiden. Wanneer u een app publiceert met de toepassingsproxy, stelt u een interne URL in, maar soms ziet u niet de pagina die een gebruiker als eerste zou moeten zien. Stel een aangepaste startpagina in zodat gebruikers de juiste pagina krijgen bij het openen van de app. Gebruikers zien de aangepaste startpagina die u instelt, ongeacht of ze toegang hebben tot de app vanuit Microsoft Entra Mijn apps of het startprogramma voor Microsoft 365-apps.

Wanneer een gebruiker de app start, wordt deze standaard omgeleid naar de URL van het hoofddomein voor de gepubliceerde app. De landingspagina wordt meestal ingesteld als de URL van de startpagina. Gebruik de Microsoft Entra PowerShell-module om een aangepaste URL voor de startpagina te definiëren wanneer u wilt dat een app-gebruiker op een specifieke pagina binnen de app terechtkomt.

In dit scenario wordt uitgelegd waarom uw bedrijf een aangepaste startpagina zou moeten instellen:

• Binnen uw bedrijfsnetwerk gaat een gebruiker zich https://ExpenseApp/login/login.aspx aanmelden en krijgt toegang tot uw app.
• Omdat u andere assets (zoals afbeeldingen) hebt waartoe de toepassingsproxy toegang moet hebben op het hoogste niveau van de mapstructuur, publiceert u de app met https://ExpenseApp als de interne URL.
• De standaard externe URL is https://ExpenseApp-contoso.msappproxy.net, waarmee geen externe gebruiker naar de aanmeldingspagina wordt geleid.
• U wilt in plaats daarvan https://ExpenseApp-contoso.msappproxy.net/login/login.aspx instellen als de URL van de startpagina, zodat een externe gebruiker eerst de aanmeldingspagina ziet.

Voordat u begint

Houd rekening met de volgende vereisten voordat u de URL van de startpagina instelt:

• Het pad dat u opgeeft, moet een subdomeinpad van de URL van het hoofddomein zijn.

  Als de URL van het hoofddomein bijvoorbeeld is https://apps.contoso.com/app1/, moet u beginnen met https://apps.contoso.com/app1/de URL van de startpagina die u configureert.

• Als u een wijziging aanbrengt in de gepubliceerde app, kan de wijziging de waarde van de URL van de startpagina opnieuw instellen. Wanneer u de app in de toekomst bijwerkt, moet u de URL van de startpagina opnieuw controleren en, indien nodig, bijwerken.

U kunt de URL van de startpagina instellen via het Microsoft Entra-beheercentrum of met behulp van PowerShell.

De startpagina wijzigen in het Microsoft Entra-beheercentrum

Als u de URL van de startpagina van uw app wilt wijzigen via het Microsoft Entra-beheercentrum, voert u de volgende stappen uit:

1. Meld u aan bij het Microsoft Entra-beheercentrum als ten minste een toepassingsbeheerder.
2. Selecteer uw gebruikersnaam in de rechterbovenhoek. Controleer of u bent aangemeld bij een map die gebruikmaakt van de toepassingsproxy. Als u mappen wilt wijzigen, selecteert u Schakelen tussen mappen en kiest u een map die gebruikmaakt van de toepassingsproxy.
3. Blader naar Entra ID>App-registraties. De lijst met geregistreerde apps wordt weergegeven.
4. Kies uw app uit de lijst. Er wordt een pagina met de details van de geregistreerde app weergegeven.
5. Onder Beheren, selecteer de optie Huisstijl.
6. Werk de URL van de startpagina bij met uw nieuwe pad.
7. Selecteer Opslaan.

De startpagina wijzigen met PowerShell

Als u de startpagina van een app wilt configureren met PowerShell, moet u het volgende doen:

1. Installeer de Microsoft Entra PowerShell-module.
2. Zoek de waarde ObjectId van de app.
3. Werk de URL van de startpagina van de app bij met PowerShell-opdrachten.

De Microsoft Entra PowerShell-module installeren

Voordat u een aangepaste URL voor de startpagina definieert met behulp van PowerShell, installeert u de Microsoft Entra PowerShell-module. U kunt het pakket downloaden uit PowerShell Gallery, dat gebruikmaakt van het Graph API-eindpunt.

Voer de volgende stappen uit om het pakket te installeren:

1. Open een standaard PowerShell-venster en voer dan de volgende opdracht uit:

   Install-Module -Name Microsoft.Graph
   

   Als u de opdracht zonder beheerdersrechten uitvoert, gebruikt u de -Scope CurrentUser optie.

2. Selecteer tijdens de installatie Y om twee pakketten uit Nuget.org te installeren. Beide pakketten zijn vereist.

De ObjectId van de app zoeken

U vindt de ObjectId van de app door te zoeken naar de app op basis van de weergavenaam of startpagina.

1. Importeer in hetzelfde PowerShell-venster de Microsoft Entra-module.

   Import-Module -Name Microsoft.Graph
   

2. Meld u als tenantbeheerder aan bij de Microsoft Entra-module.

   Connect-Entra -Scopes 'Application.Read.All'
   

3. Zoek de app. In dit voorbeeld wordt PowerShell gebruikt om de ObjectId te vinden door te zoeken naar de app met een weergavenaam SharePoint.

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

   U krijgt een resultaat dat vergelijkbaar is met het resultaat dat hier wordt weergegeven. Kopieer de ObjectId-GUID die u in de volgende sectie wilt gebruiken.

   DisplayName       : SharePoint
   IdentifierUris    : https://sharepoint-iddemo.msappproxy.net/
   ObjectId          : aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb
   

   U kunt ook gewoon de lijst met alle apps ophalen, de lijst zoeken naar de app met een specifieke weergavenaam of startpagina en de ObjectId van de app kopiëren zodra de app is gevonden.

   Get-EntraApplication | Format-List DisplayName, IdentifierUris, ObjectId
   

De URL van de startpagina bijwerken

Maak de URL van de startpagina en werk uw app bij met die waarde. Blijf hetzelfde PowerShell-venster gebruiken of meld u opnieuw aan bij de Microsoft Entra-module als Connect-Entrau een nieuw PowerShell-venster gebruikt. Volg nu deze stappen:

1. Maak een variabele voor het opslaan van de ObjectId waarde die u hebt gekopieerd.

   $objguid = "<object id>"
   

2. Controleer of u de juiste app hebt door de volgende opdracht uit te voeren. De uitvoer moet identiek zijn aan de uitvoer die u in de vorige sectie hebt gezien (Zoek de ObjectId van de app).

   Get-EntraApplication -ObjectId $objguid | Format-List DisplayName, IdentifierUris, ObjectId
   

3. Stel de URL van de startpagina in op de gewenste waarde. De waarde moet een subdomeinpad van de gepubliceerde app zijn. Als u bijvoorbeeld de URL van de startpagina wijzigt van https://sharepoint-iddemo.msappproxy.net/ in https://sharepoint-iddemo.msappproxy.net/hybrid/, gaan app-gebruikers rechtstreeks naar de aangepaste startpagina.

   Gebruik deze opdracht

   Set-EntraApplication -ApplicationId $objguid -IdentifierUris 'https://sharepoint-iddemo.msappproxy.net/hybrid/'
   

4. Als u wilt controleren of de wijziging is geslaagd, voert u de volgende opdracht opnieuw uit vanaf stap 2.

   Get-EntraApplication -ObjectId $objguid | Format-List DisplayName, IdentifierUris, ObjectId
   

   In ons voorbeeld moet de uitvoer nu als volgt worden weergegeven:

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

5. Start de app opnieuw om te bevestigen dat de startpagina wordt weergegeven als het eerste scherm, zoals verwacht.

Volgende stappen

• Externe toegang tot SharePoint inschakelen met Microsoft Entra-toepassingsproxy
• Handleiding: Een on-premises Toepassing toevoegen voor externe toegang via proxyserver voor toepassingen in Microsoft Entra ID