CIPP icon

CIPP

Interact with CIPP API

Actions129

Overview

This node interacts with the CIPP API to list custom roles within the CIPP Administration resource. It is useful for administrators who need to retrieve and manage custom role definitions in their CIPP environment. For example, it can be used to fetch all custom roles to audit permissions or to integrate role data into other workflows.

Use Case Examples

  1. List all custom roles in CIPP Administration to review role configurations.
  2. Fetch custom roles to synchronize with an external user management system.

Properties

Name Meaning
Request Options Options to control request behavior such as batching, SSL certificate validation, proxy settings, and timeout.

Output

JSON

  • customRoles - Array of custom role objects retrieved from the CIPP API.

Dependencies

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

Troubleshooting

  • If the node fails due to SSL certificate issues, enable 'Ignore SSL Issues' to bypass validation (not recommended for production).
  • Timeout errors can occur if the server is slow; increase the 'Timeout' value as needed.
  • Proxy settings must be correctly configured if your network requires a proxy to access the internet.
  • Batching settings should be adjusted to avoid hitting API rate limits or to optimize performance.

Discussion