@point3/logto-module 1.0.0

package/README.md

@@ -0,0 +1,224 @@
+# point3-logto-module
+
+NestJS 기반 Logto 인증/권한 통합 모듈  
+(서버/클라이언트, M2M, 사용자/역할 관리, OAuth, DI 기반 확장성 제공)
+
+---
+
+## 📦 개요
+
+`@point3-logto-module`은 [Logto](https://logto.io/) 인증 시스템을 NestJS 환경에서 손쉽게 통합할 수 있도록 설계된 모듈 번들입니다.  
+OAuth, M2M(Machine-to-Machine), 사용자/역할 관리, 토큰 검증, 인증 가드 등 인증/권한 관련 기능을 일관된 DI 패턴으로 제공합니다.
+
+- **유연한 로깅 연동**: 외부 로거 모듈/토큰을 DI로 주입받아, 다양한 로깅 시스템과 쉽게 통합
+- **NestJS Dynamic Module 패턴**: 환경/구성에 따라 동적으로 모듈 생성
+- **실제 서비스에서 검증된 인증/권한 관리 기능**: OAuth, M2M, 사용자/역할 관리, 토큰 검증, 인증 가드 등
+
+---
+
+## 🏗️ 주요 구성요소
+
+### 1. LogtoModule (Dynamic Module)
+
+- 외부에서 로거 모듈과 토큰을 주입받아, Logto 인증/권한 기능을 번들로 제공
+- `LogtoModule.forLogger(loggerModule, loggerToken)` 패턴으로 사용
+
+### 2. 핵심 서비스/토큰
+
+- **OAuthClient**: OAuth 인증(로그인/로그아웃 URI, 토큰 발급 등)
+- **LogtoM2MClient**: 서버 간(M2M) 인증 및 사용자/역할 관리
+- **LogtoLoginSession**: 세션 기반 로그인 플로우 관리
+- **LogtoTokenVerifier**: JWT 토큰 검증 및 권한 체크
+- **LogtoTokenGuard**: NestJS 인증 가드(컨트롤러 보호)
+- **LogtoLoggerServiceToken**: DI로 주입받는 외부 로거 토큰
+
+### 3. 주요 타입/설정
+
+- **LogtoConfig**: 인증/권한 기능을 위한 환경설정 객체
+- **Prompt, GrantType**: OAuth 표준 파라미터 Enum
+- **LogtoUser, LogtoRole 등**: 사용자/역할 관리용 타입
+
+---
+
+## ⚙️ 설치
+
+```bash
+npm install @point3-logto-module
+```
+
+---
+
+## 🚀 사용법
+
+### 1. 외부 로거 모듈 준비
+
+```ts
+// my-logger.module.ts
+import { Module } from '@nestjs/common';
+import { WinstonLoggerService } from './winston-logger.service';
+
+export const MY_LOGGER_TOKEN = Symbol.for('LOGGER');
+
+@Module({
+  providers: [
+    {
+      provide: MY_LOGGER_TOKEN,
+      useClass: WinstonLoggerService,
+    },
+  ],
+  exports: [MY_LOGGER_TOKEN],
+})
+export class MyLoggerModule {}
+```
+
+### 2. AppModule에서 LogtoModule 동적 생성
+
+```ts
+import { Module } from '@nestjs/common';
+import { LogtoModule } from '@point3-logto-module';
+import { MyLoggerModule, MY_LOGGER_TOKEN } from './my-logger.module';
+
+@Module({
+  imports: [
+    LogtoModule.forLogger(MyLoggerModule, MY_LOGGER_TOKEN),
+  ],
+})
+export class AppModule {}
+```
+
+### 3. 서비스 DI 및 사용 예시
+
+```ts
+import { Injectable } from '@nestjs/common';
+import { OAuthClient, LogtoM2MClient, LogtoLoginSession } from '@point3-logto-module';
+
+@Injectable()
+export class AuthService {
+  constructor(
+    private readonly oauthClient: OAuthClient,
+    private readonly m2mClient: LogtoM2MClient,
+    private readonly loginSession: LogtoLoginSession,
+  ) {}
+
+  async loginUri() {
+    return this.oauthClient.getSignInURI('admin');
+  }
+
+  async createUser(user) {
+    return this.m2mClient.createUser(user);
+  }
+}
+```
+
+---
+
+## 🛠️ 주요 기능 및 역할
+
+### LogtoModule
+
+- 외부 로거 모듈/토큰을 받아, 인증/권한 관련 서비스와 가드를 번들로 제공
+- DynamicModule 패턴으로 다양한 환경에 유연하게 적용 가능
+
+### OAuthClient
+
+- OAuth 로그인/로그아웃 URI 생성
+- 인증 코드로 토큰 발급
+- 토큰 해지(로그아웃)
+
+### LogtoM2MClient
+
+- M2M 인증(서버 간 토큰 발급)
+- 사용자/역할 생성, 조회, 수정, 삭제, 할당 등 관리
+- 인증코드 발송/검증, 비밀번호 변경 등 부가 기능
+
+### LogtoLoginSession
+
+- 세션 기반 로그인 플로우(단계별 API 호출)
+- 비밀번호 검증, 사용자 식별, 동의 처리 등
+
+### LogtoTokenVerifier
+
+- JWT 토큰 검증 및 권한 체크
+- 인증 가드(LogtoTokenGuard)에서 활용
+
+---
+
+## 📝 환경설정 예시 (`LogtoConfig`)
+
+```ts
+const config: LogtoConfig = {
+  endpoint: 'https://auth.example.com/oidc',
+  appId: 'my-client-id',
+  appSecret: 'my-client-secret',
+  grantType: GrantType.AuthorizationCode,
+  scopes: ['openid', 'profile', 'email'],
+  resources: ['https://api.example.com'],
+  prompt: Prompt.Login,
+  redirectUri: 'https://myapp.com/callback',
+};
+```
+
+---
+
+## 🗂️ 환경변수 목록 및 설명
+
+| 환경변수명                        | 설명                                              | 예시 값                                  |
+|-----------------------------------|---------------------------------------------------|------------------------------------------|
+| LOGTO_AUTH_ENDPOINT               | Logto 인증 서버 OIDC 엔드포인트                   | https://auth.example.com/oidc            |
+| LOGTO_CLIENT_ID                   | OAuth 클라이언트 ID                               | my-client-id                             |
+| LOGTO_CLIENT_SECRET               | OAuth 클라이언트 시크릿                           | my-client-secret                         |
+| LOGTO_RESOURCES                   | 접근할 리소스 서버(여러 개일 경우 쉼표로 구분)     | https://api.example.com                  |
+| LOGTO_SCOPES                      | 요청할 OAuth 스코프(쉼표로 구분)                  | openid,profile,email                     |
+| LOGTO_PROMPT                      | OAuth prompt 파라미터                             | login                                    |
+| LOGTO_REDIRECT_URI                | 인증 후 리다이렉트될 URI                          | https://myapp.com/callback               |
+| LOGTO_SIGN_IN_URI                 | 기본 로그인 URI                                   | https://auth.example.com                 |
+| LOGTO_DASHBOARD_SIGN_IN_URI       | 대시보드 로그인 URI(선택)                         | https://dashboard.example.com            |
+| LOGTO_M2M_CLIENT_ID               | M2M 인증용 클라이언트 ID                          | my-m2m-client-id                         |
+| LOGTO_M2M_CLIENT_SECRET           | M2M 인증용 클라이언트 시크릿                      | my-m2m-client-secret                     |
+| LOGTO_M2M_RESOURCE                | M2M 인증용 리소스                                 | https://api.example.com                  |
+| LOGTO_M2M_API_URL                 | M2M API 서버의 base URL                           | https://api.example.com/api              |
+| LOGTO_JWKS_URI                    | JWT 검증용 JWKS 엔드포인트                        | https://auth.example.com/oidc/jwks       |
+| LOGTO_AUTH_ISSUER                 | JWT 발급자(iss)                                   | https://auth.example.com/oidc            |
+
+> ⚠️ 실제로 필요한 환경변수는 사용하는 서비스(OAuth, M2M, 세션 등)에 따라 다를 수 있습니다. 위 표를 참고하여 .env 파일 또는 환경설정에 추가하세요.
+
+---
+
+## 🧩 확장/커스터마이징
+
+- 외부 로깅 시스템과의 연동이 필요할 경우, 원하는 로거 모듈/토큰을 DI로 주입
+- 각 서비스별로 NestJS의 DI/Provider 패턴을 그대로 활용 가능
+- 필요시 각 서비스/가드를 직접 DI 받아 커스텀 비즈니스 로직 구현 가능
+
+---
+
+## ❓ FAQ
+
+- **Q. 로거 토큰이 다르면 어떻게 하나요?**  
+  → `forLogger`의 두 번째 인자로 원하는 토큰(Symbol)을 넘기면 됩니다.
+
+- **Q. 환경변수 기반 설정은 어떻게 하나요?**  
+  → 각 서비스는 DI로 `ConfigService`를 받아 환경변수 기반으로 설정을 자동 주입받습니다.
+
+- **Q. 인증/권한 외에 사용자/역할 관리도 가능한가요?**  
+  → 네, `LogtoM2MClient`를 통해 사용자/역할 생성, 조회, 수정, 삭제, 할당 등 모든 관리가 가능합니다.
+
+---
+
+## 🏷️ 내보내는 토큰/서비스
+
+- `OAuthClientToken`, `LogtoM2MClientToken`, `LogtoTokenVerifierToken`, `LogtoLoginSessionToken`, `LogtoTokenGuard`
+- 각 서비스/가드는 NestJS DI로 바로 주입받아 사용 가능
+
+---
+
+## 📚 참고
+
+- [Logto 공식 문서](https://logto.io/)
+- [NestJS 공식 문서](https://docs.nestjs.com/)
+
+---
+
+## 📝 라이선스
+
+MIT 

package/client/__tests__/m2m-client.spec.ts

@@ -0,0 +1,60 @@
+
+import { Test, TestingModule } from "@nestjs/testing";
+import { ConfigModule } from "@nestjs/config";
+import { p3Values } from "point3-common-tool";
+
+import { LogtoLoggerServiceToken, LogtoM2MClient, LogtoM2MClientToken, LogtoUser } from "..";
+import { LogtoTokenVerifier, LogtoTokenVerifierToken } from "../../token";
+import { ConsoleLogger } from "@nestjs/common";
+
+describe('M2mclient를 이용한 Logto API 테스트', () => {
+    let m2mClient: LogtoM2MClient;
+    let testUser : LogtoUser;
+    let testUserId : string = 'bead71jr45u1';
+    let testRoleId : string = '0fwcgs8okjy7lav216sb3';
+    beforeAll(async () => {
+        const module: TestingModule = await Test.createTestingModule({
+            imports: [
+                ConfigModule.forRoot({
+                    envFilePath: `env/.env.${process.env.NODE_ENV}`, 
+                    isGlobal: true,
+                })
+            ],
+            providers: [
+                {
+                    provide: LogtoTokenVerifierToken,
+                    useClass: LogtoTokenVerifier
+                },
+                {
+                    provide: LogtoLoggerServiceToken,
+                    useClass: ConsoleLogger
+                }
+            ],
+        }).compile();
+        m2mClient = module.get<LogtoM2MClient>(LogtoM2MClientToken);
+        
+        // random number 4 자리
+        const randomNumber = Math.floor(1000 + Math.random() * 9000);
+        testUser = {
+            username: p3Values.Guid.create('test').toString().replace(/-/g, '_'), // '01958ea8-8a60-7c41-bef2-f6ed8d2d5506'
+            name: 'test' + randomNumber,
+            primaryEmail: 'test' + randomNumber + '@test.com',
+            password: 'test123',
+            primaryPhone: '0101111' + randomNumber,
+        };
+    });
+    
+    it('유저 생성', async () => {
+        const userId = await m2mClient.createUser(testUser);
+        expect(userId).toBeDefined();
+        testUserId = userId;
+    });
+
+    it('토큰 발급', async () => {
+        await m2mClient.fetchAccessToken();
+    });
+
+    it('유저 정보 수정', async () => {
+        await m2mClient.updateUserClientInfo(testUserId);
+    });
+});

package/client/__tests__/oauth-client.spec.ts

@@ -0,0 +1,43 @@
+import { Test } from "@nestjs/testing";
+import { LogtoLoggerServiceToken, OAuthClient, OAuthClientToken, SignInType } from "..";
+import { ConfigModule } from "@nestjs/config";
+import { ConsoleLogger } from "@nestjs/common";
+import { LogtoTokenVerifierToken, LogtoTokenVerifier } from "../../token";
+
+describe('OAuthClient', () => {
+    let oauthClient: OAuthClient;
+    
+    beforeEach(async () => {
+        const testingModule = await Test.createTestingModule({
+            imports: [
+                ConfigModule.forRoot({
+                  envFilePath: `env/.env.${process.env.NODE_ENV}`, // Ensure this matches your environment file path
+                  isGlobal: true,
+                }),
+              ],
+            providers: [
+                {
+                    provide: LogtoLoggerServiceToken,
+                    useClass: ConsoleLogger
+                },
+                { 
+                    provide: OAuthClientToken, 
+                    useClass: OAuthClient 
+                }, 
+                {
+                    provide: LogtoTokenVerifierToken,
+                    useClass: LogtoTokenVerifier
+                }
+            ],
+        }).compile();
+
+        oauthClient = testingModule.get<OAuthClient>(OAuthClientToken);
+    });
+    
+    it('로그인/ 회원가입을 위한 로그인 페이지 요청 URI 생성', () => {
+
+        const uri = oauthClient.getSignInURI(SignInType.Admin);
+
+        expect(uri).toContain('prompt=login');
+    });
+});

package/client/config.ts

@@ -0,0 +1,79 @@
+/**
+ * LogtoConfig
+ *
+ * Logto 인증 및 OAuth 클라이언트/서버(M2M) 기능을 위한 환경설정 객체입니다.
+ * 각 서비스(OAuthClient, LogtoM2MClient 등)에서 DI를 통해 주입받은 환경변수 기반으로 설정됩니다.
+ *
+ * 주요 필드 설명:
+ * - endpoint: Logto 인증 서버의 엔드포인트 URL (예: https://auth.example.com/oidc)
+ * - appId: Logto 애플리케이션의 Client ID
+ * - appSecret: Logto 애플리케이션의 Client Secret
+ * - grantType: OAuth 인증 플로우에서 사용할 Grant Type (GrantType enum 참고)
+ * - scopes: 요청할 OAuth 스코프 목록 (예: ['openid', 'profile', 'email'])
+ * - resources: 접근할 리소스 서버 목록 (예: ['https://api.example.com'])
+ * - prompt: 인증 요청 시 사용할 prompt 파라미터 (Prompt enum 참고)
+ * - includeReservedScopes: Logto의 예약 스코프 포함 여부 (일반적으로 false, 필요시 true)
+ * - redirectUri: 인증 후 리다이렉트될 URI (Authorization Code 플로우에서 필수)
+ *
+ * 예시:
+ * ```ts
+ * const config: LogtoConfig = {
+ *   endpoint: 'https://auth.example.com/oidc',
+ *   appId: 'my-client-id',
+ *   appSecret: 'my-client-secret',
+ *   grantType: GrantType.AuthorizationCode,
+ *   scopes: ['openid', 'profile', 'email'],
+ *   resources: ['https://api.example.com'],
+ *   prompt: Prompt.Login,
+ *   redirectUri: 'https://myapp.com/callback',
+ * };
+ * ```
+ */
+export type LogtoConfig = {
+    /** Logto 인증 서버의 엔드포인트 URL (예: https://auth.example.com/oidc) */
+    endpoint: string;
+    /** Logto 애플리케이션의 Client ID */
+    appId: string;
+    /** OAuth 인증 플로우에서 사용할 Grant Type (GrantType enum 참고) */
+    grantType: GrantType;
+    /** Logto 애플리케이션의 Client Secret */
+    appSecret: string;
+    /** 요청할 OAuth 스코프 목록 (예: ['openid', 'profile', 'email']) */
+    scopes?: string[];
+    /** 접근할 리소스 서버 목록 (예: ['https://api.example.com']) */
+    resources?: string[];
+    /** 인증 요청 시 사용할 prompt 파라미터 (Prompt enum 참고) */
+    prompt?: Prompt;
+    /** Logto의 예약 스코프 포함 여부 (일반적으로 false, 필요시 true) */
+    includeReservedScopes?: boolean;
+    /** 인증 후 리다이렉트될 URI (Authorization Code 플로우에서 필수) */
+    redirectUri?: string;
+};
+
+/**
+ * Prompt
+ *
+ * 인증 요청 시 prompt 파라미터로 사용할 값의 Enum.
+ * - None: 사용자 상호작용 없이 인증 시도
+ * - Consent: 동의 화면 강제 표시
+ * - Login: 로그인 화면 강제 표시
+ */
+export enum Prompt {
+    None = "none",
+    Consent = "consent",
+    Login = "login",
+}
+
+/**
+ * GrantType
+ *
+ * OAuth 인증 플로우에서 사용할 Grant Type의 Enum.
+ * - AuthorizationCode: 일반적인 사용자 인증(프론트엔드/백엔드 연동)
+ * - ClientCredentials: 서버 간(M2M) 인증
+ * - RefreshToken: 리프레시 토큰을 통한 토큰 갱신
+ */
+export enum GrantType {
+    AuthorizationCode = 'authorization_code',
+    ClientCredentials = 'client_credentials',
+    RefreshToken = 'refresh_token',
+}

package/client/index.ts

@@ -0,0 +1,5 @@
+export * from "./config";
+export * from "./m2m-client";
+export * from "./oauth-client";
+export * from "./logto-login-session";
+export * from "./types";

package/client/logto-login-session.ts

@@ -0,0 +1,239 @@
+import { Inject, Injectable, LoggerService } from "@nestjs/common";
+import { ConfigService } from "@nestjs/config";
+import axios, { AxiosResponse } from "axios";
+import { axiosAdapter } from "point3-common-tool";
+
+import {
+    OAuthClient,
+    OAuthClientToken,
+    SignInType,
+} from "./oauth-client";
+
+import {
+    LogtoLoggerServiceToken,
+    LogtoOAuthRESTTemplate,
+} from "./types";
+
+// DI token for LogtoLoginSession
+export const LogtoLoginSessionToken = Symbol.for("LogtoLoginSession");
+
+@Injectable()
+/**
+ * LogtoLoginSession
+ * 
+ * Logto 인증 세션 플로우를 관리하는 클래스입니다.
+ * NestJS DI 환경에서 사용되며, Logto 로그인 과정의 각 단계를 API 호출로 래핑합니다.
+ * 
+ * 주요 역할:
+ *   - 로그인 세션 시작 및 세션 쿠키 관리
+ *   - 인증 플로우(로그인 경험) 단계별 진행
+ *   - 비밀번호 검증, 사용자 식별, 동의 및 제출 처리
+ *   - 커스텀 로그인 플로우를 위한 저수준 제어 제공
+ * 
+ * 사용 예시:
+ *   const session = new LogtoLoginSession(...);
+ *   await session.createSignInSession(...);
+ *   ...
+ */
+export class LogtoLoginSession {
+    /**
+     * /api 엔드포인트 요청을 위한 REST 템플릿입니다.
+     */
+    private readonly apiRestTemplate: axiosAdapter.RESTTemplate;
+
+    /**
+     * LogtoLoginSession 생성자
+     * 
+     * @param logger - 로깅 서비스
+     * @param configService - 환경설정 서비스
+     * @param oauthClient - OAuth 클라이언트 인스턴스
+     */
+    constructor(
+        @Inject(LogtoLoggerServiceToken)
+        private readonly logger: LoggerService,
+
+        @Inject(ConfigService)
+        private readonly configService: ConfigService,
+
+        @Inject(OAuthClientToken)
+        private readonly oauthClient: OAuthClient,
+    ) {
+        // API 기본 URL로 REST 템플릿 초기화
+        const baseURL = this.configService.get<string>("LOGTO_M2M_API_URL");
+        this.apiRestTemplate = new LogtoOAuthRESTTemplate(this.logger, baseURL);
+    }
+
+    /**
+     * Logto 로그인 세션을 시작합니다.
+     *
+     * 인증 URI를 요청하여 로그인 플로우를 시작하며, 응답에는 세션 쿠키가 포함됩니다.
+     *
+     * @param signInType - 로그인 유형(예: Admin, Dashboard 등)
+     * @returns Axios 응답 객체와 생성된 state 문자열을 포함하는 객체
+     */
+    public async createSignInSession(
+        signInType: SignInType,
+    ): Promise<{ response: AxiosResponse | undefined; state: string }> {
+        const { uri, state } = this.oauthClient.getSignInURI(signInType);
+        const response = await axios.get(uri, {
+            maxRedirects: 0,
+            validateStatus: (status) => status >= 200 && status <= 400,
+            withCredentials: true,
+        });
+        return { response, state };
+    }
+
+    /**
+     * Logto 인증 경험(로그인 플로우 1단계)을 시작합니다.
+     *
+     * 로그인 UI를 트리거하고 상호작용 이벤트를 설정합니다.
+     *
+     * @param cookie - 초기 로그인 세션에서 받은 세션 쿠키
+     * @returns 경험(Experience) 엔드포인트의 응답 데이터
+     * @throws 시작 실패 시 에러 발생
+     */
+    public async experienceSignIn(cookie: string): Promise<any> {
+        try {
+            const response = await this.apiRestTemplate.put(
+                `/experience`,
+                { interactionEvent: 'SignIn' },
+                {
+                    headers: {
+                        'Content-Type': 'application/json',
+                        Cookie: cookie,
+                    },
+                    withCredentials: true,
+                },
+            );
+            return response.data;
+        } catch (error) {
+            this.logger.error('Failed to start login experience');
+            throw error;
+        }
+    }
+
+    /**
+     * 로그인 플로우 중 사용자의 비밀번호를 검증합니다.
+     *
+     * @param cookie - 세션 쿠키
+     * @param dto - identifier(타입/값)와 비밀번호를 포함한 객체
+     * @returns 비밀번호 검증 엔드포인트의 응답 데이터
+     * @throws 검증 실패 시 에러 발생
+     */
+    public async verificationPassword(
+        cookie: string,
+        dto: {
+            identifier: {
+                type: string;
+                value: string;
+            };
+            password: string;
+        },
+    ): Promise<any> {
+        try {
+            const response = await this.apiRestTemplate.post(
+                `/experience/verification/password`,
+                {
+                    identifier: dto.identifier,
+                    password: dto.password,
+                },
+                {
+                    headers: { Cookie: cookie },
+                    withCredentials: true,
+                },
+            );
+            return response.data;
+        } catch (error) {
+            throw error;
+        }
+    }
+
+    /**
+     * 로그인 플로우에서 verificationId를 사용해 사용자를 식별합니다.
+     *
+     * @param cookie - 세션 쿠키
+     * @param verificationId - 이전 단계에서 받은 verification ID
+     * @returns 식별 엔드포인트의 응답 데이터
+     * @throws 식별 실패 시 에러 발생
+     */
+    public async identify(cookie: string, verificationId: string): Promise<any> {
+        try {
+            const response = await this.apiRestTemplate.post(
+                `/experience/identification`,
+                { verificationId },
+                {
+                    headers: { Cookie: cookie },
+                    withCredentials: true,
+                },
+            );
+            return response.data;
+        } catch (error) {
+            throw error;
+        }
+    }
+
+    /**
+     * 인증 경험(Experience)을 제출하여 로그인 플로우를 완료합니다.
+     *
+     * @param cookie - 세션 쿠키
+     * @returns 제출 엔드포인트의 응답 데이터
+     * @throws 제출 실패 시 에러 발생
+     */
+    public async submit(cookie: string): Promise<any> {
+        try {
+            const response = await this.apiRestTemplate.post(
+                `/experience/submit`,
+                {},
+                {
+                    headers: { Cookie: cookie },
+                    withCredentials: true,
+                },
+            );
+            return response.data;
+        } catch (error) {
+            throw error;
+        }
+    }
+
+    /**
+     * 사용자를 동의(Consent) 화면으로 리다이렉트합니다.
+     *
+     * 인증 후 토큰 발급 전 동의 화면으로 이동할 때 사용합니다.
+     *
+     * @param redirectTo - 동의 페이지로 리다이렉트할 URL
+     * @param cookie - 세션 쿠키
+     * @returns 리다이렉트 요청의 Axios 응답 객체
+     */
+    public async redirectToConsent(redirectTo: string, cookie: string): Promise<AxiosResponse> {
+        const response = await axios.get(redirectTo, {
+            maxRedirects: 0,
+            validateStatus: (status) => status >= 200 && status <= 400,
+            withCredentials: true,
+            headers: { Cookie: cookie },
+        });
+        return response;
+    }
+
+    /**
+     * 사용자의 동의(Consent)를 Logto 서버에 제출합니다.
+     *
+     * @param cookie - 세션 쿠키
+     * @returns 동의 엔드포인트의 응답 데이터
+     * @throws 동의 제출 실패 시 에러 발생
+     */
+    public async consent(cookie: string): Promise<any> {
+        try {
+            const response = await this.apiRestTemplate.post(
+                `/interaction/consent`,
+                {},
+                {
+                    headers: { Cookie: cookie },
+                    withCredentials: true,
+                },
+            );
+            return response.data;
+        } catch (error) {
+            throw error;
+        }
+    }
+}