Creating the CIPP Service Account
Setup Video for the CIPP Service Account
When creating your new CIPP Service Account, it's important to remember the following:
Must be a Global Administrator while setting up the integration. These permissions may be removed after the integration has been setup.
Must be added to the AdminAgents group. This group is required for connection to the Microsoft Partner API.
Must have Microsoft multi-factor authentication setup prior to being ready for executing the SAM Wizard either via Conditional Access when available or via Per User MFA when Conditional Access is not available.
You may not use any other authentication provider other than Microsoft for this account. Duo or other providers will not work. See the Supported MFA section of Microsoft's partner tenant security guidelines for further details.
Don't over-assign GDAP roles. Too many permissions will stop GDAP functionality. Review Microsoft's GDAP frequently asked questions page for more information.
Must be added to your GDAP Groups. If you're going through the invite process in CIPP, these will be created for you. If you did the migration previously through CIPP, these would start with
M365 GDAP
. These groups are not roles in your own tenant. These must be the GDAP assigned groups. For the latest, check the Recommended Roles
Setup Walkthrough for the CIPP Service Account
This guide walks you through the process from the video of setting up the CIPP Service Account. Follow the instructions on this page to the letter to ensure a seamless setup process down the line.
To get started, head to the Microsoft Entra Portal's user overview at entra.microsoft.com
Click on the "New user" button.
![](https://docs.cipp.app/~gitbook/image?url=https%3A%2F%2Fstorage.app.guidde.com%2Fv0%2Fb%2Fguidde-production.appspot.com%2Fo%2FquickguiddeScreenshots%252FIEPB08VSavefFaCa9OSp3Y87aGu1%252Fi9fztXsCUWjY3cr8mySvCX%252Fv5BfyGiEY4FqmbqxRCymsD_doc.png%3Falt%3Dmedia%26token%3Dad9a3831-cec6-4244-b5f4-f90d08ae87ea%26time%3DFri%2520Jul%252026%25202024%252021%3A57%3A39%2520GMT-0400%2520%28Eastern%2520Daylight%2520Time%29&width=768&dpr=4&quality=100&sign=b343876f&sv=1)
Create a new internal user in your organization
![](https://docs.cipp.app/~gitbook/image?url=https%3A%2F%2Fstorage.app.guidde.com%2Fv0%2Fb%2Fguidde-production.appspot.com%2Fo%2FquickguiddeScreenshots%252FIEPB08VSavefFaCa9OSp3Y87aGu1%252Fi9fztXsCUWjY3cr8mySvCX%252FsTTkLSePkCmuzgTg9nFYvJ_doc.png%3Falt%3Dmedia%26token%3D2017aff5-ecc2-4030-ba90-9b955a14ec97%26time%3DFri%2520Jul%252026%25202024%252021%3A57%3A44%2520GMT-0400%2520%28Eastern%2520Daylight%2520Time%29&width=768&dpr=4&quality=100&sign=db440bba&sv=1)
Enter a username in the field, we recommend something identifiable like "CIPP Service Account"
![](https://docs.cipp.app/~gitbook/image?url=https%3A%2F%2Fstorage.app.guidde.com%2Fv0%2Fb%2Fguidde-production.appspot.com%2Fo%2FquickguiddeScreenshots%252FIEPB08VSavefFaCa9OSp3Y87aGu1%252Fi9fztXsCUWjY3cr8mySvCX%252Fmp4FiwSvkpKyfKgcbQ3Ac9_doc.png%3Falt%3Dmedia%26token%3Deda4079d-869a-40bd-8a0f-2c436806be3e%26time%3DFri%2520Jul%252026%25202024%252021%3A57%3A46%2520GMT-0400%2520%28Eastern%2520Daylight%2520Time%29&width=768&dpr=4&quality=100&sign=e2a0189d&sv=1)
Enter "CIPP Service Account" in the Display Name field. Set the password to something strong, and save this password in a secure location
![](https://docs.cipp.app/~gitbook/image?url=https%3A%2F%2Fstorage.app.guidde.com%2Fv0%2Fb%2Fguidde-production.appspot.com%2Fo%2FquickguiddeScreenshots%252FIEPB08VSavefFaCa9OSp3Y87aGu1%252Fi9fztXsCUWjY3cr8mySvCX%252FhLEJyFsy7Dxs69tcJkYt4p_doc.png%3Falt%3Dmedia%26token%3D216ec97e-b904-4dcb-8a4c-1f359ae5fc91%26time%3DFri%2520Jul%252026%25202024%252021%3A57%3A47%2520GMT-0400%2520%28Eastern%2520Daylight%2520Time%29&width=768&dpr=4&quality=100&sign=8c43f981&sv=1)
Click on "Next: Properties".
![](https://docs.cipp.app/~gitbook/image?url=https%3A%2F%2Fstorage.app.guidde.com%2Fv0%2Fb%2Fguidde-production.appspot.com%2Fo%2FquickguiddeScreenshots%252FIEPB08VSavefFaCa9OSp3Y87aGu1%252Fi9fztXsCUWjY3cr8mySvCX%252FreEjqnr9Xp15EZ3UPq6ZVJ_doc.png%3Falt%3Dmedia%26token%3Dacee15fa-1072-459a-ac97-77c4fb8e30bd%26time%3DFri%2520Jul%252026%25202024%252021%3A57%3A49%2520GMT-0400%2520%28Eastern%2520Daylight%2520Time%29&width=768&dpr=4&quality=100&sign=e1c25cc0&sv=1)
Click on "Next: Assignments".
![](https://docs.cipp.app/~gitbook/image?url=https%3A%2F%2Fstorage.app.guidde.com%2Fv0%2Fb%2Fguidde-production.appspot.com%2Fo%2FquickguiddeScreenshots%252FIEPB08VSavefFaCa9OSp3Y87aGu1%252Fi9fztXsCUWjY3cr8mySvCX%252FeY6Qmd985ryQ1gDMCLiL86_doc.png%3Falt%3Dmedia%26token%3Da8fddef5-d5be-4419-9d9c-582385be0847%26time%3DFri%2520Jul%252026%25202024%252021%3A57%3A50%2520GMT-0400%2520%28Eastern%2520Daylight%2520Time%29&width=768&dpr=4&quality=100&sign=db1913c3&sv=1)
If you are a Microsoft Partner, and want to manage all your client tenants, click on Add Group.
Select the AdminAgents group. This group is required for connection to the Microsoft Partner API.
![](https://docs.cipp.app/~gitbook/image?url=https%3A%2F%2Fstorage.app.guidde.com%2Fv0%2Fb%2Fguidde-production.appspot.com%2Fo%2FquickguiddeScreenshots%252FIEPB08VSavefFaCa9OSp3Y87aGu1%252Fi9fztXsCUWjY3cr8mySvCX%252FpZSBZsEEMGeyHRon7PjrnM_doc.png%3Falt%3Dmedia%26token%3D790a804e-52cf-4f8e-b6cc-b1caace518cd%26time%3DFri%2520Jul%252026%25202024%252021%3A57%3A59%2520GMT-0400%2520%28Eastern%2520Daylight%2520Time%29&width=768&dpr=4&quality=100&sign=737e8d77&sv=1)
Select your GDAP groups
If you have already migrated to GDAP you select your GDAP groups at this stage. If you migrated using CIPP these groups start with M365 GDAP
, For the latest required GDAP roles check our Recommended Roles page.
Click "Add role"
![](https://docs.cipp.app/~gitbook/image?url=https%3A%2F%2Fstorage.app.guidde.com%2Fv0%2Fb%2Fguidde-production.appspot.com%2Fo%2FquickguiddeScreenshots%252FIEPB08VSavefFaCa9OSp3Y87aGu1%252Fi9fztXsCUWjY3cr8mySvCX%252FrNKg3zxDF4cCxMzhGPHRfT_doc.png%3Falt%3Dmedia%26token%3Deee64997-0439-4965-ad41-c8a89d343d36%26time%3DFri%2520Jul%252026%25202024%252021%3A58%3A01%2520GMT-0400%2520%28Eastern%2520Daylight%2520Time%29&width=768&dpr=4&quality=100&sign=82153c99&sv=1)
Add the Global Administrator Role
Find the Global Admin role. This role is required for the CIPP-SAM application creation, and is recommended to be removed directly after installation.
Click "Next: Review + create"
Click on "Create". This creates the account.
Last updated