CIPP icon

CIPP

Interact with CIPP API

Actions18

Overview

This node interacts with the CIPP API to perform various operations related to users, groups, licenses, tenants, and calendar permissions. Specifically, for the "User" resource and the "List User Conditional Access Policies" operation, it retrieves conditional access policies associated with a specified user within a tenant. This is useful in scenarios where you need to audit or manage security policies applied to individual users in an organization.

Practical examples include:

  • Fetching all conditional access policies that apply to a particular user to verify compliance.
  • Integrating with security dashboards to display user-specific access controls.
  • Automating reports on user access restrictions across multiple tenants.

Properties

Name Meaning
User ID The unique identifier of the user whose conditional access policies are to be listed.
Tenant Filter The tenant ID used to filter and specify the context of the user within the organization.

Output

The node outputs JSON data containing the list of conditional access policies associated with the specified user. Each item in the output typically includes details about a single policy such as its name, conditions, grant controls, and status. This structured data can be used downstream for further processing, reporting, or decision-making.

No binary data output is indicated for this operation.

Dependencies

  • Requires an API key credential for authenticating with the CIPP API.
  • The base URL for the API is configured dynamically from the credentials.
  • Proper configuration of the API URL and authentication token in n8n credentials is necessary.

Troubleshooting

  • Common issues:

    • Invalid or missing User ID or Tenant Filter will cause the API call to fail.
    • Incorrect or expired API credentials will result in authentication errors.
    • Network connectivity problems may prevent reaching the CIPP API endpoint.

  • Error messages and resolutions:

    • "Unauthorized" or "Authentication failed": Verify that the API key credential is correctly set up and has not expired.
    • "User not found": Confirm that the provided User ID exists within the specified tenant.
    • "Tenant filter invalid": Ensure the tenant ID is correct and the user belongs to that tenant.
    • Timeouts or network errors: Check internet connection and API endpoint availability.

Links and References

Discussion