Phoesion.DevJwt.CLI 0.1.3

Phoesion.DevJwt

Library and dotnet-tool for developing and testing web api services with JWT authorization. Create custom tokens that can be used localy, without an external Identity.

How to use in your service

1. Install the NuGet package

dotnet add package Phoesion.DevJwt

2. Enable dev-jwt on your JWT authorization services

services.AddAuthentication(JwtBearerDefaults.AuthenticationScheme)
        .AddJwtBearer(o => o.AddDevJwt(builder.Environment));

3. Configure in appsetting.Development.json

"Authentication": {
   "Schemes": {
      "Bearer": {
         "ValidAudience": "myApi",
         "ValidIssuer": "phoesion.devjwt"
      }
   }
}

Generate a jwt

1. Install the dotnet tool

dotnet tool install --global phoesion.devjwt.cli

2. Generate token using

dotnet devjwt create myApi --email user@mail.com --sub 42

You can now use the token for your requests.

General Information

The AddDevJwt() extension configures an ISecurityTokenValidator that validates the token. Using the HostingEnvironment, it checks that the handler is only added for Development and Testing environments.

Samples

The repository contains the following samples projects in the Samples folder :

• SampleWebApi : an ASP.Net core web api application
• GlowMicroservicebApi : a Phoesion Glow microservice
• TokenGeneratorSample : a console application that demononstrates how to generate token programmatically