使用 Microsoft Entra 應用程式 Proxy 為已發布的應用程式設定自訂首頁

文章
02/26/2024

本文討論如何設定應用程式，以將用戶導向自定義首頁。當您使用應用程式 Proxy 發佈應用程式時，會設定內部 URL，但有時不是用戶應該先看到的頁面。設定自定義首頁，讓使用者在存取應用程式時取得正確的頁面。無論使用者從 Microsoft Entra 我的應用程式還是 Microsoft 365 應用程式啟動器存取應用程式，都會看到您設定的自定義首頁。

當使用者啟動應用程式時，預設會導向已發佈應用程式的根域URL。登陸頁面通常會設定為首頁 URL。當您想要應用程式使用者登陸應用程式內的特定頁面時，請使用 Azure AD PowerShell 模組來定義自定義首頁 URL。

以下是一個案例，說明貴公司為何會設定自定義首頁：

在您的公司網路內，使用者會前往 https://ExpenseApp/login/login.aspx 登入並存取您的應用程式。
因為您有應用程式 Proxy 在資料夾結構最上層需要存取的其他資產（例如影像），因此您會將 https://ExpenseApp 應用程式發佈為內部 URL。
默認的外部 URL 是 https://ExpenseApp-contoso.msappproxy.net，不會將外部使用者帶到登入頁面。
您想要改為設定 https://ExpenseApp-contoso.msappproxy.net/login/login.aspx 為首頁 URL，因此外部使用者會先看到登入頁面。

注意

當您為使用者提供已發佈應用程式的存取權時，應用程式會顯示在我的應用程式和 Office 365 應用程式啟動器中。

在您開始使用 Intune 之前

設定首頁 URL 之前，請記住下列需求：

您指定的路徑必須是根域 URL 的子域路徑。

例如，如果根域 URL 是 https://apps.contoso.com/app1/，則您設定的首頁 URL 必須以 https://apps.contoso.com/app1/開頭。
如果您變更已發佈的應用程式，變更可能會重設首頁 URL 的值。當您在未來更新應用程式時，應該重新檢查，並視需要更新首頁 URL。

您可以透過 Microsoft Entra 系統管理中心或使用 PowerShell 來設定首頁 URL。

變更 Microsoft Entra 系統管理中心的首頁

若要透過 Microsoft Entra 系統管理中心變更應用程式的首頁 URL，請遵循下列步驟：

以至少應用程式管理員 istrator 身分登入 Microsoft Entra 系統管理中心。
選取右上角的用戶名稱。確認您已登入使用應用程式 Proxy 的目錄。如果您需要變更目錄，請選取 [切換目錄 ]，然後選擇使用應用程式 Proxy 的目錄。
流覽至 [身分>識別應用程式> 應用程式註冊。 已註冊的應用程式清單隨即出現。
從清單中選擇您的應用程式。顯示已註冊應用程式詳細數據的頁面隨即出現。
在 [管理] 底下，選取 [商標]。
使用 您的新路徑更新首頁 URL 。
選取 [儲存]。

使用 PowerShell 變更首頁

若要使用 PowerShell 設定應用程式的首頁，您需要：

安裝 Azure AD PowerShell 模組。
尋找應用程式的 ObjectId 值。
使用 PowerShell 命令更新應用程式的首頁 URL。

安裝 Azure AD PowerShell 模組

使用 PowerShell 定義自定義首頁 URL 之前，請先安裝 Azure AD PowerShell 模組。您可以從使用圖形 API 端點的 PowerShell 資源庫下載套件。

若要安裝套件，請遵循下列步驟：

開啟標準 PowerShell 視窗，然後執行下列命令：
```
Install-Module -Name AzureAD
```
如果您執行命令時沒有系統管理許可權，請使用 -scope currentuser 選項。
在安裝期間，選取 [Y ] 以從 Nuget.org 安裝兩個套件。這兩個套件都是必要的。

尋找應用程式的 ObjectId

您可以依應用程式的顯示名稱或首頁搜尋應用程式，以取得應用程式的 ObjectId。

在相同的 PowerShell 視窗中，匯入 Microsoft Entra 模組。
```
Import-Module AzureAD
```
以租用戶系統管理員身分登入 Microsoft Entra 模組。
```
Connect-AzureAD
```
尋找應用程式。此範例會使用PowerShell來尋找 ObjectId，方法是搜尋具有顯示名稱 SharePoint的應用程式。
```
Get-AzureADApplication | Where-Object { $_.DisplayName -eq "SharePoint" } | Format-List DisplayName, Homepage, ObjectId
```
您應該會收到類似此處所示的結果。複製 ObjectId GUID 以在下一節中使用。
```
DisplayName : SharePoint
Homepage    : https://sharepoint-iddemo.msappproxy.net/
ObjectId    : 8af89bfa-eac6-40b0-8a13-c2c4e3ee22a4
```
或者，您可以只提取所有應用程式的清單、搜尋具有特定顯示名稱或首頁的應用程式清單，並在找到應用程式後複製應用程式的 ObjectId。
```
Get-AzureADApplication | Format-List DisplayName, Homepage, ObjectId
```

更新首頁 URL

建立首頁 URL，並使用該值更新您的應用程式。繼續使用相同的 PowerShell 視窗，或者如果您使用新的 PowerShell 視窗，請使用 Connect-AzureAD再次登入 Microsoft Entra 模組。接著，依照下列步驟執行：

建立變數來保存 ObjectId 您複製的值。
```
$objguid = "<object id>"
```
執行下列命令來確認您有正確的應用程式。輸出應該與您在上一節中看到的輸出相同（尋找應用程式的 ObjectId）。
```
Get-AzureADApplication -ObjectId $objguid | Format-List DisplayName, Homepage, ObjectId
```
建立空白的應用程式物件，以保存您想要進行的變更。
```
$appnew = New-Object "Microsoft.Open.AzureAD.Model.Application"
```
將首頁 URL 設定為您想要的值。這個值必須是已發佈應用程式的子域路徑。例如，如果您將首頁 URL 從 https://sharepoint-iddemo.msappproxy.net/ 變更為 https://sharepoint-iddemo.msappproxy.net/hybrid/，應用程式使用者就會直接移至自定義首頁。
```
$homepage = "https://sharepoint-iddemo.msappproxy.net/hybrid/"
```

進行首頁的更新。

Set-AzureADApplication -ObjectId $objguid -Homepage $homepage

若要確認變更成功，請再次從步驟 2 執行下列命令。

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

在我們的範例中，輸出現在應該如下所示：

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

重新啟動應用程式，確認首頁顯示為第一個畫面，如預期般顯示。

注意

您對應用程式所做的任何變更，都可能會重設首頁 URL。如果您的首頁 URL 重設，請重複本節中的步驟，將其設回。