> ## Documentation Index
> Fetch the complete documentation index at: https://translations.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# イベントストリーム

> Auth0 テナント内で購読中のイベントタイプが発生した際に非同期で実行される イベントストリーム Actions について説明します。ユーザーのトランザクションに影響を与えることなく、イベントを外部システムに転送できます。

`event-stream` トリガーは、Auth0 テナント内で特定のイベントが発生したときに実行されます。各 イベントストリーム Action はイベントストリームに関連付けられ、あらかじめ定義された[イベントタイプ](/docs/ja-jp/events) (ログインの成功、パスワードの変更、ユーザーの削除など) を監視します。購読しているイベントが発生すると、Action がトリガーされます。Login または Pre-Registration Actions とは異なり、イベントストリーム Actions はバックグラウンドで実行され、ユーザーの主要なトランザクションには影響しません。

<Frame>
  <img src="https://mintcdn.com/translations/xwVvTWJUElMm5YAK/docs/images/customize/actions/event-stream-triggers.svg?fit=max&auto=format&n=xwVvTWJUElMm5YAK&q=85&s=83ad07ff0459e962f49e6a9ef62dd886" alt="イベントストリーム Actions がテナントイベントを購読して処理する仕組みを示す図。" width="666" height="150" data-path="docs/images/customize/actions/event-stream-triggers.svg" />
</Frame>

このフローの Actions はノンブロッキング (非同期) です。Auth0 パイプラインは Action の完了を待たずに実行を続けるため、Action の結果は Auth0 トランザクションに影響せず、ユーザー体験のレイテンシにも影響を与えません。

<div id="references">
  ## 参照
</div>

* [イベントオブジェクト](/docs/ja-jp/customize/actions/reference/event-stream/event-stream-event-object): イベントストリームメッセージとActionの実行の両方に関するコンテキストを提供します。
* [API オブジェクト](/docs/ja-jp/customize/actions/reference/event-stream/event-stream-api-object): フローの動作を変更するためのメソッドを提供します。

<div id="common-use-cases">
  ## 一般的なユースケース
</div>

<div id="synchronize-events-to-an-external-service">
  ### 外部サービスにイベントを同期する
</div>

event-stream Action を使用すると、カスタムロジックに基づいて特定のイベントを外部サービスに通知できます。次の Action は、保存されている API key を使用して、イベントメッセージを外部サービスに安全に転送する方法を示しています。

```javascript lines theme={null}
/**
 * @param {Event} event - 受信したイベントの詳細。
 * @param {EventStreamAPI} api - イベントストリーム処理を定義するためのメソッドとユーティリティ。
 */
exports.onExecuteEventStream = async (event, api) => {
  const message = event.message;

  try {
    await fetch(event.secrets.URL, {
      method: 'POST',
      headers: {
        'X-API-Key': event.secrets.API_KEY,
      },
      body: JSON.stringify(message),
    });
  } catch (err) {
    throw new Error('External service failure');
  }

  return;
};
```

<div id="learn-more">
  ## 詳細はこちら
</div>

* [初めてのActionを作成する](/docs/ja-jp/customize/actions/write-your-first-action)
* [イベントストリームを作成する](/docs/ja-jp/customize/events/create-an-event-stream#create-an-event-stream-actions)