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

Action	Description
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 a GDAP relationship with

Table Actions

Action	Description	Bulk Action Available
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
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.