Overview

This node interacts with the CIPP API to list Conditional Access Policies for a specified tenant. It is useful for administrators who need to retrieve and manage security policies related to conditional access within their organization's tenant. For example, it can be used to audit or review access policies applied to users and devices in a Microsoft environment.

Use Case Examples

1. List all Conditional Access Policies for a tenant by specifying the tenant ID or domain name.
2. Use batching options to handle large sets of policies efficiently.

Properties

Output

JSON

• policies
  • id - Unique identifier of each Conditional Access Policy.
  • displayName - Display name of the Conditional Access Policy.
  • state - Current state of the policy (e.g., enabled, disabled).
  • conditions - Conditions under which the policy applies, such as user or device criteria.
  • grantControls - Grant controls configured for the policy, defining access requirements.

Dependencies

• Requires an OAuth2 API credential for authentication with the CIPP API.

Troubleshooting

• Ensure the tenantFilter property is correctly set to a valid tenant ID or domain name; otherwise, the API call may fail or return no data.
• If SSL certificate validation errors occur, consider enabling the 'Ignore SSL Issues' option, but be aware of the security implications.
• Proxy settings must be correctly configured if used; incorrect proxy details can cause request failures.
• Timeout settings should be adjusted based on network conditions to avoid premature request termination.