Wincrypt Sshagent

스마트카드 네이티브 지원

드라이버 설치 없이 Windows에서 Yubikey PIV와 같은 스마트카드를 네이티브하게 사용할 수 있습니다. Windows 인증서 관리 기능을 활용하여 인증서나 스마트카드를 SSH 인증에 직접 활용할 수 있습니다.

다중 프로토콜 호환성

다음 5가지 인기 있는 프로토콜을 구현하여 대부분의 Windows SSH 클라이언트와 호환됩니다:

• Cygwin UNIX 소켓
• Windows UNIX 소켓 (Windows 10 1803 이상)
• 네임드 파이프
• Pageant SSH 에이전트 프로토콜
• XShell Xagent 프로토콜

이를 통해 Git for Windows, Windows Subsystem for Linux, Windows OpenSSH, PuTTY, Jetbrains IDE, SecureCRT, XShell, Cygwin, MINGW 등과 원활하게 작동합니다.

OpenSSH 인증서 지원

OpenSSH 인증서 형식 인증을 지원합니다. 사용자 프로필 폴더에 OpenSSH 인증서를 배치하고 특정 이름 규칙(-cert.pub 또는 -cert.pub)으로 이름을 변경하여 사용할 수 있습니다.

Chocolatey를 통한 설치

Chocolatey 패키지 관리자를 사용하는 경우 다음 명령어로 설치할 수 있습니다:

choco install wincrypt-sshagent

수동 설치

안정 버전은 GitHub 릴리스 페이지에서 다운로드할 수 있습니다. 다운로드 후 실행 파일을 시작 폴더에 바로가기를 만들어 시스템 시작 시 자동 실행되도록 설정할 수 있습니다.

기본 사용법/명령어

WinCryptSSHAgent를 실행한 후 작업 표시줄의 아이콘을 오른쪽 클릭하면 메뉴를 통해 다양한 정보를 확인할 수 있습니다. 일부 SSH 클라이언트(예: PuTTY, XShell, Jetbrains)는 Pageant 프로토콜을 사용하므로 시스템 전체 설정이 필요 없으며 작업 표시줄 메뉴에 나타나지 않을 수 있습니다.

디버그 로그 활성화

문제 해결이 필요한 경우 다음 단계를 따라 디버그 로그를 활성화할 수 있습니다:

1. 명령 프롬프트에서 setx WCSA_DEBUG 1 실행
2. 시스템 재부팅하여 환경 변수 적용
3. 문제 재현
4. 로그 파일 확인: %USERPROFILE%WCSA_DEBUG.log

이런 경우에 유용합니다

Windows 환경에서 Yubikey 같은 하드웨어 보안 키를 SSH 인증에 사용하고 싶은 개발자나 시스템 관리자에게 유용합니다. 별도의 드라이버 설치 없이 스마트카드를 SSH 에이전트로 활용할 수 있어 보안성과 편의성을 동시에 높일 수 있습니다. 특히 WSL과 함께 사용할 때 Yubikey를 이용한 SSH 인증 설정을 간소화해줍니다.

제한 사항·확인 사항

OpenSSH 인증서를 사용할 때는 X.509 형식의 인증서를 직접 변환해서 사용할 수 없습니다. OpenSSH는 자체적인 인증서 형식을 사용하므로 Windows 인증서 저장소의 인증서를 그대로 사용하기 위해서는 프로젝트에서 제공하는 공개 키 오버라이드 메커니즘을 따라야 합니다.