CIPP icon

CIPP

Interact with CIPP API

Actions129

Overview

This node interacts with the CIPP API to manage user devices, specifically allowing the deletion, enabling, or disabling of a user device by its Device ID. It is useful in scenarios where administrators need to control device access for users, such as revoking access from lost or compromised devices or re-enabling devices after maintenance.

Use Case Examples

  1. An IT administrator deletes a device from a user's account to prevent unauthorized access.
  2. A security officer disables a device temporarily while investigating suspicious activity.
  3. A support technician enables a previously disabled device after resolving an issue.

Properties

Name Meaning
Device ID The unique identifier of the user device to be acted upon. This is required to specify which device to delete, enable, or disable.
Device Action The action to perform on the device, which can be Enable, Disable, or Delete. This determines how the device will be managed.
Request Options Additional request settings such as batching, SSL certificate validation, proxy configuration, and request timeout to customize the API call behavior.

Output

JSON

  • success - Indicates whether the device action was successfully completed.
  • message - Provides additional information or confirmation about the device action performed.

Dependencies

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

Troubleshooting

  • Ensure the Device ID is correct and exists in the system; otherwise, the API may return an error indicating the device was not found.
  • Verify that the API credentials are valid and have sufficient permissions to perform device management actions.
  • If SSL certificate validation errors occur, consider enabling the 'Ignore SSL Issues' option, but be aware of the security implications.
  • Check proxy settings if the node cannot reach the API endpoint, especially in restricted network environments.
  • Timeout errors may occur if the server is slow to respond; adjust the timeout setting accordingly.

Discussion