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

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

ユーザーはアプリを起動すると、既定で、発行されたアプリのルート ドメイン URL に案内されます。 通常、ランディング ページがホーム ページの URL として設定されます。 アプリ ユーザーに、アプリ内の特定のページを最初に訪問させたい場合は、Azure AD 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 として設定します。それにより、外部ユーザーに対しては最初にサインインページが表示されます。

注意

発行されたアプリにユーザーがアクセスできるようにすると、マイ アプリと Office 365 アプリ起動ツールにアプリが表示されます。

開始する前に

ホーム ページの 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. [ID]>[アプリケーション]>[アプリの登録] を参照します。 登録済みのアプリの一覧が表示されます。

4. 一覧からアプリを選択します。 登録済みのアプリの詳細を示すページが表示されます。

5. [管理] 下にある [ブランド] を選択します。

6. [ホーム ページ URL] をご自分の新しいパスで更新します。

   

7. [保存] を選択します。

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

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

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

Azure AD PowerShell モジュールをインストールする

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

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

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

   Install-Module -Name AzureAD
   

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

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

アプリの ObjectId を見つける

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

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

   Import-Module AzureAD
   

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

   Connect-AzureAD
   

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

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

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

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

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

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

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

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

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

   $objguid = "<object id>"
   

2. 次のコマンドを実行して、正しいアプリを持っていることを確認します。 この出力は、前のセクション (「アプリの Objectid を見つける」) で確認した出力と同じものになるはずです。

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

3. 修正する変更箇所を保持しておくために、空のアプリケーション オブジェクトを作成します。

   $appnew = New-Object "Microsoft.Open.AzureAD.Model.Application"
   

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

   $homepage = "https://sharepoint-iddemo.msappproxy.net/hybrid/"
   

5. ホーム ページの更新を行います。

   Set-AzureADApplication -ObjectId $objguid -Homepage $homepage
   

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

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

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

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

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

注意

アプリを変更すると、ホーム ページの URL がリセットされる可能性があります。 ホーム ページの URL がリセットされた場合は、このセクションの手順を繰り返して設定し直します。

次のステップ

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