사용 방법
- 키 종류를 고릅니다. 특별한 이유가 없으면 Ed25519를 쓰고, 오래된 장비나 서비스가 Ed25519를 받지 않을 때만 RSA를 고릅니다.
- 공개키 끝에 붙을 주석을 적습니다. 이메일이나
이름@기기형식이 흔하고, 비워도 됩니다. - 페이지를 열거나 새 키 생성을 누를 때마다 새 키쌍이 만들어집니다. 지문(SHA256)이 함께 표시됩니다.
- 공개키는 접속하려는 서버의
authorized_keys파일이나 GitHub·GitLab의 SSH 키 등록 화면에 한 줄 그대로 붙여 넣습니다. - 개인키를 내려받아
id_ed25519(RSA는id_rsa)라는 이름으로.ssh폴더에 둡니다. 리눅스·맥에서는chmod 600으로 본인만 읽게 권한을 줄여야 ssh가 사용합니다.
키 종류와 크기
| 종류 | 공개키 한 줄의 시작 | 특징 |
|---|---|---|
| Ed25519 | ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAA… |
키가 짧고 빠릅니다. 공개키 Base64가 68자로 고정입니다. |
| RSA 2048 | ssh-rsa AAAAB3NzaC1yc2EAAAADAQAB… |
호환성이 가장 넓습니다. 공개키 지수는 65537입니다. |
| RSA 3072 | 같음 | 2048보다 여유가 있고 만드는 시간은 조금 더 걸립니다. |
| RSA 4096 | 같음 | 가장 큽니다. 접속 때 계산이 느려질 수 있습니다. |
RSA 1024처럼 약한 크기는 제공하지 않습니다. OpenSSH 8.8부터는 SHA-1을 쓰는 ssh-rsa 서명 방식이 기본으로 꺼져 있지만, RSA 키 자체는 rsa-sha2-256·rsa-sha2-512 방식으로 계속 쓸 수 있습니다.
개인키 형식 두 가지
- OpenSSH 형식(
-----BEGIN OPENSSH PRIVATE KEY-----):ssh -i,ssh-add, 대부분의 Git 클라이언트에 바로 쓰는 형식입니다. 이 도구가 만든 파일은ssh-keygen -y -f로 공개키를 다시 뽑아 보면 화면의 공개키와 같습니다. - PKCS#8 PEM(
-----BEGIN PRIVATE KEY-----): OpenSSL이나 프로그래밍 라이브러리가 읽는 표준 형식입니다.
두 형식은 같은 키를 다르게 담은 것입니다. 지문은 개인키 형식과 관계없이 공개키로만 계산하므로 ssh-keygen -l -f 공개키파일 결과와 같습니다.
키를 안전하게 보관하는 법
- 개인키를 가진 사람은 누구든 당신으로 접속할 수 있습니다. 메신저·메일·이슈 트래커에 붙여 넣지 마세요.
- 내려받은 개인키에는 암호(passphrase)가 걸려 있지 않습니다.
ssh-keygen -p -f id_ed25519로 암호를 추가하는 것을 권합니다. - 공개키는 공유해도 안전합니다. 개인키를 잃어버렸거나 노출된 것 같다면 서버의
authorized_keys에서 해당 공개키 줄을 지우고 새 키를 만드세요. - 중요한 서버에 쓸 키는 신뢰할 수 있는 본인 기기에서
ssh-keygen으로 직접 만드는 쪽이 가장 확실합니다. 이 도구는 개발·테스트용 키나 빠른 설정에 알맞습니다.
자주 묻는 질문
이 키가 서버로 전송되나요?
아니요. 키는 브라우저의 WebCrypto(crypto.subtle)로 이 기기에서 만들어지고, 공개키 인코딩과 지문 계산도 모두 이 페이지 안에서 끝납니다. 어디에도 전송·저장되지 않습니다. 다만 화면에 보이는 개인키는 복사하거나 내려받으면 그대로 남으니 보관에 주의하세요.
Ed25519와 RSA 중 무엇을 쓰나요?
GitHub, GitLab, 최신 OpenSSH 서버는 모두 Ed25519를 지원하므로 기본 선택으로 충분합니다. 아주 오래된 장비나 일부 사내 시스템이 Ed25519를 받지 않으면 RSA 3072 이상을 쓰세요.
암호(passphrase)는 왜 여기서 설정하지 않나요?
OpenSSH의 암호화 개인키 형식은 bcrypt 기반 키 유도를 쓰는데, 브라우저 표준 API에는 없습니다. 암호를 걸려면 내려받은 뒤 ssh-keygen -p -f 파일이름 을 실행하세요.
Ed25519 생성을 지원하지 않는다고 나오면 어떻게 하나요?
WebCrypto의 Ed25519는 비교적 최근에 들어간 기능입니다. 브라우저를 최신 버전으로 올리거나 RSA를 고르면 됩니다.
공개키 지문은 어디에 쓰나요?
서버에 처음 접속할 때나 GitHub 설정 화면에서 보이는 SHA256:... 값과 비교해 같은 키인지 확인하는 데 씁니다. 해시가 궁금하다면 해시 생성기로 직접 계산해 볼 수 있습니다.
관련 도구
- 인증서나 서명에 쓰는 PEM 키는 RSA 키 생성기에서 PKCS#1·PKCS#8로 만들 수 있습니다.
- 서버 계정 비밀번호는 비밀번호 생성기로 만드세요.
- Base64 문자열을 확인하려면 Base64 인코더·디코더, 메시지 서명에는 HMAC 생성기가 있습니다.
생성한 키는 브라우저 안에서만 처리되며 서버로 전송되지 않습니다.