Bitwarden-cli 사용하기

이슈

 iTerm2  는 여러 개의 서버의 접속정보를 저장하고 분류하는 데 강력한 기능을 가지고 있다. 특히 버전3부터 지원된 Password Manager  기능으로 비밀번호를 저장할 수 있는 점에서 좋은 기능으로 사용해 왔지만, 2차 인증이 지원되지 않아 아쉬운 부분이 있어 Bitwarden-cli 함께 사용시 해당 부분을 어느 정도 해소할 수 있다.

설치하기

// install bitwarden-cli
$ brew install bitwarden-cli
// install jq
$ brew install jq

 

사용하기

• bw 위치 확인

$ which bw
/usr/local/bin/bw

 

• bw 버전 확인하기

$ bw -v
2024.6.1

 

• 외부 서버 설정

// bitwarden 공식 사용시 필요없음
// 별도 사설서버 사용시 config 설정 필요.
$ bw config server https://bitwarden.test.com
// 서버 설정 확인하기
$ bw config server
https://bitwarden.test.com

 

• 로그인 하기

$ bw login
? Email address: {email}
? Master password: {password}
? Two-step login code: {totp code}
You are logged in!

To unlock your vault, set your session key to the `BW_SESSION` environment variable. ex:
$ export BW_SESSION="{session key}"
> $env:BW_SESSION="{session key}"

You can also pass the session key to any command with the `--session` option. ex:
$ bw list items --session {session key}

// 세션키 환경변수 등록
$ export BW_SESSION="{session key}"

// 세션키 환경변수 확인
$ env
...
BW_SESSION={session key} 

 

• 로그 아웃 하기

$ bw logout
You have logged out.

• git clone bitwarden-iterm-helper 

$ cd ~
$ git clone https://github.com/creatorKoo/bitwarden-iterm-helper.git

• bitwarden에 서버 정보 등록하기 

 

$ ssh ssh-user-name:ssh-password@ssh.server.domain.com

• iTerm2 프로필 Command 설정 및  Trigger 설정하기

// 서버 비밀번호 조회
$ ~/bitwarden-iterm-helper/get_pw.sh "{awesome-server}"

// 서버 TOTP 조회
$ ~/bitwarden-iterm-helper/get_otp.sh "{awesome-server}"

• bitwarden 정보 추가시 bitwarden-cli 동기화 하기
  

  $ bw sync
  Syncing complete.

마무리 

cli를 통해서 간단한 명령어로 비밀번호 및 2차인증을 사용할 수 있는 부분에서 좋았지만 iTerm2 자체에서 지원되는 기능이 강화되면 좋을 듯 쉽다. 기존에 Authy를 잘 사용하고 있었는데 PC에서 더이상 사용할 수 없는 부분이 참 아쉽다.

 

참고

https://github.com/creatorKoo/bitwarden-iterm-helper

https://bitwarden.com/help/cli/