CIPP icon

CIPP

Interact with CIPP API

Actions18

Overview

The node named "CIPP" provides integration with the CIPP API, allowing users to interact with various resources such as Licenses, Users, Groups, Tenants, and Calendar Permissions. Specifically, for the "License" resource with the "List Licenses" operation, the node fetches a list of licenses filtered by a tenant identifier. This is useful in scenarios where an organization needs to retrieve all license information associated with a particular tenant, for example, to audit license usage or manage entitlements.

Properties

Name Meaning
Tenant Filter A string value used to filter licenses by a specific tenant. This property is required.

Output

The node outputs JSON data representing the list of licenses retrieved from the CIPP API for the specified tenant. Each item in the output JSON array corresponds to a license object with its associated details as provided by the API. The node does not explicitly handle binary data output.

Dependencies

  • Requires an API key credential for authenticating with the CIPP API (configured via OAuth2).
  • The base URL for the API is dynamically set from the credentials.
  • The node expects the CIPP API to be accessible and properly configured for the authenticated user.

Troubleshooting

  • Common Issues:
    • Missing or invalid API authentication token can cause authorization errors.
    • Incorrect or empty tenant filter may result in no licenses being returned.
    • Network connectivity issues to the CIPP API endpoint.
  • Error Messages:
    • Authorization errors typically indicate problems with the API key or OAuth2 token; ensure credentials are correctly set up.
    • Validation errors may occur if the tenant filter is missing or malformed; verify that the tenant filter string is correct.
    • Timeout or connection errors suggest network problems; check API availability and network settings.

Links and References

Discussion