Festlegen einer benutzerdefinierten Startseite für veröffentlichte Apps mithilfe eines Microsoft Entra-Anwendungsproxys

2025-04-30

In diesem Artikel wird erläutert, wie Sie eine App so konfigurieren, dass sie Benutzer zu einer benutzerdefinierten Homepage weiterleiten. Wenn Sie eine App mit dem Anwendungsproxy veröffentlichen, legen Sie eine interne URL fest. Dies ist jedoch in einigen Fällen nicht die Seite, die den Benutzern zuerst angezeigt werden soll. Legen Sie eine benutzerdefinierte Startseite fest, damit Benutzer beim Zugriff auf die App die richtige Seite erhalten. Benutzer sehen die von Ihnen festgelegte benutzerdefinierte Startseite, unabhängig davon, ob sie von Microsoft Entra My Apps oder dem Microsoft 365-App-Startfeld auf die App zugreifen.

Wenn ein Benutzer die App startet, wird er standardmäßig an die Stammdomänen-URL für die veröffentlichte App weitergeleitet. Die Zielseite wird in der Regel als URL der Startseite festgelegt. Verwenden Sie das Microsoft Entra PowerShell-Modul, um eine benutzerdefinierte Startseiten-URL zu definieren, wenn ein App-Benutzer auf einer bestimmten Seite innerhalb der App landen soll.

Hier ist ein Szenario, das erklärt, warum Ihr Unternehmen eine benutzerdefinierte Homepage festlegen sollte:

In Ihrem Unternehmensnetzwerk navigiert ein Benutzer zu https://ExpenseApp/login/login.aspx, um sich anzumelden und auf Ihre App zuzugreifen.
Da Sie auf oberster Ebene der Ordnerstruktur über andere Ressourcen verfügen, auf die der Anwendungsproxy zugreifen muss (z. B. Images), veröffentlichen Sie die App mit https://ExpenseApp als interner URL.
Die standardmäßige externe URL lautet https://ExpenseApp-contoso.msappproxy.net, was einen externen Benutzer nicht zur Anmeldeseite leitet.
Sie möchten https://ExpenseApp-contoso.msappproxy.net/login/login.aspx als URL der Homepage festlegen, damit externen Benutzern zuerst die Anmeldeseite angezeigt wird.

Hinweis

Wenn Sie Benutzern Zugriff auf veröffentlichte Apps gewähren, werden die Apps in "Meine Apps" und im Office 365-App-Startfeld angezeigt.

Vorbereitung

Beachten Sie vor dem Festlegen der Startseiten-URL die folgenden Anforderungen:

Bei dem angegebenen Pfad muss es sich um einen Unterdomänenpfad der Stammdomänen-URL handeln.

Wenn die URL der Stammdomäne beispielsweise lautet https://apps.contoso.com/app1/, muss die von Ihnen konfigurierte Startseiten-URL mit https://apps.contoso.com/app1/beginnen.
Nach einer Änderung der veröffentlichten App wird der Wert der Startseiten-URL unter Umständen zurückgesetzt. Wenn Sie die App in Zukunft aktualisieren, sollten Sie die URL der Startseite erneut überprüfen und bei Bedarf aktualisieren.

Sie können die URL der Homepage über das Microsoft Entra Admin Center oder mithilfe von PowerShell festlegen.

Ändern der Homepage im Microsoft Entra Admin Center

Um die URL der Homepage Ihrer App über das Microsoft Entra Admin Center zu ändern, gehen Sie folgendermaßen vor:

Melden Sie sich mindestens als Anwendungsadministrator beim Microsoft Entra Admin Center an.
Wählen Sie rechts oben Ihren Benutzernamen aus. Stellen Sie sicher, dass Sie an einem Verzeichnis angemeldet sind, für das der Anwendungsproxy verwendet wird. Wenn Sie Verzeichnisse ändern müssen, wählen Sie "Verzeichnis wechseln" aus, und wählen Sie ein Verzeichnis aus, das anwendungsproxy verwendet.
Navigieren Sie zu Entra>ID-App-Registrierungen. Die Liste der registrierten Apps wird angezeigt.
Wählen Sie Ihre App in der Liste aus. Eine Seite mit den Details der registrierten App wird angezeigt.
Wählen Sie unter "Verwalten"die Option "Branding" aus.
Aktualisieren Sie die HOMEPAGE-URL mit Ihrem neuen Pfad.
Wählen Sie "Speichern" aus.

Ändern der Startseite mit PowerShell

Um die Homepage einer App über PowerShell zu konfigurieren, gehen Sie folgendermaßen vor:

Installieren Sie das Microsoft Entra PowerShell-Modul.
Suchen Sie den Wert ObjectId der App.
Aktualisieren Sie die URL der Homepage für die App mit PowerShell-Befehlen.

Installieren des Microsoft Entra PowerShell-Moduls

Bevor Sie eine benutzerdefinierte Homepage-URL mithilfe von PowerShell definieren, installieren Sie das Microsoft Entra PowerShell-Modul. Sie können das Paket aus dem PowerShell-Katalog herunterladen, der den Graph-API-Endpunkt verwendet.

Führen Sie diese Schritte aus, um das Paket zu installieren:

Öffnen Sie ein standardmäßiges PowerShell-Fenster, und führen Sie dann den folgenden Befehl aus:
```
Install-Module -Name Microsoft.Graph
```
Wenn Sie den Befehl ohne Administratorrechte ausführen, verwenden Sie die Option -Scope CurrentUser.
Wählen Sie während der Installation Y aus, um zwei Pakete aus Nuget.org zu installieren. Beide Pakete sind erforderlich.

Ermitteln der Objekt-ID der App

Sie erhalten die Objekt-ID der App, indem Sie nach dem Anzeigenamen oder der Homepage der App suchen.

Importieren Sie in demselben PowerShell-Fenster das Microsoft Entra-Modul.
```
Import-Module -Name Microsoft.Graph
```
Melden Sie sich beim Microsoft Entra-Modul als Mandantenadministrator an.
```
Connect-Entra -Scopes 'Application.Read.All'
```
Suchen Sie die App. In diesem Beispiel wird die Objekt-ID mithilfe von PowerShell gesucht, indem nach der App mit dem Anzeigenamen SharePoint gesucht wird.
```
Get-EntraApplication | Where-Object { $_.DisplayName -eq "SharePoint" } | Format-List DisplayName, IdentifierUris, ObjectId
```
Das Ergebnis sieht etwa wie das hier gezeigte aus. Kopieren Sie die GUID für die Objekt-ID zur Verwendung im nächsten Abschnitt.
```
DisplayName       : SharePoint
IdentifierUris    : https://sharepoint-iddemo.msappproxy.net/
ObjectId          : aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb
```
Alternativ können Sie auch einfach die Liste aller Apps abrufen, die Liste nach der App mit einem bestimmten Anzeigenamen oder einer bestimmten Homepage durchsuchen und die Objekt-ID der App anschließend kopieren.
```
Get-EntraApplication | Format-List DisplayName, IdentifierUris, ObjectId
```

Schritt 2: Aktualisieren der URL der Startseite

Erstellen Sie die URL der Startseite, und aktualisieren Sie die App mit diesem Wert. Fahren Sie im selben PowerShell-Fenster fort, oder wenn Sie stattdessen ein neues PowerShell-Fenster verwenden, melden Sie sich mit Connect-Entra erneut beim Microsoft Entra-Modul an. Führen Sie dann die folgenden Schritte durch:

Erstellen Sie eine Variable, die den kopierten Wert ObjectId enthält.
```
$objguid = "<object id>"
```
Vergewissern Sie sich, dass die richtige App vorliegt, indem Sie folgenden Befehl ausführen. Die Ausgabe sollte mit der Ausgabe identisch sein, die Sie im vorherigen Abschnitt gesehen haben (Suchen der ObjectId der App).
```
Get-EntraApplication -ObjectId $objguid | Format-List DisplayName, IdentifierUris, ObjectId
```
Legen Sie die URL der Startseite auf den gewünschten Wert fest. Der Wert muss ein Unterdomänenpfad der veröffentlichten App sein. Wenn Sie die URL der Startseite also beispielsweise von https://sharepoint-iddemo.msappproxy.net/ in https://sharepoint-iddemo.msappproxy.net/hybrid/ ändern, werden App-Benutzer direkt zur benutzerdefinierten Startseite weitergeleitet.

Verwenden Sie diesen Befehl:
```
Set-EntraApplication -ApplicationId $objguid -IdentifierUris 'https://sharepoint-iddemo.msappproxy.net/hybrid/'
```

Um zu bestätigen, dass die Änderung erfolgreich war, führen Sie den folgenden Befehl aus Schritt 2 erneut aus.

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

In unserem Beispiel sollte die Ausgabe der folgenden gleichen:

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

Starten Sie die App neu, um zu bestätigen, dass die Homepage wie erwartet als erster Bildschirm angezeigt wird.

Hinweis

Sämtliche Änderungen, die Sie an der App vornehmen, können die URL der Startseite zurücksetzen. Wenn die URL der Startseite zurückgesetzt wird, wiederholen Sie die Schritte in diesem Abschnitt, um sie wiederherzustellen.

Freigeben über