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 Secrets 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 Secrets Manager連携情報の削除

1. Admin > General > System > Integrations > Secret Storesメニューに移動します。
2. AWS Secrets Managerタイルを選択します。
3. 詳細画面で削除対象をチェックした後Deleteボタンをクリックします。
4. 確認ポップアップでOKをクリックします。