Manage organization entitlements

In 10Duke SysAdmin, you can create and manage organizations’ entitlements, which contain their licenses.

An organization must have at least one entitlement to store their licenses.

Create an organization entitlement

Before you start:

• Entitlements are specific to an organization, so make sure the organization has been created.

To create an entitlement for an organization:

1. In SysAdmin in the left sidebar, go to ENTITLEMENTS > Organization.

2. Click Change organization, search and select the organization, and click Confirm.

   The organization’s entitlements table opens.

3. Select Actions > Create. A dialog opens.

4. In Name, define a name for the entitlement.

5. In Description (optional), write a short description.

6. Click Save to create the entitlement.

You can copy the unique ID of the new entitlement from the table: click the copy icon on the row on the right. The entitlement ID must be included in the request path when calling some of the 10Duke API endpoints.

Next steps:

• If you want this to be the organization’s default entitlement, see instructions below.

• Grant licenses to the organization in the entitlement.

• Authorize the organization’s user groups to access the entitlement.

Change the organization’s default entitlement

If you grant licenses using the 10Duke Entitlement Management REST API, they are created in the default entitlement.

To change the default entitlement:

1. Go to the organization’s entitlements table as described above.

2. Select the entitlement in the table and select Actions > Set as default.

Edit an organization entitlement

1. Go to the organization’s entitlements table as described above.

2. Select the entitlement in the table and select Actions > Edit.

3. Edit the fields in the same way as when creating an entitlement.

The changes take effect immediately.

Delete an organization entitlement

Caution: Deleting an entitlement also deletes all the licenses in that entitlement.

Before you start:

• If the entitlement contains licenses that must not be deleted, you can move them to another entitlement of the same organization.

• If you have multiple entitlements and you want to delete the default one, consider first setting one of the others as default (see instructions above). Otherwise if licenses are granted through the Entitlement Management REST API, a new entitlement is automatically created for the licenses and set as default.

• If licenses are being granted using the Entitlement Management REST API, a particular transaction item’s licenses should be deleted all in one go. If the entitlement contains only some of the licenses from a transaction item, move licenses as needed to prevent any issues. See more about provisioning using transactions through the Entitlement Management REST API.

To delete an entitlement from an organization:

1. Go to the organization’s entitlements table as described above.

2. Select the entitlements you want to delete and select Actions > Delete.

3. Click OK to confirm the deletion.

If a user is currently consuming a license that was deleted, they are able to continue consuming the license until the license lease expires or the client application tries to refresh the lease, whichever comes first.