dotnet user-jwts를 사용하여 개발 중인 JSON 웹 토큰 관리

작성자: Rick Anderson

명령줄 도구는 dotnet user-jwts 앱별 로컬 JWT(JSON 웹 토큰 )를 만들고 관리할 수 있습니다.

이 문서에서는 명령 및 예제에 대한 구문 세부 정보를 제공합니다.

개요

dotnet user-jwts [<PROJECT>] [command]
dotnet user-jwts [command] -h|--help

설명

프로젝트별 로컬 JSON 웹 토큰을 만들고 관리합니다.

인수

PROJECT | SOLUTION

명령을 적용할 MSBuild 프로젝트입니다. 프로젝트가 지정되지 않은 경우 MSBuild는 현재 작업 디렉터리에서 proj로 끝나는 파일 확장자를 포함하는 파일을 검색합니다. 그런 다음 해당 파일을 사용하여 명령에 대한 프로젝트 정보를 가져옵니다.

명령

만들기 명령에 대한 옵션

사용법: dotnet user-jwts create [options]

예제

다음 명령을 실행하여 빈 웹 프로젝트를 만들고 Microsoft.AspNetCore.Authentication.JwtBearer NuGet 패키지를 추가합니다.

dotnet new web -o MyJWT
cd MyJWT
dotnet add package Microsoft.AspNetCore.Authentication.JwtBearer

Program.cs 파일의 내용을 다음 코드로 바꿉니다.

using System.Security.Claims;

var builder = WebApplication.CreateBuilder(args);

builder.Services.AddAuthorization();
builder.Services.AddAuthentication("Bearer").AddJwtBearer();

var app = builder.Build();

app.UseAuthorization();

app.MapGet("/", () => "Hello, World!");
app.MapGet("/secret", (ClaimsPrincipal user) => $"Hello {user.Identity?.Name}. My secret")
    .RequireAuthorization();

app.Run();

위의 코드에서 엔드포인트에 대한 GET 요청은 /secret 오류를 반환합니다 401 Unauthorized . 프로덕션 앱은 자격 증명으로 로그인한 결과로 보안 토큰 서비스에서 JWT를 받을 수 있습니다. 로컬 개발 dotnet user-jwts 중에 API를 사용하는 경우 명령줄 도구를 사용하여 앱별 로컬 JWT를 만들고 관리할 수 있습니다.

이 user-jwts 도구는 사용자 비밀 도구와 개념상 유사합니다. 로컬 컴퓨터의 개발자에게만 유효한 앱의 값을 관리하는 데 사용할 수 있습니다. 실제로 이 도구는 user-jwts 인프라를 user-secrets 활용하여 JWT가 서명된 키를 관리합니다. 이 방법을 사용하면 키가 사용자 프로필에 안전하게 저장됩니다.

user-jwts 도구는 값이 저장되는 위치 및 방법과 같은 구현 세부 정보를 숨깁니다. 구현 세부 정보를 몰라도 도구를 사용할 수 있습니다.

값은 로컬 컴퓨터의 사용자 프로필 폴더에 있는 JSON 파일에 저장됩니다.

• Windows: %APPDATA%\Microsoft\UserSecrets<secrets_GUID>\user-jwts.json

• Linux/macOS: ~/.microsoft/usersecrets/<secrets_GUID>/user-jwts.json

JWT 만들기

다음 명령은 로컬 JWT를 만듭니다.

dotnet user-jwts create

앞의 명령은 JWT를 만들고 다음 예제와 유사한 JSON으로 프로젝트 appsettings.Development.json 파일을 업데이트합니다.

{
  "Logging": {
    "LogLevel": {
      "Default": "Information",
      "Microsoft.AspNetCore": "Warning"
    }
  },
  "Authentication": {
    "Schemes": {
      "Bearer": {
        "ValidAudiences": [
          "http://localhost:8401",
          "https://localhost:44308",
          "http://localhost:5182",
          "https://localhost:7076"
        ],
        "ValidIssuer": "dotnet-user-jwts"
      }
    }
  }
}

이전 명령에서 만든 JWT 및 ID를 복사합니다. Curl과 같은 도구를 사용하여 엔드포인트를 /secret 테스트합니다. 여기서 이전에 생성된 JWT는 다음과 {token} 같습니다.

curl -i -H "Authorization: Bearer {token}" https://localhost:{port}/secret

JWT 보안 정보 표시

다음 명령은 만료, 범위, 역할, 토큰 헤더 및 페이로드 및 압축 토큰을 포함한 JWT 보안 정보를 표시합니다.

dotnet user-jwts print {ID} --show-all

특정 사용자 및 범위에 대한 토큰 만들기

다음 명령은 이름이 지정된 MyTestUser사용자에 대한 JWT를 만듭니다. 지원되는 create 옵션은 만들기 명령 섹션에 대한 옵션을 참조하세요.

dotnet user-jwts create --name MyTestUser --scope "myapi:secrets"

앞의 명령에는 다음 예제와 유사한 출력이 있습니다.

New JWT saved with ID '43e0b748'.
Name: MyTestUser
Scopes: myapi:secrets

Token: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.{Remaining token deleted}

이전 토큰을 사용하여 다음 코드에서 /secret2 엔드포인트를 테스트할 수 있습니다.

using System.Security.Claims;

var builder = WebApplication.CreateBuilder(args);

builder.Services.AddAuthorization();
builder.Services.AddAuthentication("Bearer").AddJwtBearer();

var app = builder.Build();

app.MapGet("/", () => "Hello, World!");
app.MapGet("/secret", (ClaimsPrincipal user) => $"Hello {user.Identity?.Name}. My secret")
    .RequireAuthorization();
app.MapGet("/secret2", () => "This is a different secret!")
    .RequireAuthorization(p => p.RequireClaim("scope", "myapi:secrets"));

app.Run();

관련 콘텐츠

• Microsoft. AspNetCore.Authentication.JwtBearer
• JSON 웹 토큰