NotifyMessage コンポーネントはイベント通知を送信します。
機能
アクション | 説明 | ユースケース |
notifyByMessageCenter | メッセージセンター経由でイベント通知を送信します。メッセージタイプは "Security Message - Cloud Security Information Notification" です。 | メッセージセンターで設定した通知方法を使用して、セキュリティイベントの生成、セキュリティアラートの生成、セキュリティイベントの更新に関する通知を送信します。 |
notifyByCustom | カスタムイベント通知を送信します。 | メールアドレスおよび DingTalk グループにカスタムメッセージを送信します。 |
設定例
このトピックでは、テスト用プレイブックとしてインポートできる NotifyMessage アクションの設定例を示します。可視化フローエディターを使用して、各アクションの設定パラメータを把握し、テストできます。これにより、コンポーネントのロジックと使用方法をすばやく習得できます。インポート手順については、プレイブックのインポートをご参照ください。
次に進む前に、サンプルデータを JSON ファイルとして保存してください。
サンプルデータ
{
"cells": [
{
"position": {
"x": -660,
"y": -170
},
"size": {
"width": 36,
"height": 36
},
"attrs": {
"body": {
"fill": "white",
"strokeOpacity": 0.95,
"stroke": "black",
"strokeWidth": 2
},
"label": {
"text": "start",
"fontSize": 12,
"refX": 0.5,
"refY": "100%",
"refY2": 4,
"textAnchor": "middle",
"textVerticalAnchor": "top"
}
},
"visible": true,
"shape": "circle",
"id": "58d87b7d-28d9-4f0e-b135-4adc4f1a70e4",
"zIndex": 1,
"data": {
"nodeType": "startEvent",
"appType": "basic",
"nodeName": "start",
"icon": "icon-circle",
"description": "プレイブックの開始ノードです。プレイブックには開始ノードが 1 つだけ必要です。プレイブックの入力データを設定する必要があります。"
},
"markup": [
{
"tagName": "circle",
"selector": "body"
},
{
"tagName": "text",
"selector": "label"
}
],
"isNode": true
},
{
"shape": "custom-edge",
"zIndex": 1,
"id": "5293c3f9-e1c9-4a49-b0eb-635067dc67e8",
"data": {
"nodeType": "sequenceFlow",
"appType": "basic",
"isRequired": true,
"icon": "icon-upper-right-arrow"
},
"isNode": false,
"source": {
"cell": "58d87b7d-28d9-4f0e-b135-4adc4f1a70e4"
},
"target": {
"cell": "88d3ff93-4f11-4d82-b43b-31dfd0530774"
},
"visible": true,
"router": {
"name": "manhattan",
"args": {
"padding": 5,
"excludeHiddenNodes": true,
"excludeNodes": [
"clone_node_id"
]
}
},
"vertices": [ ]
},
{
"position": {
"x": -70,
"y": -170
},
"size": {
"width": 36,
"height": 36
},
"attrs": {
"body": {
"fill": "white",
"strokeOpacity": 0.95,
"stroke": "black",
"strokeWidth": 2
},
"path": {
"r": 12,
"refX": "50%",
"refY": "50%",
"fill": "black",
"strokeOpacity": 0.95,
"stroke": "black",
"strokeWidth": 4
},
"label": {
"text": "end",
"fontSize": 12,
"refX": 0.5,
"refY": "100%",
"refY2": 4,
"textAnchor": "middle",
"textVerticalAnchor": "top"
}
},
"visible": true,
"shape": "circle",
"id": "317dd1be-2d20-460e-977e-1fc936ffb583",
"zIndex": 1,
"data": {
"nodeType": "endEvent",
"appType": "basic",
"nodeName": "end",
"icon": "icon-radio-off-full",
"description": "end"
},
"markup": [
{
"tagName": "circle",
"selector": "body"
},
{
"tagName": "circle",
"selector": "path"
},
{
"tagName": "text",
"selector": "label"
}
],
"isNode": true
},
{
"position": {
"x": -551,
"y": -185
},
"size": {
"width": 137,
"height": 66
},
"view": "react-shape-view",
"attrs": {
"label": {
"text": "NotifyMessage_1"
}
},
"shape": "activity",
"id": "88d3ff93-4f11-4d82-b43b-31dfd0530774",
"data": {
"componentName": "NotifyMessage",
"appType": "component",
"nodeType": "action",
"icon": "https://img.alicdn.com/tfs/TB1mO0AeAL0gK0jSZFAXXcA9pXa-200-200.svg",
"ownType": "sys",
"zIndex": 1,
"tenantId": "baba",
"customInput": false,
"description": "メッセージセンターの通知機能です。",
"id": 0,
"name": "notifyByMessageCenter",
"operateType": "general",
"output": [
{
"dataType": "String",
"name": "message",
"tags": ""
},
{
"dataType": "Boolean",
"name": "status",
"tags": ""
}
],
"parameters": [
{
"dataType": "String",
"defaultValue": "",
"description": "",
"enDescription": "",
"name": "aliuid",
"needCascader": false,
"required": true,
"tags": ""
},
{
"dataType": "String",
"defaultValue": "",
"description": "チャネルを選択しない場合、すべてのチャネルで通知が送信されます。",
"enDescription": "",
"formConfig": "{\"component\":\"Select\",\"options\":{\"selectMode\":\"pureSelect\",\"remote\":false,\"optionList\":[{\"label\":\"SMS\",\"value\":\"sms\"},{\"label\":\"Email\",\"value\":\"email\"},{\"label\":\"webhook\",\"value\":\"webhook\"},{\"label\":\"Internal Message\",\"value\":\"pmsg\"}],\"mode\":\"multiple\",\"labelKey\":\"label\",\"valueKey\":\"value\"}}",
"name": "channelTypeList",
"needCascader": false,
"required": false,
"tags": ""
},
{
"dataType": "String",
"defaultValue": "",
"description": "メッセージイベントの ID。",
"enDescription": "",
"name": "eventId",
"needCascader": false,
"required": true,
"tags": ""
},
{
"dataType": "String",
"defaultValue": "",
"description": "パラメータ変数。",
"enDescription": "",
"name": "params",
"needCascader": false,
"required": false,
"tags": ""
},
{
"dataType": "String",
"defaultValue": "",
"description": "コンソールの言語。",
"enDescription": "",
"name": "lang",
"needCascader": false,
"required": false,
"tags": ""
}
],
"riskLevel": 2,
"nodeName": "NotifyMessage_1",
"actionName": "notifyByMessageCenter",
"actionDisplayName": "notifyByMessageCenter",
"cascaderValue": [ ],
"valueData": {
"lang": "en",
"channelTypeList": [ ],
"eventId": "yundun_soar_incident_generate",
"aliuid": "1766xxxx",
"params": "{\"incidentName\":\"Event Generation Test\",\"incidentID\":\"xxx\",\"startTime\":\"2025-02-03 00:00:00\"}"
}
},
"zIndex": 1
},
{
"shape": "custom-edge",
"zIndex": 1,
"id": "6444c559-f58d-4d0c-8fdc-6988af2f766d",
"data": {
"nodeType": "sequenceFlow",
"appType": "basic",
"isRequired": true,
"icon": "icon-upper-right-arrow"
},
"isNode": false,
"visible": true,
"router": {
"name": "manhattan",
"args": {
"padding": 5,
"excludeHiddenNodes": true,
"excludeNodes": [
"clone_node_id"
]
}
},
"source": {
"cell": "88d3ff93-4f11-4d82-b43b-31dfd0530774"
},
"target": {
"cell": "6e34b2ec-3ac4-4f4c-8d0a-3cbebb00bd64"
},
"vertices": [ ]
},
{
"position": {
"x": -329,
"y": -185
},
"size": {
"width": 137,
"height": 66
},
"view": "react-shape-view",
"attrs": {
"label": {
"text": "NotifyMessage_2"
}
},
"shape": "activity",
"id": "6e34b2ec-3ac4-4f4c-8d0a-3cbebb00bd64",
"data": {
"componentName": "NotifyMessage",
"appType": "component",
"nodeType": "action",
"icon": "https://img.alicdn.com/tfs/TB1mO0AeAL0gK0jSZFAXXcA9pXa-200-200.svg",
"ownType": "sys",
"zIndex": 1,
"tenantId": "baba",
"customInput": true,
"description": "DingTalk とメールを使用して通知を送信します。",
"id": 0,
"name": "notifyByCustom",
"operateType": "general",
"output": [
{
"dataType": "String",
"name": "message"
},
{
"dataType": "Boolean",
"name": "status"
}
],
"parameters": [
{
"dataType": "String",
"defaultValue": "",
"description": "",
"name": "emailTitle",
"needCascader": false,
"required": false
},
{
"dataType": "String",
"defaultValue": "",
"description": "",
"name": "receivers",
"needCascader": false,
"required": false
},
{
"dataType": "String",
"defaultValue": "",
"description": "",
"name": "telephone",
"needCascader": false,
"required": false
},
{
"dataType": "String",
"defaultValue": "",
"description": "",
"name": "telephonecontext",
"needCascader": false,
"required": false
},
{
"dataType": "String",
"defaultValue": "",
"description": "",
"name": "dingding",
"needCascader": false,
"required": false
},
{
"dataType": "String",
"defaultValue": "",
"description": "",
"name": "dingdingcontext",
"needCascader": false,
"required": false
},
{
"dataType": "String",
"defaultValue": "",
"description": "",
"name": "sms",
"needCascader": false,
"required": false
},
{
"dataType": "String",
"defaultValue": "",
"description": "",
"name": "smscontext",
"needCascader": false,
"required": false
},
{
"dataType": "String",
"defaultValue": "",
"description": "",
"name": "email",
"needCascader": false,
"required": false
},
{
"dataType": "String",
"defaultValue": "",
"description": "",
"name": "emailcontext",
"needCascader": false,
"required": false
},
{
"dataType": "String",
"defaultValue": "",
"description": "",
"name": "customReceiver",
"needCascader": false,
"required": false
},
{
"dataType": "String",
"defaultValue": "",
"description": "",
"name": "jsonInput",
"needCascader": false,
"required": false
},
{
"dataType": "String",
"defaultValue": "",
"description": "",
"name": "dingdingWebhooks",
"needCascader": false,
"required": false
},
{
"dataType": "String",
"defaultValue": "",
"description": "",
"name": "dingdingMsgType",
"needCascader": false,
"required": false
}
],
"riskLevel": 2,
"nodeName": "NotifyMessage_2",
"actionName": "notifyByCustom",
"actionDisplayName": "notifyByCustom",
"cascaderValue": [
{
"label": "NotifyMessage_1",
"value": "${NotifyMessage_1}",
"children": [ ]
}
],
"assetUuid": "acde2ae8-8b01-4bec-97c4-44ba6c9ba457",
"valueData": {
"email": 1,
"receivers": "[{\"userid\":-1,\"email\":\"xxx@163.com\"}]",
"emailTitle": "Custom Notification Test",
"emailcontext": "Custom Notification Test"
}
},
"zIndex": 1
},
{
"shape": "custom-edge",
"zIndex": 1,
"id": "5f2bddfd-ae71-423e-ac59-e4dde4a45238",
"data": {
"nodeType": "sequenceFlow",
"appType": "basic",
"isRequired": true,
"icon": "icon-upper-right-arrow"
},
"isNode": false,
"visible": true,
"router": {
"name": "manhattan",
"args": {
"padding": 5,
"excludeHiddenNodes": true,
"excludeNodes": [
"clone_node_id"
]
}
},
"source": {
"cell": "6e34b2ec-3ac4-4f4c-8d0a-3cbebb00bd64"
},
"target": {
"cell": "317dd1be-2d20-460e-977e-1fc936ffb583"
},
"vertices": [ ]
}
]
}リソースインスタンスの設定
NotifyMessage コンポーネントを使用するには、最初にメール設定を行います：
コンポーネントをクリックします。[Basic Information Configuration] タブの [Resource instance configuration] エリアで、[Resource instance configuration] をクリックします。
[Resource instance configuration] ページで、[Add] をクリックし、次の表に従ってパラメータを設定します。
パラメータ | 説明 |
assetname | リソースインスタンスのカスタム名。 |
emailSendServer | SMTP サーバー。このパラメータは任意です。
|
emailUsername | 送信者のメールアドレス。 重要
|
emailPassword | 送信者メールアドレスのパスワード。 重要 メールアカウントで認証が有効になっている場合は、認証コードを入力します。認証コードには有効期限があり、期限前に更新する必要があります。更新しない場合、認証に失敗し、コンポーネントはメールを送信できません。 |
notifyByMessageCenter
メッセージセンター経由でイベント通知を送信します。メッセージタイプは "Security Message - Cloud Security Information Notification" です。
パラメータ
パラメータ | 説明 |
通知方法 | このパラメータは任意です。複数の方法を選択できます。
たとえば、コンポーネントでサイト内メッセージとメールを指定し、メッセージセンターでメールと Webhook を指定した場合、通知はメールでのみ送信されます。 |
通知テンプレート | 次のテンプレートを使用できます：セキュリティイベントの生成、セキュリティアラートの生成、セキュリティイベントの更新。 説明 通知テンプレートには変数が含まれており、コンポーネントが通知を送信する際に実際の値に置き換えられます。 |
パラメータ設定 | 通知テンプレートで定義されている変数に、実際の値を設定します。定数、または ${event._tenant_id} などの先行ノードの出力パラメータを指定できます。 |
notifyByCustom
カスタムメッセージを送信します。メールおよび DingTalk グループに対応しています。
メールパラメータ
パラメータ | 説明 |
送信者 | リソースインスタンスで設定した、送信者のメールアドレスです。 |
受信者 | 受信者のメールアドレス。 |
件名 | メールの件名。 |
本文 | メールの本文。 |
DingTalk パラメーター
パラメータ | 説明 |
Webhook | メッセージの送信先となる Webhook URL。メッセージセンターで Webhook URL を管理できます。 |
メッセージテンプレート | メッセージテンプレート。 |