Microsoft Entra アプリケーション プロキシを使用して、発行されたアプリのカスタム ホーム ページを設定する

この記事では、ユーザーをカスタム ホーム ページに移動させるようにアプリを構成する方法について説明します。 アプリケーション プロキシを使用してアプリを発行するときに内部 URL を設定しますが、それが、最初にユーザーに対して表示すべきページでない場合があります。 ユーザーがアプリにアクセスするときに正しいページを取得するように、カスタム ホーム ページを設定します。 ユーザーは、Microsoft Entra My Apps または Microsoft 365 アプリ起動ツールからアプリにアクセスするかどうかに関係なく、設定したカスタム ホーム ページを表示します。

ユーザーがアプリを起動すると、既定で発行されたアプリのルート ドメイン URL に移動されます。 通常、ランディング ページがホーム ページの URL として設定されます。 Microsoft Entra PowerShell モジュールを使用して、アプリ ユーザーがアプリ内の特定のページに移動する場合に、カスタム ホーム ページ URL を定義します。

ご自分の会社がカスタム ホーム ページを設定する理由を説明する 1 つのシナリオを次に示します。

• あなたの企業ネットワーク内では、ユーザーが https://ExpenseApp/login/login.aspx に移動して、お使いのアプリにサインインしてアクセスします。
• フォルダー構造の最上位に、アプリケーション プロキシがアクセスする必要がある他のアセット (イメージなど) があるため、内部 URL として https://ExpenseApp を使用してアプリを発行します。
• 既定の外部 URL は https://ExpenseApp-contoso.msappproxy.netであり、外部ユーザーはサインイン ページに誘導されません。
• 代わりに https://ExpenseApp-contoso.msappproxy.net/login/login.aspx をホーム ページ URL として設定します。それにより、外部ユーザーに対しては最初にサインインページが表示されます。

開始する前に

ホーム ページの URL を設定する前に、次の要件に留意してください。

• 指定するパスは、ルート ドメイン URL のサブドメインのパスでなければなりません。

  たとえば、ルート ドメイン URL が https://apps.contoso.com/app1/されている場合、構成するホーム ページの URL は https://apps.contoso.com/app1/ で始まる必要があります。

• 発行されたアプリに変更を加えると、ホーム ページの URL の値がリセットされる可能性があります。 後でアプリを更新する場合は、ホーム ページの URL を再確認し、必要であれば更新してください。

ホーム ページの URL は、Microsoft Entra 管理センターまたは PowerShell を使用して設定することができます。

Microsoft Entra 管理センターでホーム ページを変更する

Microsoft Entra 管理センターからご自分のアプリのホーム ページ URL を変更するには、次の手順に従ってください。

1. Microsoft Entra 管理センターに、少なくともアプリケーション管理者としてサインインします。
2. 右上隅で自分のユーザー名を選択します。 アプリケーション プロキシを使うディレクトリにサインインしていることを確認します。 ディレクトリを変更する必要がある場合は、[ ディレクトリの切り替え ] を選択し、アプリケーション プロキシを使用するディレクトリを選択します。
3. Entra ID>アプリ登録に移動します。 登録済みのアプリの一覧が表示されます。
4. 一覧からアプリを選択します。 登録済みのアプリの詳細を示すページが表示されます。
5. [ 管理] で [ ブランド] を選択します。
6. ホーム ページの URL を新しいパスで更新します。
7. [保存] を選択します。

PowerShell でホーム ページを変更する

PowerShell を使用してアプリのホーム ページを構成するには、次を実行する必要があります。

1. Microsoft Entra PowerShell モジュールをインストールします。
2. アプリの ObjectId 値を見つけます。
3. PowerShell のコマンドを使用してアプリのホーム ページの URL を更新します。

Microsoft Entra PowerShell モジュールをインストールする

PowerShell を使用してカスタム ホーム ページ URL を定義する前に、Microsoft Entra PowerShell モジュールをインストールします。 Graph API エンドポイントを使用する PowerShell ギャラリーからパッケージをダウンロードできます。

このパッケージをインストールするには、次の手順を実行します。

1. 標準の PowerShell ウィンドウを開き、次のコマンドを実行します。

   Install-Module -Name Microsoft.Graph
   

   管理者権限なしでコマンドを実行している場合は、-Scope CurrentUser オプションを使用してください。

2. インストール中に Y を選択して、Nuget.org から 2 つのパッケージをインストールします。両方のパッケージが必要です。

アプリの ObjectId を見つける

アプリの ObjectId は、その表示名またはホーム ページでアプリを検索して取得します。

1. 同じ PowerShell ウィンドウで、Microsoft Entra モジュールをインポートします。

   Import-Module -Name Microsoft.Graph
   

2. テナント管理者として Microsoft Entra モジュールにサインインします。

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

3. アプリを見つけます。 この例では、PowerShell を使用して、SharePoint の表示名でアプリを検索して ObjectId を検出しています。

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

   次のような結果が表示されます。 次のセクションで使用するために ObjectId GUID をコピーします。

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

   または、単にすべてのアプリの一覧をプルし、特定の表示名やホーム ページでアプリの一覧を検索し、該当のアプリが検出されたらアプリの ObjectId をコピーすることもできます。

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

ホーム ページの URL を更新する

ホーム ページの URL を作成し、その値でアプリを更新します。 同じ PowerShell ウィンドウを引き続き使用します。または、新しい PowerShell ウィンドウを使用する場合は、Connect-Entra を使用してもう一度 Microsoft Entra モジュールにサインインしてください。 その後、次の手順に従います。

1. コピーした ObjectId 値を保持する変数を作成します。

   $objguid = "<object id>"
   

2. 次のコマンドを実行して、正しいアプリを持っていることを確認します。 出力は、前のセクションで確認した出力と同じである必要があります (アプリの ObjectId を検索します)。

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

3. ホーム ページの URL を目的の値に設定します。 この値は、発行済みアプリのサブドメイン パスである必要があります。 たとえば、ホーム ページの URL を https://sharepoint-iddemo.msappproxy.net/ から https://sharepoint-iddemo.msappproxy.net/hybrid/ に変更すると、アプリ ユーザーはカスタム ホーム ページに直接移動します。

   次のコマンドを実行します。

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

4. 変更が成功したことを確認するには、手順 2 からの次のコマンドをもう一度実行します。

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

   この例では、出力は次のように表示されるはずです。

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

5. アプリを再起動して、想定どおりにホーム ページが最初の画面として表示されることを確認します。

次のステップ

• Microsoft Entra アプリケーション プロキシを使用して SharePoint へのリモート アクセスを有効にする
• チュートリアル: Microsoft Entra ID のアプリケーション プロキシを使用してリモート アクセスするためのオンプレミス アプリケーションを追加する