License management

What Is This Page?

The License Management page lets MSP administrators generate, assign, and revoke worker licenses. A worker license is the token that authorizes a specific worker instance to authenticate with the Intune Assistant backend and execute jobs against customer tenants.

Each license is tied to a single worker. Once assigned, it cannot be reassigned to a different worker without revoking it first.

This page is only visible to MSP accounts. If you are a direct (non-MSP) customer, your platform administrator manages worker licenses on your behalf — you do not need to interact with this page.

---

Key Concepts

What is a worker license?

A worker license is a cryptographic key in the format INTUNE-{customerid}-{randompart}. It is generated once, shown to you exactly once (copy it immediately), and then stored only as a hashed reference. When a worker registers or sends a heartbeat, it presents this key to authenticate itself.

Term	Meaning
Generated	License exists in the system but is not yet assigned to any worker
Assigned	License is linked to a specific worker registration
Revoked	License has been permanently deactivated; the worker using it will be rejected at next heartbeat

License quota

Your license quota controls how many licenses you can generate. It is tied to your Intune Assistant subscription (MaxTenants on your customer license). The quota bar at the top of the page always shows:

• Total licenses included in your plan
• How many have been issued (generated)
• How many are still available to generate

Once all quota slots are used, you must either revoke an existing license or contact Intune Assistant support to increase your quota before generating a new one.

Billing vs. deployment

Licenses are billed under your MSP account regardless of which customer tenant the worker is deployed in. This is by design — you pay for your workers centrally, and you can deploy them into any of your customer environments.

---

Page Layout

The page has three main sections:

Section	Purpose
Quota bar	Shows issued vs. total licenses at a glance; changes colour as you approach the limit
Generate License button	Opens the generation dialog
License table	All licenses with status, assignment, and actions

---

Quota Progress Bar

The bar at the top of the page displays X of Y licenses used.

Bar colour	When shown	What it means
Blue	Below 80% used	Healthy — plenty of quota remaining
Amber	80–99% used	Warning — you are running low
Red	100% used	Full — no more licenses can be generated

---

License Table

Each row represents one license.

Column	Description
License Key	The key, masked to the first 20 characters. Use the copy icon to copy the full key to the clipboard (only possible for un-revoked licenses where the key was shown at generation time).
Status	Active, Assigned, or Revoked badge
Assigned To	The worker registration ID the license is assigned to, or — if unassigned
Issued	Date the license was generated
Expires	Expiry date if set, or Never
Actions	Assign (if unassigned), Revoke

After a license is assigned via the Assign action, the "Assigned To" column shows the worker's machine name (if the worker has already registered) or the registration ID.

---

Generating a License

1

Click Generate License

Click Generate License at the top right of the page.

2

Fill in the form

Field	Required	Description
Recipient email	Yes	Contact email for the person responsible for this worker (used for notifications)
Company	No	The customer company name, for reference
Expiry date	No	Set an expiry if you want the license to automatically become invalid on a specific date. Leave blank for a perpetual license.
Notes	No	Internal notes visible only in this management page

3

Click Generate

Click Generate.

4

Copy the generated key

The generated key appears in a highlighted read-only field.

Save this key immediately. It is shown only once and cannot be retrieved later. Copy it to a password manager or securely hand it to the person installing the worker.

Click Copy to copy the full key, then click Close.

---

Assigning a License to a Worker

After generating a license, you can assign it to a specific worker registration. This step is optional at generation time — you can also assign later from the table.

From the table

1

Find the license row

Find the license row with Status: Active (unassigned).

2

Open the Assign action

Click Assign in the Actions column.

3

Select the target worker

Select the target worker from the dropdown. The dropdown shows only workers that:

• Have registration status Approved
• Do not already have a license assigned

4

Confirm the assignment

Click Assign License.

5

Assign license to worker

Last step is to assign the license at at worker side.

Cross-tenant assignment

If you are an MSP and the worker is deployed inside a customer tenant, you can still assign the license from your MSP account. The license remains billed under your MSP account; the worker validates it using the worker registration ID rather than the customer tenant ID.

---

Revoking a License

Revoking a license permanently deactivates it. The worker using it will fail authentication at the next heartbeat and stop executing jobs.

1

Find the license row

Find the license row in the table.

2

Open the Revoke action

Click Revoke in the Actions column.

3

Enter a revocation reason

Enter a revocation reason (required — this is logged in the audit trail).

4

Confirm revocation

Click Confirm Revoke.

Revocation is permanent. A revoked license cannot be re-activated. You will need to generate a new license and reinstall the worker.

---

Worker Detail Page — License Card

On the Worker Detail page (/worker/{id}), a License card shows the license status for that specific worker:

State shown	What it means
License assigned	The worker holds an active license. Shows the masked key and assignment date.
No license assigned	The worker is registered but does not have a license. It cannot authenticate until one is assigned.
License revoked	The worker's license has been revoked. The worker will stop functioning.

A Generate License button is also available directly on the worker detail page. This opens the same generation dialog pre-filtered for that worker, and after generating, immediately offers to assign it.

📸 [Screenshot placeholder: Worker detail page showing the License card with an active license]

---

MSP Workflow — End-to-End

Here is the complete workflow from first deployment to an operational worker.

1

Worker is installed at customer site

The engineer installs the Intune Assistant Worker on a server in the customer tenant. The worker registers itself and appears in your Worker Overview with status Pending.

2

Approve the worker

Go to Worker > Overview, find the new registration, and click Approve. Set a default sender email and recipient email for the worker (used by scheduled jobs unless overridden per-job).

3

Generate a license

Go to Worker > Licenses. Click Generate License. Fill in the recipient email (use the customer's IT contact). Copy the generated key immediately.

4

Assign the license

Either:

• Click Assign on the new license row and select the worker from the dropdown.
• Or hand the key to the engineer and have them paste it into the worker configuration. The worker will self-register the key on next startup.

5

Worker is operational

The worker's status changes to Approved + Licensed. It begins polling for jobs and executing scheduled reports.

📸 [Screenshot placeholder: License table with one Assigned license and green quota bar]

---

Frequently Asked Questions

Can I move a license from one worker to another?

No. Revoke the existing license and generate a new one for the destination worker.

What happens if a license expires?

The worker will fail its next license validation check and stop accepting jobs. It will not be automatically removed from the system. Generate a new license and assign it to restore operation.

I lost the license key after generating it. What do I do?

Revoke the lost license and generate a new one. The key cannot be recovered.

A customer has set up a worker without my involvement. Who manages the license?

For MSP customers, all worker licenses are managed centrally through your MSP account. A non-MSP customer's workers are licensed by the platform administrator — the customer does not have access to the license management page.

My quota is full but I need another license. What do I do?

Revoke any unused or obsolete licenses first. If you still need more, contact Intune Assistant support to increase your quota.

---

Related Pages

• Worker Overview — view and approve registered workers
• Worker Detail — manage a single worker, view license status
• Customer Information — view your subscription tier and license quota settings