ホストされている ASP.NET Core Blazor WebAssembly アプリを Microsoft Entra ID でセキュリティ保護する

[アーティクル]
02/09/2024

この記事では、認証用に Microsoft Entra ID (ME-ID) を使用するホステッド Blazor WebAssembly ソリューションを作成する方法について説明します。この記事では、シングルテナント Azure アプリ登録を使用したシングルテナントアプリに焦点を当てます。

この記事では、マルチテナント ME-ID の登録については説明しません。詳しくは、「アプリケーションのマルチテナント化」を参照してください。

この記事では、「クイックスタート: テナントを設定する」で説明されているように、Microsoft Entra テナントの使用に焦点を当てています。「チュートリアル: Azure Active Directory B2C テナントの作成」で説明されているようにアプリを Azure Active Directory B2C テナントに登録していても、この記事のガイダンスに従うと、ME-ID によるアプリ ID URI の管理は異なる方法で行われます。詳細については、この記事の「Azure Active Directory B2C テナントの使用」セクションを参照してください。

この記事を読んだ後の追加のセキュリティシナリオの説明については、「ASP.NET Core Blazor WebAssembly のセキュリティに関するその他のシナリオ」を参照してください。

チュートリアル

このチュートリアルのサブセクションでは、次の方法について説明します。

Azure でテナントを作成する
Azure でサーバー API アプリを登録する
Azure でクライアントアプリを登録する
Blazor アプリを作成する
Serverappsettings.json 構成を変更する
既定のアクセストークンスコープスキームを変更する
アプリを実行する

Azure でテナントを作成する

「クイックスタート: テナントを設定する」のガイダンスに従って、ME-ID でテナントを作成します。

Azure でサーバー API アプリを登録する

サーバー API アプリ用の ME-ID アプリを登録します。

Azure portal で [Microsoft Entra ID] に移動します。サイドバーで [アプリケーション]>[アプリの登録] を選択します。 [新規登録] ボタンを選択します。
アプリの名前を指定します (例: Blazor Server ME-ID)。
[サポートされているアカウントの種類] を選択します。このエクスペリエンスでは、 [この組織のディレクトリ内のアカウントのみ] (シングルテナント) を選択できます。
"サーバー API アプリ" の場合、このシナリオでは [リダイレクト URI] は必要ないので、[プラットフォームの選択] ドロップダウンリストは選択しないままにし、リダイレクト URI は入力しないでください。
この記事では、アプリが Microsoft Entra ID テナントに登録されていることを前提としています。アプリが Azure Active Directory B2C テナントに登録されている場合は、[アクセス許可]>[openid と offline_access アクセス許可に対して管理者の同意を付与します] チェックボックスが表示され、選択されています。このチェックボックスの選択を解除して、設定を無効にします。 Active Azure Directory テナントを使用している場合、このチェックボックスは表示されません。
[登録] を選択します。

次の情報を記録しておきます。

"サーバー API アプリ" のアプリケーション (クライアント) ID (例: 41451fa7-82d9-4673-8fa5-69eff5a761fd)
ディレクトリ (テナント) ID (例: e86c78e2-8bb4-4c41-aefd-918e0565a45e)
ME-ID プライマリ、パブリッシャー、テナントドメイン (contoso.onmicrosoft.com など): ドメインは、Azure portal で登録されているアプリに対する [ブランド] ブレードのパブリッシャードメインとして使用できます。

[API のアクセス許可] で、[Microsoft Graph]>[User.Read] アクセス許可を削除します。サーバー API アプリでは、単にユーザーにサインインし、サーバー API エンドポイントを呼び出すための追加の API アクセスは必要ないためです。

[API の公開] で:

api://{SERVER API APP CLIENT ID} の形式でアプリ ID URI を確定または追加します。
[Scope の追加] を選択します。
[Save and continue](保存して続行) を選択します。
[スコープ名] を指定します (例: API.Access)。
[管理者の同意の表示名] を指定します (例: Access API)。
[管理者の同意の説明] を指定します (例: Allows the app to access server app API endpoints.)。
[状態] が [有効] に設定されていることを確認します。
[スコープの追加] を選択します。

次の情報を記録しておきます。

アプリ ID URI GUID (たとえば、api://41451fa7-82d9-4673-8fa5-69eff5a761fd のアプリ ID URI からのレコード 41451fa7-82d9-4673-8fa5-69eff5a761fd)
スコープ名 (例: API.Access)

重要

アプリ ID URI にカスタム値を使用する場合は、Blazor WebAssembly プロジェクトテンプレートからアプリを作成した後、Server アプリと Client アプリの両方に対して構成の変更が必要です。詳細については、「カスタムアプリ ID URI の使用」セクションを参照してください。

Azure でクライアントアプリを登録する

クライアントアプリ用の ME-ID アプリを登録します。

Azure portal で [Microsoft Entra ID] に移動します。サイドバーで [アプリの登録] を選択します。 [新規登録] ボタンを選択します。
アプリの名前を指定します (例: Blazor クライアント ME-ID)。
[サポートされているアカウントの種類] を選択します。このエクスペリエンスでは、 [この組織のディレクトリ内のアカウントのみ] (シングルテナント) を選択できます。
[リダイレクト URI] ドロップダウンリストを [シングルページアプリケーション (SPA)] に設定し、次のリダイレクト URI を指定します: https://localhost/authentication/login-callback。 Azure の既定のホスト (たとえば azurewebsites.net) またはカスタムドメインホスト (たとえば contoso.com) の運用リダイレクト URI がわかっている場合は、localhost リダイレクト URI を提供するのと同時に運用リダイレクト URI を追加することもできます。追加する運用リダイレクト URI には、ポート:443 以外のポートのポート番号を必ず含めてください。
この記事では、アプリが Microsoft Entra ID テナントに登録されていることを前提としています。アプリが Azure Active Directory B2C テナントに登録されている場合は、[アクセス許可]>[openid と offline_access アクセス許可に対して管理者の同意を付与します] チェックボックスが表示され、選択されています。このチェックボックスの選択を解除して、設定を無効にします。 Active Azure Directory テナントを使用している場合、このチェックボックスは表示されません。
[登録] を選択します。

Note

localhost ME-ID リダイレクト URI のポート番号を指定する必要はありません。詳細については、「リダイレクト URI (応答 URL) に関する制約と制限」の「Localhost 例外」(Entra ドキュメント) を参照してください。

Client アプリのアプリケーション (クライアント) ID を記録しておきます (例: 4369008b-21fa-427c-abaa-9b53bf58e538)。

[認証]>[プラットフォーム構成]>[シングルページアプリケーション] で次のようにします。

リダイレクト URI が https://localhost/authentication/login-callback であることを確認します。
[暗黙的な許可] セクションで、[アクセストークン] と [ID トークン] のチェックボックスが選択されていないことを確認します。 暗黙的な許可は、MSAL v2.0 以降が使用されている Blazor アプリにはお勧めしていません。 詳しくは、「ASP.NET Core Blazor WebAssembly をセキュリティで保護する」をご覧ください。
アプリの残りの既定値は、このエクスペリエンスで使用可能です。
変更を加えた場合は、[保存] ボタンを選択します。

[API のアクセス許可] で:

アプリに Microsoft Graph>User.Read アクセス許可があることを確認します。
[アクセス許可の追加] を選択し、 [自分の API] を選択します。
[名前] 列でサーバー API アプリを選択します (例: Blazor Server ME-ID)。
[API] の一覧を開きます。
API へのアクセスを有効にします (例: API.Access)。
[アクセス許可の追加] を選択します.
[<テナント名> に管理者の同意を与えます] ボタンを選択します。 [はい] を選択して確定します。

重要

アプリの使用に対する同意がユーザーに委任されたため、API アクセス許可の構成の最後の手順でテナントに管理者の同意を付与する権限を持っていなかった場合は、次の追加の手順を実行する必要があります。

アプリでは、信頼された発行元ドメインを使用する必要があります。
Azure portal の Server アプリの構成で、[API の公開] を選択します。 [認可済みのクライアントアプリケーション] で、[クライアントアプリケーションの追加] ボタンを選択します。 Client アプリのアプリケーション (クライアント) ID を追加します (例: 4369008b-21fa-427c-abaa-9b53bf58e538)。

Blazor アプリを作成する

空のフォルダーで、次のコマンドのプレースホルダーを、前に記録した情報に置き換え、コマンドシェルでこのコマンドを実行します。

dotnet new blazorwasm -au SingleOrg --api-client-id "{SERVER API APP CLIENT ID}" --app-id-uri "{SERVER API APP ID URI GUID}" --client-id "{CLIENT APP CLIENT ID}" --default-scope "{DEFAULT SCOPE}" --domain "{TENANT DOMAIN}" -ho -o {PROJECT NAME} --tenant-id "{TENANT ID}"

警告

OIDC アプリ識別子の形成を妨げるダッシュ (-) をアプリ名 {PROJECT NAME} に使用しないでください。 Blazor WebAssembly プロジェクトテンプレート内のロジックでは、ソリューションの構成内の OIDC アプリ識別子にプロジェクト名を使用します。パスカルケース (BlazorSample) またはアンダースコア (Blazor_Sample) は許容可能な代替手段です詳細については、ホストされた Blazor WebAssembly プロジェクト名に含まれるダッシュによって OIDC のセキュリティが破られる (dotnet/aspnetcore #35337)を参照してください。

プレースホルダー	Azure portal での名前	例
`{PROJECT NAME}`	—	`BlazorSample`
`{CLIENT APP CLIENT ID}`	Client アプリのアプリケーション (クライアント) ID	`4369008b-21fa-427c-abaa-9b53bf58e538`
`{DEFAULT SCOPE}`	スコープ名	`API.Access`
`{SERVER API APP CLIENT ID}`	"サーバー API アプリ" のアプリケーション (クライアント) ID	`41451fa7-82d9-4673-8fa5-69eff5a761fd`
`{SERVER API APP ID URI GUID}`	アプリケーション ID の URI GUID	`41451fa7-82d9-4673-8fa5-69eff5a761fd` (GUID のみ。既定では `{SERVER API APP CLIENT ID}` と一致します)
`{TENANT DOMAIN}`	プライマリ、パブリッシャー、テナントドメイン	`contoso.onmicrosoft.com`
`{TENANT ID}`	ディレクトリ (テナント) ID	`e86c78e2-8bb4-4c41-aefd-918e0565a45e`

-o|--output オプションで指定した出力場所にプロジェクトフォルダーが存在しない場合は作成されて、プロジェクトの名前の一部になります。 OIDC アプリ識別子の形成を妨げるダッシュ (-) をアプリ名に使用しないでください (前述の警告を参照)。

重要

アプリを実行する

Server プロジェクトからアプリを実行します。 Visual Studio を使用しているときは、次のいずれかを行います。

[実行] ボタンの横にあるドロップダウン矢印を選択します。ドロップダウンリストから [Configure Startup Projects] (スタートアッププロジェクトの構成) を開きます。 [シングルスタートアッププロジェクト] オプションを選択します。スタートアッププロジェクトのプロジェクトを確認するか、Server プロジェクトに変更します。
次のいずれかの方法でアプリを起動する前に、Server プロジェクトがソリューションエクスプローラーで強調表示されていることを確認します。
- [実行] ボタンを選択します。
- メニューの、 [デバッグ]>[デバッグ開始] を使用します。
- F5キーを押します。
コマンドシェルで、ソリューションの Server プロジェクトフォルダーに移動します。 dotnet run コマンドを実行します。

`User.Identity.Name` を構成する

"このセクションのガイダンスでは、必要に応じて name 要求の値を User.Identity.Name に設定する方法について説明します。"

既定では、 Server アプリ API により、http://schemas.xmlsoap.org/ws/2005/05/identity/claims/name 要求の種類からの値が User.Identity.Name に設定されます (例: 2d64b3da-d9d5-42c6-9352-53d8df33d770@contoso.onmicrosoft.com)。

name 要求の種類から値を受け取るようにアプリを構成するために、以下のようにします。

Program ファイルに Microsoft.AspNetCore.Authentication.JwtBearer の名前空間を追加します。
```
using Microsoft.AspNetCore.Authentication.JwtBearer;
```

JwtBearerOptions の TokenValidationParameters.NameClaimType を構成します。

builder.Services.Configure<JwtBearerOptions>(
    JwtBearerDefaults.AuthenticationScheme, options =>
    {
        options.TokenValidationParameters.NameClaimType = "name";
    });

ソリューションの各パーツ

このセクションでは、Blazor WebAssembly プロジェクトテンプレートから生成されたソリューションの各部分について説明し、そのソリューションの Client および Server プロジェクトを参照用に構成する方法について説明します。「チュートリアル」セクションのガイダンスを使用してアプリを作成した場合、基本的な作業アプリケーションについては、このセクションに従う必要がある具体的なガイダンスはありません。このセクションのガイダンスは、ユーザーの認証と承認を行うためにアプリを更新する場合に役立ちます。ただし、アプリは別の方法で更新することもできます。それには、「チュートリアル」セクションに記載のガイダンスに従って新しいアプリを作成し、アプリのコンポーネント、クラス、リソースを新しいアプリに移動してください。

`appsettings.json` 構成

"このセクションは、ソリューションの Server アプリに関連しています。 "

appsettings.json ファイルには、アクセストークンの検証に使用される JWT ベアラーハンドラーを構成するためのオプションが含まれています。次の AzureAd 構成セクションを追加します。

{
  "AzureAd": {
    "Instance": "https://login.microsoftonline.com/",
    "Domain": "{TENANT DOMAIN}",
    "TenantId": "{TENANT ID}",
    "ClientId": "{SERVER API APP CLIENT ID}",
    "CallbackPath": "/signin-oidc",
    "Scopes": "{SCOPES}"
  }
}

例:

{
  "AzureAd": {
    "Instance": "https://login.microsoftonline.com/",
    "Domain": "contoso.onmicrosoft.com",
    "TenantId": "e86c78e2-8bb4-4c41-aefd-918e0565a45e",
    "ClientId": "41451fa7-82d9-4673-8fa5-69eff5a761fd",
    "CallbackPath": "/signin-oidc",
    "Scopes": "API.Access"
  }
}

重要

Server アプリが (既定の形式 api://{SERVER API APP CLIENT ID} ではなく) ME-ID でカスタムアプリ ID URI を使用するように登録されている場合は、「カスタムアプリ ID URI の使用」セクションを参照してください。 Server および Client アプリの両方で変更を行う必要があります。

認証パッケージ

"このセクションは、ソリューションの Server アプリに関連しています。 "

Microsoft Identity Platform での ASP.NET Core Web API の呼び出しの認証と承認のサポートは、Microsoft.Identity.Web パッケージによって提供されます。

Note

.NET アプリへのパッケージの追加に関するガイダンスについては、「パッケージ利用のワークフロー」 (NuGet ドキュメント) の "パッケージのインストールと管理" に関する記事を参照してください。 NuGet.org で正しいパッケージバージョンを確認します。

Blazor WebAssembly テンプレートから作成された、ホストされている Blazor ソリューションの Server アプリには、既定で Microsoft.Identity.Web.UI パッケージが含まれます。このパッケージでは、Web アプリでユーザー認証用の UI が追加され、Blazor フレームワークでは使用されません。ユーザーの認証に Server アプリが直接使われない場合は、Server アプリのプロジェクトファイルからパッケージ参照を削除しても安全です。

認証サービスのサポート

"このセクションは、ソリューションの Server アプリに関連しています。 "

AddAuthentication メソッドにより、アプリ内での認証サービスが設定され、JWT ベアラーハンドラーが既定の認証方法として構成されます。 AddMicrosoftIdentityWebApi メソッドによって、Microsoft Identity Platform v2.0 を使用して Web API を保護するようにサービスを構成できます。このメソッドでは、認証オプションを初期化するために必要な設定で、アプリの構成の AzureAd セクションが想定されます。

builder.Services.AddAuthentication(JwtBearerDefaults.AuthenticationScheme)
    .AddMicrosoftIdentityWebApi(Configuration.GetSection("AzureAd"));

注意

1 つの認証スキームが登録されると、認証スキームがアプリの既定のスキームとして自動的に使用され、スキームを AddAuthentication に指定、または AuthenticationOptions 経由にする必要はありません。詳細については、「ASP.NET Core の認証の概要」と ASP.NET Core のお知らせ (aspnet/Announcements #490) を参照してください。

UseAuthentication と UseAuthorization により、次のようになります。

アプリにより、受信要求のトークンの解析と検証が試みられます。
適切な資格情報なしで保護されたリソースへのアクセスを試みた要求は失敗します。

app.UseAuthentication();
app.UseAuthorization();

WeatherForecast コントローラー

"このセクションは、ソリューションの Server アプリに関連しています。 "

WeatherForecast コントローラー (Controllers/WeatherForecastController.cs) は、[Authorize] 属性が適用されている保護された API をコントローラーに公開します。次のことを理解しておくことが重要です。

この API コントローラーの [Authorize] 属性は、この API を不正アクセスから保護する唯一のものです。
Blazor WebAssembly アプリで使用される [Authorize] 属性は、アプリが正しく動作するにはユーザーを承認する必要がある、というアプリへのヒントとしてのみ機能します。

[Authorize]
[ApiController]
[Route("[controller]")]
[RequiredScope(RequiredScopesConfigurationKey = "AzureAd:Scopes")]
public class WeatherForecastController : ControllerBase
{
    [HttpGet]
    public IEnumerable<WeatherForecast> Get()
    {
        ...
    }
}

`wwwroot/appsettings.json` 構成

"このセクションは、ソリューションの Client アプリに関連しています。 "

構成は wwwroot/appsettings.json ファイルによって提供されます。

{
  "AzureAd": {
    "Authority": "https://login.microsoftonline.com/{TENANT ID}",
    "ClientId": "{CLIENT APP CLIENT ID}",
    "ValidateAuthority": true
  }
}

例:

{
  "AzureAd": {
    "Authority": "https://login.microsoftonline.com/e86c78e2-...-918e0565a45e",
    "ClientId": "4369008b-21fa-427c-abaa-9b53bf58e538",
    "ValidateAuthority": true
  }
}

認証パッケージ

"このセクションは、ソリューションの Client アプリに関連しています。 "

職場または学校アカウント (SingleOrg) を使用するようにアプリを作成すると、アプリは Microsoft Authentication Library (Microsoft.Authentication.WebAssembly.Msal) のパッケージ参照を自動的に受け取ります。このパッケージには、アプリでユーザーを認証し、保護された API を呼び出すためのトークンを取得するのに役立つ一連のプリミティブが用意されています。

アプリに認証を追加する場合は、アプリに Microsoft.Authentication.WebAssembly.Msal パッケージを手動で追加します。

Note

Microsoft.Authentication.WebAssembly.Msal パッケージによって、Microsoft.AspNetCore.Components.WebAssembly.Authentication パッケージがアプリに推移的に追加されます。

認証サービスのサポート

"このセクションは、ソリューションの Client アプリに関連しています。 "

Server アプリへの要求を行うときのアクセストークンが含まれる HttpClient インスタンスのサポートが追加されます。

Program ファイルで次の操作を行います。

builder.Services.AddHttpClient("{PROJECT NAME}.ServerAPI", client => 
        client.BaseAddress = new Uri(builder.HostEnvironment.BaseAddress))
    .AddHttpMessageHandler<BaseAddressAuthorizationMessageHandler>();

builder.Services.AddScoped(sp => sp.GetRequiredService<IHttpClientFactory>()
    .CreateClient("{PROJECT NAME}.ServerAPI"));

プレースホルダー {PROJECT NAME} は、ソリューション作成時のプロジェクト名です。たとえば、プロジェクト名として BlazorSample を指定すると、BlazorSample.ServerAPI の名前付きの HttpClient が生成されます。

ユーザーの認証に対するサポートは、Microsoft.Authentication.WebAssembly.Msal パッケージによって提供される AddMsalAuthentication 拡張メソッドを使用して、サービスコンテナーに登録されます。このメソッドでは、アプリが IdentityID プロバイダー (IP) とやり取りするために必要なサービスが設定されます。

Program ファイルで次の操作を行います。

builder.Services.AddMsalAuthentication(options =>
{
    builder.Configuration.Bind("AzureAd", options.ProviderOptions.Authentication);
    options.ProviderOptions.DefaultAccessTokenScopes.Add("{SCOPE URI}");
});

AddMsalAuthentication メソッドでは、アプリを認証するために必要なパラメーターを構成するためのコールバックを受け入れます。アプリを構成するために必要な値は、アプリを登録するときに Azure Portal の ME-ID の構成から取得できます。

アクセストークンスコープ

"このセクションは、ソリューションの Client アプリに関連しています。 "

既定のアクセストークンスコープでは、次のようなアクセストークンスコープの一覧が表されます。

サインイン要求に既定で含まれます。
認証直後にアクセストークンをプロビジョニングするために使用されます。

Program ファイルには、必要に応じて他のスコープを追加することができます。

builder.Services.AddMsalAuthentication(options =>
{
    ...
    options.ProviderOptions.DefaultAccessTokenScopes.Add("{SCOPE URI}");
});

AdditionalScopesToConsent を使用して追加のスコープを指定します。

options.ProviderOptions.AdditionalScopesToConsent.Add("{ADDITIONAL SCOPE URI}");

Note

ユーザーが最初に Microsoft Azure に登録されたアプリを使用する場合、Microsoft Entra ID 同意 UI を介して Microsoft Graph の委任されたユーザーアクセス許可を AdditionalScopesToConsent でプロビジョニングすることはできません。詳細については、「ASP.NET Core Blazor WebAssembly で Graph API を使用する」を参照してください。

既定のアクセストークンスコープの例:

options.ProviderOptions.DefaultAccessTokenScopes.Add(
    "api://41451fa7-82d9-4673-8fa5-69eff5a761fd/API.Access");

詳細については、"その他のシナリオ" に関する記事の次のセクションを参照してください。

"このセクションは、ソリューションの Client アプリに関連しています。 "

フレームワークは、既定ではポップアップログインモードになり、ポップアップを開くことができない場合はリダイレクトログインモードに戻ります。 MsalProviderOptions の LoginMode プロパティを redirect に設定して、リダイレクトログインモードを使用するように MSAL を構成します。

builder.Services.AddMsalAuthentication(options =>
{
    ...
    options.ProviderOptions.LoginMode = "redirect";
});

既定の設定は popup であり、文字列の値の大文字と小文字は区別されません。

インポートファイル

"このセクションは、ソリューションの Client アプリに関連しています。 "

Microsoft.AspNetCore.Components.Authorization 名前空間は、_Imports.razor ファイルを介してアプリ全体で使用できるようになります。

@using System.Net.Http
@using System.Net.Http.Json
@using Microsoft.AspNetCore.Components.Authorization
@using Microsoft.AspNetCore.Components.Forms
@using Microsoft.AspNetCore.Components.Routing
@using Microsoft.AspNetCore.Components.Web
@using Microsoft.AspNetCore.Components.Web.Virtualization
@using Microsoft.AspNetCore.Components.WebAssembly.Http
@using Microsoft.JSInterop
@using {APPLICATION ASSEMBLY}
@using {APPLICATION ASSEMBLY}.Shared

Index ページ

"このセクションは、ソリューションの Client アプリに関連しています。 "

Index ページ (wwwroot/index.html) ページには、JavaScript で AuthenticationService を定義するスクリプトが含まれています。 AuthenticationService によって、OIDC プロトコルの下位レベルの詳細が処理されます。アプリは、認証操作を実行するために、スクリプトで定義されているメソッドを内部的に呼び出します。

<script src="_content/Microsoft.Authentication.WebAssembly.Msal/AuthenticationService.js"></script>

アプリコンポーネント

"このセクションは、ソリューションの Client アプリに関連しています。 "

App コンポーネント (App.razor) は、Blazor Server アプリにある App コンポーネントに似ています。

CascadingAuthenticationState コンポーネントによって、アプリの残りの部分に AuthenticationState を公開する動作が管理されます。
AuthorizeRouteView コンポーネントによって、現在のユーザーには所与のページへのアクセスが許可されます。それ以外では、RedirectToLogin コンポーネントがレンダリングされます。
RedirectToLogin コンポーネントによって、承認されていないユーザーのログインページへのリダイレクトが管理されます。

ASP.NET Core のリリースごとにフレームワークに違いがあるため、App コンポーネント (App.razor) の Razor マークアップは、このセクションでは説明しません。特定のリリース向けのコンポーネントのマークアップを調べる場合は、次の方法の ''いずれか'' を使用してください。

使用しようとしている ASP.NET Core のバージョン向けの既定の Blazor WebAssembly プロジェクトテンプレートから、認証のためにプロビジョニングされたアプリを作成します。作成されたアプリで、App コンポーネント (App.razor) を検証します。
参照元で、App コンポーネント (App.razor) を検証します。ブランチセレクターからバージョンを選択し、リポジトリの ProjectTemplates フォルダーでコンポーネントを検索します。これは、長年にわたって移動しているためです。

Note

通常、.NET 参照ソースへのドキュメントリンクを使用すると、リポジトリの既定のブランチが読み込まれます。このブランチは、.NET の次回リリースに向けて行われている現在の開発を表します。特定のリリースのタグを選択するには、[Switch branches or tags](ブランチまたはタグの切り替え) ドロップダウンリストを使います。詳細については、「ASP.NET Core ソースコードのバージョンタグを選択する方法」 (dotnet/AspNetCore.Docs #26205) を参照してください。

RedirectToLogin コンポーネント

"このセクションは、ソリューションの Client アプリに関連しています。 "

RedirectToLogin コンポーネント (RedirectToLogin.razor) は:

承認されていないユーザーのログインページへのリダイレクトを管理します。
ユーザーがアクセスしようとしている現在の URL は、次を使用して認証が成功した場合にそのページに戻ることができるように保持されます。
- .NET 7 以降の ASP.NET Core でのナビゲーション履歴の状態。
- .NET 6 以前の ASP.NET Core でのクエリ文字列。

参照元で、RedirectToLogin コンポーネントを検証します。コンポーネントの場所は時間の経過と共に変更されたため、GitHub 検索ツールを使用してコンポーネントを見つけてください。

Note

通常、.NET 参照ソースへのドキュメントリンクを使用すると、リポジトリの既定のブランチが読み込まれます。このブランチは、.NET の次回リリースに向けて行われている現在の開発を表します。特定のリリースのタグを選択するには、[Switch branches or tags](ブランチまたはタグの切り替え) ドロップダウンリストを使います。詳細については、「ASP.NET Core ソースコードのバージョンタグを選択する方法」 (dotnet/AspNetCore.Docs #26205) を参照してください。

LoginDisplay コンポーネント

"このセクションは、ソリューションの Client アプリに関連しています。 "

LoginDisplay コンポーネント (LoginDisplay.razor) は MainLayout コンポーネント (MainLayout.razor) でレンダリングされます。このコンポーネントによって次の動作が管理されます。

認証されたユーザーの場合:
- 現在のユーザー名が表示されます。
- ASP.NET Core Identity のユーザープロファイルページへのリンクが提供されます。
- アプリからログアウトするためのボタンが用意されます。
匿名ユーザーの場合:
- 登録するオプションが提供されます。
- ログインするオプションが提供されます。

ASP.NET Core のリリースごとにフレームワークに違いがあるため、LoginDisplay コンポーネントの Razor マークアップは、このセクションでは説明しません。特定のリリース向けのコンポーネントのマークアップを調べる場合は、次の方法の ''いずれか'' を使用してください。

使用しようとしている ASP.NET Core のバージョン向けの既定の Blazor WebAssembly プロジェクトテンプレートから、認証のためにプロビジョニングされたアプリを作成します。作成されたアプリで、LoginDisplay コンポーネントを検証します。
参照元で、LoginDisplay コンポーネントを検証します。コンポーネントの場所は時間の経過と共に変更されたため、GitHub 検索ツールを使用してコンポーネントを見つけてください。 true と等しい Hosted のテンプレートコンテンツが使用されます。

注意

通常、.NET 参照ソースへのドキュメントリンクを使用すると、リポジトリの既定のブランチが読み込まれます。このブランチは、.NET の次回リリースに向けて行われている現在の開発を表します。特定のリリースのタグを選択するには、[Switch branches or tags](ブランチまたはタグの切り替え) ドロップダウンリストを使います。詳細については、「ASP.NET Core ソースコードのバージョンタグを選択する方法」 (dotnet/AspNetCore.Docs #26205) を参照してください。

認証コンポーネント

"このセクションは、ソリューションの Client アプリに関連しています。 "

Authentication コンポーネント (Pages/Authentication.razor) によって生成されるページによって、さまざまな認証ステージを処理するために必要なルートが定義されます。

RemoteAuthenticatorView コンポーネント:

Microsoft.AspNetCore.Components.WebAssembly.Authentication パッケージによって提供されます。
認証の各段階における適切なアクションの実行を管理します。

@page "/authentication/{action}"
@using Microsoft.AspNetCore.Components.WebAssembly.Authentication

<RemoteAuthenticatorView Action="Action" />

@code {
    [Parameter]
    public string? Action { get; set; }
}

Note

null 許容参照型 (NRT) と .NET コンパイラの null 状態スタティック分析は、.NET 6 以降の ASP.NET Core でサポートされています。 .NET 6 の ASP.NET Core のリリースより前は、string 型は null 型の指定 (?) なしで表示されます。

FetchData コンポーネント

"このセクションは、ソリューションの Client アプリに関連しています。 "

FetchData コンポーネントは次の方法を示します。

アクセストークンをプロビジョニングする。
アクセストークンを使用して、Server アプリで保護されたリソース API を呼び出す。

@attribute [Authorize] ディレクティブは、このコンポーネントにアクセスするためにユーザーを承認する必要があることを Blazor WebAssembly の承認システムに示します。 Client アプリに属性が存在しても、適切な資格情報を使用せずにサーバー上の API が呼び出されるのを防ぐことはできません。また、Server アプリは、適切なエンドポイントでそれを正しく保護するために [Authorize] も使用する必要があります。

IAccessTokenProvider.RequestAccessToken は、API を呼び出すために要求に追加できるアクセストークンの要求を処理します。トークンがキャッシュされている場合、またはサービスがユーザーの操作なしで新しいアクセストークンをプロビジョニングできる場合、トークン要求は成功します。それ以外の場合、トークン要求は、try-catch ステートメントでキャッチされた AccessTokenNotAvailableException により失敗します。

要求に含める実際のトークンを取得するには、アプリが tokenResult.TryGetToken(out var token) を呼び出して、要求が成功したことを確認する必要があります。

要求が成功すると、トークン変数にアクセストークンが設定されます。トークンの AccessToken.Value プロパティは、Authorization 要求ヘッダーに含めるリテラル文字列を公開します。

ユーザーの操作なしでトークンをプロビジョニングできなかったために要求が失敗した場合:

.NET 7 以降の ASP.NET Core: アプリは指定された AccessTokenResult.InteractionOptions を使用して AccessTokenResult.InteractiveRequestUrl に移動し、アクセストークンを更新できるようにします。
.NET 6 以前の ASP.NET Core: トークン結果にはリダイレクト URL が含まれます。この URL に移動すると、認証が成功した後、ユーザーがログインページに移動してから、現在のページに戻ります。

@page "/fetchdata"
@using Microsoft.AspNetCore.Authorization
@using Microsoft.AspNetCore.Components.WebAssembly.Authentication
@using {APP NAMESPACE}.Shared
@attribute [Authorize]
@inject HttpClient Http

...

@code {
    private WeatherForecast[] forecasts;

    protected override async Task OnInitializedAsync()
    {
        try
        {
            forecasts = await Http.GetFromJsonAsync<WeatherForecast[]>("WeatherForecast");
        }
        catch (AccessTokenNotAvailableException exception)
        {
            exception.Redirect();
        }
    }
}

Azure Active Directory B2C テナントの使用

「チュートリアル: Azure Active Directory B2C テナントの作成」で説明されているようにアプリを Azure Active Directory B2C テナントに登録していても、この記事のガイダンスに従うと、ME-ID によるアプリ ID URI の管理は異なる方法で行われます。

既存のテナントの種類を確認するには、ME-ID 組織の [概要] の上部にある [テナントの管理] リンクを選択してください。組織の [テナントの種類] 列の値を調べます。このセクションの内容は、この記事のガイダンスに従いつつも Azure Active Directory B2C テナントに登録されているアプリに関連するものとなっています。

App ID URI の形式は api://{SERVER API APP CLIENT ID OR CUSTOM VALUE} に一致するものではなく、https://{TENANT}.onmicrosoft.com/{SERVER API APP CLIENT ID OR CUSTOM VALUE} となっています。この違いは、Client および Server アプリの構成に影響します。

サーバー API アプリの場合は、アプリ設定ファイル (Audience) 内に appsettings.json を設定して、末尾のスラッシュなしで Azure portal によって指定される、アプリの対象ユーザー (アプリ ID URI) と一致させます。
```
"Audience": "https://{TENANT}.onmicrosoft.com/{SERVER API APP CLIENT ID OR CUSTOM VALUE}"
```
例:
```
"Audience": "https://contoso.onmicrosoft.com/41451fa7-82d9-4673-8fa5-69eff5a761fd"
```
Client アプリの Program ファイルで、サーバー API アプリの対象ユーザーと一致するようにスコープ (アプリ ID URI) の対象ユーザーを設定します。
```
options.ProviderOptions.DefaultAccessTokenScopes
    .Add("https://{TENANT}.onmicrosoft.com/{SERVER API APP CLIENT ID OR CUSTOM VALUE}/{DEFAULT SCOPE}");
```
前のスコープでは、アプリ ID URI または対象ユーザーは、値の https://{TENANT}.onmicrosoft.com/{SERVER API APP CLIENT ID OR CUSTOM VALUE} 部分となっています。これには、末尾のスラッシュ (/) とスコープ名 ({DEFAULT SCOPE}) は含まれません。

例:
```
options.ProviderOptions.DefaultAccessTokenScopes
    .Add("https://contoso.onmicrosoft.com/41451fa7-82d9-4673-8fa5-69eff5a761fd/API.Access");
```
前のスコープでは、アプリ ID URI または対象ユーザーは、値の https://contoso.onmicrosoft.com/41451fa7-82d9-4673-8fa5-69eff5a761fd 部分となっています。これには、末尾のスラッシュ (/) とスコープ名 (API.Access) は含まれません。

カスタムアプリ ID URI の使用

アプリ ID URI がカスタム値の場合は、Client アプリ内の既定のアクセストークンスコープ URI を手動で更新し、対象ユーザーを Server アプリの ME-ID 構成に追加する必要があります。

重要

api://{SERVER API APP CLIENT ID} の既定のアプリ ID URI を使用する場合、次の構成は必要 "ありません"。

urn://custom-app-id-uri のアプリ ID URI と API.Access のスコープ名の例:

Client アプリの Program ファイル内は次のようになっています。

options.ProviderOptions.DefaultAccessTokenScopes.Add(
    "urn://custom-app-id-uri/API.Access");

Server アプリの appsettings.json 内に、アプリ ID URI のみを含み末尾にスラッシュが付いていない Audience エントリを追加します。
```
"Audience": "urn://custom-app-id-uri"
```

トラブルシューティング

ログ機能

Blazor WebAssembly 認証のデバッグまたはトレースログを有効にするには、記事バージョンセレクターを ASP.NET Core 7.0 以降に設定して、ASP.NET Core Blazor ログの "クライアント側認証ログ" セクションを参照してください。

一般的なエラー

アプリまたは Identity プロバイダー (IP) の構成の誤り

最も一般的なエラーの原因は、構成の誤りです。以下に例を示します。
- シナリオの要件によっては、権限、インスタンス、テナント ID、テナントドメイン、クライアント ID、またはリダイレクト URI の欠落または誤りによって、アプリによるクライアントの認証ができなくなります。
- 要求スコープが正しくないと、クライアントはサーバー Web API エンドポイントにアクセスできません。
- サーバー API のアクセス許可が正しくないか、存在しないと、クライアントがサーバー Web API エンドポイントにアクセスできなくなります。
- IP のアプリ登録のリダイレクト URI で構成されているものとは異なるポートでアプリが実行されています。 Microsoft Entra ID と、localhost 開発テストアドレスで実行されるアプリにポートは必要ありませんが、アプリのポート構成とアプリが実行されているポートは、localhost 以外のアドレスと一致する必要があることに注意してください。
この記事のガイダンスの構成セクションに、正しい構成の例を示します。記事の各セクションを慎重に確認して、アプリと IP の構成の誤りを探してください。

構成が正しい場合:
- アプリケーションログを分析します。
- ブラウザーの開発者ツールを使用して、クライアントアプリと IP またはサーバーアプリの間のネットワークトラフィックを確認します。多くの場合、要求を行った後、IP またはサーバーアプリによって、問題の原因を特定する手掛かりを含む正確なエラーメッセージまたはメッセージがクライアントに返されます。開発者ツールのガイダンスは、次の記事にあります。
  - Google Chrome (Google ドキュメント)
  - Microsoft Edge
  - Mozilla Firefox (Mozilla ドキュメント)
- JSON Web トークン (JWT) が使われている Blazor のリリースの場合は、問題が発生している場所に応じて、クライアントの認証またはサーバー Web API へのアクセスに使われるトークンの内容をデコードします。詳細については、「JSON Web トークン (JWT) の内容を検査する」を参照してください。
ドキュメントチームは、ドキュメントのフィードバックと記事のバグについては対応します (こちらのページのフィードバックセクションからイシューを作成してください) が、製品サポートを提供することはできません。アプリのトラブルシューティングに役立つ、いくつかのパブリックサポートフォーラムが用意されています。次をお勧めします。
上記のフォーラムは、Microsoft が所有または管理するものではありません。

セキュリティで保護されておらず、機密でも社外秘でもない再現可能なフレームワークのバグレポートについては、ASP.NET Core 製品単位でイシューを作成してください。問題の原因を徹底的に調査し、パブリックサポートフォーラムのコミュニティの助けを借りてもお客様自身で解決できない場合にのみ、製品単位でイシューを作成してください。単純な構成の誤りやサードパーティのサービスに関連するユースケースによって破損した個々のアプリのトラブルシューティングは、製品単位で行うことはできません。レポートが機密性の高い性質のものでる場合や、攻撃者が悪用するおそれのある製品の潜在的なセキュリティ上の欠陥が記述されている場合は、セキュリティの問題とバグの報告 (dotnet/aspnetcore GitHub リポジトリ) を参照してください。
ME-ID で承認されないクライアント

情報:Microsoft.AspNetCore.Authorization.DefaultAuthorizationService[2] 承認に失敗しました。次の要件が満たされていません。DenyAnonymousAuthorizationRequirement:認証済みユーザーが必要です。

ME-ID からのログインコールバックエラー:
- エラー: unauthorized_client
- 説明: AADB2C90058: The provided application is not configured to allow public clients.
このエラーを解決するには:
1. Azure portal で、アプリのマニフェストにアクセスします。
2. allowPublicClient 属性を null または true に設定します。

Cookie とサイトデータ

Cookie とサイトデータは、アプリが更新されても保持され、テストやトラブルシューティングに影響する可能性があります。アプリコードの変更、プロバイダーによるユーザーアカウントの変更、プロバイダーアプリの構成変更を行うときは、次のものをクリアしてください。

ユーザーサインイン cookie
アプリ cookie
キャッシュおよび保存されたサイトデータ

残った cookie とサイトデータがテストとトラブルシューティングに影響しないようにする方法を、次に示します。

ブラウザーを構成する
- ブラウザーが閉じるたびに cookie とサイトデータをすべて削除するように構成できることをテストするために、ブラウザーを使用します。
- アプリ、テストユーザー、プロバイダー構成が変更されるたびにブラウザーが手動で、または IDE によって閉じられていることを確認します。
カスタムコマンドを使用して、Visual Studio でブラウザーを InPrivate または Incognito モードで開きます:
- Visual Studio の [実行] ボタンをクリックして [ブラウザーの選択] ダイアログボックスを開きます。
- [追加] ボタンを選びます。
- [プログラム] フィールドでブラウザーのパスを指定します。次の実行可能パスが、Windows 10 の一般的なインストール場所です。ブラウザーが別の場所にインストールされている場合、または Windows 10 を使用していない場合は、ブラウザーの実行可能ファイルのパスを指定してください。
  - Microsoft Edge: C:\Program Files (x86)\Microsoft\Edge\Application\msedge.exe
  - Google Chrome: C:\Program Files (x86)\Google\Chrome\Application\chrome.exe
  - Mozilla Firefox: C:\Program Files\Mozilla Firefox\firefox.exe
- [引数] フィールドに、ブラウザーを InPrivate または Incognito モードで開くために使用するコマンドラインオプションを指定します。ブラウザーによっては、アプリの URL が必要になる場合があります。
  - Microsoft Edge:-inprivate を使用してください。
  - Google Chrome:--incognito --new-window {URL} を使用します。プレースホルダー {URL} は開く URL (https://localhost:5001 など) です。
  - Mozilla Firefox:-private -url {URL} を使用します。プレースホルダー {URL} は開く URL (https://localhost:5001 など) です。
- [フレンドリ名] フィールドに名前を指定します。たとえば、Firefox Auth Testing のようにします。
- [OK] ボタンを選択します。
- アプリでテストを繰り返すたびにブラウザープロファイルを選択する必要がないようにするには、 [既定値として設定] ボタンでプロファイルを既定値として設定します。
- アプリ、テストユーザー、またはプロバイダー構成が変更されるたびに、ブラウザーが IDE によって閉じられていることを確認します。

アプリのアップグレード

開発マシンで .NET Core SDK をアップグレードしたり、アプリ内のパッケージバージョンを変更したりした直後に、機能しているアプリが失敗することがあります。場合によっては、パッケージに統一性がないと、メジャーアップグレード実行時にアプリが破壊されることがあります。これらの問題のほとんどは、次の手順で解決できます。

コマンドシェルから dotnet nuget locals all --clear を実行して、ローカルシステムの NuGet パッケージキャッシュをクリアします。
プロジェクトのフォルダー bin と obj を削除します。
プロジェクトを復元してリビルドします。
アプリを再展開する前に、サーバー上の展開フォルダー内のすべてのファイルを削除します。

Note

アプリのターゲットフレームワークと互換性のないパッケージバージョンの使用はサポートされていません。パッケージの詳細については、NuGet ギャラリーまたは FuGet パッケージエクスプローラーを使用してください。

`Server` アプリを実行する

ホステッド Blazor WebAssemblyソリューションのテストとトラブルシューティングを行うときは、Server プロジェクトからアプリを実行していることをご確認ください。

ユーザーを検査する

次の User コンポーネントは、アプリ内で直接使うことも、さらにカスタマイズするための基礎として使うこともできます。

User.razor:

@page "/user"
@attribute [Authorize]
@using System.Text.Json
@using System.Security.Claims
@inject IAccessTokenProvider AuthorizationService

<h1>@AuthenticatedUser?.Identity?.Name</h1>

<h2>Claims</h2>

@foreach (var claim in AuthenticatedUser?.Claims ?? Array.Empty<Claim>())
{
    <p class="claim">@(claim.Type): @claim.Value</p>
}

<h2>Access token</h2>

<p id="access-token">@AccessToken?.Value</p>

<h2>Access token claims</h2>

@foreach (var claim in GetAccessTokenClaims())
{
    <p>@(claim.Key): @claim.Value.ToString()</p>
}

@if (AccessToken != null)
{
    <h2>Access token expires</h2>

    <p>Current time: <span id="current-time">@DateTimeOffset.Now</span></p>
    <p id="access-token-expires">@AccessToken.Expires</p>

    <h2>Access token granted scopes (as reported by the API)</h2>

    @foreach (var scope in AccessToken.GrantedScopes)
    {
        <p>Scope: @scope</p>
    }
}

@code {
    [CascadingParameter]
    private Task<AuthenticationState> AuthenticationState { get; set; }

    public ClaimsPrincipal AuthenticatedUser { get; set; }
    public AccessToken AccessToken { get; set; }

    protected override async Task OnInitializedAsync()
    {
        await base.OnInitializedAsync();
        var state = await AuthenticationState;
        var accessTokenResult = await AuthorizationService.RequestAccessToken();

        if (!accessTokenResult.TryGetToken(out var token))
        {
            throw new InvalidOperationException(
                "Failed to provision the access token.");
        }

        AccessToken = token;

        AuthenticatedUser = state.User;
    }

    protected IDictionary<string, object> GetAccessTokenClaims()
    {
        if (AccessToken == null)
        {
            return new Dictionary<string, object>();
        }

        // header.payload.signature
        var payload = AccessToken.Value.Split(".")[1];
        var base64Payload = payload.Replace('-', '+').Replace('_', '/')
            .PadRight(payload.Length + (4 - payload.Length % 4) % 4, '=');

        return JsonSerializer.Deserialize<IDictionary<string, object>>(
            Convert.FromBase64String(base64Payload));
    }
}

JSON Web トークン (JWT) の内容を検査する

JSON Web トークン (JWT) をデコードするには、Microsoft の jwt.ms ツールを使用します。 UI の値がブラウザーに残ることはありません。

エンコードされた JWT の例 (表示用に短縮されています):

eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImtpZCI6Ilg1ZVhrNHh5b2pORnVtMWtsMll0djhkbE5QNC1j ... bQdHBHGcQQRbW7Wmo6SWYG4V_bU55Ug_PW4pLPr20tTS8Ct7_uwy9DWrzCMzpD-EiwT5IjXwlGX3IXVjHIlX50IVIydBoPQtadvT7saKo1G5Jmutgq41o-dmz6-yBMKV2_nXA25Q

Azure AAD B2C に対して認証するアプリのツールによってデコードされた JWT の例:

{
  "typ": "JWT",
  "alg": "RS256",
  "kid": "X5eXk4xyojNFum1kl2Ytv8dlNP4-c57dO6QGTVBwaNk"
}.{
  "exp": 1610059429,
  "nbf": 1610055829,
  "ver": "1.0",
  "iss": "https://mysiteb2c.b2clogin.com/5cc15ea8-a296-4aa3-97e4-226dcc9ad298/v2.0/",
  "sub": "5ee963fb-24d6-4d72-a1b6-889c6e2c7438",
  "aud": "70bde375-fce3-4b82-984a-b247d823a03f",
  "nonce": "b2641f54-8dc4-42ca-97ea-7f12ff4af871",
  "iat": 1610055829,
  "auth_time": 1610055822,
  "idp": "idp.com",
  "tfp": "B2C_1_signupsignin"
}.[Signature]

ホストされている ASP.NET Core Blazor WebAssembly アプリを Microsoft Entra ID でセキュリティ保護する

チュートリアル

Azure でテナントを作成する

Azure でサーバー API アプリを登録する

Azure でクライアントアプリを登録する

Blazor アプリを作成する

アプリを実行する

`User.Identity.Name` を構成する

ソリューションの各パーツ

`appsettings.json` 構成

認証パッケージ

認証サービスのサポート

WeatherForecast コントローラー

`wwwroot/appsettings.json` 構成

認証パッケージ

認証サービスのサポート

アクセストークンスコープ

インポートファイル

Index ページ

アプリコンポーネント

RedirectToLogin コンポーネント

LoginDisplay コンポーネント

認証コンポーネント

FetchData コンポーネント

Azure Active Directory B2C テナントの使用

カスタムアプリ ID URI の使用

トラブルシューティング

ログ機能

一般的なエラー

Cookie とサイトデータ

アプリのアップグレード

`Server` アプリを実行する

ユーザーを検査する

JSON Web トークン (JWT) の内容を検査する

その他の技術情報

フィードバック

その他のリソース

ホストされている ASP.NET Core Blazor WebAssembly アプリを Microsoft Entra ID でセキュリティ保護する

チュートリアル

Azure でテナントを作成する

Azure でサーバー API アプリを登録する

Azure でクライアント アプリを登録する

Blazor アプリを作成する

アプリを実行する

User.Identity.Name を構成する

ソリューションの各パーツ

appsettings.json 構成

認証パッケージ

認証サービスのサポート

WeatherForecast コントローラー

wwwroot/appsettings.json 構成

認証パッケージ

認証サービスのサポート

アクセス トークン スコープ

ログイン モード

インポート ファイル

Index ページ

アプリ コンポーネント

RedirectToLogin コンポーネント

LoginDisplay コンポーネント

認証コンポーネント

FetchData コンポーネント

Azure Active Directory B2C テナントの使用

カスタム アプリ ID URI の使用

トラブルシューティング

ログ機能

一般的なエラー

Cookie とサイト データ

アプリのアップグレード

Server アプリを実行する

ユーザーを検査する

JSON Web トークン (JWT) の内容を検査する

その他の技術情報

フィードバック

その他のリソース

Azure でクライアントアプリを登録する

`User.Identity.Name` を構成する

`appsettings.json` 構成

`wwwroot/appsettings.json` 構成

アクセストークンスコープ

ログインモード

インポートファイル

アプリコンポーネント

カスタムアプリ ID URI の使用

Cookie とサイトデータ

`Server` アプリを実行する