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

# シークレットイベント通知
<a name="secret-event-notifications"></a>

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

## EventBridge が Secrets Manager イベントをルーティングする方法
<a name="eventbridge-routes-secretsmanager-events"></a>

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

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

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

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

![AWS サービスは EventBridge のデフォルトイベントバスにイベントを送信します。イベントがルールのイベントパターンに一致すると、EventBridge はそのルールで指定されたターゲットに、イベントを送信します。](https://docs.aws.amazon.com/ja_jp/secretsmanager/latest/userguide/images/eventbridge-integration-how-it-works.png)


詳細については、*EventBridge ユーザーガイド*」の[「ルールの作成](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-create-rule.html)」を参照してください。

## Secrets Manager の イベント
<a name="supported-events-secretsmanager"></a>

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

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


| イベントの詳細のタイプ | 説明 | 
| --- | --- | 
| [シークレットラベルが更新されました](event-detail-secret-label-updated-secretsmanager.md) | Secrets Manager は、ステージングラベルを新しいバージョンのシークレットに移動しました。 | 

### イベントの構造
<a name="eventbridge-event-structure-secretsmanager"></a>

 AWS サービスからのすべてのイベントには、次の 2 種類のデータが含まれます。
+ イベントのソースである AWS サービス、イベントが生成された時刻、イベントが発生したアカウントとリージョンなど、イベントに関するメタデータを含む一般的なフィールドのセット。これらの一般的なフィールドの定義については、「*Amazon EventBridge イベントリファレンス*」の「[イベントの構造](https://docs.aws.amazon.com/eventbridge/latest/ref/overview-event-structure.html)」を参照してください。
+ `detail` フィールドには、その特定のサービスイベントに固有のデータが含まれます。

## Secrets Manager イベントに一致するイベントパターンの作成
<a name="eventbridge-event-delivery-filter-secretsmanager"></a>

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

各イベントパターンは JSON 形式のオブジェクトで、以下が含まれています。
+ イベントを送信するサービスを識別する `source` 属性。Secrets Manager イベントの場合、ソースは です`aws.secretsmanager`。
+ (オプション): 照合するイベント名の配列を含む `detail-type` 属性。
+ (オプション): 照合対象となるその他のイベントデータを含む `detail` 属性。

次のイベントパターンは、`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 ユーザーガイド」の「イベント*[パターン](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-event-patterns.html)」を参照してください。

イベントパターンの作成は、ルールを作成する大規模なプロセスのステップです。詳細については、*EventBridge ユーザーガイド*」の[「ルールの作成](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-create-rule.html)」を参照してください。