10.5. イベントストリームの静的な汎用一意識別子 (UUID)


静的な汎用一意識別子 (UUID) を使用してイベントストリームを設定すると、イベントストリームサービスが再作成された場合でも、Webhook URL の一貫性が維持されます。

この機能は、ファイアウォールやサードパーティーの Webhook などの外部システムを新しい URL を使用するように簡単に再設定できない障害復旧シナリオに関連しています。静的 UUID の使用を検討する際の重要な概念は次のとおりです。

障害復旧のサポート
静的 UUID により、https://your-eda-server.com/api/eda/v1/external_event_stream/{uuid}/ の形式に従う外部 Webhook URL が、サービスの再作成時に変更されないようにします。
一意性
指定する UUID は、システム内のすべての既存のイベントストリームにわたって一意である必要があります。
セキュリティー警告
静的 UUID を使用すると、Webhook URL が予測可能になり、セキュリティーが低下する可能性があります。この機能は、URL の一貫性が重要であり、強力な追加のセキュリティー対策 (強力な認証やネットワーク制限など) を実装している場合にのみ使用してください。通常の操作では、常に自動生成された (動的) UUID を使用します。

強力な認証情報タイプ (HMAC、mTLS) やネットワーク制限などの追加のセキュリティー対策が実施されていることを確認する必要があります。

10.5.1. 静的 UUID を使用したイベントストリームの更新 (API メソッド)

静的なカスタム UUID を使用する場合は、API を使用してイベントストリームを更新する必要があります。作成用の API エンドポイントは POST/api/eda/v1/event-streams/ です。

前提条件

  • Ansible Automation Platform2.6-next

手順

  1. Ansible Automation Platform にログインします。
  2. ナビゲーションパネルから Overview を選択します。
  3. URL で、Overview を API エンドポイント api/eda/v1/ に置き換えます (例: https://<platformURL>.com/api/eda/v1/)。Api V1 Root ページには、EDA リソース URL のリストが表示されます。

    {
        "config": "http://<aap.platform>.com/api/eda/v1/config/",
        "status": "http://<aap.platform>/api/eda/v1/status/",
        "openapi-json": "http://<aap.platform>/api/eda/v1/openapi.json",
        "openapi-yaml": "http://<aap.platform>/api/eda/v1/openapi.yaml",
        "openapi-docs": "http://<aap.platform>/api/eda/v1/docs/",
        "openapi-redoc": "http://<aap.platform>/api/eda/v1/redoc/",
        "session-login": "http://<aap.platform>/api/eda/v1/auth/session/login/",
        "session-logout": "http://<aap.platform>/api/eda/v1/auth/session/logout/",
        "token-refresh": "http://<aap.platform>/api/eda/v1/auth/token/refresh/",
        "current-user": "http://<aap.platform>/api/eda/v1/users/me/",
        "project-list": "http://<aap.platform>/api/eda/v1/projects/",
        "rulebook-list": "http://<aap.platform>/api/eda/v1/rulebooks/",
        "activation-list": "http://<aap.platform>/api/eda/v1/activations/",
        "activationinstance-list": "http://<aap.platform>/api/eda/v1/activation-instances/",
        "auditrule-list": "http://<aap.platform>/api/eda/v1/audit-rules/",
        "user-list": "http://<aap.platform>/api/eda/v1/users/",
        "controller-token-list": "http://<aap.platform>/api/eda/v1/users/me/awx-tokens/",
        "credentialtype-list": "http://<aap.platform>/api/eda/v1/credential-types/",
        "edacredential-list": "http://<aap.platform>/api/eda/v1/eda-credentials/",
        "credentialinputsource-list": "http://<aap.platform>/api/eda/v1/credential-input-sources/",
        "decisionenvironment-list": "http://<aap.platform>/api/eda/v1/decision-environments/",
        "organization-list": "http://<aap.platform>/api/eda/v1/organizations/",
        "team-list": "http://<aap.platform>/api/eda/v1/teams/",
        "eventstream-list": "http://<aap.platform>/api/eda/v1/event-streams/"
    Copy to Clipboard Toggle word wrap
  4. リストの最後にある ”eventstream-list” URL をクリックします。これにより Event Stream List ページに移動します。
  5. 更新するイベントストリーム UUID の “id” を見つけてコピーします。これは、イベントストリームデータの最後にあります。

    },
    "id": *1*,
    "owner": "admin",
    "url": "https://<platformURL>/eda-event-streams/api/eda/v1/external_event_stream/bab8dddd-51cc-424f-87a4-0ed8ebe0a755/post/",
    "created_at": "2025-11-18T16:30:45.622363Z",
    "modified_at": "2025-11-18T16:30:45.622374Z",
    "test_content_type": "",
    "test_content": "",
    "test_error_message": "",
    "test_headers": "",
    "events_received": 0,
    "last_event_received_at": null
    Copy to Clipboard Toggle word wrap
  6. URL の末尾に id (例: https://<platformURL>.com/api/eda/v1/ <id#>) を貼り付けて、Enter を押します。現在の “uuid” 値を含む Event Stream Instance ページが表示されます。
  7. Event Stream Instance ページの最後にあるフォームで、“uuid” フィールドの値を任意の静的な一意文字列に更新します。
  8. Patch をクリックします。

検証

  • イベントストリームの UUID が新しい静的文字列に更新されていることを確認します。
トップに戻る
Red Hat logoGithubredditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

Red Hat ドキュメントについて

Red Hat をお使いのお客様が、信頼できるコンテンツが含まれている製品やサービスを活用することで、イノベーションを行い、目標を達成できるようにします。 最新の更新を見る.

多様性を受け入れるオープンソースの強化

Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。このような変更は、段階的に実施される予定です。詳細情報: Red Hat ブログ.

会社概要

Red Hat は、企業がコアとなるデータセンターからネットワークエッジに至るまで、各種プラットフォームや環境全体で作業を簡素化できるように、強化されたソリューションを提供しています。

Theme

© 2025 Red Hat