Tenants
Centralized Tenant Management and Oversight
The Tenants page is a centralized platform for administrators to oversee and manage all tenants within CIPP. This page provides detailed information about each tenant and facilitates actions related to their exclusion status and permissions.
This page also shows tenants that have been excluded or removed due to the number of errors received.
Action Buttons
Force Refresh
This will force a refresh of your tenants list. NOTE: Your tenants list may temporarily clear while CIPP rebuilds the list
Table Details
The main table on this page displays information relating to all tenants that you have added to CIPP. There is a column for how the tenant was added (GDAP or Direct) along with columns regarding if the tenant has been exluded from CIPP, by whom, and when.
Table Actions
Exclude Tenants
Excludes the selected tenant(s) from being managed by CIPP. They will no longer display in the tenant selector and standards, alerts, etc. will not apply
Include Tenants
Removes an exclusion on selected tenant(s)
Refresh CPV Permissions
Refreshes the CPV permissions for the selected tenant(s) [More information]
Reset CPV Permissions
Resets the CPV permissions for the selected tenant(s) by deleting the Service Principal and re-adding it [More information]
Remove Tenant
Available for tenants added via the Direct Add method, this will remove the tenant from CIPP. The app registration remains though, so a user with rights to the tenant should remove the CIPP-SAM app manually.
Refresh CIPPDB Cache
Refreshes the CIPP reporting DB cache for the selected tenant. You can select the
More Info
Opens Extended Info flyout
Refreshing a Tenant's Permissions
CIPP works using the Control Panel Vendor API - Also known as the CPV API. The CPV API is used to add the CIPP application to your managed tenants and allows CIPP to execute actions within these tenants. Each night at 00:00 UTC the permissions are refreshed for all tenants. This makes sure that the application always has the latest set of required access.
For more details, see more about this on the Refreshing a Tenants Permission section of our troubleshooting documentation.
Resetting a Tenant's CPV Permissions
Note: The CPV Reset is a powerful tool and should be used only if you cannot manage permissions at all. This action will delete the Service Principal and re-add it, which may be necessary if there are issues with the existing permissions setup.
Feature Requests / Ideas
We value your feedback and ideas. Please raise any feature requests on GitHub.
Last updated
Was this helpful?