All Products
Search

This Product

    Security Center:NotifyMessage component

    Document Center

    Security Center:NotifyMessage component

    Last Updated:Oct 27, 2025

    The NotifyMessage component primarily provides functionality for processing event message notifications.

    Feature description

    Action

    Description

    Scenarios

    notifyByMessageCenter

    Message Center event notification, with message type "Security Message - Cloud Security Information Notification".

    Provides notifications for three scenarios: security event generation, security alert generation, and security event updates. The notification method uses the notification settings configured in Alibaba Cloud Message Center.

    notifyByCustom

    Custom event notification.

    Custom message sending, supporting email and DingTalk group.

    Configuration example

    This topic provides parameter configuration examples for each action of the NotifyMessage component. You can import them as test playbooks. Through the visualization flow editor, you can more intuitively understand and test the configuration parameters of each action, easily mastering the functional logic and usage of the component. For the procedure, see Playbook import.

    Note

    First save the example data as a JSON file.

    Example data

    {
    "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": "Playbook start node. A playbook must have one and only one start node, which requires input data configuration for the playbook."
            }, 
            "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
            },  {
                "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": "Notification function of Alibaba Cloud Message Center", 
                "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": "If not selected, all channels will be sent", 
                        "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": "Message event ID", 
                        "enDescription": "", 
                        "name": "eventId", 
                        "needCascader": false, 
                        "required": true, 
                        "tags": ""
                    }, 
                    {
                        "dataType": "String", 
                        "defaultValue": "", 
                        "description": "Parameter variables", 
                        "enDescription": "", 
                        "name": "params", 
                        "needCascader": false, 
                        "required": false, 
                        "tags": ""
                    }, 
                    {
                        "dataType": "String", 
                        "defaultValue": "", 
                        "description": "Console language", 
                        "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\":\"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, email notification function", 
                "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": [ ]
        }
    ]
}

    Resource instance configuration

    To use the NotifyMessage log component, you need to first set up email-related information. Follow these steps:

    1. Click the component, and in the Basic Information Configuration tab, click Instance Configuration.

    2. On the Resource Instance Configuration page, click the Add button. Complete the configuration as follows:

    Parameter

    Description

    assetname

    You can customize the resource name according to your business needs.

    emailSendServer

    Email sending server, optional.

    • If not specified, the system will infer based on the email suffix configured in the emailUsername parameter.

      For example: if the sender email is 1*@aliyun.com, the server is inferred as smtp.aliyun.com, using port 465.

    • If specified, the format should be "host:port", where host must be configured, and port is optional (defaults to 465).

      Note

      Due to Alibaba Cloud server security controls, port 25 is not supported. We recommend using port 465.

    emailUsername

    Sender email address.

    Important

    • Currently only supports QQ, NetEase, Gmail, and Alibaba mailboxes.

    • Only supports sending emails via SMTP protocol.

    emailPassword

    Sender email password.

    Important

    If authorization verification is enabled, this should be the authorization code. Authorization codes have expiration times. Be sure to replace with a new authorization code before expiration, otherwise email sending will fail due to authentication failure.

    notifyByMessageCenter

    Message Center event notification, with message type "Security Message - Security Center Notification".

    Parameter description

    Parameter

    Description

    Notification method

    Optional, supports multiple selections.

    • If not set, the notification component uses the notification methods configured in "Message Center - Message Receiving Management" by default.

    • If set, the actual notification methods will be the intersection of the component settings and the "Message Center - Message Receiving Management" settings.

    For example: If the component is set to internal message and email, and the Message Center is set to email and robot, then the actual notification method will be email.

    Notification template

    Currently supports three templates: event generation, alert generation, and event update.

    Note

    The notification template contains variable parameters that need to be configured and will be replaced with actual values when sent.

    Parameters setting

    Configure actual values according to the variables set in the notification template. Supports setting constants or output parameters from preceding nodes, such as ${event._tenant_id}.

    NotifyByCustom action

    Custom message sending, supporting email and DingTalk group

    Email-related parameters

    Parameter

    Description

    Sender

    Sender email, needs to be configured in the resource instance.

    Recipient

    Recipient email.

    Subject

    Email subject.

    Body

    Email body.

    DingTalk-related parameters

    Parameter

    Description

    Webhook

    The Webhook address to send to, which can be managed in the Message Center.

    Message template

    The template for the message.