InfoGrab DocsInfoGrab Docs

복구 키 관리

요약

복구 키는 OpenBao의 비상 자격 증명입니다. 복구 키는 시크릿 조회나 네임스페이스 프로비저닝 같은 일반적인 운영 작업에는 사용되지 않습니다. 복구 키로는 OpenBao 데이터베이스에 저장된 데이터를 복호화할 수 없습니다.

복구 키는 OpenBao의 비상 자격 증명입니다. 권한 있는 OpenBao 작업을 위한 루트 토큰을 생성하는 데 사용합니다.

복구 키는 시크릿 조회나 네임스페이스 프로비저닝 같은 일반적인 운영 작업에는 사용되지 않습니다. 높은 권한을 가진 자격 증명으로 취급하고 안전하게 보관합니다.

복구 키로는 OpenBao 데이터베이스에 저장된 데이터를 복호화할 수 없습니다. OpenBao의 모든 데이터는 구성된 언실(unseal) 메커니즘, 즉 gitlab-openbao-unseal 쿠버네티스 시크릿에 저장된 정적 키 또는 외부 KMS에 의해 보호됩니다. 언실 메커니즘은 복구 키와 별도로 백업합니다.

이 페이지의 명령을 실행하려면 toolbox pod의 이름이 필요합니다. 확인하려면 다음을 실행합니다:

kubectl get pods -n gitlab -lapp=toolbox

이후 명령에서 <toolbox-pod-name> 자리에 해당 pod 이름을 사용합니다.

복구 키 저장#

초기 설정 중 OpenBao를 초기화한 직후에 이 명령을 한 번 실행합니다:

kubectl exec -n gitlab -it -c toolbox <toolbox-pod-name> -- \
  gitlab-rake "gitlab:secrets_management:openbao:recovery_key:store"

이 명령은 OpenBao에서 복구 키를 생성하고 GitLab 데이터베이스에 암호화하여 저장합니다.

복구 키는 한 번만 생성할 수 있습니다. recovery_key:store를 두 번 실행하거나 recovery_key:fetch를 실행한 후에는 다시 실행할 수 없습니다.

이 명령을 실행하기 전까지, OpenBao는 pod를 재시작할 때마다 다음 경고를 로그에 기록합니다: [WARN] core: post-unseal upgrade seal keys failed: error="no recovery key found". 키를 저장하면 경고가 사라집니다.

저장된 복구 키 조회#

GitLab 데이터베이스에서 복구 키를 가져와 확인하려면 다음을 실행합니다:

kubectl exec -n gitlab -it -c toolbox <toolbox-pod-name> -- \
  gitlab-rake "gitlab:secrets_management:openbao:recovery_key:show"

이 명령은 키를 평문으로 표시하기 전에 확인을 요청합니다. 출력 결과를 안전하게 보관합니다. 로그에 기록하거나 보안 채널 외부에서 공유하지 마세요.

복구 키를 저장하지 않고 가져오기#

recovery_key:fetch를 사용하면 복구 키를 생성하여 GitLab 데이터베이스에 저장하지 않고 터미널에 표시합니다. 비밀번호 관리자나 하드웨어 보안 모듈 같은 외부 시스템에 키를 저장할 때 이 작업을 사용합니다.

복구 키는 한 번만 생성할 수 있습니다. recovery_key:fetch를 두 번 실행하거나 recovery_key:store를 실행한 후에는 다시 실행할 수 없습니다.

kubectl exec -n gitlab -it -c toolbox <toolbox-pod-name> -- \
  gitlab-rake "gitlab:secrets_management:openbao:recovery_key:fetch"

이 작업은 키를 생성하여 표시하기 전에 확인을 요청합니다. 키는 평문으로 표시됩니다.

복구 키로 루트 토큰 생성#

GitLab이 대신 수행할 수 없는 권한 있는 OpenBao 작업을 수행해야 할 때 루트 토큰을 생성합니다. 루트 토큰은 모든 OpenBao 작업과 네임스페이스에 대한 무제한 액세스 권한을 가집니다.

사전 요구 사항:

  • 툴박스 pod와 OpenBao pod에서 kubectl exec를 실행할 권한이 있어야 합니다.
  • recovery_key:store로 저장한 복구 키, 또는 recovery_key:fetch를 실행한 뒤 저장해 둔 복구 키가 있어야 합니다.
  • GitLab에서 OpenBao로의 인증이 작동해야 합니다. 인증이 실패하면 JWT 인증 실패를 참고합니다.

루트 토큰을 생성하려면 다음과 같이 합니다:

  1. Rake 작업을 실행합니다:

    kubectl exec -n gitlab -it -c toolbox <toolbox-pod-name> -- \
      gitlab-rake "gitlab:secrets_management:openbao:root_token:generate"
    
  2. 작업이 확인을 요청하면 y를 입력합니다. recovery_key:store로 복구 키를 저장했다면 작업은 저장된 키를 사용합니다. 그렇지 않으면 복구 키를 입력합니다. 작업은 키를 입력하는 동안 키를 표시하지 않습니다.

    다른 루트 토큰 생성이 이미 진행 중이면, 작업은 기존 생성을 취소하고 새로 생성을 시작할지 묻습니다. 계속하려면 y를 입력합니다.

    작업이 루트 토큰을 표시합니다. 이후 단계에서 <root_token>을 이 값으로 교체합니다.

  3. OpenBao pod 이름을 확인합니다:

    kubectl get pods -n gitlab -l app.kubernetes.io/name=openbao -o name | head -1
    

    이후 단계에서 <openbao-pod-name>을 이 명령의 출력으로 교체합니다. 예: pod/gitlab-openbao-5c6dfc987d-b2wtb.

  4. 루트 토큰이 작동하는지 확인합니다:

    kubectl exec -n gitlab <openbao-pod-name> -- \
      sh -c "BAO_ADDR=http://127.0.0.1:8200 BAO_TOKEN=<root_token> bao token lookup"
    

    성공적인 응답에는 policies [root]가 포함됩니다.

  5. 필요한 권한 작업을 수행합니다. 예를 들어 ACL 정책을 변경하려면 정책을 파일로 저장하고, 파일을 편집한 다음, 파일을 OpenBao에 다시 씁니다:

    kubectl exec -n gitlab <openbao-pod-name> -- \
      sh -c "BAO_ADDR=http://127.0.0.1:8200 BAO_TOKEN=<root_token> bao policy read <policy-name>" \
      > <policy-name>.hcl
    kubectl exec -i -n gitlab <openbao-pod-name> -- \
      sh -c "BAO_ADDR=http://127.0.0.1:8200 BAO_TOKEN=<root_token> bao policy write <policy-name> -" \
      < <policy-name>.hcl
    

    -i 플래그는 편집한 파일을 표준 입력을 통해 bao policy write에 전달합니다.

  6. 루트 토큰은 만료되지 않으므로 루트 토큰을 폐기합니다:

    kubectl exec -n gitlab <openbao-pod-name> -- \
      sh -c "BAO_ADDR=http://127.0.0.1:8200 BAO_TOKEN=<root_token> bao token revoke -self"
    

복구 키 관리

GitLab v19.6
원문 보기

요약

복구 키는 OpenBao의 비상 자격 증명입니다. 복구 키는 시크릿 조회나 네임스페이스 프로비저닝 같은 일반적인 운영 작업에는 사용되지 않습니다. 복구 키로는 OpenBao 데이터베이스에 저장된 데이터를 복호화할 수 없습니다.

복구 키는 OpenBao의 비상 자격 증명입니다. 권한 있는 OpenBao 작업을 위한 루트 토큰을 생성하는 데 사용합니다.

복구 키는 시크릿 조회나 네임스페이스 프로비저닝 같은 일반적인 운영 작업에는 사용되지 않습니다. 높은 권한을 가진 자격 증명으로 취급하고 안전하게 보관합니다.

복구 키로는 OpenBao 데이터베이스에 저장된 데이터를 복호화할 수 없습니다. OpenBao의 모든 데이터는 구성된 언실(unseal) 메커니즘, 즉 gitlab-openbao-unseal 쿠버네티스 시크릿에 저장된 정적 키 또는 외부 KMS에 의해 보호됩니다. 언실 메커니즘은 복구 키와 별도로 백업합니다.

이 페이지의 명령을 실행하려면 toolbox pod의 이름이 필요합니다. 확인하려면 다음을 실행합니다:

kubectl get pods -n gitlab -lapp=toolbox

이후 명령에서 <toolbox-pod-name> 자리에 해당 pod 이름을 사용합니다.

복구 키 저장#

초기 설정 중 OpenBao를 초기화한 직후에 이 명령을 한 번 실행합니다:

kubectl exec -n gitlab -it -c toolbox <toolbox-pod-name> -- \
  gitlab-rake "gitlab:secrets_management:openbao:recovery_key:store"

이 명령은 OpenBao에서 복구 키를 생성하고 GitLab 데이터베이스에 암호화하여 저장합니다.

복구 키는 한 번만 생성할 수 있습니다. recovery_key:store를 두 번 실행하거나 recovery_key:fetch를 실행한 후에는 다시 실행할 수 없습니다.

이 명령을 실행하기 전까지, OpenBao는 pod를 재시작할 때마다 다음 경고를 로그에 기록합니다: [WARN] core: post-unseal upgrade seal keys failed: error="no recovery key found". 키를 저장하면 경고가 사라집니다.

저장된 복구 키 조회#

GitLab 데이터베이스에서 복구 키를 가져와 확인하려면 다음을 실행합니다:

kubectl exec -n gitlab -it -c toolbox <toolbox-pod-name> -- \
  gitlab-rake "gitlab:secrets_management:openbao:recovery_key:show"

이 명령은 키를 평문으로 표시하기 전에 확인을 요청합니다. 출력 결과를 안전하게 보관합니다. 로그에 기록하거나 보안 채널 외부에서 공유하지 마세요.

복구 키를 저장하지 않고 가져오기#

recovery_key:fetch를 사용하면 복구 키를 생성하여 GitLab 데이터베이스에 저장하지 않고 터미널에 표시합니다. 비밀번호 관리자나 하드웨어 보안 모듈 같은 외부 시스템에 키를 저장할 때 이 작업을 사용합니다.

복구 키는 한 번만 생성할 수 있습니다. recovery_key:fetch를 두 번 실행하거나 recovery_key:store를 실행한 후에는 다시 실행할 수 없습니다.

kubectl exec -n gitlab -it -c toolbox <toolbox-pod-name> -- \
  gitlab-rake "gitlab:secrets_management:openbao:recovery_key:fetch"

이 작업은 키를 생성하여 표시하기 전에 확인을 요청합니다. 키는 평문으로 표시됩니다.

복구 키로 루트 토큰 생성#

GitLab이 대신 수행할 수 없는 권한 있는 OpenBao 작업을 수행해야 할 때 루트 토큰을 생성합니다. 루트 토큰은 모든 OpenBao 작업과 네임스페이스에 대한 무제한 액세스 권한을 가집니다.

사전 요구 사항:

  • 툴박스 pod와 OpenBao pod에서 kubectl exec를 실행할 권한이 있어야 합니다.
  • recovery_key:store로 저장한 복구 키, 또는 recovery_key:fetch를 실행한 뒤 저장해 둔 복구 키가 있어야 합니다.
  • GitLab에서 OpenBao로의 인증이 작동해야 합니다. 인증이 실패하면 JWT 인증 실패를 참고합니다.

루트 토큰을 생성하려면 다음과 같이 합니다:

  1. Rake 작업을 실행합니다:

    kubectl exec -n gitlab -it -c toolbox <toolbox-pod-name> -- \
      gitlab-rake "gitlab:secrets_management:openbao:root_token:generate"
    
  2. 작업이 확인을 요청하면 y를 입력합니다. recovery_key:store로 복구 키를 저장했다면 작업은 저장된 키를 사용합니다. 그렇지 않으면 복구 키를 입력합니다. 작업은 키를 입력하는 동안 키를 표시하지 않습니다.

    다른 루트 토큰 생성이 이미 진행 중이면, 작업은 기존 생성을 취소하고 새로 생성을 시작할지 묻습니다. 계속하려면 y를 입력합니다.

    작업이 루트 토큰을 표시합니다. 이후 단계에서 <root_token>을 이 값으로 교체합니다.

  3. OpenBao pod 이름을 확인합니다:

    kubectl get pods -n gitlab -l app.kubernetes.io/name=openbao -o name | head -1
    

    이후 단계에서 <openbao-pod-name>을 이 명령의 출력으로 교체합니다. 예: pod/gitlab-openbao-5c6dfc987d-b2wtb.

  4. 루트 토큰이 작동하는지 확인합니다:

    kubectl exec -n gitlab <openbao-pod-name> -- \
      sh -c "BAO_ADDR=http://127.0.0.1:8200 BAO_TOKEN=<root_token> bao token lookup"
    

    성공적인 응답에는 policies [root]가 포함됩니다.

  5. 필요한 권한 작업을 수행합니다. 예를 들어 ACL 정책을 변경하려면 정책을 파일로 저장하고, 파일을 편집한 다음, 파일을 OpenBao에 다시 씁니다:

    kubectl exec -n gitlab <openbao-pod-name> -- \
      sh -c "BAO_ADDR=http://127.0.0.1:8200 BAO_TOKEN=<root_token> bao policy read <policy-name>" \
      > <policy-name>.hcl
    kubectl exec -i -n gitlab <openbao-pod-name> -- \
      sh -c "BAO_ADDR=http://127.0.0.1:8200 BAO_TOKEN=<root_token> bao policy write <policy-name> -" \
      < <policy-name>.hcl
    

    -i 플래그는 편집한 파일을 표준 입력을 통해 bao policy write에 전달합니다.

  6. 루트 토큰은 만료되지 않으므로 루트 토큰을 폐기합니다:

    kubectl exec -n gitlab <openbao-pod-name> -- \
      sh -c "BAO_ADDR=http://127.0.0.1:8200 BAO_TOKEN=<root_token> bao token revoke -self"