I want to manage my own tenant
If you want to manage your own tenant or if you are not a Microsoft Partner but still want to use CIPP you can perform the setup and enable access to the partner tenant or enable Single Tenant Mode. The CIPP Service Account should be granted at least the Recommended Roles within the tenant being managed.
To manage the tenant mode, a user with the CIPP superadmin role will need to access the Tenant Mode page of the Super Admin settings.
There are 3 different modes in CIPP to choose from:
Multi Tenant - GDAP mode
This is the default mode in CIPP, it does not allow access to the partner tenant.
Multi Tenant - Add Partner Tenant
This mode allows direct access to the partner tenant in addition to your customer tenants via GDAP. See the Limitations below for more details.
Single Tenant - Own Tenant Mode
This mode is for if you would like to manage your own tenant and/or are not a Microsoft Partner. See the limitations below for more details.
Limitations of Single Tenant Mode
When using Single Tenant Mode CIPP runs in a somewhat more limited state - You are not able to add any other tenant to CIPP, and it only works for the configured tenant. GDAP permissions will not apply, and you must directly assign roles such as Global Admin to the service account.
Limitations of Partner Tenant Enabled
When using Partner Tenant Enabled mode you can see your partner tenant inside of CIPP. There will be no permissions applied to who can see this tenant and control it.
It is highly recommended to use a custom role if multiple users have access to your CIPP instances. This can help ensure not all users have access to manage your partner tenant. If you do not, it's important to note that all your users will have access to edit/configure your partner tenant. Information on custom roles can be found here.
GDAP permissions will not apply, and you must directly assign roles to the service account in the Entra portal (e.g. User Administrator, Exchange Administrator, etc.).
To set the tenant mode, follow these steps
Log in to CIPP with an account with the role
superadmin. This role will allow you access to the menu to change this setting.Click CIPP at the bottom of the left-hand menu
Click Advanced
Click Super Admin
The default tab is the Tenant Mode tab
Select one of the three modes. The default mode is "Multi Tenant - GDAP Mode"
Clear the tenant cache. Users of CIPP now have access to the CSP Partner tenant, or to the single tenant it's been configured for.
Feature Requests / Ideas
We value your feedback and ideas. Please raise any feature requests on GitHub.
Last updated
Was this helpful?

