coforward-virtual-keyboard/
├── src/                      # 클라이언트 SDK (JavaScript)
│   ├── core/                 # 핵심 로직
│   │   ├── crypto.js         # AES-256-GCM + RSA-OAEP
│   │   ├── keypad.js         # Canvas 렌더링 엔진
│   │   └── session.js        # 세션 관리
│   ├── keypads/              # 키패드 레이아웃
│   │   ├── numeric.js
│   │   ├── english.js
│   │   └── korean.js
│   └── index.js              # 공개 API 진입점
├── server/                   # Java Spring Boot 서버
│   ├── coforward-vk-core/    # 핵심 도메인 로직
│   ├── coforward-vk-spring/  # Spring Boot 자동 설정
│   └── coforward-vk-demo/    # 데모 서버
└── dist/                     # 빌드 산출물
    ├── coForward-virtual-keypad.js   # UMD 번들
    └── coForward-virtual-keypad.esm.js

<!-- UMD (CDN / 직접 포함) -->
<script src="dist/coForward-virtual-keypad.js"></script>

<!-- autoInit()이 자동으로 키패드를 연결합니다 -->
<input type="text" data-coForward-vk="numeric" placeholder="비밀번호" />
<input type="text" data-coForward-vk="english" placeholder="영문 ID" />
<input type="text" data-coForward-vk="korean"  placeholder="한글 입력" />

@SpringBootApplication
@EnableCoForwardVK
public class Application {
    public static void main(String[] args) {
        SpringApplication.run(Application.class, args);
    }
}

npm install coforward-virtual-keyboard

import CoForwardVK from 'coforward-virtual-keyboard';

<dependency>
  <groupId>com.coforward</groupId>
  <artifactId>coforward-vk-spring</artifactId>
  <version>1.0.0</version>
</dependency>

{
  "sessionId":  "550e8400-e29b-41d4-a716-446655440000",
  "publicKey":  "-----BEGIN PUBLIC KEY-----\n...",
  "expiresAt":  1735689600000,
  "keypadSeed": 42
}

{
  "success":   true,
  "plaintext": "1234"
}

@SpringBootApplication
@EnableCoForwardVK
public class Application {
    public static void main(String[] args) {
        SpringApplication.run(Application.class, args);
    }
}

coforward:
  vk:
    rsa-key-size: 2048          # RSA 키 크기 (2048 | 4096)
    session-ttl-seconds: 300   # 세션 유효 시간 (초)
    allowed-origins:
      - "https://yourapp.com"
    timestamp-tolerance-ms: 30000  # 타임스탬프 허용 오차

@RestController
public class LoginController {

    private final VirtualKeypadService vkService;

    @PostMapping("/login")
    public ResponseEntity<?> login(@RequestBody LoginRequest req) {
        String plainPassword = vkService.decrypt(
            req.getSessionId(),
            req.getEncryptedKey(),
            req.getEncryptedData(),
            req.getIv()
        );
        // plainPassword 즉시 처리 후 폐기
        return authService.authenticate(req.getUsername(), plainPassword);
    }
}

/* 다크 테마 */
:root {
  --coForward-vk-bg:         #1a1a2e;
  --coForward-vk-key-bg:     #16213e;
  --coForward-vk-key-hover:  #0f3460;
  --coForward-vk-key-color:  #e0e0e0;
  --coForward-vk-radius:     8px;
}

CoForwardVK.init({
  target: '#password',
  type:   'numeric',
  theme: {
    '--coForward-vk-bg':        '#1a1a2e',
    '--coForward-vk-key-bg':    '#16213e',
    '--coForward-vk-key-color': '#e0e0e0',
  }
});