@thinkingcat/auth-utils 1.0.9 → 1.0.11

package/README.md

@@ -60,7 +60,7 @@ npm install @thinkingcat/auth-utils
 ```json
 {
   "dependencies": {
-    "@thinkingcat/auth-utils": "^1.0.8"
+    "@thinkingcat/auth-utils": "^1.0.11"
   }
 }
 ```
@@ -152,25 +152,25 @@ import {
 } from "@thinkingcat/auth-utils";
 ```
 
-### 2. 라이센스 키 설정 (선택사항)
+### 2. 라이센스 키 사용
 
-라이센스 키를 사용하려면 `.env.local` 파일에 다음 환경 변수를 설정하세요:
+라이센스 키는 **필수**입니다. 모든 함수 호출 시 `licenseKey` 파라미터를 전달해야 합니다.
 
-```env
-# 단일 라이센스 키 (가장 간단)
-LICENSE_KEY=TC-checkon-XXXX-XXXX
-
-# 또는 여러 서비스별 키 목록
-LICENSE_KEYS={"checkon":"TC-checkon-XXXX-XXXX","renton":"TC-renton-YYYY-YYYY"}
+```typescript
+// 예시: handleMiddleware 사용 시
+const response = await handleMiddleware(req, middlewareConfig, {
+  secret: process.env.NEXTAUTH_SECRET!,
+  isProduction: process.env.NODE_ENV === "production",
+  ssoBaseURL: process.env.SSO_BASE_URL!,
+  licenseKey: process.env.LICENSE_KEY!, // 필수
+});
 ```
 
-**중요**:
-
-- 라이센스 키는 선택사항입니다. 제공하지 않으면 라이센스 검증을 건너뜁니다.
-- `LICENSE_KEY` 환경 변수를 설정하면 함수 호출 시 자동으로 사용됩니다.
-- 함수 파라미터로 `licenseKey`를 전달하면 환경 변수보다 우선합니다.
+**중요**: 
+- 라이센스 키는 모든 함수 호출 시 필수 파라미터입니다.
+- 라이센스 키가 없거나 유효하지 않으면 함수가 에러를 발생시킵니다.
+- 라이센스 키는 SHA-256 해시로 변환되어 모듈 내부의 유효한 키 목록과 비교됩니다.
 - 다른 환경 변수(NEXTAUTH_SECRET, SSO_BASE_URL 등)는 이 패키지를 사용하는 애플리케이션에서 관리합니다.
-- `.env.example` 파일을 참조하여 라이센스 키 설정 방법을 확인하세요.
 
 ## 📚 주요 기능 (Features)
 
@@ -775,6 +775,7 @@ return new NextResponse(html, {
 - `isProduction`: 프로덕션 환경 여부 (기본값: false)
 - `cookieDomain`: 쿠키 도메인 (선택)
 - `serviceId`: 서비스 ID (필수)
+- `licenseKey`: 라이센스 키 (필수)
 
 **반환값:**
 
@@ -791,7 +792,8 @@ const response = await createAuthResponse(accessToken, secret, {
   cookiePrefix: "myservice",
   isProduction: process.env.NODE_ENV === "production",
   cookieDomain: process.env.COOKIE_DOMAIN,
-  serviceId: "myservice", // 필수
+  serviceId: "myservice",
+  licenseKey: process.env.LICENSE_KEY!, // 필수
 });
 ```
 
@@ -1156,6 +1158,7 @@ interface MiddlewareOptions {
   getNextAuthToken?: (req: NextRequest) => Promise<JWT | null>;
   ssoBaseURL: string;
   authServiceKey?: string;
+  licenseKey: string;
 }
 ```
 
@@ -1281,10 +1284,30 @@ setCustomTokens(response, accessToken, {
 });
 ```
 
+### 문제 7: "License key is required" 또는 "Invalid license key" 에러
+
+**해결 방법:**
+라이센스 키는 모든 함수 호출 시 필수입니다. 환경 변수에서 라이센스 키를 가져와서 전달하세요:
+
+```typescript
+const licenseKey = process.env.LICENSE_KEY;
+if (!licenseKey) {
+  throw new Error("LICENSE_KEY environment variable is required");
+}
+
+// 함수 호출 시 licenseKey 전달
+const response = await handleMiddleware(req, middlewareConfig, {
+  secret: process.env.NEXTAUTH_SECRET!,
+  licenseKey, // 필수
+  ssoBaseURL: process.env.SSO_BASE_URL!,
+  // ... 기타 옵션
+});
+```
+
 ## 📦 패키지 정보
 
 - **패키지명**: `@thinkingcat/auth-utils`
-- **버전**: `1.0.8`
+- **버전**: `1.0.11`
 - **라이선스**: MIT
 - **저장소**: npm registry
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thinkingcat/auth-utils",
-  "version": "1.0.9",
+  "version": "1.0.11",
   "description": "Authentication utilities for ThinkingCat SSO services",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",