Secret Store 연동

Overview

Integrations 메뉴에서는 Secret Store의 정보를 입력하고 관리합니다.

Secret Store 를 통해 안전하게 DB 및 서버 인증 정보를 관리할 수 있고, 사용자에게 직접적인 인증 정보 노출 없이 DB 및 서버에 안전하게 접속이 가능합니다. 커넥션 접속 정보 저장 시 인증정보를 QueryPie 내부에 저장하는 것이 아닌 Secret Store 에서 가져와 인증할 수 있도록 설정할 수 있습니다.

실제 Secret Store의 사용 여부는 Security메뉴에서 설정할 수 있습니다. 다음은 QueryPie에서 지원 중인 Secret Store 서비스 목록입니다.

• HashiCorp Vault
• Microsoft Active Directory
• AWS Secrets Manager (QueryPie ACP 버전 11.6.0 버전 부터 사용가능)

HashiCorp Vault 연동 정보 입력하기

1. HashiCorp Vault 페이지에서 Connect 버튼을 클릭합니다.
2. Name : Secret Store의 명칭을 입력합니다.
3. Service: 이 Secret Store의 연결을 사용할 서비스(DB 또는 Server)를 선택합니다.
   1. Service 항목은 저장 후 변경이 불가능합니다.
4. 선택된 Secret Store 타입에 따라 연동을 위한 인증 정보를 입력합니다.
   1. Server Address : Secret Store 서버의 주소를 입력합니다.
   2. Auth Method : QueryPie 와 Vault 의 인증 방식을 선택합니다.
      1. Token : Vault에서 발급받은 Token을 이용한 인증 방식입니다.
      2. AppRole : Role ID와 Secret ID 조합을 이용한 인증 방식입니다.
         1. Role ID : AppRole 인증 시 필수로 사용되는 고유 식별자입니다.
         2. Secret ID : 로그인 시 필요한 비밀 Credentials입니다.
   3. Secret Engine : Hashicorp Vault 의 Secret Engine 타입을 선택합니다.
      1. 현재 버전 기준 Database, K/V, SSH OTP, SSH CA 엔진 4가지를 지원합니다.
      2. Secret Engine 은 저장 후 변경이 불가능합니다.
      3. 변경하고자 하는 경우 모든 커넥션의 Secret Store 설정을 해제한 뒤 재설정이 필요합니다.
5. Namespace : Vault의 Namespace를 입력합니다.
   1. Namespace 항목은 저장 후 변경이 불가능합니다.
6. 필요한 모든 정보를 입력했다면, Verify integration 버튼을 클릭합니다.
   1. 모든 정보가 올바르게 입력되었다면 ✔️ Success 메시지가 표시됩니다.
7. OK 버튼을 클릭하여 저장합니다.

HashiCorp Vault 연동 정보 조회하기

1. Administrator > General > System > Integrations > 메뉴로 진입합니다.
2. Secret Store 하단의 HashiCorp Vault 타일을 클릭합니다.
3. 현재 연동 중인 Vault 목록을 조회할 수 있습니다.

HashiCorp Vault 연동 정보 삭제하기

Administrator > General > Security 페이지 내 Secret Store 활성화를 해제하기 위해서는 먼저 연동되어 있는 Vault 정보를 모두 삭제해야 합니다. 다음은 연동 정보를 삭제하는 방법입니다.

1. 테이블에서 체크박스를 선택하면 헤더 영역에 Delete 버튼이 나타납니다. 버튼을 클릭합니다.
2. 삭제 확인 모달에서 OK 버튼을 클릭합니다.
3. 리스트 상에서, 선택한 리스트 아이템의 삭제 완료를 확인합니다.

Active Directory 연동 정보 입력하기

1. Active Directory 페이지에서 + Connect 버튼을 클릭합니다.
2. 연동에 필요한 정보를 입력합니다.
   1. Name: 연동 정보의 명칭을 입력합니다.
   2. Domain Information: 암호를 관리할 Active Directory의 도메인 이름을 입력합니다.
   3. Server Address: Active Directory 서버의 주소를 입력합니다.
   4. Auth Type: 인증 방식은 LDAPS로 고정되어 있습니다.
   5. Port: LDAPS 포트 번호를 입력합니다. (기본값: 636)
   6. Admin Account: AD에 연결할 관리자 계정의 사용자 이름을 입력합니다. 이 계정은 다른 사용자의 암호를 변경할 수 있는 권한이 필요합니다.
   7. Admin Password: 관리자 계정의 암호를 입력합니다.
3. 모든 정보를 입력했다면, Verify Integration 버튼을 클릭하여 AD 서버와의 연동을 확인합니다.
4. 연동 확인 성공 메시지가 표시되면 Save 버튼을 클릭하여 설정을 완료합니다.

Active Directory 연동 정보 조회하기

1. Admin > General > System > Integrations > Secret Stores 메뉴로 진입합니다.
2. Microsoft Active Directory (AD) 타일을 클릭합니다.
3. 현재 연동 중인 AD 정보 목록을 조회할 수 있습니다.

Active Directory 연동 정보 삭제하기

1. 삭제할 AD 정보의 테이블 항목에서 체크박스를 선택하면 헤더 영역에 Delete 버튼이 나타납니다. 해당 버튼을 클릭합니다.
2. 삭제 확인 모달에서 OK 버튼을 클릭합니다.
3. 목록에서 선택한 항목이 삭제되었는지 확인합니다.

AWS Secrets Manager 연동 정보 입력하기

1. Admin > General > System > Integrations > Secret Stores 메뉴로 이동합니다.
2. AWS Secrets Manager 타일을 선택합니다.
3. + Connect 버튼을 클릭합니다.
4. Secret Store 생성을 위한 정보를 입력합니다.
   • Name : Secret Store의 명칭을 입력합니다.
   • Region : AWS Region을 선택합니다 (예: ap-northeast-2).
   • Auth Method : 인증 방식을 선택합니다.
     1. IAM Role : QueryPie ACP 실행 환경에 구성된 기본 AWS 자격 증명을 사용합니다. 별도의 인증 정보 입력이 필요하지 않습니다.
     2. Access Key : AWS IAM Access Key로 인증합니다. 다음 항목을 추가로 입력합니다.
        • Access Key ID : AWS IAM Access Key ID를 입력합니다.
        • Secret Access Key : AWS IAM Secret Access Key를 입력합니다.
     3. Assume Role : Role ARN을 사용하여 Assume Role 방식으로 인증합니다. 필요에 따라 Cross-account 접근에도 사용할 수 있습니다. 다음 항목을 추가로 입력합니다.
        • Role ARN : IAM Role ARN을 입력합니다 (예: arn:aws:iam::123456789012:role/MyRole).
        • External ID : (선택) Cross-account 접근과 관련된 External ID를 입력합니다.
5. Verify Integration 버튼을 클릭하여 AWS 연결 상태를 검증합니다.
6. OK 버튼을 클릭하여 저장합니다.

AWS Screts Manager 연동 정보 조회하기

1. Admin > General > System > Integrations > Secret Stores 메뉴로 이동합니다.
2. AWS Secrets Manager 타일을 선택합니다.
3. 등록된 Secret Store 목록이 표시됩니다. 목록의 필드에 대한 설명은 아래와 같습니다.
   • Name : Secret Store의 명칭입니다.
   • Region : AWS region입니다.
   • Auth Method : AWS Secrets Manager의 인증방식입니다. (IAM Role / Access Key / Assume Role ).
   • Last Access At : 마지막으로 Secret을 조회한 일시입니다.

AWS Screts Manager 연동 정보 삭제하기

1. Admin > General > System > Integrations > Secret Stores 메뉴로 이동합니다.
2. AWS Secrets Manager 타일을 선택합니다.
3. 상세 화면에서 삭제할 대상을 체크한 뒤 Delete 버튼을 클릭합니다.
4. 확인 팝업에서 OK 를 클릭합니다.