CIPP icon

CIPP

Interact with CIPP API

Actions129

Overview

This node operation allows users to add an alert to a specified tenant in the CIPP system. It is useful for monitoring specific event types within a tenant and triggering actions based on defined conditions. For example, an administrator can set up alerts to monitor security events or compliance issues in a tenant and automate responses when those events occur.

Use Case Examples

  1. Add an alert to monitor login failures in a tenant and send a notification when the alert triggers.
  2. Set up an alert for suspicious activity in a tenant with specific conditions and automated remediation actions.

Properties

Name Meaning
Tenant Filter Specifies the tenant ID or domain name to which the alert will be added.
Event Type Defines the type of event to monitor for triggering the alert.
Conditions JSON object specifying the conditions under which the alert should trigger.
Actions JSON object defining the actions to take when the alert triggers.
Request Options Settings for request behavior such as batching, SSL certificate validation, proxy usage, and timeout.

Output

JSON

  • alertId - The unique identifier of the created alert.
  • status - The status of the alert creation operation.
  • message - Additional information or confirmation message about the alert creation.

Dependencies

  • Requires an API key credential for authentication to the CIPP API.

Troubleshooting

  • Ensure the tenant ID or domain name is correctly specified to avoid errors related to tenant identification.
  • Verify that the event type is valid and supported by the CIPP API to prevent invalid event type errors.
  • Check the JSON format of conditions and actions to avoid parsing errors.
  • If SSL certificate validation fails, consider enabling the option to ignore SSL issues or configure a valid certificate.
  • Timeout errors may occur if the server is slow to respond; adjust the timeout setting accordingly.

Discussion