मैट डेकेरे के शानदार जवाब से काम करते हुए , मैंने टोकन-आधारित प्रमाणीकरण का एक पूरी तरह से काम करने वाला उदाहरण बनाया है, ASP.NET Core (1.0.1) के खिलाफ काम कर रहा है। आप इस रिपॉजिटरी में GitHub ( 1.0.0-rc1 , Beta8 , beta7 के लिए वैकल्पिक शाखाएं) पर पूर्ण कोड पा सकते हैं , लेकिन संक्षेप में, महत्वपूर्ण चरण हैं:
अपने एप्लिकेशन के लिए एक कुंजी बनाएं
मेरे उदाहरण में, मैं एप्लिकेशन शुरू होने पर हर बार एक यादृच्छिक कुंजी उत्पन्न करता हूं, आपको एक को उत्पन्न करना होगा और इसे कहीं स्टोर करना होगा और इसे अपने एप्लिकेशन को प्रदान करना होगा। इस फ़ाइल को देखें कि मैं एक यादृच्छिक कुंजी कैसे बना रहा हूँ और आप इसे एक .json फ़ाइल से कैसे आयात कर सकते हैं । जैसा कि @kspearrin द्वारा टिप्पणियों में सुझाया गया है, डेटा सुरक्षा एपीआई कुंजी को "सही ढंग से" प्रबंधित करने के लिए एक आदर्श उम्मीदवार की तरह लगता है, लेकिन मैंने अभी तक संभव नहीं होने पर काम नहीं किया है। यदि आप इसे काम करते हैं तो कृपया एक अनुरोध भेजें!
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
टोकन नियंत्रक में, आपको साइनअप करने वाली कुंजी का उपयोग करने के लिए एक विधि की आवश्यकता होती है जो कि स्टार्टअप.क्स में लोड की गई थी। हमने स्टार्टअप में एक टोकनएथ्यूशंस उदाहरण दर्ज किया है, इसलिए हमें टोकनकेन्ट्रोलर के लिए कंस्ट्रक्टर में इसे इंजेक्ट करने की आवश्यकता है:
[Route("api/[controller]")]
public class TokenController : Controller
{
private readonly TokenAuthOptions tokenOptions;
public TokenController(TokenAuthOptions tokenOptions)
{
this.tokenOptions = tokenOptions;
}
...
फिर आपको लॉगिन एंडपॉइंट के लिए अपने हैंडलर में टोकन जेनरेट करना होगा, मेरे उदाहरण में मैं एक यूजरनेम और पासवर्ड ले रहा हूं और अगर एक स्टेटमेंट का उपयोग करने वालों को मान्य कर रहा है, लेकिन आपको एक दावा बनाने या लोड करने की आवश्यकता है पहचान-आधारित पहचान और उसके लिए टोकन उत्पन्न करना:
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")]भी विधि या वर्ग को आप संरक्षित करना चाहते हैं, उसमें बस जोड़ें , और यदि आपको टोकन के बिना इसे एक्सेस करने का प्रयास करना है, तो आपको एक त्रुटि मिलनी चाहिए। यदि आप 500 त्रुटि के बजाय 401 को वापस करना चाहते हैं, तो आपको एक कस्टम अपवाद हैंडलर को पंजीकृत करना होगा, जैसा कि मेरे उदाहरण में मेरे पास है ।