CIPP icon

CIPP

Interact with CIPP API

Actions129

Overview

This node operation allows users to set or remove SharePoint permissions for a specified user within a given tenant and site URL. It is useful for managing access control in SharePoint sites or OneDrive, enabling automation of permission assignments or removals based on user principal names. For example, an administrator can automate granting or revoking access to a SharePoint site for specific users across different tenants.

Use Case Examples

  1. Automate adding a user to a SharePoint site with specific permissions.
  2. Remove a user's access to a OneDrive folder by revoking permissions.

Properties

Name Meaning
Tenant Filter The tenant ID or domain name to specify the target tenant for the operation.
URL The web URL of the SharePoint site or OneDrive location where permissions are to be set or removed.
User The user principal name of the user whose permissions are being modified.
UPN The owner principal name, required for setting SharePoint permissions.
Remove Permission Boolean flag indicating whether to remove (true) or add (false) permissions.
OneDrive Access User User principal name for OneDrive access, used when setting permissions related to OneDrive.
Request Options Settings for request behavior including batching, SSL certificate validation, proxy configuration, and timeout settings.

Output

JSON

  • success - Indicates whether the permission setting or removal operation was successful.
  • message - Additional information or error message related to the operation outcome.

Dependencies

  • Requires an API key credential for authentication to the CIPP API.

Troubleshooting

  • Ensure the tenant ID or domain name is correct to avoid authentication or authorization errors.
  • Verify the user principal names (User and UPN) are valid and exist in the tenant to prevent permission assignment failures.
  • Check network connectivity and proxy settings if requests time out or fail to reach the API.
  • If SSL certificate validation fails, consider enabling the option to ignore SSL issues, but be aware of security risks.

Discussion