CIPP icon

CIPP

Interact with CIPP API

Actions129

Overview

This node interacts with the CIPP API to list user sign-in activities within a specified tenant. It is useful for monitoring user sign-in events, especially for security auditing or troubleshooting access issues. For example, an administrator can use this node to retrieve all sign-in attempts for a tenant, optionally filtering to show only failed sign-ins to identify potential unauthorized access attempts.

Use Case Examples

  1. List all sign-ins for a tenant to monitor user activity.
  2. Retrieve only failed sign-ins to investigate security incidents.

Properties

Name Meaning
Tenant Filter The tenant ID or domain name to filter the sign-in data for a specific tenant.
Failures Only A boolean flag to indicate whether to show only failed sign-in attempts.
Request Options Additional request settings such as batching, SSL certificate validation, proxy configuration, and timeout settings to control how the API requests are made.

Output

JSON

  • signIns - An array of sign-in records retrieved from the tenant, each containing details about individual sign-in events such as user information, timestamps, and status.

Dependencies

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

Troubleshooting

  • Ensure the tenant ID or domain name is correctly specified to avoid empty or incorrect results.
  • If the node returns SSL certificate errors, consider enabling the 'Ignore SSL Issues' option if appropriate for your environment.
  • Timeout errors may occur if the server is slow to respond; increase the timeout setting if needed.
  • Batching settings should be adjusted carefully to avoid overwhelming the API or hitting rate limits.

Discussion