Licensing and provisioning
Assign Grunt licenses and automate provisioning with Microsoft Entra ID
Grunt supports both interactive license validation for end users and automated provisioning for IT-managed environments.
#Interactive license validation
When a user starts Grunt for the first time, Grunt asks for their company email address and sends a validation email. If validation fails repeatedly, Grunt can eventually show the license as expired even if the subscription is still active.
If a user reports activation issues, verify:
- The user is validating with the correct company identity
- The user can refresh the license from Grunt > Settings > License
- The network allows access to the required Grunt endpoints
- Proxy-based environments have Use default proxy for API communication enabled when needed
#Automated provisioning with Microsoft Entra ID
Use SCIM to manage Grunt user access through Microsoft Entra ID. Entra provisions assigned users and removes their Grunt license assignments when they are deprovisioned.
Benefits include:
- Automatic provisioning and deprovisioning as group membership changes
- Reuse of your existing directory groups for Grunt access control
- Less manual license administration
Connect your organization, configure Entra mappings, test your rollout, and renew your provisioning key.
#Operational notes
- Provisioning is not instant. Allow time for directory sync and API propagation.
- Keep the same group logic across HR, identity, and software deployment processes.
- If users still see expired-license errors after provisioning, troubleshoot endpoint access and proxy handling before reassigning licenses.
For deployment-related network requirements, continue to Network and security.