CIPP icon

CIPP

Interact with CIPP API

Actions129

Overview

This node interacts with the Intune API to retrieve the recovery key for a specified device within a tenant. It is useful in scenarios where administrators need to access BitLocker recovery keys for devices managed by Microsoft Intune, for example, to assist users in recovering encrypted drives.

Use Case Examples

  1. An IT administrator uses this node to fetch the recovery key of a corporate laptop to help an employee unlock their encrypted drive.
  2. A support team automates the retrieval of recovery keys for devices flagged in a security incident.

Properties

Name Meaning
Tenant Filter Specifies the default .onmicrosoft.com tenant name to filter the Intune environment context for the request.
Device ID The unique identifier of the device for which the recovery key is requested.
Request Options Additional request settings such as batching, SSL certificate validation, proxy configuration, and timeout settings to control the HTTP request behavior.

Output

JSON

  • recoveryKey - The BitLocker recovery key retrieved for the specified device.

Dependencies

  • Requires authentication credentials to access the Intune API, typically an API key or OAuth2 token.

Troubleshooting

  • Ensure the Tenant Filter is correctly set to the tenant's .onmicrosoft.com domain; incorrect tenant names will cause request failures.
  • Verify the Device ID is accurate and corresponds to a device managed in Intune; invalid IDs will result in errors or empty responses.
  • If SSL certificate errors occur, consider enabling the 'Ignore SSL Issues' option, but be aware of security risks.
  • Check proxy settings if network requests fail due to connectivity issues.
  • Timeout errors may occur if the server is slow to respond; increase the timeout setting if necessary.

Links

Discussion