For the complete documentation index, see llms.txt. This page is also available as Markdown.

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

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.

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.


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.


  • 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

Last updated