License confirmation and connection to the service

A tracker with an activated license confirms it with the license service automatically every few minutes. The status and the dates are shown in Settings → License («Настройки → Лицензия»). Owners and admins can see this section.

What a confirmation is

A confirmation is the license service's response saying that the license is valid for this installation and this panel domain. The tracker gets it when you activate the key and then renews it automatically. While the confirmation is valid, the panel is open.

• One confirmation is valid for 10 minutes, but no longer than the term of the license itself.
• A confirmation is issued only for the installation and the panel domain the license is bound to.
• The confirmation does not affect traffic: clicks and incoming conversions are recorded in any license status.

The license transfer also depends on the confirmation term: after you unbind the server in your account, the new key activates once the old server's confirmation ends — usually within 10 minutes. For details, see Transferring a license to another server.

Where to see the confirmation term

In the “Micator license” («Лицензия Micator») block on the Settings → License tab:

• the status line under the heading — the current status, see the status reference;
• Works offline until («Работа без связи с сервисом до») — the term of the current confirmation. Until that time the panel is open, even if the license service does not respond;
• the red line at the bottom of the block — the error of the last check with the saved key. After a successful check the line disappears;
• Check renewal («Проверить продление») — requests a confirmation right away, using the saved key. Only the installation owner sees this button.

Dates are shown in the browser's time zone, and the block's data refreshes every 15 seconds. The other elements of the tab are described on How the license works.

How often the tracker renews the confirmation

The tracker requests a new confirmation roughly every 4–5 minutes, without waiting for the current one to end. The time in the Works offline until field moves forward each time.

After a license renewal, the tracker gets the new term at the next check. To avoid waiting, the installation owner clicks Check renewal.

License service unavailable

If the tracker could not get a response from the license service, the red line “License service unavailable; we will retry the check automatically” («Сервис лицензий недоступен; повторим проверку автоматически») appears at the bottom of the block. You do not need to do anything:

• the tracker retries the request every 1–2 minutes;
• until the time in the Works offline until field, the panel, the API and outgoing events work as usual;
• after the first successful response, the error line disappears and the term in the field moves forward.

The offline margin is whatever remains of the current confirmation, usually 5 to 10 minutes. If the connection has not come back by then, the status changes to “License confirmation required” («Нужно подтвердить лицензию»).

The “License confirmation required” status

The confirmation has ended, and the tracker has not received a new one. Instead of the panel, the “Tracker access closed” («Доступ к трекеру закрыт») screen opens with the same “Micator license” block. Traffic and conversion intake continue, and outgoing events wait in the queue — see License expiry: what is closed and what keeps working.

The tracker keeps requesting a confirmation every 1–2 minutes. After the first successful response, the panel opens on its own and events from the queue are sent automatically.

To avoid waiting:

1. Log in to the panel as the installation owner.
2. Click Check renewal in the “Micator license” block.

On success, the panel opens. If the check failed, a red line with the reason appears under the block heading. Find this message in the message reference, fix the cause and click Check renewal again.

Service refusal: access closes immediately

If the license service replied that the license is not valid, access closes immediately, without waiting for the confirmation to end. The status is “License unavailable” («Лицензия недоступна»), and the red line reads “License expired, revoked or bound to another installation” («Лицензия истекла, отозвана или привязана к другой установке»).

Reasons for refusal:

• the license term has ended;
• the license has been suspended or revoked;
• the server was unbound in your account: after unbinding, the license gets a new key and the old one is no longer accepted;
• the license is bound to another installation or another panel domain.

The license status and the bound domain are shown in your account, in the Licenses section: the Status and Domain columns.

In this status, too, the tracker repeats the check every 1–2 minutes. If the cause is removed, for example the license is renewed, the panel opens on its own. After unbinding the server, activate the new key — see Transferring a license to another server.

Network and time on the server

The tracker contacts the license service itself, at https://micator.com. Outgoing HTTPS connections from the server to this address must be allowed. Incoming connections are not needed for the license check.

The server clock must be accurate:

• If the server time has been set back relative to the last license check, the status changes to “Check the server time” («Проверьте время на сервере») and the panel closes. Once the time is fixed, this status clears by itself.
• If the server clock is behind or ahead by several minutes or more, the tracker does not accept new confirmations: the message “Invalid license confirmation” («Некорректное подтверждение лицензии») appears.

The clock of the computer you open the panel from does not affect the check.

Changing the panel domain or the server secret

The panel domain was changed

The license is bound to the panel domain. After the panel domain changes, the status becomes “License check failed” («Проверка лицензии не пройдена»), and after the next check — “License unavailable”. The old key does not activate with the new domain.

Transfer the license: unbind the server in your account, wait until the new key is ready, and activate it in the tracker. The steps are on Transferring a license to another server.

The installation's server secret was changed

After the server secret changes, the tracker cannot read the saved license key or renew the confirmation. When the current confirmation ends, the status becomes “License confirmation required”, and the Check renewal button replies: “Save the license key again: the server secret has changed” («Сохраните ключ лицензии заново: изменился серверный секрет»).

1. Open the Licenses section in your account.
2. Click Manage in the license row.
3. Click Copy in the key row.
4. Paste the key into the License key («Ключ лицензии») field in the tracker.
5. Click Activate («Активировать»).

You do not need to unbind the server: the installation and the panel domain are the same. The server secret is stored in the .env.production file — see Installation files, ports, services and logs.

Status reference

What each status means is described on How the license works. The panel is open in the “License active” («Лицензия активна») and “Licensing not enabled yet” («Лицензирование ещё не подключено») statuses. In all other statuses, the “Tracker access closed” screen opens instead.

Message reference

The error of the last automatic check is shown as a red line at the bottom of the “Micator license” block. The response to clicking Activate or Check renewal is shown as a line under the block heading.