CIPP icon

CIPP

Interact with CIPP API

Actions129

Overview

This node interacts with the CIPP API to list security alerts related to a specified tenant in a Security & Compliance context. It is useful for monitoring and managing security alerts within an organization's tenant, helping security teams stay informed about potential issues or threats. For example, it can be used to fetch alerts for a tenant identified by its ID or domain name, enabling automated workflows for alert handling or reporting.

Use Case Examples

  1. Fetch all security alerts for a tenant by specifying the tenant ID or domain name.
  2. Automate alert monitoring by periodically listing alerts and triggering notifications or remediation workflows.

Properties

Name Meaning
Tenant Filter The tenant ID or domain name used to filter the alerts for a specific tenant.
Request Options Settings to control request behavior such as batching, SSL certificate validation, proxy usage, and request timeout.

Output

JSON

  • alerts - Array of security alerts retrieved for the specified tenant.

Dependencies

  • Requires an API key credential for authenticating with the CIPP API.

Troubleshooting

  • Ensure the tenant ID or domain name is correctly specified; incorrect values may result in no alerts being returned.
  • If SSL certificate validation fails and 'Ignore SSL Issues' is not enabled, requests may be blocked; enable this option cautiously if needed.
  • Proxy settings must be correctly configured if used; incorrect proxy details can cause request failures.
  • Timeout settings should be adjusted based on network conditions to avoid premature request termination.

Discussion