翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

シークレットイベント通知

Secrets Manager は、シークレットのステージングラベルが変更されると、Amazon EventBridge にイベントを発行します。これらのイベントに一致する EventBridge ルールを作成し、ターゲットにルーティングしてイベント駆動型ワークフローを構築できます。

EventBridge が Secrets Manager イベントをルーティングする方法

以下は、EventBridge が Secrets Manager イベントと連携する方法について説明します。

多くの AWS サービスと同様に、Secrets Manager はイベントを生成して EventBridge のデフォルトイベントバスに送信します。イベントバスはルーターであり、イベントを受信して指定された送信先やターゲットに配信します。ターゲットには、他の AWS サービス、カスタムアプリケーション、SaaS パートナーアプリケーションを含めることができます。

EventBridge は、イベントバスで作成されたルールに従ってイベントを配信します。ルールごとに、フィルターまたはイベントパターンを指定して、必要なイベントのみを選択します。イベントがイベントバスに送信されるたびに、EventBridge はイベントを各ルールと比較します。イベントがルールと一致する場合、EventBridge は指定されたターゲットにイベントをルーティングします。

次の図は、EventBridge が Secrets Manager イベントをデフォルトのイベントバスから指定したターゲットにルーティングする方法を示しています。

詳細については、EventBridge ユーザーガイド」の「ルールの作成」を参照してください。

Secrets Manager の イベント

Secrets Manager は、 AWSPENDINGと を除くステージングラベルが変更されるたびに、デフォルトの EventBridge イベントバスにSecret Label Updatedイベントを発行しますAWSPREVIOUS。これにはカスタムラベルが含まれます。イベントは、すべてのシークレットに対してデフォルトで有効になっています。これらのイベントを使用するには、イベントと一致する EventBridge ルールを作成し、ターゲットにルーティングします。ターゲットとして使用できるサービスの完全なリストについては、EventBridge ユーザーガイド」の「EventBridge ターゲット」を参照してください。 EventBridge

Secrets Manager は、タグ、説明、ローテーション設定、リソースポリシーの更新などのメタデータ変更のイベントを発行しません。

イベントの構造

AWS サービスからのすべてのイベントには、次の 2 種類のデータが含まれます。

Secrets Manager イベントに一致するイベントパターンの作成

イベントパターンは、選択するイベントに含めるデータを指定するフィルターです。

各イベントパターンは JSON 形式のオブジェクトで、以下が含まれています。

次のイベントパターンは、AWSCURRENTラベルが新しいバージョンに移動したときにイベントに一致します。これは、アクティブなシークレット値が変更されたことを示します。

{
  "source": ["aws.secretsmanager"],
  "detail-type": ["Secret Label Updated"],
  "detail": {
    "labelUpdated": ["AWSCURRENT"]
  }
}

次のイベントパターンは、名前が で始まるシークレットのラベル変更のみに一致しますMyTestSecret。

{
  "source": ["aws.secretsmanager"],
  "detail-type": ["Secret Label Updated"],
  "detail": {
    "name": [{"prefix": "MyTestSecret"}]
  }
}

次のイベントパターンは、 で始まる名前のシークレットで AWSCURRENTが変更された場合にのみ一致するようにフィルターを組み合わせますprod/。

{
  "source": ["aws.secretsmanager"],
  "detail-type": ["Secret Label Updated"],
  "detail": {
    "name": [{"prefix": "prod/"}],
    "labelUpdated": ["AWSCURRENT"]
  }
}

ワークフローでカスタムステージングラベルを使用する場合は、それらのラベルのイベントを一致させることができます。次の例は、 という名前のラベルMyLabelが移動されたときに一致します。

{
  "source": ["aws.secretsmanager"],
  "detail-type": ["Secret Label Updated"],
  "detail": {
    "labelUpdated": ["MyLabel"]
  }
}

イベントパターンの記述の詳細については、「EventBridge ユーザーガイド」の「イベントパターン」を参照してください。

イベントパターンの作成は、ルールを作成する大規模なプロセスのステップです。詳細については、EventBridge ユーザーガイド」の「ルールの作成」を参照してください。