Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/furkandeveloper/easytokengenerator
This repo aims to dynamically and simply generate tokens in Token Based systems.
https://github.com/furkandeveloper/easytokengenerator
authentication authentication-backend csharp dotnet dotnetcore jwt jwt-authentication jwt-token token token-authentication token-based token-based-authentication
Last synced: 23 days ago
JSON representation
This repo aims to dynamically and simply generate tokens in Token Based systems.
- Host: GitHub
- URL: https://github.com/furkandeveloper/easytokengenerator
- Owner: furkandeveloper
- License: mit
- Created: 2020-09-11T15:50:33.000Z (about 4 years ago)
- Default Branch: master
- Last Pushed: 2021-11-18T06:25:17.000Z (about 3 years ago)
- Last Synced: 2023-03-03T23:04:38.312Z (over 1 year ago)
- Topics: authentication, authentication-backend, csharp, dotnet, dotnetcore, jwt, jwt-authentication, jwt-token, token, token-authentication, token-based, token-based-authentication
- Language: C#
- Homepage:
- Size: 110 KB
- Stars: 17
- Watchers: 3
- Forks: 1
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Token Generator for .Net
[](https://www.codefactor.io/repository/github/furkandeveloper/easytokengenerator)
[](https://opensource.org/licenses/MIT)
[](https://circleci.com/gh/circleci/circleci-docs)
[](https://codeclimate.com/github/furkandeveloper/EasyTokenGenerator/maintainability)
Heeey, This repo aims to dynamically and simply generate tokens in Token Based systems.
Follow me;
- Turn on your computer.
- Prepare your coffee.
- And sit back.
# What is Authentication?
Authentication is the set of processes that try to recognize the user on the system with information such as User Name, Password, Email or Phone Number.
## Single Factor Authentication
This method, which we use quite often in daily life, will be sufficient for the user to enter the password corresponding to any information in order to navigate in the system.
## Two Factor Authentication
With this method, a more secure authentication is achieved by requesting another information that can only be accessed by the user in addition to User Name and Password information. An example is the confirmation code that is used in daily life in banks and comes as an SMS after login.
# What is Token Based Authentication?
A token is a piece of data that has no meaning or use on its own, but combined with the correct tokenization system, becomes a vital player in securing your application. Token based authentication works by ensuring that each request to a server is accompanied by a signed token which the server verifies for authenticity and only then responds to the request.
JSON Web Token (JWT) is an open standard (RFC 7519) that defines a compact and self-contained method for securely transmitting information between parties encoded as a JSON object. JWT has gained mass popularity due to its compact size which allows tokens to be easily transmitted via query strings, header attributes and within the body of a POST request.
## Getting Started
Install [EasyTokenGenerator](https://www.nuget.org/packages/EasyJwtTokenGenerator/) from Nuget.
# Startup.cs Configuration
```csharp
services.AddEasyJwtToken(options =>
{
Configuration.Bind(nameof(JwtBearerOptions), options);
options.SecurityKey = Configuration.GetValue("SecurityKey");
});
```
## Usage
Get the IJwtTokenGenerator interface from the Constructor.
```csharp
private readonly IJwtTokenService jwtTokenService;
public AccountController(IJwtTokenService jwtTokenService)
{
this.jwtTokenService = jwtTokenService;
}
```
# Generate Claims
```csharp
var claims = await jwtTokenService.GenerateClaimsAsync(new List()
{
new Jwt.Models.ClaimDto()
{
Type = "Email",
Value = "[email protected]"
}
});
```
# Generate Jwt Token
```csharp
var jwtToken = await jwtTokenService.GenerateJwtTokenAsync(claims, Jwt.Models.Algorithms.HmacSha256Signature);
```
Easy Token Generator supported Security Algorithms. Look.
```csharp
public enum Algorithms
{
HmacSha256Signature,
HmacSha384,
HmacSha512,
RsaSha256Signature,
RsaSha384Signature,
RsaSha512Signature,
EcdsaSha256,
EcdsaSha384,
EcdsaSha512,
RsaSsaPssSha256,
RsaSsaPssSha384
}
```
# Generate Refresh Token
```csharp
await jwtTokenService.GenerateRefreshTokenAsync(size:64)
```
## Extensions
# Claims Extensions
```csharp
public static Claim GetClaim(this IEnumerable claims, string claimType)
=> claims?.FirstOrDefault(x => x.Type == claimType);
// Usage
var claim = User.Claims.GetClaim("Email");
```
```csharp
public static string GetClaimValue(this IEnumerable claims, string claimType)
=> claims?.FirstOrDefault(x => x.Type == claimType)?.Value;
// Usage
var claimValue = User.Claims.GetClaimValue("Email");
```
```csharp
public static IEnumerable GetClaims(this IEnumerable claims, string claimType)
=>claims?.Where(x => x.Type == claimType);
// Usage
var claims = User.Claims.GetClaims("Email");
```
```csharp
public static string GetEmail(this IEnumerable claims)
=> claims.GetClaim(ClaimTypes.Email)?.Value;
// Usage
var email = User.Claims.GetEmail();
```
```csharp
public static string GetGivenName(this IEnumerable claims)
=> claims.GetClaim(ClaimTypes.GivenName)?.Value;
// Usage
var givenName = User.Claims.GetGivenName();
```
```csharp
public static string GetExpiration(this IEnumerable claims)
=> claims.GetClaim(ClaimTypes.Expiration)?.Value;
// Usage
var expiration = User.Claims.GetExpiration();
```
You can look at the [demo](https://easy-token-generator.herokuapp.com/)