コネクションでHashiCorp Vaultシークレットエンジンを使用する ​

このガイドでは、HashiCorp Vaultシークレットエンジンのシークレットを使用してWorkatoコネクションを設定する方法について説明します。

前提条件 ​

このガイドの手順を完了するには、以下が必要です。

• Workatoで:

  • 正常に確立されたワークスペースレベルのHashiCorp VaultシークレットエンジンまたはプロジェクトレベルのHashiCorp Vaultシークレットエンジンコネクションがあるアカウント。
  • 作成およびコネクションの編集権限を持つユーザーロール。

• HashiCorp Vaultで：

  • HashiCorp Vault Key-value（KV）シークレットエンジンのバージョン1または2。
  • AppRole認証メソッドが有効になっているアカウント。
  • 1つ以上のAppRoleが設定されていること。
  • Workatoにシークレットエンジン設定および使用するシークレットエンジンへの読み取りアクセス権を付与するポリシー。
  • 使用するシークレットエンジンに、;、/、?、:、@、&、=、+、$、,などの予約文字が含まれていないこと。

HashiCorp Vaultからシークレットの詳細を取得する ​

Workatoコネクションを設定する ​

シークレットマスクを使用してシークレットを追加する場合は、Workatoコネクションの認証情報に次の構文を使用します：

{{workato:sm:<key_name>:<secret_engine_name>:<secret_name>}}

• <key_name>

• キーの名前。 HashiCorp Vaultに保存されているシークレットには、複数のキーと値のペアを含めることができます。

• <secret_engine_name>

• 使用するシークレットエンジンの名前。

• <secret_name>

• 使用するシークレットの名前。 シークレットエンジンには複数のシークレットを含めることができます。

例:

{{workato:sm:password:workato_docs:zendesk}}

ここで、workato_docsはシークレットエンジン、zendeskはシークレット名です。

コネクションの設定ページで、この値全体を適切なフィールドに貼り付けます。

コネクション設定を完了する ​

接続をクリックし、このコネクションが動作していることを確認します。

シークレットキャッシュの動作 ​

WorkatoはHashiCorp Vaultから取得した認証情報を60分間キャッシュします。 この期間中は、シークレットを更新またはローテーションしても、レシピはキャッシュされた値を引き続き使用します。

キャッシュの有効期限が切れると、次回のレシピ実行時にHashiCorp Vaultから最新の値が取得されます。 変更をすぐに適用するには、Secrets managementキャッシュをクリアエンドポイントを呼び出します。 これにより、コネクションを切断して再接続しなくても、Workatoで最新の認証情報を強制的に取得できます。