Weasel Pageant

SSH 키 포워딩

Windows에서 실행 중인 PuTTY Pageant(또는 PuTTY-CAC, Gpg4win의 SSH 에이전트 모드 등 호환 프로그램)가 관리하는 SSH 키를 WSL 환경의 OpenSSH 클라이언트에 투명하게 제공합니다.

에이전트 재사용 옵션

-r/–reuse 옵션을 사용하면 이미 실행 중인 에이전트가 있으면 새로운 데몬을 시작하지 않고 기존 환경 변수만 출력합니다. 이를 통해 여러 WSL 콘솔 간에 에이전트를 효율적으로 공유할 수 있습니다.

지속형 소켓 지원

Windows 10 1809 이상에서는 -a 플래그로 고정된 소켓 경로를 지정하고 -b 플래그로 프로세스가 부모 터미널 종료 시 함께 종료되는 것을 방지하여, 안정적인 고정 소켓을 사용할 수 있습니다.

다운로드·설치 방법

설치는 두 가지 방법이 제공됩니다.

• GitHub 릴리스 페이지에서 zip 파일을 다운로드하여 Windows 드라이브의 적절한 위치에 압축을 풉니다. WSL 파일시스템(lxfs 마운트) 내에 압축을 풀면 작동하지 않으므로, 반드시 Windows 파트에 설치해야 합니다.
• 소스에서 빌드할 경우, Visual Studio 2019에서 “Desktop development with C++”와 “Linux development with C++” 기능이 필요합니다.

기본 사용법

사용법은 Linux 환경의 ssh-agent와 유사합니다.

1. PuTTY의 Pageant가 실행 중인지 확인합니다(SSH 키가 로드되어 있어야 합니다). Windows 시작 프로그램에 Pageant를 추가하여 항상 사용 가능하도록 하는 것이 권장됩니다.
2. WSL의 ~/.bashrc(또는 ~/.bash_profile)에 다음 명령어를 추가합니다:
   eval $(<설치 위치>/weasel-pageant -r)
3. 셸을 다시 시작하거나 `source ~/.bashrc` 명령어를 실행합니다. `ssh-add -l`을 입력하면 Pageant에 등록된 키 목록이 표시됩니다.

기본적으로 Win32 헬퍼는 weasel-pageant와 같은 디렉토리에서 검색되며, 별도 위치에 배치한 경우 `-H` 플래그로 경로를 지정할 수 있습니다.

명령어 옵션

Weasel Pageant는 ssh-agent 옵션과 호환되며, 추가 옵션을 제공합니다:

• -r/–reuse: 기존 에이전트 재사용 허용
• -a SOCKET: 특정 경로에 소켓 생성
• -b: tty 종료 시 프로세스 종료 방지 (Windows 10 1809 이상 필요)
• -H: Win32 헬퍼 바이너리 경로 지정
• -k: 현재 weasel-pageant 종료
• -d: 디버그 모드 활성화

이런 경우에 유용합니다

스마트 카드를 사용하여 SSH 인증을 수행할 때, 물리적 키를 WSL 환경으로 복사할 수 없는 경우 Weasel Pageant가 해결책이 됩니다. 또한 Windows와 WSL 환경을 모두 사용하는 개발자에게, 하나의 Pageant 인스턴스로 두 환경에서 동일한 SSH 키를 관리할 수 있는 편의성을 제공합니다.

지원 환경·시스템 요구사항

Weasel Pageant는 Windows 10 1703(Creators Update) 이상에서만 작동하며, WSL과 Windows/Ubuntu 상호 운용 기능이 필요합니다. Windows 10 1709까지는 업데이트가 지원되었으나, 현재는 중단된 상태입니다.

최신 버전·업데이트

최신 버전은 1.4이며(2019년 8월 4일 출시), Windows 10 1903의 Win32 상호 운용 버그에 대한 해결 방법과 Alpine과 같은 glibc 미사용 배포판과의 호환성을 위해 리눅스 바이너리를 정적 링크로 전환한 것이 포함되어 있습니다.

제한 사항·확인 사항

• Weasel Pageant의 개발은 2020년 4월 14일에 종료되었으며, 이후 보안 패치도 제공되지 않습니다.
• Windows 10 1803 이상에서는 Unix 도메인 소켓이 네이티브로 지원되므로, 더 현대적인 대안(예: WinCryptSSHAgent, wsl-ssh-pageant)으로 마이그레이션이 권장됩니다.
• WSL 환경에서 원격으로 로그인하는 사용자가 Pageant에 저장된 SSH 키에 접근할 수 있는 보안상의 위험이 있으므로, WSL 환경에 대한 원격 접근(SSH 서버 등)을 허용하지 않는 것이 중요합니다.
• screen, tmux 등과 함께 사용할 때 소켓 연결 문제가 발생할 수 있으며, Windows 10 1809 이상에서는 -b 플래그로 일부 해결이 가능합니다.