Nastavení vlastní domovské stránky pro publikované aplikace pomocí proxy aplikací Microsoft Entra

Tento článek popisuje, jak nakonfigurovat aplikaci tak, aby uživatele nasměrovává na vlastní domovskou stránku. Když publikujete aplikaci s proxy aplikací, nastavíte interní adresu URL, ale někdy to není stránka, kterou by měl uživatel vidět jako první. Nastavte vlastní domovskou stránku, aby uživatelé získali správnou stránku při přístupu k aplikaci. Uživatelé uvidí vlastní domovskou stránku, kterou jste nastavili, bez ohledu na to, jestli přistupují k aplikaci z Microsoft Entra My Apps nebo spouštěče aplikací Microsoft 365.

Když uživatel spustí aplikaci, ve výchozím nastavení se přesměruje na adresu URL kořenové domény publikované aplikace. Cílová stránka je obvykle nastavená jako adresa URL domovské stránky. Pomocí modulu Microsoft Entra PowerShell definujte vlastní adresu URL domovské stránky, pokud chcete, aby uživatel aplikace přistál na konkrétní stránce v aplikaci.

Tady je jeden scénář, který vysvětluje, proč by vaše společnost nastavovala vlastní domovskou stránku:

• Uvnitř podnikové sítě uživatel přejde na https://ExpenseApp/login/login.aspx, aby se přihlásil a získal přístup k vaší aplikaci.
• Protože máte další prostředky (například obrázky), ke kterým proxy aplikace potřebuje přistupovat na nejvyšší úrovni struktury složek, publikujete aplikaci s https://ExpenseApp jako interní adresou URL.
• Výchozí externí adresa URL je https://ExpenseApp-contoso.msappproxy.net, která nesměruje externího uživatele na přihlašovací stránku.
• Chcete místo toho nastavit https://ExpenseApp-contoso.msappproxy.net/login/login.aspx jako adresu URL domovské stránky, aby externí uživatel viděl přihlašovací stránku jako první.

Poznámka:

Když uživatelům udělíte přístup k publikovaným aplikacím, zobrazí se v Moje aplikace a ve spouštěči aplikací Office 365.

Než začnete

Před nastavením adresy URL domovské stránky mějte na paměti tyto požadavky:

• Zadaná cesta musí být cesta subdomény adresy URL kořenové domény.

  Pokud je například adresa URL kořenové domény https://apps.contoso.com/app1/, pak adresa URL domovské stránky, kterou nastavujete, musí začínat s https://apps.contoso.com/app1/.

• Pokud provedete změnu publikované aplikace, může změna obnovit hodnotu adresy URL domovské stránky. Při aktualizaci aplikace v budoucnu byste měli znovu zkontrolovat a v případě potřeby aktualizovat adresu URL domovské stránky.

Adresu URL domovské stránky můžete nastavit prostřednictvím Centra pro správu Microsoft Entra nebo pomocí PowerShellu.

Změna domovské stránky v Centru pro správu Microsoft Entra

Pokud chcete změnit adresu URL domovské stránky aplikace prostřednictvím Centra pro správu Microsoft Entra, postupujte takto:

1. Přihlaste se do Centra pro správu Microsoft Entra jako alespoň správce aplikací.
2. Vyberte své uživatelské jméno v pravém horním rohu. Ověřte, že jste přihlášení k adresáři, který používá proxy aplikace. Pokud potřebujete změnit adresáře, vyberte Přepnout adresář a zvolte adresář, který používá proxy aplikace.
3. Přejděte k Entra ID>registracím aplikace. Zobrazí se seznam registrovaných aplikací.
4. V seznamu vyberte svou aplikaci. Zobrazí se stránka s podrobnostmi registrované aplikace.
5. V části Spravovat vyberte Branding.
6. Aktualizujte adresu URL domovské stránky na novou cestu.
7. Vyberte Uložit.

Změna domovské stránky pomocí PowerShellu

Pokud chcete nakonfigurovat domovskou stránku aplikace pomocí PowerShellu, musíte:

1. Nainstalujte modul Microsoft Entra PowerShell.
2. Najděte hodnotu ObjectId aplikace.
3. Aktualizujte adresu URL domovské stránky aplikace pomocí příkazů PowerShellu.

Instalace modulu Microsoft Entra PowerShellu

Před definováním vlastní adresy URL domovské stránky pomocí PowerShellu nainstalujte modul Microsoft Entra PowerShell. Balíček si můžete stáhnout z PowerShell Galerie, která používá koncový bod rozhraní Graph API.

Chcete-li balíček nainstalovat, postupujte takto:

1. Otevřete standardní okno PowerShellu a spusťte následující příkaz:

   Install-Module -Name Microsoft.Graph
   

   Pokud příkaz spouštíte bez oprávnění správce, použijte tuto -Scope CurrentUser možnost.

2. Během instalace vyberte Y a nainstalujte ze Nuget.org dva balíčky. Oba balíčky jsou povinné.

Vyhledání ID objektu aplikace

Id objektu aplikace získáte tak, že aplikaci vyhledáte podle jejího zobrazovaného názvu nebo domovské stránky.

1. Ve stejném okně PowerShellu importujte modul Microsoft Entra.

   Import-Module -Name Microsoft.Graph
   

2. Přihlaste se k modulu Microsoft Entra jako správce tenanta.

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

3. Najděte aplikaci. Tento příklad používá PowerShell k vyhledání ObjectId vyhledáním aplikace se zobrazovaným názvem SharePoint.

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

   Měli byste získat výsledek, který je podobný té, která je zde zobrazená. Zkopírujte identifikátor GUID ObjectId, který chcete použít v další části.

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

   Případně můžete jednoduše načíst seznam všech aplikací, v seznamu vyhledat aplikaci podle konkrétního zobrazovaného názvu nebo domovské stránky a zkopírovat její ID objektu po jejím nalezení.

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

Aktualizace adresy URL domovské stránky

Vytvořte adresu URL domovské stránky a aktualizujte aplikaci pomocí této hodnoty. Pokračujte ve stejném okně PowerShellu nebo pokud používáte nové okno PowerShellu, znovu se přihlaste k modulu Microsoft Entra pomocí Connect-Entra. Poté postupujte následovně:

1. Vytvořte proměnnou, která bude obsahovat zkopírovanou ObjectId hodnotu.

   $objguid = "<object id>"
   

2. Spuštěním následujícího příkazu ověřte, že máte správnou aplikaci. Výstup by měl být shodný s výstupem, který jste viděli v předchozí části (Najít ID objektu aplikace).

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

3. Nastavte adresu URL domovské stránky na požadovanou hodnotu. Hodnota musí být cesta subdomény publikované aplikace. Pokud například změníte adresu URL domovské stránky z https://sharepoint-iddemo.msappproxy.net/ na https://sharepoint-iddemo.msappproxy.net/hybrid/, uživatelé aplikace přejdou přímo na vlastní domovskou stránku.

   Použijte tento příkaz:

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

4. Pokud chcete potvrdit, že změna proběhla úspěšně, spusťte z kroku 2 znovu následující příkaz.

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

   V našem příkladu by se teď měl výstup zobrazit takto:

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

5. Restartujte aplikaci, abyste potvrdili, že se domovská stránka zobrazuje jako první obrazovka podle očekávání.

Poznámka:

Všechny změny provedené v aplikaci můžou obnovit adresu URL domovské stránky. Pokud se adresa URL domovské stránky resetuje, opakujte kroky v této části a nastavte ji zpět.

Další kroky

• Povolení vzdáleného přístupu k SharePointu pomocí proxy aplikace Microsoft Entra
• Kurz: Přidání místní aplikace pro vzdálený přístup prostřednictvím proxy aplikací v Microsoft Entra ID