InfoGrab DocsInfoGrab Docs

OpenBao 유지 관리

OpenBao의 백업 및 복원, 복구 키 관리, 인증 복구 및 데이터 초기화 절차를 설명합니다.

Geo 장애 조치에 대해서는 Geo 재해 복구 를 참고합니다. OpenBao 백업 및 복원 # OpenBao는 PostgreSQL의 별도 논리 데이터베이스에 데이터를 저장합니다. 장애 발생 후 시크릿을 복원할 수 있도록 이 데이터베이스를 정기적인 GitLab 백업과 함께 백업합니다. OpenBao에 특화된 자세한 백업 및 복원 절차는 OpenBao 백업 문서 를 참고합니다. 복구 키 관리 # 복구 키 저장, 조회, 루트 토큰 생성 등 OpenBao 복구 키 관리에 대한 정보는 복구 키 관리 를 참고합니다. OpenBao 인증 복구 # GitLab은 JSON Web Token(JWT)으로 OpenBao에 인증합니다. OpenBao는 JWT의 iss (issuer)와 aud (audience) 클레임이 OpenBao가 저장한 값과 일치할 때만 JWT를 수락합니다. OpenBao는 이 값을 OpenBao를 초기화할 때와 각 프로젝트와 그룹에 GitLab Secrets Manager를 프로비저닝할 때 저장합니다. 이후 구성을 변경해도 OpenBao는 저장된 값을 업데이트하지 않습니다. 다음과 같은 경우 인증이 실패합니다. JWT audience 불일치: OpenBao URL이 변경된 경우처럼 GitLab이 OpenBao가 저장한 audience와 다른 audience를 전송합니다. 불일치를 해결하려면 JWT audience를 복원 합니다. JWT issuer 불일치: OpenBao를 초기화한 후 GitLab URL이 변경되었습니다. 불일치를 해결하려면 JWT issuer를 복원 합니다. gitlab:secrets_management:openbao:root_token:generate 는 GitLab JWT로 OpenBao에 인증하므로 루트 토큰으로는 인증 문제를 해결할 수 없습니다. audience나 issuer를 복원할 수 없다면 OpenBao 데이터를 초기화 합니다. 초기화하면 저장된 모든 시크릿이 삭제됩니다. 저장된 JWT audience 찾기 # 저장된 audience는 OpenBao를 처음 초기화했을 때의 OpenBao URL입니다. 저장된 JWT audience를 찾으려면 다음과 같이 합니다. 후보를 찾습니다. 이전 복원에서 global.openbao.jwt_audience 를 설정했다면 그 값이 저장된 audience입니다. 다음 단계에서 그 값을 확인합니다. 그렇지 않다면 후보를 나열합니다. Helm은 최근 차트 리비전의 렌더링된 구성을 보관하므로, 각 리비전의 bound_audiences 값을 나열합니다. for revision in $(helm history gitlab -n gitlab | awk 'NR > 1 { print $1 }'); do echo "$revision: $(helm get manifest gitlab -n gitlab --revision "$revision" | grep -o '"bound_audiences": "[^"]*"')" done 서로 다른 값 하나하나가 후보입니다. 기본적으로 Helm은 최근 1