@passcend/passgen

v1.0.1

Published

13 days ago

A secure, flexible, and zero-dependency password and passphrase generator for Node.js and the browser.

0High
0Medium
0Low

yooseungjae

password passphrase generator security crypto eff wordlist

Passcend Passgen

Node.js 및 브라우저를 위한 안전하고 유연하며 종속성이 없는 비밀번호 및 패스프레이즈 생성기입니다.

사용자 친화적인 CLI 도구와 강력한 TypeScript 라이브러리를 모두 제공합니다. 한국어 패스프레이즈 생성, QWERTY 키보드 변환, Leet Speak, AES-GCM 암호화 등 다양한 보안 기능을 지원합니다.

🌟 특징 (Features)

🔒 강력한 보안 (Secure):
- crypto.getRandomValues (브라우저) 및 crypto.randomBytes (Node.js)를 사용하여 암호학적으로 안전한 난수를 생성합니다.
- 편향 없는(Bias-free) 알고리즘을 사용하여 예측 불가능성을 보장합니다.
🛠️ 유연성 (Flexible):
- 사용자 정의 문자 세트(대문자, 소문자, 숫자, 특수 문자)를 조합하여 원하는 규칙의 비밀번호를 생성할 수 있습니다.
🗣️ 패스프레이즈 (Passphrases):
- 영어: EFF 대용량 단어 목록 (7,776개)을 사용하여 기억하기 쉽고 강력한 패스프레이즈를 생성합니다.
- 한국어: BIP-39 기반의 한국어 단어 목록을 지원합니다.
🔢 PIN 생성기 (PIN Generator):
- 보안성이 강화된 숫자 PIN을 생성합니다.
- 1234 같은 연속된 숫자나 1111 같은 반복된 숫자를 자동으로 방지하는 옵션을 제공합니다.
🔠 변환 기능 (Transformations):
- QWERTY 변환: 한국어 발음을 영문 QWERTY 키보드 입력값으로 변환하여 보안성을 높입니다. (예: 홍길동 -> ghdrlfehd)
- Leet Speak: 텍스트를 해커어(1337)로 변환합니다. (예: password -> p455w0rd)
- Case: 대문자, 소문자, Titlecase 변환을 지원합니다.
🛡️ 강도 측정기 (Strength Meter):
- 비밀번호의 정보 엔트로피(Entropy)를 비트 단위로 계산합니다.
- 키보드 패턴(qwerty, asdf 등) 및 단순 반복을 감지하여 보안 경고를 제공합니다.
🔐 AES-GCM 암호화:
- PBKDF2(SHA-256) 키 유도를 사용하는 표준 AES-GCM 암호화/복호화 기능을 제공합니다.
🚫 무의존성 (Zero Dependencies):
- 외부 런타임 라이브러리에 전혀 의존하지 않아 가볍고 안전합니다.
📘 TypeScript 지원:
- 100% TypeScript로 작성되어 완벽한 타입 정의를 제공합니다.

🚀 설치 (Installation)

npm을 사용하여 프로젝트에 설치할 수 있습니다.

npm install @passcend/passgen

💻 CLI 사용법 (CLI Usage)

이 패키지는 강력한 CLI 도구를 포함하고 있습니다. 설치 없이 npx로 바로 실행하거나 전역으로 설치하여 사용할 수 있습니다.

실행 방법

# 설치 없이 바로 실행 (추천)
npx @passcend/passgen [command] [options]

# 또는 전역 설치
npm install -g @passcend/passgen
passgen [command] [options]

1. 비밀번호 (Password)

무작위 문자열로 구성된 비밀번호를 생성합니다. 별도의 명령어가 없으면 기본적으로 이 모드로 실행됩니다.

옵션 (Options):

사용 예시 (Example):

npx @passcend/passgen password -l 20 --no-special

출력 (Output):

Password: mK9xP2jL5vN8qR4wZ1yA
Strength: Very Strong (115 bits)

2. 패스프레이즈 (Passphrase)

기억하기 쉬운 단어들을 조합하여 패스프레이즈를 생성합니다.

옵션 (Options):

사용 예시 (Example):

# 한국어 단어를 QWERTY 영문으로 변환하여 생성
npx @passcend/passgen passphrase --lang ko --qwerty

출력 (Output):

Passphrase: rkdskdzhd-dkqjwl-thskan-qkek5
Strength:   Very Strong (140 bits)

3. PIN 번호 (PIN)

금융 및 보안 장치에 사용되는 숫자 비밀번호를 생성합니다.

옵션 (Options):

사용 예시 (Example):

npx @passcend/passgen pin -l 6

출력 (Output):

PIN:      829104
Strength: Weak (20 bits)

4. 암호화 / 복호화 (Encryption / Decryption)

AES-GCM 알고리즘과 PBKDF2(SHA-256) 키 유도를 사용하여 텍스트를 안전하게 보호합니다.

옵션 (Options):

사용 예시 (Example):

# 암호화
npx @passcend/passgen encrypt "My Secret Data" --secret "password123"

# 복호화
npx @passcend/passgen decrypt "encrypted_string_here..." --secret "password123"

출력 (Output):

# 암호화 결과
Saltbase64...IVbase64...CiphertextBase64...

# 복호화 결과
My Secret Data

5. 강도 측정 (Strength)

비밀번호의 엔트로피와 패턴을 분석하여 강도를 측정합니다.

사용 예시 (Example):

npx @passcend/passgen strength "password123"

출력 (Output):

Password: password123
Strength: Very Weak (Score: 1/4)
Entropy:  28 bits

📚 라이브러리 사용법 (Library Usage)

Node.js 또는 브라우저 애플리케이션에서 직접 가져와 사용할 수 있습니다.

패스프레이즈 생성

import { generatePassphrase } from '@passcend/passgen';

// 기본 생성
const phrase = generatePassphrase();

Output (String):

"Correct-Horse-Battery-Staple5"

// 고급 옵션 (한국어 + QWERTY 변환)
const customPhrase = generatePassphrase({
  language: 'ko',
  qwertyConvert: true,
  numWords: 5,
  leet: true
});

Output (String):

"rkdskdzhd-dkqjwl-thskan-qkek5"

비밀번호 생성

import { generatePassword } from '@passcend/passgen';

const password = generatePassword({
  length: 24,
  uppercase: true,
  numbers: true,
  special: true
});

Output (String):

"x7K9vM2pQ5nL8jR4wZ1yA3bC"

PIN 생성

import { generatePin } from '@passcend/passgen';

// 안전한 PIN (연속/반복 숫자 자동 거부)
const safePin = generatePin({ length: 6 });

Output (String):

"829104"

비밀번호 강도 측정

import { calculateStrength } from '@passcend/passgen';

const result = calculateStrength("Tr0ub4dor&3");

Output (JSON Object):

{
  "score": 3,
  "label": "Strong",
  "color": "lime",
  "entropy": 85,
  "warnings": []
}

비밀번호 정책 검증

import { validatePassword } from '@passcend/passgen';

const result = validatePassword("pass", { minLength: 8 });

Output (JSON Object):

{
  "isValid": false,
  "errors": [
    "Password must be at least 8 characters long."
  ]
}

데이터 암호화 (AES-GCM)

import { encrypt, decrypt } from '@passcend/passgen';

async function secureData() {
  const secretKey = 'my-super-secret-key';
  const data = 'Sensitive Information';

  // 암호화
  const encrypted = await encrypt(data, secretKey);

  // 복호화
  const original = await decrypt(encrypted, secretKey);
}

Output (String - Encrypted):

"7f8d... (Base64 Encoded Salt + IV + Ciphertext)"

📄 라이선스 (License)

이 프로젝트는 MIT 라이선스 하에 배포됩니다. 자유롭게 사용, 수정 및 배포할 수 있습니다.

Published

Vulnerabilities

Links

Maintainers

Keywords

Readme

Passcend Passgen

🌟 특징 (Features)

🚀 설치 (Installation)

💻 CLI 사용법 (CLI Usage)

실행 방법

1. 비밀번호 (Password)

2. 패스프레이즈 (Passphrase)

3. PIN 번호 (PIN)

4. 암호화 / 복호화 (Encryption / Decryption)

5. 강도 측정 (Strength)

📚 라이브러리 사용법 (Library Usage)

패스프레이즈 생성

비밀번호 생성

PIN 생성

비밀번호 강도 측정

비밀번호 정책 검증

데이터 암호화 (AES-GCM)

📄 라이선스 (License)