...

вторник, 24 июня 2014 г.

[Из песочницы] Начало работы с ASP.NET Identity

Многие из вас должны знать, что выход ASP.NET MVC 5 ознаменовался переходом на новую систему авторизации под названием ASP.NET Identity. Разработчики фреймворка настоятельно рекомендуют переходить на новую систему, называя основными ее преимуществами возможность внедрения в абсолютно любой проект (ASP.NET MVC, Web Forms, Web Pages, Web API и SignalR), простую социальную интеграцию, работу на OWIN, установку и обновление посредством NuGet и другие. Присмотревшись внимательнее к ASP.NET Identity, можно без зазрения совести сказать, что это — следующий этап в развитии веб-программирования на ASP.NET. В данном посте я размещу простой туториал для начала работы с ASP.NET Identity.



Побродив немножко по интернету в поисках доступного туториала по реализации системы авторизации в проекте MVC 5, я нашел определенное количество тематических статей, но практически все они были ориентированы на использование Entity Framework как хранилища пользовательских данных. Даже корневой ресурс, к моему великому расстройству, не смог в должной степени раскрыть тему и ответить на все интересующие вопросы.

Пусть у нас имеется MVC-проект, где мы бы хотели использовать самые последние технологии, в частности Owin, Katana и конечно же ASP.NET Identity. Если вдруг термин Owin вводит вас в замешательство, рекомендую прочесть статью.


1. Основные библиотеки, которые нам потребуются: Microsoft.AspNet.Identity.Core, Microsoft.Owin, Microsoft.Owin.Security + все, от них зависимые и зависящие. Легко устанавливаются при помощи NuGet Package Manager. Через консоль NuGet это можно сделать так:



Install-Package Microsoft.AspNet.Identity.Core


2. Реализуем основные классы:



public class ApplicationUser : IUser
{
public ApplicationUser(string name)
{
Id = Guid.NewGuid().ToString();
UserName = name;
}

public string Id { get; private set; }
public string UserName { get; set; }
}




Интерфейс Microsoft.AspNet.Identity.IUser требует реализации полей Id и UserName. Помимо этого вы можете добавить нужные вам поля (Email, Password, City и т.д.)

public class CustomUserStore : IUserStore<ApplicationUser>
{
static readonly List<ApplicationUser> Users = new List<ApplicationUser>();

public void Dispose()
{
throw new NotImplementedException();
}

public Task CreateAsync(ApplicationUser user)
{
return Task.Factory.StartNew(() => Users.Add(user));
}

public Task UpdateAsync(ApplicationUser user)
{
throw new NotImplementedException();
}

public Task DeleteAsync(ApplicationUser user)
{
throw new NotImplementedException();
}

public Task<ApplicationUser> FindByIdAsync(string userId)
{
throw new NotImplementedException();
}

public Task<ApplicationUser> FindByNameAsync(string userName)
{
return Task<ApplicationUser>.Factory.StartNew(() => Users.FirstOrDefault(u => u.UserName == userName));
}
}




CustomUserStore, как понятно из названия, является хранилищем пользователей и включает базовые методы (Create, Update, Delete) для работы с ними. Здесь я использую для хранения статическое поле Users. Здесь же можно прикрутить любое, подходящее для вас хранилище. Также нельзя не обратить внимание на тип возвращаемого значения — Task и Task. Это означает, что методы будут выполняться асинхронно. По этой теме есть неплохие материалы на хабре (например, вот).

public class CustomUserManager : UserManager<ApplicationUser>
{
public CustomUserManager(CustomUserStore store)
: base(store)
{
this.PasswordHasher = new CustomPasswordHasher();
}

public override Task<ApplicationUser> FindAsync(string userName, string password)
{
Task<ApplicationUser> taskInvoke = Task<ApplicationUser>.Factory.StartNew(() =>
{
PasswordVerificationResult result = this.PasswordHasher.VerifyHashedPassword(userName, password);
if (result == PasswordVerificationResult.SuccessRehashNeeded)
{
return Store.FindByNameAsync(userName).Result;
}
return null;
});
return taskInvoke;
}
}

public class CustomPasswordHasher : PasswordHasher
{
public override string HashPassword(string password)
{
return base.HashPassword(password);
}

public override PasswordVerificationResult VerifyHashedPassword(string hashedPassword, string providedPassword)
{
if (true)
{
return PasswordVerificationResult.SuccessRehashNeeded;
}
else
{
return PasswordVerificationResult.Failed;
}
}
}




CustomUserManager — главный класс, методы которого мы будем вызывать для манипулирования пользовательскими данными(замена старому Membership Provider). Он должен являться наследником Microsoft.AspNet.Identity.UserManager, который содержит множество виртуальных методов. В данном случае мы переопределили метод FindAsync(), в котором для примера сначала проверяется пароль, и в случае успеха возвращается юзер. Как вы видите, в конструкторе UserManeger мы определили собственный PasswordHasher — класс, предназначенный для управления паролями. Тело метода VerifyHashedPassword имеет демонстрационный вид. Вы же можете там написать свою логику проверки пароля.

3. Настраиваем приложение на работу с нашим CustomUserManager. Для этого в файле Startup.cs, который исполняется сборкой Owin при запуске приложения, добавляем строку:



app.CreatePerOwinContext(CustomUserManager.Create);


4. Используем CustomUserManager внутри контроллера:



public class TestController : ApiController
{
private static CustomUserManager _customUserManager;

public CustomUserManager UserManager
{
get
{
return _customUserManager ??
(_customUserManager = HttpContext.Current.GetOwinContext().GetUserManager<CustomUserManager>());
}
}
public async Task<bool> Authenticate(string name, string password)
{
if (await UserManager.FindAsync(name, password) != null)
{
return true;
}

return false;
}
}





Вы можете использовать те методы UserManager, которые вы переопределили, а также стандартный набор методов класса CustomUserStore (они вызываются по умолчанию, если вы используете одноименные методы вашего UserManager), которые должны быть определены в обязательном порядке.

5. Для использования стандартных атрибутов MVC [Authorize] установите нужный вам тип авторизации в классе Startup. Например:



public class Startup
{
public void Configuration(IAppBuilder app)
{
app.UseCookieAuthentication(new CookieAuthenticationOptions
{
AuthenticationType = DefaultAuthenticationTypes.ApplicationCookie,
LoginPath = new PathString("/Account/Login")
});
}
}


Список использованных ресурсов:

Simple Asp.net Identity Core Without Entity Framework

ASP.NET Identity 2.0 Cookie & Token Authentication


P.S. Данный материал является дебютным и, конечно же, не претендует на исчерпывающий мануал по ASP.NET Identity. Рассчитан на людей, знакомых с технологией MVC, желающих познакомиться с новой системой авторизации.


This entry passed through the Full-Text RSS service — if this is your content and you're reading it on someone else's site, please read the FAQ at http://ift.tt/jcXqJW.


Комментариев нет:

Отправить комментарий