[리눅스] Vault-SSH 플러그인을 설치하는 방법

Vault-SSH 플러그인을 설치하는 방법

테스트 환경

$ lsb_release -d
Description:    Ubuntu 22.04.2 LTS

 

Vault-SSH 플러그인을 설치하려면 다음 단계를 따를 수 있습니다.

 

1. Vault-SSH 플러그인 가져오기

Vault-SSH 플러그인을 다운로드해야 합니다. GitHub 저장소에서 최신 릴리스를 확인하고 플러그인을 다운로드합니다.

다음은 플러그인을 다운로드하는 명령어 예시입니다.

curl -LO https://github.com/hashicorp/vault-ssh-helper/releases/download/v<version>/vault-ssh-helper_<version>_<platform>_amd64.zip

<version>은 사용하려는 Vault-SSH 플러그인 버전을, <platform>은 플러그인을 실행할 운영 체제 플랫폼을 나타냅니다. 예를 들어, Linux x86_64 플랫폼의 경우 linux_amd64를 사용합니다.

 

curl -LO https://releases.hashicorp.com/vault-ssh-helper/0.2.1/vault-ssh-helper_0.2.1_linux_amd64.zip

 

2. 압축 해제

다운로드한 zip 파일을 압축 해제합니다. 다음 명령어를 사용할 수 있습니다.

unzip vault-ssh-helper_<version>_<platform>_amd64.zip

 

apt update

apt install unzip

unzip vault-ssh-helper_0.2.1_linux_amd64.zip

$ unzip vault-ssh-helper_0.2.1_linux_amd64.zip
Archive:  vault-ssh-helper_0.2.1_linux_amd64.zip
  inflating: vault-ssh-helper

 

3. 실행 파일 이동

압축 해제된 실행 파일을 Vault가 실행되는 서버의 적절한 위치로 이동시킵니다.

보통 /usr/local/bin 또는 /usr/bin과 같은 시스템 PATH에 있는 디렉토리로 이동시킵니다.

 

mv vault-ssh-helper /usr/local/bin/

$ vault-ssh-helper -v
vault-ssh-helper v0.2.1

 

4. Vault-SSH 플러그인 구성

Vault-SSH 플러그인을 구성해야 합니다. 보통 config.hcl 파일을 사용하여 구성합니다.

구성 파일에는 Vault 서버의 주소, 포트, 토큰 등이 포함됩니다. 구체적인 구성 방법은 Vault-SSH 플러그인의 문서를 참조하시기 바랍니다.

 

mkdir /etc/vault-ssh-helper.d/

sudo tee /etc/vault-ssh-helper.d/config.hcl <<EOF
vault_addr = "http://vault:8200"
tls_skip_verify = false
ssh_mount_point = "ssh"
allowed_roles = "*"
EOF

 

5. SSH 서버 구성 파일 편집

SSH 서버의 구성 파일을 편집하여 Vault-SSH 플러그인을 사용하도록 설정합니다.

/etc/ssh/sshd_config 또는 /etc/sshd_config 파일을 편집합니다.

AuthorizedKeysCommand와 AuthorizedKeysCommandUser 설정을 추가합니다.

AuthorizedKeysCommand /path/to/vault-ssh-helper
AuthorizedKeysCommandUser <user>

/path/to/vault-ssh-helper는 이전 단계에서 이동한 Vault-SSH 실행 파일의 경로로 대체해야 하고, <user>는 실행 파일을 실행할 사용자를 나타냅니다.

 

sudo cp /etc/ssh/sshd_config /etc/ssh/sshd_config.orig

echo "AuthorizedKeysCommand /usr/local/bin/vault-ssh-helper" | sudo tee -a /etc/ssh/sshd_config

echo "AuthorizedKeysCommandUser ubuntu" | sudo tee -a /etc/ssh/sshd_config

 

6. SSH 서버 재시작

SSH 서버를 재시작하여 구성 변경 사항을 적용합니다.

다음 명령어를 사용할 수 있습니다.

sudo systemctl restart ssh

 

Vault-SSH 플러그인을 설치하고 SSH 서버와 통합하는 방법에 대해 설명했습니다. 이를 통해 SSH 인증을 Vault와 연동하여 중앙 집중식 보안 및 액세스 제어를 구현할 수 있습니다. 구체적인 구성 및 운영 방법은 Vault-SSH 플러그인의 문서를 참조하시기 바랍니다.

 

vault-ssh-helper -verify-only -dev -config /etc/vault-ssh-helper.d/config.hcl

$ vault-ssh-helper -verify-only -dev -config /etc/vault-ssh-helper.d/config.hcl
2023/06/01 04:51:56 ==> WARNING: Dev mode is enabled!
2023/06/01 04:51:56 [INFO] using SSH mount point: ssh
2023/06/01 04:51:56 [INFO] using namespace: 
2023/06/01 04:51:56 [INFO] vault-ssh-helper verification successful!

 

참고URL

- vault-ssh-helper(releases.hashicorp.com) : https://releases.hashicorp.com/vault-ssh-helper/