ASP.NET Core プロジェクトの Identity にカスタム ユーザー データを追加、ダウンロード、削除する

作成者: Rick Anderson

この記事では、次の方法について説明します。

  • ASP.NET Core Web アプリにカスタム ユーザー データを追加します。
  • カスタム ユーザー データ モデルを PersonalDataAttribute 属性でマークして、自動的にダウンロードおよび削除できるようにします。 データをダウンロードおよび削除できるようにすると、 GDPR 要件を満たすのに役立ちます。

プロジェクト サンプルは、Razor Pages Web アプリから作成されますが、ASP.NET Core MVC Web アプリの手順は似ています。

Prerequisites

.NET 6 SDK

サンプル コードを表示またはダウンロードする (ダウンロード方法)

Razor Web アプリを作成する

Razor Web アプリの新しいプロジェクトを作成します。

  1. Visual Studioで、File>New>Project を選択します。

  2. プロジェクトの名前を入力します。 ダウンロード サンプル コードの名前空間と名前を一致させる場合は、「 WebApp1」と入力します。

  3. ASP.NET Core Web アプリケーション を選択し、 OK を選択します。

  4. [ 認証の種類 ] ドロップダウン リストで、[ 個々のアカウント] を選択します。

  5. [ Web アプリケーション ] を選択し、[ OK] を選択します

  6. プロジェクトをビルドして実行します。

Identity スキャフォールディングを実行する

Identity スキャフォールディングを作成して実行します。

  1. Visual Studio の ソリューション エクスプローラー で、プロジェクトを右クリックし、追加>新しいスキャフォールディングされた項目 を選択します。

  2. [ スキャフォールディングの追加 ] ダイアログの左側のウィンドウで、 Identity>[追加] を選択します。

  3. [Identityの追加] ダイアログで、次のオプションを構成します。

    1. 既存のレイアウト ファイル ~/Pages/Shared/_Layout.cshtml を選択します。

    2. オーバーライドする対象の次のページファイルを選択します。

      • Account/Register
      • Account/Manage/Index
    3. プラス記号アイコン (+) を選択し、新しい データ コンテキスト クラスを作成します。 型を受け入れます (たとえば、プロジェクトの名前が WebApp1 の場合は WebApp1.WebApp1Context)。

    4. プラス アイコン (+) を選択し、新しい User クラスを作成します。 型 (たとえば、プロジェクトの名前が WebApp1 の場合は WebApp1User) を受け入れ、[追加] を選択します。

  4. 操作を完了するには、[追加] を選択 します

移行を作成してアプリを確認する

Identity スキャフォールディングを準備したら、移行を作成し、アプリを確認します。 次の手順については、「 移行、UseAuthentication、およびレイアウト」の詳細な手順を参照してください。

  1. 移行を作成し、データベースを更新します。

  2. Program.cs UseAuthentication メソッドを追加します。

  3. レイアウト ファイルに <partial name="_LoginPartial" /> 部分を追加します。 詳細については、「レイアウトの 変更」を参照してください。

  4. アプリを確認します。

    1. ユーザーを登録します。

    2. 新しいユーザー名 ( [ログアウト ] リンクの横) を選択します。 ウィンドウを展開するか、ナビゲーション バーアイコンを選択してユーザー名やその他のリンクを表示することが必要になる場合があります。

    3. [ 個人データ ] タブを選択します。

    4. [ ダウンロード ] を選択し、 PersonalData.json ファイルを調べます。

    5. [ 削除] を選択し、サインインしているユーザーを削除できることを確認します。

Identity データベースにカスタム ユーザー データを追加する

IdentityUser派生クラスをカスタム プロパティで更新する必要があります。 プロジェクトに WebApp1 という名前を付けた場合、更新する対応するファイルは Areas/Identity/Data/WebApp1User.cs です。 次のコードでファイルを更新します。

using Microsoft.AspNetCore.Identity;

namespace WebApp1.Areas.Identity.Data;

public class WebApp1User : IdentityUser
{
    [PersonalData]
    public string? Name { get; set; }
    [PersonalData]
    public DateTime DOB { get; set; }
}

PersonalDataAttribute 属性を持つプロパティは次のとおりです。

  • Areas/Identity/Pages/Account/Manage/DeletePersonalData.cshtml Razor ページがUserManager.Deleteを呼び出すと削除されます。
  • Areas/Identity/Pages/Account/Manage/DownloadPersonalData.cshtml Razor ページでダウンロードしたデータに含まれます。

'Account/Manage/Index.cshtml' ページ ファイルを更新する

  1. Areas/Identity/Pages/Account/Manage/Index.cshtml.cs ファイルでInputModel クラス定義を次の強調表示されたコードで更新します。

    public class IndexModel : PageModel
    {
        private readonly UserManager<WebApp1User> _userManager;
        private readonly SignInManager<WebApp1User> _signInManager;
    
        public IndexModel(
            UserManager<WebApp1User> userManager,
            SignInManager<WebApp1User> signInManager)
        {
            _userManager = userManager;
            _signInManager = signInManager;
        }
    
        /// <summary>
        ///     This API supports the ASP.NET Core Identity default UI infrastructure and is not intended to be used
        ///     directly from your code. This API may change or be removed in future releases.
        /// </summary>
        public string Username { get; set; }
    
        // Remaining API warnings ommited.
    
        [TempData]
        public string StatusMessage { get; set; }
    
        [BindProperty]
        public InputModel Input { get; set; }
    
        public class InputModel
        {
            [Required]
            [DataType(DataType.Text)]
            [Display(Name = "Full name")]
            public string Name { get; set; }
    
            [Required]
            [Display(Name = "Birth Date")]
            [DataType(DataType.Date)]
            public DateTime DOB { get; set; }
    
            [Phone]
            [Display(Name = "Phone number")]
            public string PhoneNumber { get; set; }
        }
    
        private async Task LoadAsync(WebApp1User user)
        {
            var userName = await _userManager.GetUserNameAsync(user);
            var phoneNumber = await _userManager.GetPhoneNumberAsync(user);
    
            Username = userName;
    
            Input = new InputModel
            {
                Name = user.Name,
                DOB = user.DOB,
                PhoneNumber = phoneNumber
            };
        }
    
        public async Task<IActionResult> OnGetAsync()
        {
            var user = await _userManager.GetUserAsync(User);
            if (user == null)
            {
                return NotFound($"Unable to load user with ID '{_userManager.GetUserId(User)}'.");
            }
    
            await LoadAsync(user);
            return Page();
        }
    
        public async Task<IActionResult> OnPostAsync()
        {
            var user = await _userManager.GetUserAsync(User);
            if (user == null)
            {
                return NotFound($"Unable to load user with ID '{_userManager.GetUserId(User)}'.");
            }
    
            if (!ModelState.IsValid)
            {
                await LoadAsync(user);
                return Page();
            }
    
            var phoneNumber = await _userManager.GetPhoneNumberAsync(user);
            if (Input.PhoneNumber != phoneNumber)
            {
                var setPhoneResult = await _userManager.SetPhoneNumberAsync(user, Input.PhoneNumber);
                if (!setPhoneResult.Succeeded)
                {
                    StatusMessage = "Unexpected error when trying to set phone number.";
                    return RedirectToPage();
                }
            }
    
            if (Input.Name != user.Name)
            {
                user.Name = Input.Name;
            }
    
            if (Input.DOB != user.DOB)
            {
                user.DOB = Input.DOB;
            }
    
            await _userManager.UpdateAsync(user);
            await _signInManager.RefreshSignInAsync(user);
            StatusMessage = "Your profile has been updated";
            return RedirectToPage();
        }
    }
    
  2. 同じファイルで、次の強調表示されたマークアップに示すように、示されている form-floating セクションを更新します。

    @page
    @model IndexModel
    @{
        ViewData["Title"] = "Profile";
        ViewData["ActivePage"] = ManageNavPages.Index;
    }
    
    <h3>@ViewData["Title"]</h3>
    <partial name="_StatusMessage" for="StatusMessage" />
    <div class="row">
        <div class="col-md-6">
            <form id="profile-form" method="post">
                <div asp-validation-summary="ModelOnly" class="text-danger"></div>
                <div class="form-floating">
                    <input asp-for="Username" class="form-control" disabled />
                    <label asp-for="Username" class="form-label"></label>
                </div>
                <div class="form-floating">
                    <input asp-for="Input.Name" class="form-control" />
                    <label asp-for="Input.Name" class="form-label"></label>
                </div>
                <div class="form-floating">
                    <input asp-for="Input.DOB" class="form-control" />
                    <label asp-for="Input.DOB" class="form-label"></label>
                </div>
                <div class="form-floating">
                    <input asp-for="Input.PhoneNumber" class="form-control" />
                    <label asp-for="Input.PhoneNumber" class="form-label"></label>
                    <span asp-validation-for="Input.PhoneNumber" class="text-danger"></span>
                </div>
                <button id="update-profile-button" type="submit" class="w-100 btn btn-lg btn-primary">Save</button>
            </form>
        </div>
    </div>
    
    @section Scripts {
        <partial name="_ValidationScriptsPartial" />
    }
    

'Account/Register.cshtml' ページ ファイルを更新する

  1. Areas/Identity/Pages/Account/Register.cshtml.cs ファイルでInputModel クラス定義を次の強調表示されたコードで更新します。

        public class RegisterModel : PageModel
        {
            private readonly SignInManager<WebApp1User> _signInManager;
            private readonly UserManager<WebApp1User> _userManager;
            private readonly IUserStore<WebApp1User> _userStore;
            private readonly IUserEmailStore<WebApp1User> _emailStore;
            private readonly ILogger<RegisterModel> _logger;
            private readonly IEmailSender _emailSender;
    
            public RegisterModel(
                UserManager<WebApp1User> userManager,
                IUserStore<WebApp1User> userStore,
                SignInManager<WebApp1User> signInManager,
                ILogger<RegisterModel> logger,
                IEmailSender emailSender)
            {
                _userManager = userManager;
                _userStore = userStore;
                _emailStore = GetEmailStore();
                _signInManager = signInManager;
                _logger = logger;
                _emailSender = emailSender;
            }
    
            /// <summary>
            ///     This API supports the ASP.NET Core Identity default UI infrastructure and is not intended to be used
            ///     directly from your code. This API may change or be removed in future releases.
            /// </summary>
            [BindProperty]
            public InputModel Input { get; set; }
    
            // Remaining API warnings ommited.
            public string ReturnUrl { get; set; }
    
            public IList<AuthenticationScheme> ExternalLogins { get; set; }
    
            public class InputModel
            {
                [Required]
                [DataType(DataType.Text)]
                [Display(Name = "Full name")]
                public string Name { get; set; }
    
                [Required]
                [Display(Name = "Birth Date")]
                [DataType(DataType.Date)]
                public DateTime DOB { get; set; }
    
                [Required]
                [EmailAddress]
                [Display(Name = "Email")]
                public string Email { get; set; }
    
                [Required]
                [StringLength(100, ErrorMessage = "The {0} must be at least {2} and at max {1} characters long.", MinimumLength = 6)]
                [DataType(DataType.Password)]
                [Display(Name = "Password")]
                public string Password { get; set; }
    
                [DataType(DataType.Password)]
                [Display(Name = "Confirm password")]
                [Compare("Password", ErrorMessage = "The password and confirmation password do not match.")]
                public string ConfirmPassword { get; set; }
            }
    
    
            public async Task OnGetAsync(string returnUrl = null)
            {
                ReturnUrl = returnUrl;
                ExternalLogins = (await _signInManager.GetExternalAuthenticationSchemesAsync()).ToList();
            }
    
            public async Task<IActionResult> OnPostAsync(string returnUrl = null)
            {
                returnUrl ??= Url.Content("~/");
                ExternalLogins = (await _signInManager.GetExternalAuthenticationSchemesAsync()).ToList();
                if (ModelState.IsValid)
                {
                    var user = CreateUser();
    
                    user.Name = Input.Name;
                    user.DOB = Input.DOB;
    
                    await _userStore.SetUserNameAsync(user, Input.Email, CancellationToken.None);
                    await _emailStore.SetEmailAsync(user, Input.Email, CancellationToken.None);
                    var result = await _userManager.CreateAsync(user, Input.Password);
    
                    if (result.Succeeded)
                    {
                        _logger.LogInformation("User created a new account with password.");
    
                        var userId = await _userManager.GetUserIdAsync(user);
                        var code = await _userManager.GenerateEmailConfirmationTokenAsync(user);
                        code = WebEncoders.Base64UrlEncode(Encoding.UTF8.GetBytes(code));
                        var callbackUrl = Url.Page(
                            "/Account/ConfirmEmail",
                            pageHandler: null,
                            values: new { area = "Identity", userId = userId, code = code, returnUrl = returnUrl },
                            protocol: Request.Scheme);
    
                        await _emailSender.SendEmailAsync(Input.Email, "Confirm your email",
                            $"Please confirm your account by <a href='{HtmlEncoder.Default.Encode(callbackUrl)}'>clicking here</a>.");
    
                        if (_userManager.Options.SignIn.RequireConfirmedAccount)
                        {
                            return RedirectToPage("RegisterConfirmation", new { email = Input.Email, returnUrl = returnUrl });
                        }
                        else
                        {
                            await _signInManager.SignInAsync(user, isPersistent: false);
                            return LocalRedirect(returnUrl);
                        }
                    }
                    foreach (var error in result.Errors)
                    {
                        ModelState.AddModelError(string.Empty, error.Description);
                    }
                }
    
                // If we got this far, something failed, redisplay form
                return Page();
            }
    
            private WebApp1User CreateUser()
            {
                try
                {
                    return Activator.CreateInstance<WebApp1User>();
                }
                catch
                {
                    throw new InvalidOperationException($"Can't create an instance of '{nameof(WebApp1User)}'. " +
                        $"Ensure that '{nameof(WebApp1User)}' is not an abstract class and has a parameterless constructor, or alternatively " +
                        $"override the register page in /Areas/Identity/Pages/Account/Register.cshtml");
                }
            }
    
            private IUserEmailStore<WebApp1User> GetEmailStore()
            {
                if (!_userManager.SupportsUserEmail)
                {
                    throw new NotSupportedException("The default UI requires a user store with email support.");
                }
                return (IUserEmailStore<WebApp1User>)_userStore;
            }
        }
    }
    
  2. 同じファイルで、次の強調表示されたマークアップに示すように、示されている form-floating セクションを更新します。

    @page
    @model RegisterModel
    @{
        ViewData["Title"] = "Register";
    }
    
    <h1>@ViewData["Title"]</h1>
    
    <div class="row">
        <div class="col-md-4">
            <form id="registerForm" asp-route-returnUrl="@Model.ReturnUrl" method="post">
                <h2>Create a new account.</h2>
                <hr />
                <div asp-validation-summary="ModelOnly" class="text-danger"></div>
    
                <div class="form-floating">
                    <input asp-for="Input.Name" class="form-control" />
                    <label asp-for="Input.Name"></label>
                    <span asp-validation-for="Input.Name" class="text-danger"></span>
                </div>
                <div class="form-floating">
                    <input asp-for="Input.DOB" class="form-control" />
                    <label asp-for="Input.DOB"></label>
                    <span asp-validation-for="Input.DOB" class="text-danger"></span>
                </div>
    
                <div class="form-floating">
                    <input asp-for="Input.Email" class="form-control" autocomplete="username" aria-required="true" />
                    <label asp-for="Input.Email"></label>
                    <span asp-validation-for="Input.Email" class="text-danger"></span>
                </div>
                <div class="form-floating">
                    <input asp-for="Input.Password" class="form-control" autocomplete="new-password" aria-required="true" />
                    <label asp-for="Input.Password"></label>
                    <span asp-validation-for="Input.Password" class="text-danger"></span>
                </div>
                <div class="form-floating">
                    <input asp-for="Input.ConfirmPassword" class="form-control" autocomplete="new-password" aria-required="true" />
                    <label asp-for="Input.ConfirmPassword"></label>
                    <span asp-validation-for="Input.ConfirmPassword" class="text-danger"></span>
                </div>
                <button id="registerSubmit" type="submit" class="w-100 btn btn-lg btn-primary">Register</button>
            </form>
        </div>
        <div class="col-md-6 col-md-offset-2">
            <section>
                <h3>Use another service to register.</h3>
                <hr />
                @{
                    if ((Model.ExternalLogins?.Count ?? 0) == 0)
                    {
                        <div>
                            <p>
                                There are no external authentication services configured. See this <a href="https://go.microsoft.com/fwlink/?LinkID=532715">article
                                about setting up this ASP.NET application to support logging in via external services</a>.
                            </p>
                        </div>
                    }
                    else
                    {
                        <form id="external-account" asp-page="./ExternalLogin" asp-route-returnUrl="@Model.ReturnUrl" method="post" class="form-horizontal">
                            <div>
                                <p>
                                    @foreach (var provider in Model.ExternalLogins!)
                                    {
                                        <button type="submit" class="btn btn-primary" name="provider" value="@provider.Name" title="Log in using your @provider.DisplayName account">@provider.DisplayName</button>
                                    }
                                </p>
                            </div>
                        </form>
                    }
                }
            </section>
        </div>
    </div>
    
    @section Scripts {
        <partial name="_ValidationScriptsPartial" />
    }
    
  3. プロジェクトをビルドします。

レイアウトを更新する

Web アプリのすべてのページにサインインとサインアウトリンクを追加します。 詳細な手順については、「 レイアウトの変更」を参照してください。

カスタム ユーザー データの移行を追加する

カスタム ユーザーのデータをデータベースに追加します。

Visual Studio パッケージ マネージャー コンソールで次のコマンドを実行します。

Add-Migration CustomUserData
Update-Database

カスタム ユーザー データを使用してアプリをテストする (作成、表示、ダウンロード、削除)

カスタム データを使用して新しいユーザーを追加して、Web アプリをテストします。

  1. 新しいユーザーを登録します。

  2. /Identity/Account/Manage ページでカスタム ユーザー データを表示します。

  3. /Identity/Account/Manage/PersonalData ページからユーザーの個人データをダウンロードして表示します。

  4. [ 削除] を選択し、カスタム ユーザー データを削除できることを確認します。

.NET Core 3.0 SDK

Razor Web アプリを作成する

  • Visual Studio File メニューから、New>Project を選択します。 ダウンロード サンプル コードの名前空間と一致させる場合は、プロジェクトに WebApp1 という名前を付けます。
  • ASP.NET Core Web アプリケーションOKを選択します
  • [ 認証 ] セクションで、[ 個々のユーザー アカウント] を選択します。
  • Web アプリケーション>OK の選択
  • プロジェクトをビルドして実行します。

Identity スキャフォールディングを実行する

  • ソリューション エクスプローラーから、プロジェクトを右クリックし、>追加>新しいスキャフォールディングアイテムを選択します。
  • スキャフォールディングの追加ダイアログの左側のウィンドウで、Identityを選択します。
  • [Identityの追加] ダイアログで、次のオプションを選択します。
    • 既存のレイアウト ファイルを選択する ~/Pages/Shared/_Layout.cshtml
    • オーバーライドする次のファイルを選択します。
      • Account/Register
      • Account/Manage/Index
    • + ボタンを選択して、新しいデータ コンテキスト クラスを作成します。 型を受け入れます (プロジェクトの名前が WebApp1 の場合は WebApp1.WebApp1Context)。
    • + ボタンを選択して、新しい User クラスを作成します。 指定された型 (WebApp1 という名前のプロジェクトなら WebApp1User) を受け入れ、追加します。>
  • [] を選択し、[] を追加します。

移行、UseAuthentication、およびレイアウトの手順に従って、次の手順を実行します。

  • 移行を作成し、データベースを更新します。
  • UseAuthenticationStartup.Configure に追加します。
  • レイアウト ファイルに <partial name="_LoginPartial" /> を追加します。
  • アプリをテストします。
    • ユーザーを登録する
    • 新しいユーザー名 ( [ログアウト ] リンクの横) を選択します。 ウィンドウを展開するか、ナビゲーション バーアイコンを選択してユーザー名やその他のリンクを表示することが必要になる場合があります。
    • [ 個人データ ] タブを選択します。
    • [ ダウンロード ] ボタンを選択し、 PersonalData.json ファイルを調べました。
    • ログオンしているユーザーを削除する [ 削除 ] ボタンをテストします。

Identity DB にカスタム ユーザー データを追加する

IdentityUser派生クラスをカスタム プロパティで更新します。 プロジェクトに WebApp1 という名前を付けた場合、ファイルには Areas/Identity/Data/WebApp1User.cs という名前が付けられます。

次のコードでファイルを更新します。

using System;
using Microsoft.AspNetCore.Identity;

namespace WebApp1.Areas.Identity.Data
{
    public class WebApp1User : IdentityUser
    {
        [PersonalData]
        public string Name { get; set; }
        [PersonalData]
        public DateTime DOB { get; set; }
    }
}

PersonalData 属性を持つプロパティは次のとおりです。

  • Areas/Identity/Pages/Account/Manage/DeletePersonalData.cshtml Razor ページがUserManager.Deleteを呼び出すと削除されます。
  • Areas/Identity/Pages/Account/Manage/DownloadPersonalData.cshtml Razor ページでダウンロードしたデータに含まれます。

Account/Manage/Index.cshtml ページを更新する

InputModelAreas/Identity/Pages/Account/Manage/Index.cshtml.csを、次の強調表示されたコードで更新します。

public partial class IndexModel : PageModel
{
    private readonly UserManager<WebApp1User> _userManager;
    private readonly SignInManager<WebApp1User> _signInManager;

    public IndexModel(
        UserManager<WebApp1User> userManager,
        SignInManager<WebApp1User> signInManager)
    {
        _userManager = userManager;
        _signInManager = signInManager;
    }

    public string Username { get; set; }

    [TempData]
    public string StatusMessage { get; set; }

    [BindProperty]
    public InputModel Input { get; set; }

    public class InputModel
    {
        [Required]
        [DataType(DataType.Text)]
        [Display(Name = "Full name")]
        public string Name { get; set; }

        [Required]
        [Display(Name = "Birth Date")]
        [DataType(DataType.Date)]
        public DateTime DOB { get; set; }

        [Phone]
        [Display(Name = "Phone number")]
        public string PhoneNumber { get; set; }
    }

    private async Task LoadAsync(WebApp1User user)
    {
        var userName = await _userManager.GetUserNameAsync(user);
        var phoneNumber = await _userManager.GetPhoneNumberAsync(user);

        Username = userName;

        Input = new InputModel
        {
            Name = user.Name,
            DOB = user.DOB,
            PhoneNumber = phoneNumber
        };
    }

    public async Task<IActionResult> OnGetAsync()
    {
        var user = await _userManager.GetUserAsync(User);
        if (user == null)
        {
            return NotFound(
                $"Unable to load user with ID '{_userManager.GetUserId(User)}'.");
        }

        await LoadAsync(user);
        return Page();
    }

    public async Task<IActionResult> OnPostAsync()
    {
        var user = await _userManager.GetUserAsync(User);
        if (user == null)
        {
            return NotFound(
                $"Unable to load user with ID '{_userManager.GetUserId(User)}'.");
        }

        if (!ModelState.IsValid)
        {
            await LoadAsync(user);
            return Page();
        }

        var phoneNumber = await _userManager.GetPhoneNumberAsync(user);
        if (Input.PhoneNumber != phoneNumber)
        {
            var setPhoneResult = await _userManager.SetPhoneNumberAsync(user, 
                Input.PhoneNumber);

            if (!setPhoneResult.Succeeded)
            {
                var userId = await _userManager.GetUserIdAsync(user);
                throw new InvalidOperationException(
                    $"Unexpected error occurred setting phone number for user with ID '{userId}'.");
            }
        }
        
        if (Input.Name != user.Name)
        {
            user.Name = Input.Name;
        }

        if (Input.DOB != user.DOB)
        {
            user.DOB = Input.DOB;
        }

        await _userManager.UpdateAsync(user);

        await _signInManager.RefreshSignInAsync(user);
        StatusMessage = "Your profile has been updated";
        return RedirectToPage();
    }
}

次の強調表示されたマークアップで Areas/Identity/Pages/Account/Manage/Index.cshtml を更新します。

@page
@model IndexModel
@{
    ViewData["Title"] = "Profile";
    ViewData["ActivePage"] = ManageNavPages.Index;
}

<h4>@ViewData["Title"]</h4>
<partial name="_StatusMessage" model="Model.StatusMessage" />
<div class="row">
    <div class="col-md-6">
        <form id="profile-form" method="post">
            <div asp-validation-summary="All" class="text-danger"></div>
            <div class="form-group">
                <label asp-for="Username"></label>
                <input asp-for="Username" class="form-control" disabled />
            </div>
            <div class="form-group">
                <label asp-for="Input.Name"></label>
                <input asp-for="Input.Name" class="form-control" />
            </div>
            <div class="form-group">
                <label asp-for="Input.DOB"></label>
                <input asp-for="Input.DOB" class="form-control" />
            </div>
            <div class="form-group">
                <label asp-for="Input.PhoneNumber"></label>
                <input asp-for="Input.PhoneNumber" class="form-control" />
                <span asp-validation-for="Input.PhoneNumber" 
                    class="text-danger"></span>
            </div>
            <button id="update-profile-button" type="submit" 
                class="btn btn-primary">Save</button>
        </form>
    </div>
</div>

@section Scripts {
    <partial name="_ValidationScriptsPartial" />
}

Account/Register.cshtml ページを更新する

InputModelAreas/Identity/Pages/Account/Register.cshtml.csを、次の強調表示されたコードで更新します。

[AllowAnonymous]
public class RegisterModel : PageModel
{
    private readonly SignInManager<WebApp1User> _signInManager;
    private readonly UserManager<WebApp1User> _userManager;
    private readonly ILogger<RegisterModel> _logger;
    private readonly IEmailSender _emailSender;

    public RegisterModel(
        UserManager<WebApp1User> userManager,
        SignInManager<WebApp1User> signInManager,
        ILogger<RegisterModel> logger,
        IEmailSender emailSender)
    {
        _userManager = userManager;
        _signInManager = signInManager;
        _logger = logger;
        _emailSender = emailSender;
    }

    [BindProperty]
    public InputModel Input { get; set; }

    public string ReturnUrl { get; set; }

    public IList<AuthenticationScheme> ExternalLogins { get; set; }

    public class InputModel
    {
        [Required]
        [DataType(DataType.Text)]
        [Display(Name = "Full name")]
        public string Name { get; set; }

        [Required]
        [Display(Name = "Birth Date")]
        [DataType(DataType.Date)]
        public DateTime DOB { get; set; }

        [Required]
        [EmailAddress]
        [Display(Name = "Email")]
        public string Email { get; set; }

        [Required]
        [StringLength(100, ErrorMessage = "The {0} must be at least {2} and at max {1} characters long.", MinimumLength = 6)]
        [DataType(DataType.Password)]
        [Display(Name = "Password")]
        public string Password { get; set; }

        [DataType(DataType.Password)]
        [Display(Name = "Confirm password")]
        [Compare("Password", ErrorMessage = "The password and confirmation password do not match.")]
        public string ConfirmPassword { get; set; }
    }

    public async Task OnGetAsync(string returnUrl = null)
    {
        ReturnUrl = returnUrl;
        ExternalLogins = (await _signInManager.GetExternalAuthenticationSchemesAsync()).ToList();
    }

    public async Task<IActionResult> OnPostAsync(string returnUrl = null)
    {
        returnUrl = returnUrl ?? Url.Content("~/");
        ExternalLogins = (await _signInManager.GetExternalAuthenticationSchemesAsync()).ToList();
        if (ModelState.IsValid)
        {
            var user = new WebApp1User {
                Name = Input.Name,
                DOB = Input.DOB,
                UserName = Input.Email, 
                Email = Input.Email 
            };
            var result = await _userManager.CreateAsync(user, Input.Password);
            if (result.Succeeded)
            {
                _logger.LogInformation("User created a new account with password.");

                var code = await _userManager.GenerateEmailConfirmationTokenAsync(user);
                code = WebEncoders.Base64UrlEncode(Encoding.UTF8.GetBytes(code));
                var callbackUrl = Url.Page(
                    "/Account/ConfirmEmail",
                    pageHandler: null,
                    values: new { area = "Identity", userId = user.Id, code = code },
                    protocol: Request.Scheme);

                await _emailSender.SendEmailAsync(Input.Email, 
                    "Confirm your email",
                    $"Please confirm your account by <a href='{HtmlEncoder.Default.Encode(callbackUrl)}'>clicking here</a>.");

                if (_userManager.Options.SignIn.RequireConfirmedAccount)
                {
                    return RedirectToPage("RegisterConfirmation", new { email = Input.Email });
                }
                else
                {
                    await _signInManager.SignInAsync(user, isPersistent: false);
                    return LocalRedirect(returnUrl);
                }
            }
            foreach (var error in result.Errors)
            {
                ModelState.AddModelError(string.Empty, error.Description);
            }
        }

        // If we got this far, something failed, redisplay form
        return Page();
    }
}

次の強調表示されたマークアップで Areas/Identity/Pages/Account/Register.cshtml を更新します。

@page
@model RegisterModel
@{
    ViewData["Title"] = "Register";
}

<h1>@ViewData["Title"]</h1>

<div class="row">
    <div class="col-md-4">
        <form asp-route-returnUrl="@Model.ReturnUrl" method="post">
            <h4>Create a new account.</h4>
            <hr />
            <div asp-validation-summary="All" class="text-danger"></div>

            <div class="form-group">
                <label asp-for="Input.Name"></label>
                <input asp-for="Input.Name" class="form-control" />
                <span asp-validation-for="Input.Name" class="text-danger"></span>
            </div>
            <div class="form-group">
                <label asp-for="Input.DOB"></label>
                <input asp-for="Input.DOB" class="form-control" />
                <span asp-validation-for="Input.DOB" class="text-danger"></span>
            </div>
            
            <div class="form-group">
                <label asp-for="Input.Email"></label>
                <input asp-for="Input.Email" class="form-control" />
                <span asp-validation-for="Input.Email" class="text-danger"></span>
            </div>
            <div class="form-group">
                <label asp-for="Input.Password"></label>
                <input asp-for="Input.Password" class="form-control" />
                <span asp-validation-for="Input.Password" class="text-danger"></span>
            </div>
            <div class="form-group">
                <label asp-for="Input.ConfirmPassword"></label>
                <input asp-for="Input.ConfirmPassword" class="form-control" />
                <span asp-validation-for="Input.ConfirmPassword" class="text-danger"></span>
            </div>
            <button type="submit" class="btn btn-primary">Register</button>
        </form>
    </div>
    <div class="col-md-6 col-md-offset-2">
        <section>
            <h4>Use another service to register.</h4>
            <hr />
            @{
                if ((Model.ExternalLogins?.Count ?? 0) == 0)
                {
                    <div>
                        <p>
                            There are no external authentication services configured. See 
                             <a href="https://go.microsoft.com/fwlink/?LinkID=532715">this article</a>
                            for details on setting up this ASP.NET application to support 
                            logging in via external services.
                        </p>
                    </div>
                }
                else
                {
                    <form id="external-account" asp-page="./ExternalLogin" 
                        asp-route-returnUrl="@Model.ReturnUrl" method="post" 
                        class="form-horizontal">
                        <div>
                            <p>
                                @foreach (var provider in Model.ExternalLogins)
                                {
                                    <button type="submit" class="btn btn-primary" name="provider" 
                                        value="@provider.Name" 
                                        title="Log in using your @provider.DisplayName account">
                                            @provider.DisplayName</button>
                                }
                            </p>
                        </div>
                    </form>
                }
            }
        </section>
    </div>
</div>

@section Scripts {
    <partial name="_ValidationScriptsPartial" />
}

プロジェクトをビルドします。

カスタム ユーザー データの移行を追加する

Visual Studio パッケージ マネージャー コンソール:

Add-Migration CustomUserData
Update-Database

カスタム ユーザー データの作成、表示、ダウンロード、削除をテストする

アプリをテストします。

  • 新しいユーザーを登録します。
  • /Identity/Account/Manage ページでカスタム ユーザー データを表示します。
  • /Identity/Account/Manage/PersonalData ページからユーザーの個人データをダウンロードして表示します。

Identity に要求を追加するために IUserClaimsPrincipalFactory<ApplicationUser> を使用する

Note

このセクションは、前のチュートリアルの拡張機能ではありません。 チュートリアルを使用してビルドされたアプリに次の手順を適用するには、このGitHubの問題を参照してください。

Identity インターフェイスを使用して、ASP.NET Core IUserClaimsPrincipalFactory<T> に追加の要求を追加できます。 このクラスは、 Startup.ConfigureServices メソッドでアプリに追加できます。 次のように、クラスのカスタム実装を追加します。

public void ConfigureServices(IServiceCollection services)
{
    services.AddIdentity<ApplicationUser, IdentityRole>()
        .AddEntityFrameworkStores<ApplicationDbContext>()
        .AddDefaultTokenProviders();

    services.AddScoped<IUserClaimsPrincipalFactory<ApplicationUser>, 
        AdditionalUserClaimsPrincipalFactory>();

デモ コードでは、 ApplicationUser クラスを使用します。 このクラスは、追加の要求を追加するために使用される IsAdmin プロパティを追加します。

public class ApplicationUser : IdentityUser
{
    public bool IsAdmin { get; set; }
}

AdditionalUserClaimsPrincipalFactoryは、UserClaimsPrincipalFactory インターフェイスを実装します。 新しいロール要求が ClaimsPrincipalに追加されます。

public class AdditionalUserClaimsPrincipalFactory 
        : UserClaimsPrincipalFactory<ApplicationUser, IdentityRole>
{
    public AdditionalUserClaimsPrincipalFactory( 
        UserManager<ApplicationUser> userManager,
        RoleManager<IdentityRole> roleManager, 
        IOptions<IdentityOptions> optionsAccessor) 
        : base(userManager, roleManager, optionsAccessor)
    {}

    public async override Task<ClaimsPrincipal> CreateAsync(ApplicationUser user)
    {
        var principal = await base.CreateAsync(user);
        var identity = (ClaimsIdentity)principal.Identity;

        var claims = new List<Claim>();
        if (user.IsAdmin)
        {
            claims.Add(new Claim(JwtClaimTypes.Role, "admin"));
        }
        else
        {
            claims.Add(new Claim(JwtClaimTypes.Role, "user"));
        }

        identity.AddClaims(claims);
        return principal;
    }
}

その後、追加の要求をアプリで使用できます。 Razor ページでは、IAuthorizationService インスタンスを使用して要求値にアクセスできます。

@using Microsoft.AspNetCore.Authorization
@inject IAuthorizationService AuthorizationService

@if ((await AuthorizationService.AuthorizeAsync(User, "IsAdmin")).Succeeded)
{
    <ul class="mr-auto navbar-nav">
        <li class="nav-item">
            <a class="nav-link" asp-controller="Admin" asp-action="Index">ADMIN</a>
        </li>
    </ul>
}

.NET Core 2.2 以降の SDK

Razor Web アプリを作成する

  • Visual Studio File メニューから、New>Project を選択します。 ダウンロード サンプル コードの名前空間と一致させる場合は、プロジェクトに WebApp1 という名前を付けます。
  • ASP.NET Core Web アプリケーションOKを選択します
  • ドロップダウンで ASP.NET Core 2.2 を選択します
  • [ 認証 ] セクションで、[ 個々のユーザー アカウント] を選択します。
  • Web アプリケーション>OK の選択
  • プロジェクトをビルドして実行します。

Identity スキャフォールディングを実行する

  • ソリューション エクスプローラーから、プロジェクトを右クリックし、>追加>新しいスキャフォールディングアイテムを選択します。
  • スキャフォールディングの追加ダイアログの左側のウィンドウで、Identityを選択します。
  • [Identityの追加] ダイアログで、次のオプションを選択します。
    • 既存のレイアウト ファイルを選択する ~/Pages/Shared/_Layout.cshtml
    • オーバーライドする次のファイルを選択します。
      • Account/Register
      • Account/Manage/Index
    • + ボタンを選択して、新しいデータ コンテキスト クラスを作成します。 型を受け入れます (プロジェクトの名前が WebApp1 の場合は WebApp1.WebApp1Context)。
    • + ボタンを選択して、新しい User クラスを作成します。 指定された型 (WebApp1 という名前のプロジェクトなら WebApp1User) を受け入れ、追加します。>
  • [] を選択し、[] を追加します。

移行、UseAuthentication、およびレイアウトの手順に従って、次の手順を実行します。

  • 移行を作成し、データベースを更新します。
  • UseAuthenticationStartup.Configure に追加します。
  • レイアウト ファイルに <partial name="_LoginPartial" /> を追加します。
  • アプリをテストします。
    • ユーザーを登録する
    • 新しいユーザー名 ( [ログアウト ] リンクの横) を選択します。 ウィンドウを展開するか、ナビゲーション バーアイコンを選択してユーザー名やその他のリンクを表示することが必要になる場合があります。
    • [ 個人データ ] タブを選択します。
    • [ ダウンロード ] ボタンを選択し、 PersonalData.json ファイルを調べました。
    • ログオンしているユーザーを削除する [ 削除 ] ボタンをテストします。

Identity DB にカスタム ユーザー データを追加する

IdentityUser派生クラスをカスタム プロパティで更新します。 プロジェクトに WebApp1 という名前を付けた場合、ファイルには Areas/Identity/Data/WebApp1User.cs という名前が付けられます。 次のコードでファイルを更新します。

using Microsoft.AspNetCore.Identity;
using System;

namespace WebApp1.Areas.Identity.Data
{
    public class WebApp1User : IdentityUser
    {
        [PersonalData]
        public string Name { get; set; }
        [PersonalData]
        public DateTime DOB { get; set; }
    }
}

PersonalData 属性を持つプロパティは次のとおりです。

  • Areas/Identity/Pages/Account/Manage/DeletePersonalData.cshtml Razor ページがUserManager.Deleteを呼び出すと削除されます。
  • Areas/Identity/Pages/Account/Manage/DownloadPersonalData.cshtml Razor ページでダウンロードしたデータに含まれます。

Account/Manage/Index.cshtml ページを更新する

InputModelAreas/Identity/Pages/Account/Manage/Index.cshtml.csを、次の強調表示されたコードで更新します。

public partial class IndexModel : PageModel
{
    private readonly UserManager<WebApp1User> _userManager;
    private readonly SignInManager<WebApp1User> _signInManager;
    private readonly IEmailSender _emailSender;

    public IndexModel(
        UserManager<WebApp1User> userManager,
        SignInManager<WebApp1User> signInManager,
        IEmailSender emailSender)
    {
        _userManager = userManager;
        _signInManager = signInManager;
        _emailSender = emailSender;
    }

    public string Username { get; set; }
    public bool IsEmailConfirmed { get; set; }

    [TempData]
    public string StatusMessage { get; set; }

    [BindProperty]
    public InputModel Input { get; set; }

    public class InputModel
    {
        [Required]
        [DataType(DataType.Text)]
        [Display(Name = "Full name")]
        public string Name { get; set; }

        [Required]
        [Display(Name = "Birth Date")]
        [DataType(DataType.Date)]
        public DateTime DOB { get; set; }

        [Required]
        [EmailAddress]
        public string Email { get; set; }

        [Phone]
        [Display(Name = "Phone number")]
        public string PhoneNumber { get; set; }
    }

    public async Task<IActionResult> OnGetAsync()
    {
        var user = await _userManager.GetUserAsync(User);
        if (user == null)
        {
            return NotFound($"Unable to load user with ID '{_userManager.GetUserId(User)}'.");
        }

        var userName = await _userManager.GetUserNameAsync(user);
        var email = await _userManager.GetEmailAsync(user);
        var phoneNumber = await _userManager.GetPhoneNumberAsync(user);

        Username = userName;

        Input = new InputModel
        {
            Name = user.Name,
            DOB = user.DOB,
            Email = email,
            PhoneNumber = phoneNumber
        };

        IsEmailConfirmed = await _userManager.IsEmailConfirmedAsync(user);

        return Page();
    }

    public async Task<IActionResult> OnPostAsync()
    {
        if (!ModelState.IsValid)
        {
            return Page();
        }

        var user = await _userManager.GetUserAsync(User);
        if (user == null)
        {
            return NotFound($"Unable to load user with ID '{_userManager.GetUserId(User)}'.");
        }

        var email = await _userManager.GetEmailAsync(user);
        if (Input.Email != email)
        {
            var setEmailResult = await _userManager.SetEmailAsync(user, Input.Email);
            if (!setEmailResult.Succeeded)
            {
                var userId = await _userManager.GetUserIdAsync(user);
                throw new InvalidOperationException($"Unexpected error occurred setting email for user with ID '{userId}'.");
            }
        }

        if (Input.Name != user.Name)
        {
            user.Name = Input.Name;
        }

        if (Input.DOB != user.DOB)
        {
            user.DOB = Input.DOB;
        }

        var phoneNumber = await _userManager.GetPhoneNumberAsync(user);
        if (Input.PhoneNumber != phoneNumber)
        {
            var setPhoneResult = await _userManager.SetPhoneNumberAsync(user, Input.PhoneNumber);
            if (!setPhoneResult.Succeeded)
            {
                var userId = await _userManager.GetUserIdAsync(user);
                throw new InvalidOperationException($"Unexpected error occurred setting phone number for user with ID '{userId}'.");
            }
        }

        await _userManager.UpdateAsync(user);

        await _signInManager.RefreshSignInAsync(user);
        StatusMessage = "Your profile has been updated";
        return RedirectToPage();
    }

    public async Task<IActionResult> OnPostSendVerificationEmailAsync()
    {
        if (!ModelState.IsValid)
        {
            return Page();
        }

        var user = await _userManager.GetUserAsync(User);
        if (user == null)
        {
            return NotFound($"Unable to load user with ID '{_userManager.GetUserId(User)}'.");
        }


        var userId = await _userManager.GetUserIdAsync(user);
        var email = await _userManager.GetEmailAsync(user);
        var code = await _userManager.GenerateEmailConfirmationTokenAsync(user);
        var callbackUrl = Url.Page(
            "/Account/ConfirmEmail",
            pageHandler: null,
            values: new { userId = userId, code = code },
            protocol: Request.Scheme);
        await _emailSender.SendEmailAsync(
            email,
            "Confirm your email",
            $"Please confirm your account by <a href='{HtmlEncoder.Default.Encode(callbackUrl)}'>clicking here</a>.");

        StatusMessage = "Verification email sent. Please check your email.";
        return RedirectToPage();
    }
}

次の強調表示されたマークアップで Areas/Identity/Pages/Account/Manage/Index.cshtml を更新します。

@page
@model IndexModel
@{
    ViewData["Title"] = "Profile";
    ViewData["ActivePage"] = ManageNavPages.Index;
}

<h4>@ViewData["Title"]</h4>
<partial name="_StatusMessage" for="StatusMessage" />
<div class="row">
    <div class="col-md-6">
        <form id="profile-form" method="post">
            <div asp-validation-summary="All" class="text-danger"></div>
            <div class="form-group">
                <label asp-for="Username"></label>
                <input asp-for="Username" class="form-control" disabled />
            </div>
            <div class="form-group">
                <label asp-for="Input.Email"></label>
                @if (Model.IsEmailConfirmed)
                {
                    <div class="input-group">
                        <input asp-for="Input.Email" class="form-control" />
                        <span class="input-group-addon" aria-hidden="true"><span class="glyphicon glyphicon-ok text-success"></span></span>
                    </div>
                }
                else
                {
                    <input asp-for="Input.Email" class="form-control" />
                    <button id="email-verification" type="submit" asp-page-handler="SendVerificationEmail" class="btn btn-link">Send verification email</button>
                }
                <span asp-validation-for="Input.Email" class="text-danger"></span>
            </div>
            <div class="form-group">
                <label asp-for="Input.Name"></label>
                <input asp-for="Input.Name" class="form-control" />
            </div>
            <div class="form-group">
                <label asp-for="Input.DOB"></label>
                <input asp-for="Input.DOB" class="form-control" />
            </div>
            <div class="form-group">
                <label asp-for="Input.PhoneNumber"></label>
                <input asp-for="Input.PhoneNumber" class="form-control" />
                <span asp-validation-for="Input.PhoneNumber" class="text-danger"></span>
            </div>
            <button id="update-profile-button" type="submit" class="btn btn-primary">Save</button>
        </form>
    </div>
</div>

@section Scripts {
    <partial name="_ValidationScriptsPartial" />
}

Account/Register.cshtml ページを更新する

InputModelAreas/Identity/Pages/Account/Register.cshtml.csを、次の強調表示されたコードで更新します。

[AllowAnonymous]
public class RegisterModel : PageModel
{
    private readonly SignInManager<WebApp1User> _signInManager;
    private readonly UserManager<WebApp1User> _userManager;
    private readonly ILogger<RegisterModel> _logger;
    private readonly IEmailSender _emailSender;

    public RegisterModel(
        UserManager<WebApp1User> userManager,
        SignInManager<WebApp1User> signInManager,
        ILogger<RegisterModel> logger,
        IEmailSender emailSender)
    {
        _userManager = userManager;
        _signInManager = signInManager;
        _logger = logger;
        _emailSender = emailSender;
    }

    [BindProperty]
    public InputModel Input { get; set; }

    public string ReturnUrl { get; set; }

    public class InputModel
    {
        [Required]
        [DataType(DataType.Text)]
        [Display(Name = "Full name")]
        public string Name { get; set; }

        [Required]
        [Display(Name = "Birth Date")]
        [DataType(DataType.Date)]
        public DateTime DOB { get; set; }

        [Required]
        [EmailAddress]
        [Display(Name = "Email")]
        public string Email { get; set; }

        [Required]
        [StringLength(100, ErrorMessage = "The {0} must be at least {2} and at max {1} characters long.", MinimumLength = 6)]
        [DataType(DataType.Password)]
        [Display(Name = "Password")]
        public string Password { get; set; }

        [DataType(DataType.Password)]
        [Display(Name = "Confirm password")]
        [Compare("Password", ErrorMessage = "The password and confirmation password do not match.")]
        public string ConfirmPassword { get; set; }
    }

    public void OnGet(string returnUrl = null)
    {
        ReturnUrl = returnUrl;
    }

    public async Task<IActionResult> OnPostAsync(string returnUrl = null)
    {
        returnUrl = returnUrl ?? Url.Content("~/");
        if (ModelState.IsValid)
        {
            var user = new WebApp1User {
                Name = Input.Name,
                DOB = Input.DOB,
                UserName = Input.Email,
                Email = Input.Email
            };
            var result = await _userManager.CreateAsync(user, Input.Password);
            if (result.Succeeded)
            {
                _logger.LogInformation("User created a new account with password.");

                var code = await _userManager.GenerateEmailConfirmationTokenAsync(user);
                var callbackUrl = Url.Page(
                    "/Account/ConfirmEmail",
                    pageHandler: null,
                    values: new { userId = user.Id, code = code },
                    protocol: Request.Scheme);

                await _emailSender.SendEmailAsync(Input.Email, "Confirm your email",
                    $"Please confirm your account by <a href='{HtmlEncoder.Default.Encode(callbackUrl)}'>clicking here</a>.");

                await _signInManager.SignInAsync(user, isPersistent: false);
                return LocalRedirect(returnUrl);
            }
            foreach (var error in result.Errors)
            {
                ModelState.AddModelError(string.Empty, error.Description);
            }
        }

        // If we got this far, something failed, redisplay form
        return Page();
    }
}

次の強調表示されたマークアップで Areas/Identity/Pages/Account/Register.cshtml を更新します。

@page
@model RegisterModel
@{
    ViewData["Title"] = "Register";
}

<h1>@ViewData["Title"]</h1>

<div class="row">
    <div class="col-md-4">
        <form asp-route-returnUrl="@Model.ReturnUrl" method="post">
            <h4>Create a new account.</h4>
            <hr />
            <div asp-validation-summary="All" class="text-danger"></div>

            <div class="form-group">
                <label asp-for="Input.Name"></label>
                <input asp-for="Input.Name" class="form-control" />
                <span asp-validation-for="Input.Name" class="text-danger"></span>
            </div>
            <div class="form-group">
                <label asp-for="Input.DOB"></label>
                <input asp-for="Input.DOB" class="form-control" />
                <span asp-validation-for="Input.DOB" class="text-danger"></span>
            </div>

            <div class="form-group">
                <label asp-for="Input.Email"></label>
                <input asp-for="Input.Email" class="form-control" />
                <span asp-validation-for="Input.Email" class="text-danger"></span>
            </div>
            <div class="form-group">
                <label asp-for="Input.Password"></label>
                <input asp-for="Input.Password" class="form-control" />
                <span asp-validation-for="Input.Password" class="text-danger"></span>
            </div>
            <div class="form-group">
                <label asp-for="Input.ConfirmPassword"></label>
                <input asp-for="Input.ConfirmPassword" class="form-control" />
                <span asp-validation-for="Input.ConfirmPassword" class="text-danger"></span>
            </div>
            <button type="submit" class="btn btn-primary">Register</button>
        </form>
    </div>
</div>

@section Scripts {
    <partial name="_ValidationScriptsPartial" />
}

プロジェクトをビルドします。

カスタム ユーザー データの移行を追加する

Visual Studio パッケージ マネージャー コンソール:

Add-Migration CustomUserData
Update-Database

カスタム ユーザー データの作成、表示、ダウンロード、削除をテストする

アプリをテストします。

  • 新しいユーザーを登録します。
  • /Identity/Account/Manage ページでカスタム ユーザー データを表示します。
  • /Identity/Account/Manage/PersonalData ページからユーザーの個人データをダウンロードして表示します。