This guide walks you through the full process of assigning an action from the Library and activating it in your My List.


Step 1: Browse the Library

  1. Navigate to Actions > Library in the left sidebar.
  2. Browse the available actions or use Search to find a specific one.
  3. Use the Assignment filter to show only unassigned actions.

Step 2: Review the Action

Before assigning, review the action details on its card:

  • Read the Description to understand what the action does.
  • Expand Benefit to see how it helps your environment.
  • Expand Expert Comment for additional security guidance.
  • Expand Sample Output Preview to see example results.

Step 3: Assign the Action

Click Assign on the action card. A dialog opens with one of two configuration modes:

Time Interval Assignment

Used for actions that run on a recurring schedule.

  1. Time Interval -- Set the frequency in days (e.g., 1 for daily, 7 for weekly).
  2. Custom Parameters (Optional) -- Provide JSON parameters to customize the action's behavior.
  3. Review the Suggested Custom Parameters section for available options. Common parameters include:
{
    "assets": [
        "example.com"
    ],
    "cidr": "192.168.0.0/16",
    "prefix": [
        "test",
        "dev"
    ]
}
  1. Click Assign.

Scan-Based Assignment

Used for actions that should be triggered by a specific scan tool.

  1. Search by Scan -- Use the dropdown to search and select a scan tool from the platform's tool list.
  2. The action will run automatically whenever the selected scan executes.
  3. Click Assign.

Step 4: Activate from My List

After assigning, the action appears in Actions > My List with a Pending Approval status.

  1. Navigate to Actions > My List.
  2. Find the newly assigned action.
  3. Click the three-dot menu on the action row.
  4. Click Activate to start running the action.

Note

Some actions may require administrator approval before activation. These will show a Pending Approval status until approved.

Step 5: Test and Monitor

Before relying on the action in production:

  1. Click the three-dot menu and select Test Run to execute a one-time test.
  2. Review the test output to verify the action works as expected.
  3. Click Show History to view past executions and their results.

Updating an Action

To modify an action's parameters or schedule after assignment:

  1. Go to Actions > My List.
  2. Click the three-dot menu on the action.
  3. Select Update.
  4. Modify the time interval or custom parameters.
  5. Save the changes.

What's Next?