Twilio

このドキュメントでは、Twilio を Google SecOps と統合する方法について説明します。

Google Security Operations と連携するように Twilio を構成する

  1. Twilio アカウントにログインします。

  2. Twilio コンソールで、[Settings] > [API Keys] に移動します。

  3. [Create new API Key] を選択し、Standard API Key または Master API Key のいずれかを作成します。

  4. アカウント SID と Auth Token を含む API 認証情報は、[Settings] > [General] で確認できます。

Google SecOps で Twilio 統合を構成する

Google SecOps で統合を構成する手順の詳細については、統合を構成するをご覧ください。

統合のパラメータ

次のパラメータを使用して統合を構成します。

パラメータの表示名 種類 デフォルト値 必須 説明
インスタンス名 文字列 なし いいえ 統合を構成するインスタンスの名前。
説明 文字列 なし いいえ インスタンスの説明。
アカウント SID 文字列 なし ○ Twilio アカウントの ID。
認証トークン 文字列 なし ○ 認証に使用される Twilio トークン。
SMS 用の電話番号 文字列 なし ○ Twilio コンソールで生成できる Twilio 電話番号。
リモートで実行 チェックボックス オフ いいえ 構成した統合をリモートで実行するには、フィールドのチェックボックスをオンにします。オンにすると、リモート ユーザー(エージェント)を選択するオプションが表示されます。

操作

Ping

説明

お客様のデバイスから Twilio に接続されていることを確認します。

パラメータ

なし

実行

このアクションはすべてのエンティティに対して実行されます。

アクションの結果

スクリプトの結果

接続が確立されると、スクリプトの結果は True になります。それ以外の場合は False です。

JSON の結果
N/A

SMS を送信

説明

Twilio の REST API を使用すると、特定の Twilio 電話番号から世界中の携帯電話に発信 SMS メッセージを送信できます。1 つの Twilio 送信者(番号または英数字の送信者 ID)から複数のメッセージが同時に送信された場合、Twilio はそれらのメッセージを配信のためにキューに登録します。

パラメータ

パラメータの表示名 タイプ デフォルト値 必須 説明
電話番号 文字列 なし ○ ターゲットの電話番号。電話番号にはダイヤル コードを含める必要があります。
メッセージ 文字列 テスト ○ メッセージの内容。

実行

このアクションはすべてのエンティティに対して実行されます。

アクションの結果

スクリプトの結果
スクリプトの結果名 値のオプション 例
is_success True/False is_success:False
JSON の結果
N/A

SMS を送信して待機

説明

メッセージは、生成された Google SecOps ID(<code>)とともに送信されます。アクションは、Google SecOps ID <code> を含むレスポンスを待機します。このアクションは、SMS を送信し、以前に送信した SMS メッセージに対するレスポンスを待つ役割を果たします。このアクションでは、1 つのトリガー内で複数の送信/返信待ちアクションを有効にすることもできます。これにより、自動化された SMS テキスト会話を構築し、返信結果に基づいてさまざまなアクションを実行できます。

パラメータ

パラメータの表示名 タイプ デフォルト値 必須 説明
電話番号 文字列 なし ○ 対象の電話番号。電話番号にはダイヤル コードを含める必要があります。
メッセージ 文字列 なし ○ メッセージの内容。

実行

このアクションはすべてのエンティティに対して実行されます。

アクションの結果

スクリプトの結果
スクリプトの結果名 値のオプション 例
is_success True/False is_success:False
JSON の結果
N/A

さらにサポートが必要な場合 コミュニティ メンバーや Google SecOps のプロフェッショナルから回答を得ることができます。