Manage Your NIM License
Configuration → Settings → License
Activate NIM with your supplied license code, confirm its status, and understand which identity capabilities are enabled in your environment.
An invalid or missing license limits NIM functionality. In particular, NIM marks filters as invalid, which prevents identity automation that depend on them from running correctly.
Check the license first. If the license is expired or invalid, filters may all show as invalid even when their configuration is otherwise correct.
Activate a license codeDirect link to Activate a license code
Use the license code supplied with your NIM purchase. Copy the complete code, including the BEGIN_CODE and END_CODE lines.
1. Open the License settingsDirect link to 1. Open the License settings
In NIM Studio, go to Configuration → Settings, then select the License tab.
2. Add the complete license codeDirect link to 2. Add the complete license code
Paste the supplied license into License Code. Do not remove the BEGIN_CODE or END_CODE lines, then select Save.
3. Confirm the license is activeDirect link to 3. Confirm the license is active
Review the Status pane. A successful activation clears the license error and shows your license information; NIM can then use the capabilities included in that license.
License fieldsDirect link to License fields
Review the license information and status details in Configuration → Settings → License. These values are set when the license is issued; activating a code applies the terms included in that code.
| Field | Meaning |
|---|---|
| Id | Unique identifier of the license, typically a GUID generated by the issuing system. |
| Product | The licensed product. For a NIM license, this is always NIM. |
| Type | The license's intended use: Consultancy, Evaluation, or Subscription. See License types. |
| IssuedTo | The person or organization receiving the license, identified by a name or email address. This value is non-empty and is displayed prominently in the NIM frontend. |
| SystemId | Identifies the host licensed to run NIM. The identifier is currently the hostname. An unrestricted value (*) allows use on any host. This is different from the connected systems managed within NIM. |
| MaxNrOfSystems | Maximum number of identity management systems NIM is licensed to connect to. An unrestricted value (*) removes this limit. |
| MaxRelationSize | Licensed maximum number of inter-system relations. An unrestricted value (*) removes this limit. |
| ValidUntil | Last date on which the license is valid. An unrestricted value (*) means there is no license expiration date. |
| SupportUntil | Last date covered by the license's support entitlement. |
| GracePeriod | Number of days during which a license-limit violation can be tolerated. A value of 0 disables the grace period. See Grace periods. |
* means unrestricted where that field and license type permit it. It does not mean every license field can be unrestricted. The code issued for your environment determines the actual limits and dates.
License typesDirect link to License types
| Type | Intended use |
|---|---|
| Consultancy | Issued to a specific consultant for use on any host for a limited time. |
| Evaluation | Issued to a potential or existing customer for evaluation on a specific host for a limited time. |
| Subscription | A regular commercial license valid for a subscription period, with a specified renewal interval. |
Subscription licenses and renewalDirect link to Subscription licenses and renewal
For a subscription license, ValidUntil is set to the renewal date. Arrange renewal before that date and apply the renewed license code using the activation steps.
License statusDirect link to License status
NIM checks license fields during operation; some checks run periodically. Each checked item has its own state and explanatory text. The overall status combines those results.
| Status | Meaning | Effect on NIM |
|---|---|---|
| Valid | All checked license items are valid. | NIM operates within the capabilities and limits of the license. |
| Alert | No checked item is invalid, but one or more items are approaching a limit or are covered by an active grace period. | NIM retains normal functionality. Review the explanation and resolve the condition before it becomes invalid. |
| Invalid | At least one checked license item is invalid. | Some or all key functions stop executing. Review the explanation and resolve the license issue. |
Open the License tab to inspect the individual status explanations. NIM also prominently indicates an overall Alert or Invalid state in the frontend. An invalid license can cause filters to be marked invalid, preventing dependent configuration from running.
Grace periodsDirect link to Grace periods
When enabled, GracePeriod temporarily extends validity for a specified number of days in a situation that would otherwise make the license invalid. While the grace period is active, the affected item's status is Alert.
A grace period is time to resolve the reported condition, not a permanent increase in license limits or a renewal. Check the status explanation and arrange a corrected or renewed license before the grace period ends. A GracePeriod of 0 provides no extension.
License modulesDirect link to License modules
Your license can enable one or more NIM modules. Availability depends on the license issued for your environment.
| Module | What it enables |
|---|---|
| Exports | Export and multi-export scheduled tasks. |
| Onboarding | NIM Onboarding, allowing new users to verify identity and set their own first password without receiving a shared credential. |
| Password Reset | Self-service password reset, allowing users to verify identity and reset a forgotten password. |
| Provisioning | Account management in target systems through filters and mappings. |
| Roles | Group-membership assignment through roles. |
If activation does not succeedDirect link to If activation does not succeed
- Confirm you copied the entire code, including its boundary lines.
- Verify that the code was issued for this NIM environment and has not expired.
- For a host-specific license, compare
SystemIdwith the System Identifier shown by NIM, especially after moving the service or changing the hostname. - Save the code again, then review the Status pane for the reported state.
- If the license remains invalid or expired, contact Tools4ever Support with the status information.
Include license status in routine platform checks and ensure the people responsible for NIM administration can obtain a replacement or renewed code before the current license expires.