NotifyMessage組件主要提供處理事件訊息通知資訊功能。
功能描述
動作 | 描述 | 使用情境 |
notifyByMessageCenter | 訊息中心事件通知，訊息類型為“安全訊息-Apsara Stack Security安全語音總機”。 | 對安全事件產生、安全警示產生、安全事件更新三種情境進行通知，通知方式採用阿里雲訊息中心設定的通知方式。 |
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": "劇本開始節點，一個劇本必須有且僅有一個開始節點，需為劇本配置輸入資料。"
},
"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\":\"簡訊\",\"value\":\"sms\"},{\"label\":\"郵箱\",\"value\":\"email\"},{\"label\":\"webhook\",\"value\":\"webhook\"},{\"label\":\"站內信\",\"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": "zh",
"channelTypeList": [ ],
"eventId": "yundun_soar_incident_generate",
"aliuid": "1766xxxx",
"params": "{\"incidentName\":\"事件產生測試\",\"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": "自訂通知測試",
"emailcontext": "自訂通知測試"
}
},
"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日誌組件，需要先設定郵件的相關資訊。操作步驟如下：
單擊組件，在基礎資訊配置頁簽，資源執行個體配置地區點擊資源執行個體配置。
在資源執行個體配置頁面，單擊新增按鈕。參照如下完成配置：
參數 | 描述 |
assetname | 可根據自身業務自訂資源名稱。 |
emailSendServer | 郵件發件伺服器，非必填項。
|
emailUsername | 發件郵箱地址。 重要
|
emailPassword | 寄件者郵箱密碼。 重要 如果開啟了授權驗證，則為授權碼。授權碼會有到期時間，務必在到期前更換為新授權碼，否則將因為認證失敗導致郵件發送失敗。 |
notifyByMessageCenter
訊息中心事件通知，訊息類型為“安全訊息-Apsara Stack Security安全語音總機”。
參數說明
參數 | 描述 |
通知方式 | 非必填，支援多選。
例如：組件設定為站內信、郵件，訊息中心設定為郵件、機器人。則實際的通知方式為郵件。 |
通知模板 | 目前支援事件產生、警示產生、事件更新三種模板。 說明 通知模板中會有變數參數需要配置，發送時會替換為實際值。 |
參數設定 | 根據通知模板中設定的變數，配置實際值。支援設定常量或者前置節點的輸出參數，例如${event._tenant_id}。 |
notifyByCustom動作
自訂訊息發送，支援郵箱、DingTalk群
郵件相關參數
參數 | 描述 |
寄件者 | 發件郵箱，需要在資源執行個體中配置。 |
收件者 | 收件郵箱。 |
主題 | 郵件的主題。 |
本文 | 郵件的本文。 |
DingTalk相關參數
參數 | 描述 |
Webhook | 要發送的Webhook 地址，可參見在訊息中心中進行管理。 |
訊息模板 | 訊息的模板。 |