Help Center/ SecMaster/ User Guide/ Playbook Overview/ New Server Protection Status Notification (Add Host Asset Protection Status Notification)
Updated on 2026-02-06 GMT+08:00
View PDF
Share

New Server Protection Status Notification (Add Host Asset Protection Status Notification)

Playbook Overview

The Add Host Asset Protection Status Notification playbook notifies users of any new server in the Unprotected status.

Trigger condition: The playbook is triggered when it detects a new server in the Unprotected status.

You need to enable this playbook for it to take effect.

Prerequisites

  • Your SecMaster professional edition is available.
  • You have enabled asset subscription in the workspace where the Add Host Asset Protection Status Notification playbook is located. For details, see Configuring the Asset Subscription.
  • You have created and subscribed to a topic to receive notifications from SecMaster. For details, see Creating and Subscribing to a Topic.
  • SecMaster has obtained the SMN FullAccess permission, which specifies all permissions of SMN.
    Table 1 Permission description

    Permission

    Description

    Principal

    Usage

    SMN FullAccess

    All permissions for SMN.

    SecMaster_Agency

    SecMaster uses SMN to send playbook execution notifications.

    Perform the following steps to check whether SecMaster has obtained the SMN FullAccess permission: If the permission is not allocated, allocate it to SecMaster by referring to Authorizing SecMaster.

    1. Log in to the SecMaster console as an administrator.
    2. Click in the upper left corner of the page and choose Management & Governance > Identity and Access Management.
    3. In the navigation pane on the left, choose Agencies. On the Agencies page, click SecMaster_Agency and then click the Permissions tab to view all authorization records of SecMaster_Agency.
    Figure 1 Viewing agency authorization records

Creating and Subscribing to a Topic

To receive notifications generated by the Asset Protection Status Statistics Notification playbook, you need to use Simple Message Notification (SMN) to create a SecMaster topic and subscribe to the topic.
  1. Log in to the SecMaster console.
  2. In the upper left corner of the page, click and choose Management & Governance > Simple Message Notification.
  3. Create a topic.
    1. In the navigation pane on the left, choose Topic Management > Topics. In the upper right corner of the displayed page, click Create Topic.
      Figure 2 Create Topic
    2. In the Create Topic dialog box displayed, configure topic information and click OK.
      • Topic Name: Set it to SecMaster-Notification.
      • Display Name: SecMaster notification topic is recommended.
      • Retain default values for other parameters.

      Topic Name must be to SecMaster-Notification, or playbooks may fail to be executed.

  4. Add a subscription.
    1. On the Topics page, locate the row that contains the SecMaster-Notification topic and click Add Subscription in the Operation column.
    2. On the displayed Add Subscription slide-out panel, configure subscription information and click OK.
      • Protocol: Select a notification method based on your needs. Email is used as an example.
      • Endpoint: Enter the email address of the subscription endpoint, for example, username@example.com.
  5. Confirm the subscription.

    After a subscription is added, a confirmation email will be sent to the email address set in 4. Click the subscription confirmation link in the email. A page for a successful subscription will be displayed.

Enabling a Playbook

The initial version (V1) of the Add Host Asset Protection Status Notification playbook is activated by default. You only need to enable the playbook.
  1. Log in to the SecMaster console.
  2. In the navigation pane on the left, choose Workspaces > Management. In the workspace list, click the name of the target workspace.
    Figure 3 Workspace management page
  3. In the navigation pane on the left, choose Security Orchestration > Playbooks.
    Figure 4 Accessing the Playbooks tab
  4. On the Playbooks page, search for the Add Host Asset Protection Status Notification playbook and click Enable in the Operation column of the playbook.
  5. In the dialog box displayed, select the initial playbook version v1 and click OK. If the Playbook Status of the Add Host Asset Protection Status Notification playbook changes to Enabled, the playbook has been enabled successfully.

Implementation Effect

You can receive notifications about the protection status of new servers. The following is an example.

Figure 5 New server protection status notification example

Parent topic: Playbook Overview