라이선스 발급 및 관리 센터

새 라이선스 발급

발급된 라이선스 목록

ID	라이선스 키	상태	메모	등록 기기	만료일시	관리
발급된 라이선스가 없습니다.
#{{ lic.id }}	{{ lic.licenseKey }}	{{ lic.status === 'active' ? '활성' : (lic.status === 'revoked' ? '정지됨' : lic.status) }}	{{ lic.memo }}	{{ lic.devices ? lic.devices.length : 0 }} / {{ lic.maxDevices }}	{{ formatDateTime(lic.expiresAt) }}

라이선스 키: {{ selectedLicense ? selectedLicense.licenseKey : '' }}

Machine GUID	OS	Hostname	App Version	활성화 일시
등록된 기기가 없습니다.
{{ dev.machineGuid }}	{{ dev.os }}	{{ dev.hostname }}	{{ dev.appVersion }}	{{ formatDateTime(dev.activatedAt) }}

앱 인증(Verify) 로그 실시간 현황

인증 일시	라이선스 키	Machine GUID (기기)	메시지
앱 인증 기록이 없습니다.
{{ formatDateTime(log.createdAt) }}	{{ log.licenseKey \|\| (log.license && log.license.licenseKey) \|\| 'N/A' }}	{{ log.adminUser }}	{{ log.message }}

이 화면은 관리자 웹이 아니라 실제 클라이언트(C# WPF 등) 앱 내부에서 일어나는 API 통신을 시뮬레이션하기 위한 테스트 도구입니다.

1앱 최초 실행 (등록)

사용자가 라이선스 키를 입력하면 발생하는 API 요청

입력할 라이선스 키

고유 Machine GUID (임의 변경 가능)

OS

Hostname

앱 버전

{{ JSON.stringify(testResult.register.data, null, 2) }}

2앱 재실행 시 (검증)

앱을 켤 때마다 로컬에 저장된 토큰의 유효성을 체크

검증 결과

{{ JSON.stringify(testResult.verify.data, null, 2) }}

정상 라이선스! 앱 주요 기능 활성화.

라이선스 무효 (사유: {{ testResult.verify.data.license_status }}). 앱 종료 처리.

클라이언트 앱 연동 API 가이드

이 가이드는 실제 애플리케이션(C#, C++, 모바일 등)에서 백엔드 라이선스 서버와 통신하는 방법을 설명합니다.

1. 라이선스 등록 (최초 1회 또는 토큰 만료 시)

사용자가 라이선스 키를 처음 입력했을 때, 혹은 토큰이 만료되어 재발급이 필요할 때 호출합니다.

Endpoint: POST /api/v1/license/register
Content-Type: application/json
Auth: 필요 없음 (No Auth)

요청 (Request Body)

{
  "license_key": "XXXX-XXXX-XXXX-XXXX",
  "device": {
    "machine_guid": "기기_고유_식별자(필수)",
    "os": "Windows 11 (선택)",
    "hostname": "DESKTOP-123 (선택)",
    "app_version": "1.0.0 (필수)"
  }
}

성공 응답 (Response Body, 200 OK)

{
  "status": "active",
  "token": "eyJhbGciOiJIUzI... (매우 긴 JWT 문자열)",
  "expires_at": "2024-03-22T10:00:00.000" // 토큰 만료 시간
}

중요: 응답받은 token을 클라이언트 로컬(레지스트리 등)에 안전하게 저장해야 합니다.

2. 라이선스 유효성 검증 (앱 켤 때마다)

앱이 실행될 때 로컬에 저장된 토큰을 서버에 보내어 현재 유효한 상태인지 검사합니다.

Endpoint: POST /api/v1/license/verify
Content-Type: application/json
Auth: 필요 없음 (No Auth)

요청 (Request Body)

{
  "token": "로컬에_저장해둔_JWT_문자열"
}

성공 응답 (Response Body, 200 OK)

{
  "valid": true,
  "license_status": "active"
}

클라이언트 개발 시나리오 추천

앱 실행 -> 로컬에 token이 있는지 확인
없으면 -> 사용자에게 라이선스 키 입력 창 노출 -> [1. 등록 API] 호출 -> 성공 시 토큰 저장
있으면 -> [2. 검증 API] 호출
- valid: true -> 앱 정상 실행
- valid: false 이고 license_status: "invalid_token" (만료됨) -> 백그라운드에서 [1. 등록 API]를 다시 호출하여 토큰 갱신 시도
- valid: false 이고 license_status: "revoked" (관리자가 정지함) -> 앱 실행 차단 및 에러 메시지 노출

인증 정보를 확인 중입니다...

새 라이선스 발급

발급된 라이선스 목록

앱 인증(Verify) 로그 실시간 현황

1앱 최초 실행 (등록)

{{ testResult.register.error ? '요청 실패' : '응답 성공 (토큰 발급됨)' }}

2앱 재실행 시 (검증)

검증 결과

클라이언트 앱 연동 API 가이드

1. 라이선스 등록 (최초 1회 또는 토큰 만료 시)

요청 (Request Body)

성공 응답 (Response Body, 200 OK)

2. 라이선스 유효성 검증 (앱 켤 때마다)

요청 (Request Body)

성공 응답 (Response Body, 200 OK)

클라이언트 개발 시나리오 추천