Action Types

Playbooks start with a Trigger action and end with an End action. In between, you can create any of the following actions:

Action Name

Description

When to Use/How to Use

Playbook

Triggers a different playbook from within the current or parent playbook.

For longer processes that playbooks automate, it can be helpful to break up the processes into parts. This will help you reuse different playbooks in different scenarios.

Annotation

Adds comments to a playbook action.

Let your colleagues know important information about the Action and Playbook.

API

Triggers an API call from within the playbook.

Connects the playbook to products and services from other vendors.

Script

Triggers a script from within the playbook. Currently, LogPoint only supports Python scripts.

Lets you write python scripts to customize playbook functionality.

Case Item

Adds an individual item or event to a case, the investigation’s sequence of steps. Refer to the Cases section for details.

Let’s you and your colleagues track and understand what happened through the course of an automated incident investigation.

Status

Sets the status of an incident.

Apply status to incidents based on severity.

Email

Sends an email from within the playbook.

Send incident based email to desired recipients from within the playbooks.

LDAP

Triggers an LDAP request.

Authenticates users/actions from within Playbooks by communicating with a central user database.

Configuring Playbook Action

_images/LP_SOAR_Playbooks_Actions_Playbook.png

To configure a playbook action:

  1. Enter an Action Name and its Description.

  2. Select a Playbook.

  3. Enter the information for the playbook.

  4. Click Save Data.

Configuring Annotation Action

_images/LP_SOAR_Playbooks_Actions_Annotation.png

To configure an annotation action:

  1. Enter an Action Name and its Description.

  2. Enter an Annotation Text.

  3. Click Save Data.

Configuring API Action

_images/LP_SOAR_Playbooks_Actions_API.png

API Action Configuration

To configure an API action:

  1. Enter an Action Name and its Description.

  2. Select a Product Type, a Vendor, a Product, a Product Instance, and an Action.

  3. Enter the information for the selected configuration.

  4. Click Save Data.

Configuring Custom Script Action

_images/LP_SOAR_Playbooks_Actions_Script.png

Script Action Configuration

To configure a script action:

  1. Enter an Action Name and its Description.

  2. Select the Script Language.

  3. Click Edit Python Code +, enter the required code, and click Save.

  4. Enter or select the Input Parameters and their values.

  5. Enter the Output Parameters for the block.

  6. Click Save Data.

Configuring Case Item Action

_images/LP_SOAR_Playbooks_Actions_CaseItem.png

Case Item Configuration

To configure a case item action:

  1. Enter an Action Name and its Description.

  2. Enter or select a Case Id.

  3. Select a block Type.

    • If you choose Label, enter a Description and a Label.

    • If you choose File, enter a Description, a File Name, and a File Location.

    • If you choose Query Result, enter a Description, and a Query Result.

  4. Click Save Data.

Configuring Status Action

_images/LP_SOAR_Playbooks_Actions_Status.png

Status Action Configuration

To configure a status action:

  1. Enter an Action Name and its Description.

  2. Enter or select an Incident Id. You can leave the field blank to use a dynamically generated ID.

  3. Select an Action.

    • If you select Set Case Status, select the Status.

    • If you select Handling Status, select the Case Status.

    • If you select Manage Case Severity, select the Severity Action Type and enter the Decrement Severity By value.

  4. Click Save Data.

Configuring Email Action

_images/LP_SOAR_Playbooks_Actions_Email.png

E-mail Action Configuration

To configure an e-mail action:

  1. Enter an Action Name and its Description.

  2. Enter a comma-separated list of Recipients, CC recipients, and BCC recipients.

  3. Enter a Subject.

  4. Enter the e-mail Body.

  5. Enter a key-value separated list of Input Parameters.

  6. Click Save Data.

Configuring LDAP Action

_images/LP_SOAR_Playbooks_Actions_LDAP.png

LDAP Action Configuration

To configure an LDAP action:

  1. Enter an Action Name and its Description.

  2. Select a Vendor, a Product, a Product Instance, and an Action.

  3. Click Save Data.

UML Types

UML Name

Description

When to Use/How to Use

For Each

Processes multiple queries from the same block.

When you need to loop queries through each item in an array or list.

If-Then

Processes a conditional statement.

When you need to make a specific response for a predefined event.

Configuring For Each Action

_images/LP_SOAR_Playbooks_Actions_Foreach.png
  1. Enter an Action Name and its Description.

  2. Enter or choose the Parameter.

  3. Click Save Data.

Configuring If-Then Action

_images/LP_SOAR_Playbooks_Actions_IfThen.png
  1. Enter an Action Name and its Description.

  2. Enter or choose the Left Operand.

  3. Select an Operator.

  4. Enter or choose the Right Operand.

  5. Click Save Data.

Note

Add another block to follow from the Else node when the provided condition is False.

Interactive Type

Interactive Name

Description

When to Use/How to Use

Prompt

Displays a message for manual action on part of user before the playbook runs.

When you want to confirm whether or not the user needs to perform certain manual actions before the rest of the automated playbook continues running.

Configuring Prompt Action

_images/LP_SOAR_Playbooks_Actions_Prompt.png

Prompt Action Configuration

To configure a prompt action:

  1. Enter an Action Name and its Description.

  2. Enter or choose the Case Id.

  3. Enter the Prompt Message.

  4. Enter a list of key-value based Input Parameters.

  5. Click Save Data.

Action Block Types

Action Block Name

Description

When to Use/How to Use

Format

Adds a block of parameters in the key-value format.

When you need to add multiple parameters and associate each with various actions.

Query

Adds a query to get specific fields.

When you need to input a query to generate output parameters based on input parameters.

Filter

Filters results using the input parameters.

When you need to filter out results based on input conditions.

Configuring Format Action

_images/LP_SOAR_Playbooks_Actions_Format.png

Format Action Configuration

To configure a format block:

  1. Enter an Action Name and its Description.

  2. Enter a Text.

  3. Enter a list of key-value based Parameters.

  4. Click Save Data.

Configuring Query Action

_images/LP_SOAR_Playbooks_Actions_Query.png

Query Action Configuration

To configure a query block:

  1. Enter a Query Name and its Description.

  2. Select a Data Source and a Query Result Data Format.

  3. Enter a Query to retrieve the required logs.

  4. Click Edit LogPoint Query Parameters to update the parameters.

    4.1. Enter a LogPoint Id. The value entered here overrides the value retrieved from the LogPoint incident.

    4.2. Select a Time Range and enter a Limit.

    4.3. Select a Time-Zone. You can choose between a system set time zone and a custom time zone.

    4.4. Enter a list of Repositories.

  5. Enter a list of key-value based Input Parameters.

  6. Enter a list of Query Result Fields.

  7. Click Save Data.

Configuring Filter Action

_images/LP_SOAR_Playbooks_Actions_Filter.png

Filter Action Configuration

To configure a filter block:

  1. Enter an Action Name and its Description.

  2. Enter or choose a Param.

  3. Enter a JSONPath Filter Expression.

  4. Click Save Data.

Creating and Configuring


Helpful?

We are glad this guide helped.


Please don't include any personal information in your comment

Contact Support