CIPP icon

CIPP

Interact with CIPP API

Actions129

Overview

This node interacts with the CIPP API to revoke user sessions within a specified tenant. It is useful for administrators who need to forcefully log out a user from all active sessions, for example, when a user's credentials are compromised or when access needs to be immediately terminated for security reasons. Practical applications include managing user access in enterprise environments and enforcing security policies.

Use Case Examples

  1. Revoke all active sessions for a user identified by their user ID or email within a specific tenant domain or ID.
  2. Use tenant filtering to target the correct organizational context when revoking sessions.

Properties

Name Meaning
User ID The user ID or email address of the user whose sessions are to be revoked.
Tenant Filter The tenant ID or domain name to specify the organizational context for the operation.
Request Options Additional settings for the request such as batching, SSL certificate validation, proxy configuration, and timeout settings.

Output

JSON

  • success - Indicates whether the session revocation was successful.
  • message - Additional information or status message returned by the API after attempting to revoke sessions.

Dependencies

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

Troubleshooting

  • Ensure the User ID and Tenant Filter are correctly specified; incorrect values will cause the API call to fail.
  • If SSL certificate validation fails and the 'Ignore SSL Issues' option is not enabled, the request will be aborted.
  • Proxy settings must be correctly configured if used; otherwise, the request may not reach the API endpoint.
  • Timeout settings should be adjusted based on network conditions to avoid premature request termination.

Discussion