Telegram (Webhook 経由)

Telegram と統合して、 Tenable One Cloud Exposure 検出結果を Webhook 経由で Telegram に送信します。次の手順を実行して統合を完了します。AWS を仲介として使用して、Teams で読み取れるように Tenable データを変換します。

次の手順

  • 検出結果のデータ送信を開始するには、 自動化 を設定するか、統合を追加した後に 検出結果に基づくアクションのトリガー する必要もあります。すべての統合ステップを正常に完了しても、それ自体ではデータ送信はトリガーされません。

BotFather で新しい Telegram ボットを作成する

ボットを Telegram に接続する前に、BotFather で Telegram ボットを作成します。

注意: これらの手順のほとんどは Telegram アプリで実行できますが、最後の手順では Telegram Web を使用する必要があります。
  1. Telegram で、 BotFather との新しい会話を開始します。

  2. 次のメッセージを送信して、新しい Telegram ボットを作成します。

    /newbot

  3. プロンプトが表示されたら、ボットの名前を入力します。Telegram ボットに一意のユーザー名を付けます。

    注意: ボット名は「bot」という単語で終わる必要があります (大文字と小文字は区別しません)。

  4. 後の手順で使用するため、Telegram ボットのアクセストークンをコピーして保存します。

    The BotFather message with the new bot's HTTP API token

  5. (オプション)ボットのプロファイル画像を設定します (たとえば、 Tenable ロゴを使用するなど)。
    • /setuserpicのメッセージを BotFather に送信します。
    • Tenable用に作成したボットを選択します。
    • プロファイル画像を送信します。
  6. Telegram で新しいグループを作成します。
  7. 前に作成したボットを選択し、関連するユーザーを追加します。
  8. (オプション)グループに名前を付けて画像を追加し、[作成] をクリックします。

  9. Telegram Web で、新たに作成したグループをクリックします。ブラウザの URL で、チャット ID (文字「g」の後に表示される数字) を特定して保存します。後で使用するため、この値を保存します。

    注意: ここまでの手順は Telegram アプリで実行できますが、この手順では Telegram Web を使用する必要があります。

A Telegram Web URL, with the chat ID highlighted

AWS を使用した CloudFormation スタックの作成

次の手順を実行して、AWS を使用して検出結果ペイロードを Tenable から Telegram 通知に適した形式に解析します。

SSM パラメーターを設定する

SSM パラメーターを設定する方法

  1. AWS コンソールで、 Systems Manager > パラメーターストアに移動します。
  2. [パラメーターの作成] をクリックし、次の詳細を入力します。

    • 名前: TelegramErmeticToken

      重要: 統合を機能させるには、名前を正確に入力する必要があります。
    • 階層: Standard
    • 入力: SecureString
    • KMS キーソース: デフォルト値のままにします
    • データタイプ: テキスト
    • 値: 前に設定した Telegram ボットアクセストークンを入力します
  3. [パラメーターの作成] をクリックします。
  4. [パラメーターの作成] をクリックして別のパラメーターを追加し、次の詳細を入力します。

    • 名前: TelegramErmeticChatID

      重要: 統合を機能させるには、名前を正確に入力する必要があります。
    • 階層: Standard
    • 入力: SecureString
    • KMS キーソース: デフォルト値のままにします
    • データタイプ: テキスト
    • 値: 前に設定した Telegram チャット ID を入力します
  5. [パラメーターの作成] をクリックします。

CloudFormation スタックの作成

サポートへの問い合わせ。 この手順で必要となる次のファイルを取得します。

  • CloudFormation テンプレートファイル
  • lambda 関数用の .zip ファイルデプロイメントパッケージ

CloudFormation スタックを作成する方法

  1. AWS コンソールで、[CloudFormation] > [スタック] に移動し、[スタックの作成 (新しいリソースを使用可能 - 標準)] をクリックします。[Create stack] (スタックの作成) ウィザードが開きます。
  2. 前提条件 - テンプレートの準備 セクションで、 テンプレートの準備ができています を選択します。
  3. [テンプレートの指定] セクションで、[テンプレート ファイルのアップロード] を選択し、[ファイルの選択] をクリックして、テクニカル サポートから提供された テンプレート ファイルをアップロードします。
  4. [次へ] をクリックします。
  5. クラウド形成スタックの スタック名 を入力します。例: Tenable-Telegram-Webhook-CloudFormation。

  6. (オプション) スタックはいくつかのリソース (Lambda 関数、API ゲートウェイ、IAM ロール、API キー) を作成します。リソースの名前を変更するか、デフォルト名を使用できます。[次へ] をクリックします。

    The CloudFormation Specify stack details page, with the stack name and resource name parameters

  7. [スタック オプションの構成] ページで、[次へ] をクリックします (このページには、当面のタスクを完了するために必須のフィールドはありません)。
  8. [Review] (レビュー) ページで、ページ下部のチェックボックス (AWS CloudFormation がカスタム名で IAM リソースを作成する場合があることを承認します) を確認し、[Submit] ( 送信) をクリックします。
  9. スタックの作成が完了したら [Resources] タブに移動し、Lambda関数の 物理ID リンクをクリックします。
  10. [コード] タブに移動し、[コード ソース] セクション > [.zip ファイルからアップロード] をクリックし、テクニカル サポートから提供されたErmetic_Telegram_lambda_code .zip ファイルをアップロードします。
  11. [Configuration] ( 構成 ) タブに移動します。次のステップのこのタブから、Lambda トリガー情報を入力する必要があります。

  12. APIゲートウェイトリガーを見つけ、[詳細] をクリックして追加情報を表示します。次のステップの Tenable で Webhook 統合を作成するときに必要になるため、API エンドポイントと API キーをコピーして保存します。

    The Lambda API Gateway trigger, with the API endpoint and API key highlighted

Tenable で Telegram Webhook 統合を作成する

Webhook 統合を作成する方法

  1. クラウドサイバーエクスポージャーコンソールで、[Settings > Integrations] に移動し、[Webhook] をクリックします。
  2. [開始] をクリックします。
  3. Tenable で Webhook の表示名を入力します。例: Telegram Webhook。
  4. Webhook URL には、CloudFormation スタックの作成ときに作成されたラムダトリガーの API ゲートウェイの API エンドポイント URL を入力します。

  5. [HTTP ヘッダー] で、次の詳細を入力します。

    The Lambda API Gateway trigger, with the API endpoint and API key highlighted

  6. [保存] をクリックします。

    自動化を作成したり、手動でアクションを検出結果に基づくアクションのトリガーしたりして、クラウドサイバーエクスポージャー検出結果データを Webhook 経由で Telegram に送信できるようになりました。