Працюючи з казкової відповіді Метта Декрея , я створив повноцінний приклад аутентифікації на основі лексем, що працює проти ASP.NET Core (1.0.1). Ви можете знайти повний код в цьому репозиторії на GitHub (альтернативні гілки для 1.0.0-rc1 , beta8 , beta7 ), але коротко, важливі кроки:
Створіть ключ для вашої програми
У моєму прикладі я генерую випадковий ключ щоразу, коли програма запускається, вам потрібно буде генерувати та зберігати його десь і надавати вашій програмі. Дивіться цей файл, як я генерую випадковий ключ і як ви можете імпортувати його з .json-файлу . Як було запропоновано у коментарях @kspearrin, API захисту даних здається ідеальним кандидатом для керування ключами "правильно", але я ще не розробив, чи це можливо ще. Будь ласка, надішліть запит на витяг, якщо ви його відпрацюєте!
Startup.cs - Налаштування сервісів
Тут нам потрібно завантажити приватний ключ для наших підписаних жетонів, який ми також використаємо для перевірки маркерів під час їх представлення. Ми зберігаємо ключ у змінній рівня класу, keyяку ми повторно використовуватимемо в методі Налаштування нижче. TokenAuthOptions - простий клас, який містить особу підпису, аудиторію та емітента, що нам знадобиться в TokenController для створення наших ключів.
// Replace this with some sort of loading from config / file.
RSAParameters keyParams = RSAKeyUtils.GetRandomKey();
// Create the key, and a set of token options to record signing credentials
// using that key, along with the other parameters we will need in the
// token controlller.
key = new RsaSecurityKey(keyParams);
tokenOptions = new TokenAuthOptions()
{
Audience = TokenAudience,
Issuer = TokenIssuer,
SigningCredentials = new SigningCredentials(key, SecurityAlgorithms.Sha256Digest)
};
// Save the token options into an instance so they're accessible to the
// controller.
services.AddSingleton<TokenAuthOptions>(tokenOptions);
// Enable the use of an [Authorize("Bearer")] attribute on methods and
// classes to protect.
services.AddAuthorization(auth =>
{
auth.AddPolicy("Bearer", new AuthorizationPolicyBuilder()
.AddAuthenticationSchemes(JwtBearerDefaults.AuthenticationScheme)
.RequireAuthenticatedUser().Build());
});
Ми також створили політику авторизації, щоб дозволити нам використовувати [Authorize("Bearer")]в кінцевих точках і класах, які ми хочемо захистити.
Startup.cs - Налаштування
Тут нам потрібно налаштувати JwtBearerAuthentication:
app.UseJwtBearerAuthentication(new JwtBearerOptions {
TokenValidationParameters = new TokenValidationParameters {
IssuerSigningKey = key,
ValidAudience = tokenOptions.Audience,
ValidIssuer = tokenOptions.Issuer,
// When receiving a token, check that it is still valid.
ValidateLifetime = true,
// This defines the maximum allowable clock skew - i.e.
// provides a tolerance on the token expiry time
// when validating the lifetime. As we're creating the tokens
// locally and validating them on the same machines which
// should have synchronised time, this can be set to zero.
// Where external tokens are used, some leeway here could be
// useful.
ClockSkew = TimeSpan.FromMinutes(0)
}
});
TokenController
У контролері маркера потрібно мати метод для генерації підписаних ключів за допомогою ключа, завантаженого в Startup.cs. Ми зареєстрували екземпляр TokenAuthOptions в запуску, тому нам потрібно ввести це в конструктор TokenController:
[Route("api/[controller]")]
public class TokenController : Controller
{
private readonly TokenAuthOptions tokenOptions;
public TokenController(TokenAuthOptions tokenOptions)
{
this.tokenOptions = tokenOptions;
}
...
Тоді вам потрібно буде генерувати маркер у вашому оброблювачі для кінцевої точки входу, у моєму прикладі я беру ім’я користувача та пароль і перевіряю ті, хто використовує оператор if, але ключове, що вам потрібно зробити, це створити або завантажити претензії ідентичність на основі та генерують маркер для цього:
public class AuthRequest
{
public string username { get; set; }
public string password { get; set; }
}
/// <summary>
/// Request a new token for a given username/password pair.
/// </summary>
/// <param name="req"></param>
/// <returns></returns>
[HttpPost]
public dynamic Post([FromBody] AuthRequest req)
{
// Obviously, at this point you need to validate the username and password against whatever system you wish.
if ((req.username == "TEST" && req.password == "TEST") || (req.username == "TEST2" && req.password == "TEST"))
{
DateTime? expires = DateTime.UtcNow.AddMinutes(2);
var token = GetToken(req.username, expires);
return new { authenticated = true, entityId = 1, token = token, tokenExpires = expires };
}
return new { authenticated = false };
}
private string GetToken(string user, DateTime? expires)
{
var handler = new JwtSecurityTokenHandler();
// Here, you should create or look up an identity for the user which is being authenticated.
// For now, just creating a simple generic identity.
ClaimsIdentity identity = new ClaimsIdentity(new GenericIdentity(user, "TokenAuth"), new[] { new Claim("EntityID", "1", ClaimValueTypes.Integer) });
var securityToken = handler.CreateToken(new Microsoft.IdentityModel.Tokens.SecurityTokenDescriptor() {
Issuer = tokenOptions.Issuer,
Audience = tokenOptions.Audience,
SigningCredentials = tokenOptions.SigningCredentials,
Subject = identity,
Expires = expires
});
return handler.WriteToken(securityToken);
}
І це повинно бути. Просто додайте [Authorize("Bearer")]до будь-якого методу чи класу, який ви хочете захистити, і ви отримаєте помилку, якщо спробуєте отримати доступ до нього без присутності маркера. Якщо ви хочете повернути 401 замість помилки 500, вам потрібно зареєструвати спеціальний обробник винятків, як я маю у своєму прикладі тут .