AES 암호화 및 복호화

입력 및 조작

AES-128, AES-192, AES-256에는 각각 정확히 16, 24, 32바이트가 필요합니다. 키를 자동으로 채우거나 자르지 않습니다.

GCM: 12–64바이트(12 권장). CBC, CTR, CFB: 정확히 16바이트. ECB는 IV를 사용하지 않습니다. 기본 설정에서는 매 암호화마다 새로운 무작위 IV와 salt를 생성하므로 같은 평문도 결과가 달라집니다. 수동 값은 호환성 테스트용입니다. 해당 모드의 IV/nonce 요구사항을 지켜 주세요.

Plaintext: Hello, encrypted world! 🌐
Passphrase: DevToolsy-demo-passphrase

{
  "format": "devtoolsy-aes",
  "version": 2,
  "mode": "GCM",
  "keyBits": 256,
  "keySource": "passphrase",
  "padding": "none",
  "iv": "EBESExQVFhcYGRob",
  "ciphertext": "QdSMophe/cqRY/7qS1tHMemEKsgTwgzhEdCmOixECYc6+/X/mfq9f9Wq0CE=",
  "kdf": {
    "name": "PBKDF2",
    "hash": "SHA-256",
    "iterations": 600000,
    "salt": "AAECAwQFBgcICQoLDA0ODw=="
  },
  "authentication": {
    "tagLength": 128,
    "aad": ""
  }
}

동작 및 제한

GCM은 96/104/112/120/128-bit 태그, AAD, 결합 또는 별도 태그를 지원합니다. CBC/ECB는 PKCS#7 또는 NoPadding을 지원하며 후자는 완전한 16바이트 블록이 필요합니다. CFB는 128-bit 세그먼트, CTR은 1–128-bit 카운터를 사용합니다. 평문은 1 MiB까지입니다. 바이너리 결과는 Hex/Base64 또는 원시 바이트로 저장할 수 있으며 잘못된 UTF-8은 오류로 표시합니다.

이 모드는 데이터를 인증하지 않습니다. 잘못된 키로도 오류 없이 출력될 수 있습니다. 변조 감지가 필요하면 GCM을 사용하세요.

ECB는 레거시 호환용입니다. 같은 평문 블록은 같은 암호문 블록을 만듭니다.

복사 및 활용

JSON v2는 비밀이 아닌 매개변수를 저장하며 기존 v1의 AES-256-GCM / PBKDF2-SHA256 / 600,000회도 읽습니다. JSON은 컨테이너이며 인증을 추가하지 않습니다. 결과를 입력으로 사용하면 실제 매개변수가 전달됩니다. 암호화로 돌아오면 무작위 IV/salt 기본값이 복원됩니다.

원시 키 모드는 Node.js, Python, OpenSSL과 호환될 수 있으나 모드, 키 바이트, IV, padding, 인코딩과 GCM 태그/AAD가 모두 일치해야 합니다. OpenSSL Salted__ 또는 CryptoJS 암호문구 컨테이너는 자동 해석하지 않습니다. 실제 파생 키와 IV를 사용하세요. 암호문과 함께 IV, 솔트 및 일치하는 설정을 보관하세요. 입력 키와 암호는 내보내기에 포함되지 않습니다.