امروزه استفاده از claim به یک ترند جهانی تبدیل شده است و بسیاری از افراد از آن استفاده می‌کنند. شاید شما نیز نام claim را نخستین بار در آموزش authentication در MVC شنیده باشید. در authentication، ما مفهومی به نام claim base identity داریم که در حقیقت با استفاده از آن می‌توان امنیت identity را تامین کرد و فرایند احراز هویت امن‌تری برای ما ایجاد کرد. در این مقاله به صورت کامل با claim آشنا می‌شوید و می‌توانیم با استفاده از یک مثال عملی روش کار آن را ببینیم.

آموزش claim در mvc
آموزش claim در mvc

Identity چیست؟

Identity یکی از سیستم‌های احراز هویت است که پس از سیستم‌هایی همچون ASP.NET Membership و Simple Membership برای ASP.NET MVC معرفی شده است. claim base identity نیز به نوعی یکی از attribute های identity است که به ما برای احراز هویت امن‌تر کمک می‌کند.

نکته
مقاله پیشنهادی: آموزش identity در mvc

Claim چیست؟

Claim در حقیقت اعطای اعتبار دسترسی به بخشی از سایت یا اپلیکیشن تحت وب ما، پس از دریافت اطلاعاتی از کاربر است. بهتراست claim را با استفاده از یک مثال توضیح دهیم. ممکن است برای شما نیز پیش آمده باشد که وارد سایتی شوید و این سایت برای ثبت نام شما اطلاعاتی را از شما درخواست کند. این اطلاعات می‌تواند شهر محل زندگی، کشور محل زندگی و یا تاریخ تولد شما و اطلاعات دیگری باشد. مورد مهم اما این است که برنامه‌نویس سایت قانونی مبنی بر اینکه فقط افراد چند کشور مشخص، توانایی استفاده از این سایت را دارند گذاشته باشد. پس از این اتفاق داده‌های دریافت شده از شما بررسی می‌شود و برای نمونه اگر کشور شما با کشورهای مجاز که در درون سایت وجود دارند همخوانی نداشت. اجازه دسترسی شما به محتوای سایت گرفته می‌شود. این دقیقاً مثالی از claim و روش کار آن است.

claim چیست؟
claim چیست؟

نحوه استفاده از claim در MVC

در اینجا می‌خواهیم از claim در ASP.NET MVC استفاده کنیم و ببینیم که claim base security چگونه و به چه شکلی به کمک ما میاید. برای این کار ابتدا یک پروژه hello world به صورت ASP.NET MVC Web application در ویژوال استودیو ایجاد کنید. پروژه ایجاد شده به طور خودکار تمام تنظیمات و قابلیت‌هایی که ما به آن نیاز داریم را برای ما اضافه می‌کند. تنها کاری که ما باید انجام دهیم و برای ما لازم است. افزودن یک claim در مراحل ثبت نام و احراز هویت کاربران است. پس از این کار نیز محدودیت‌هایی را بر پایه اطلاعات دریافت کرده، برای کاربران لحاظ می‌کنیم.

ابتدا و به سرعت به تاکید بر عملکرد قسمت‌هایی مهمی که کارهای امنیتی را انجام می‌دهند می‌پردازیم:

App_Start/Startup.Auth.cs کلاسی برای امنیت bootstrapping است.

۱٫	public void ConfigureAuth(IAppBuilder app)
۲٫	   {
۳٫	       / /Configure the db context, user manager, and signin
۴٫	       / /manager to use a single instance per request
۵٫	      app.CreatePerOwinContext(ApplicationDbContext.Create);
۶٫	      app.CreatePerOwinContext<ApplicationUserManager>
۷٫	         (ApplicationUserManager.Create);
۸٫	      app.CreatePerOwinContext<ApplicationSignInManager>
۹٫	         (ApplicationSignInManager.Create);
۱۰٫	 
۱۱٫	       / /Enable the application to use a cookie to store
۱۲٫	       / /information for the signed-in user and to use
۱۳٫	       / /a cookie to temporarily store information about
۱۴٫	       / /a user logging in with a third-party login provider
۱۵٫	       / /Configure the sign-in cookie
۱۶٫	      app.UseCookieAuthentication(new CookieAuthenticationOptions
۱۷٫	      {
۱۸٫	         AuthenticationType = DefaultAuthenticationTypes.
۱۹٫	            ApplicationCookie,
۲۰٫	         LoginPath = new PathString("/Account/Login"),
۲۱٫	         Provider = new CookieAuthenticationProvider
۲۲٫	         {
۲۳٫	             / /Enables the application to validate the security
۲۴٫	             / /stamp when the user logs in.
۲۵٫	             / /This is a security feature that is used when you
۲۶٫	             / /change a password or add an external login to
۲۷٫	             / /your account.
۲۸٫	            OnValidateIdentity = SecurityStampValidator.
۲۹٫	               OnValidateIdentity<ApplicationUserManager,
۳۰٫	               ApplicationUser>(
۳۱٫	               validateInterval: TimeSpan.FromMinutes(30),
۳۲٫	               regenerateIdentity: (manager, user) =>
۳۳٫	                 user.GenerateUserIdentityAsync(manager))
۳۴٫	            }
۳۵٫	      });
۳۶٫	      app.UseExternalSignInCookie(DefaultAuthenticationTypes.
۳۷٫	                                  ExternalCookie);
۳۸٫	 
۳۹٫	       / /Enables the application to temporarily store user
۴۰٫	       / /information when they are verifying the second factor
۴۱٫	       / /in the two-factor authentication process.
۴۲٫	      app.UseTwoFactorSignInCookie
۴۳٫	         (DefaultAuthenticationTypes.TwoFactorCookie,
۴۴٫	          TimeSpan.FromMinutes(5));
۴۵٫	 
۴۶٫	       / /Enables the application to remember the second login
۴۷٫	       / /verification factor, such as phone or email.
۴۸٫	       / /Once you check this option, your second step of
۴۹٫	       / /verification during the login process will be
۵۰٫	       / /remembered on the device from where you logged in.
۵۱٫	       / /This is similar to the RememberMe option when you
۵۲٫	       / /log in.
۵۳٫	      app.UseTwoFactorRememberBrowserCookie
۵۴٫	         (DefaultAuthenticationTypes.
۵۵٫	          TwoFactorRememberBrowserCookie);
۵۶٫	   }

 App_Start/IdentityConfig.cs تنظیمات و افزونههای identity است.

 Models/IdentityModels.cs حاوی کلاس ApplicationUser است.

۱٫	public class ApplicationUser : IdentityUser
۲٫	   {
۳٫	      public async Task<ClaimsIdentity> GenerateUserIdentityAsync
۴٫	         (UserManager<ApplicationUser> manager)
۵٫	      {
۶٫	          / /Note the authenticationType must match the one defined
۷٫	          / /in CookieAuthenticationOptions.AuthenticationType
۸٫	         var userIdentity = await manager.CreateIdentityAsync(this,
۹٫	            DefaultAuthenticationTypes.ApplicationCookie);
۱۰٫	          / /Add custom user claims here
۱۱٫	         return userIdentity;
۱۲٫	      }
۱۳٫	   }

اینجا مکانی است که به واسطه آن می‌توانیم تعدادی claim را معرفی کرده و از آنها استفاده کنیم. برای این کار بهتر است از تغییر کدها به شکل قابل استفاده در دنیای واقعی آغاز کنیم.

  1. Enable Entity Framework Migrations

فعال سازی entity framework migration به ما کمک می‌کند تا در صورت وجود داده‌های تکراری، الگوی دیتابیس ما به هم نریزد. پس استفاده از آن برای ما و در هنگام استفاده از claim در دنیای واقعی مهم است.

  1. Add Relevant Properties

اضافه کردن properties در کلاس application user انجام می‌شود و پس از آن می‌توان اطلاعات claim که properties آن را مشخص کردیم استفاده کرد. بیایید BirthDate را گرفته و به عنوان property به application user اضافه کنیم.

  1. Add EF Migration

یک EF migration به فیلد جدید دیتابیس به روز شده خود، در packet manager console اضافه می‌کنیم.

با استفاده از Add-Migration به شکل Age’ <press enter> می‌توانیم یک اسکریپت آپدیت شده برای تغییرات خود اضافه کنیم.

حال Update-Database <press enter> را انجام دهید تا بتوانید الگو database را آپدیت کنید.

  1. Add the Birthday Value

اکنون جایی است که مقادیر تاریخ تولد را به فرم کاربر وارد می‌کنیم. برای این کار اعداد تولد را در فرم ثبت نام کاربر و در آدرس Models\AccountViewModels.cs RegisterViewModel class قرار می‌دهیم.

۱٫	public class RegisterViewModel
۲٫	   {
۳٫	      [Required]
۴٫	      [EmailAddress]
۵٫	      [Display(Name = "Email")]
۶٫	      public string Email { get; set; }
۷٫	 
۸٫	      [Required]
۹٫	      [StringLength(100, ErrorMessage = "The {0}
۱۰٫	         must be at least {2} 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; }
۲۲٫	 
۲۳٫	      [Required]
۲۴٫	      [Display(Name ="Date of Birth")]
۲۵٫	      [DataType(DataType.Date)]
۲۶٫	      public DateTime BirthDate { get; set; }
۲۷٫	   }

فراموش نکنید که قبل از تعریف کلاس، using system را استفاده کنید.

  1. Update the Views\Account\Register.cshtml File

فایل Views\Account\Register.cshtml را با افزودن یک فیلد جدید به روز می‌کنیم.

۱٫	...
۲٫	   <div class="form-group">
۳٫	      @Html.LabelFor(m => m.BirthDate, new
۴٫	         { @class = "col-md-2 control-label" })
۵٫	      <div class="col-md-10">
۶٫	         @Html.TextBoxFor(m => m.BirthDate, new
۷٫	            { @class = "form-control" })
۸٫	      </div>
۹٫	   </div>
۱۰٫	...
ثبت نام حساب جدید
ثبت نام حساب جدید
  1. Update the Controllers\AccountController.cs Register Method

روش رجیستر Controllers\AccountController.cs را برای رد شدن از تولد به روز می‌کنیم.

۱٫	    / /POST: /Account/Register
۲٫	   [HttpPost]
۳٫	   [AllowAnonymous]
۴٫	   [ValidateAntiForgeryToken]
۵٫	   public async Task<ActionResult> Register(RegisterViewModel model)
۶٫	   {
۷٫	      if (ModelState.IsValid)
۸٫	      {
۹٫	         var user = new ApplicationUser { UserName = model.Email,
۱۰٫	            Email = model.Email, BirthDate = model.BirthDate };
۱۱٫	         var result = await UserManager.CreateAsync(user,
۱۲٫	             model.Password);
۱۳٫	         if (result.Succeeded)
۱۴٫	         {
۱۵٫	            await SignInManager.SignInAsync(user, isPersistent:false,
۱۶٫	               rememberBrowser:false);
۱۷٫	 
۱۸٫	             / /For more information on how to enable account confirmation
۱۹٫	             / /and password reset, please visit
۲۰٫	             / /http://go.microsoft.com/fwlink/?LinkID=320771
۲۱٫	             / /Send an email with this link
۲۲٫	             / /string code = await
۲۳٫	             / /UserManager.GenerateEmailConfirmationTokenAsync(user.Id);
۲۴٫	             / /var callbackUrl = Url.Action("ConfirmEmail", "Account",
۲۵٫	             / /new { userId = user.Id, code = code },
۲۶٫	             / /protocol: Request.Url.Scheme);
۲۷٫	             / /await UserManager.SendEmailAsync(user.Id,
۲۸٫	             / /"Confirm your account",
۲۹٫	             / /"Please confirm your account by clicking <a href=\"" +
۳۰٫	             / /callbackUrl + "\">here</a>");
۳۱٫	 
۳۲٫	            return RedirectToAction("Index", "Home");
۳۳٫	         }
۳۴٫	         AddErrors(result);
۳۵٫	      }
۳۶٫	 
۳۷٫	       / /If we got this far, something failed, redisplay form
۳۸٫	      return View(model);
۳۹٫	   }

کلاس applicationuser را با افزودن DOB Claim به روز می‌کنیم.

۱٫	public class ApplicationUser : IdentityUser
۲٫	   {
۳٫	      public DateTime BirthDate { get; set; }
۴٫	      public async Task<ClaimsIdentity>
۵٫	         GenerateUserIdentityAsync
۶٫	         (UserManager<ApplicationUser> manager)
۷٫	      {
۸٫	          / /Note the authenticationType must match the one defined
۹٫	          / /in CookieAuthenticationOptions.AuthenticationType
۱۰٫	         var userIdentity = await manager.CreateIdentityAsync
۱۱٫	            (this, DefaultAuthenticationTypes.ApplicationCookie);
۱۲٫	          / /Add custom user claims here
۱۳٫	         userIdentity.AddClaim(new Claim(ClaimTypes.DateOfBirth,
۱۴٫	            this.BirthDate.ToString()));
۱۵٫	 
۱۶٫	         return userIdentity;
۱۷٫	      }
۱۸٫	   }

پس از این کار ما در حقیقت Claim را در مراحل ثبت نام کاربر قرار دادیم.

  1. Verify the Claim

تنها قسمت باقی مانده نوشتن فیلترهایی برای تایید مجوز استفاده از مقادیر بر روی claim ما است. پس از نوشتن این فیلترها باید آنها را بر روی controllers action قرار دهیم.

۱٫	public class ClaimsAuthorizeAttribute : AuthorizeAttribute
۲٫	   {
۳٫	      private string claimType;
۴٫	      private string claimValue;
۵٫	      public ClaimsAuthorizeAttribute(string claimType,
۶٫	         string claimValue)
۷٫	      {
۸٫	         this.claimType = claimType;
۹٫	         this.claimValue = claimValue;
۱۰٫	      }
۱۱٫	      public override void OnAuthorization(AuthorizationContext
۱۲٫	         filterContext)
۱۳٫	      {
۱۴٫	         var user = filterContext.HttpContext.User as
۱۵٫	            ClaimsPrincipal;
۱۶٫	         if (user.HasClaim(claimType, claimValue))
۱۷٫	         {
۱۸٫	            base.OnAuthorization(filterContext);
۱۹٫	         }
۲۰٫	         else
۲۱٫	         {
۲۲٫	            base.HandleUnauthorizedRequest(filterContext);
۲۳٫	         }
۲۴٫	      }
۲۵٫	   }

Claim روز تولد در حقیقت نیازمند بررسی‌های بیشتری است. برای این منظور ما vrtification یک claim را فقط برای نشان دادن روش کار آن در Controllers\HomeController.cs قرار می‌دهیم.

۱٫	   public class HomeController : Controller
۲٫	   {
۳٫	      public ActionResult Index()
۴٫	      {
۵٫	         return View();
۶٫	      }
۷٫	 
۸٫	      public ActionResult About()
۹٫	      {
۱۰٫	         var user = HttpContext.User as ClaimsPrincipal;
۱۱٫	         if (!user.HasClaim(c => c.Type ==
۱۲٫	            ClaimTypes.DateOfBirth))
۱۳٫	         {
۱۴٫	            ViewBag.Message = "Cannot detect the Age -
۱۵٫	               Claim is absent. ";
۱۶٫	            return View();
۱۷٫	         }
۱۸٫	 
۱۹٫	         int minAge = 16;
۲۰٫	         var dateOfBirth = Convert.ToDateTime(user.FindFirst(c =>
۲۱٫	            c.Type == ClaimTypes.DateOfBirth).Value);
۲۲٫	 
۲۳٫	         if (calculateAge(dateOfBirth) >= minAge)
۲۴٫	         {
۲۵٫	            ViewBag.Message = "You can view this page.";
۲۶٫	         }
۲۷٫	         else
۲۸٫	         {
۲۹٫	            ViewBag.Message = "Your cannot view this page -
۳۰٫	               your age is bellow permitted one. ";
۳۱٫	         }
۳۲٫	 
۳۳٫	         return View();
۳۴٫	      }
۳۵٫	 
۳۶٫	      private int calculateAge(DateTime dateOfBirth)
۳۷٫	      {
۳۸٫	         int calculatedAge = DateTime.Today.Year -
۳۹٫	            dateOfBirth.Year;
۴۰٫	         if (dateOfBirth >
۴۱٫	            DateTime.Today.AddYears(-calculatedAge))
۴۲٫	         {
۴۳٫	            calculatedAge--;
۴۴٫	         }
۴۵٫	         return calculatedAge;
۴۶٫	      }
۴۷٫	 
۴۸٫	      public ActionResult Contact()
۴۹٫	      {
۵۰٫	         ViewBag.Message = "Your contact page.";
۵۱٫	 
۵۲٫	         return View();
۵۳٫	      }
۵۴٫	   }

می‌بینید که کار ما به چه شکل انجام شد و نتیجه داد. برای اینکه از درستی کدهای نوشته شده و اجرای صحیح آن‌ها مطمئن شویم، ما با تاریخ ۰۴/۱۴/۲۰۱۶ در نرم افزار ثبت نام کردیم و نتیجه‌ای به شکل زیر برای ما نمایش داده شد.

نتیجه نهایی بعد از وارد کردن تاریخ تولد
نتیجه نهایی بعد از وارد کردن تاریخ تولد

آموزش claim در mvc

ما در این مقاله به آموزش claim در mvc پرداختیم و با روش کار claim به شکل کامل آشنا شدیم و دیدیم که چگونه می‌توان از آن استفاده کرد. امروزه استفاده از claim در MVC بسیار رواج پیدا کرده و افراد بسیاری از آن استفاده می‌کنند و یکی از عناصر جدا نشدنی authentication در MVC است.

منابع

https://www.codeguru.com/csharp/.net/net_security/asp.net-mvc-and-claim-based-security.html

https://docs.microsoft.com/en-us/aspnet/core/security/authorization/claims?view=aspnetcore-5.0