Is the integration enabled, and does the panel show the right state?
The first check concerns whether the integration is really enabled where it should be. An installation without a token set on the server side shares nothing: an empty token means no path to the work history. This is a safe default setting, but also a common reason for the question 'why doesn't the portal see the history?'
The integration panel in the permissions and trainings module shows the status, the number of active passes, linked accounts, requests awaiting review and errors from the last 7 days. The settings are read-only, and keys never reach the browser. Before launch, check that the status matches the intended configuration.
Who holds the role that reviews requests?
Acceptance, rejection and retrying a decision are limited to the service administrator role. A new request creates a notification for exactly this role, so if nobody holds it, or the person holding it is absent, requests will wait. Appoint at least two people and check that each of them sees the panel and the notifications.
What should go into the procedure?
Record who replaces the administrator during holidays and how quickly they react to a new request. A contractor who waits a day for acceptance usually calls security, and that is a cost which can be avoided with one line in the procedure.
Number of checklist items by group
How do you check sign-in, MFA and locked accounts?
Logging in with a portal account follows the plant's standard path, so two-factor authentication works, and locked, disabled, deleted or expired accounts are rejected in the same way as with a password. Test three scenarios on test accounts: a correct sign-in, a locked account and an account with an expired validity date. Check that the messages are understandable to the employee.
The identity token from the portal is verified with an RS256 signature, using a key fetched from the issuer's public key set, together with checks of the issuer, the audience, the validity period and a one-time nonce value. Make sure the server can reach the public key set and that the server clock is synchronised, because the validity-period check will reject tokens when the clocks differ widely.
Error log and the machine token
Before you launch the integration for contractors, establish who reads the error counter for the last 7 days and what they do when it grows. A decision that does not reach the portal is saved with the request together with the error description and can be retried from the panel, so the log is a working tool, not just an archive.
The machine token of the portal, when registration from a QR poster is enabled, can create accounts and companies and issue passes. Token rotation and risk assessment must therefore cover this scope, not only reading the work history. The token must not appear in URLs or in configuration files in the repository. Plan the date of the first rotation and the person responsible.
Registration from a poster and automatic acceptance of requests
Registration from a QR poster and automatic acceptance of requests from linked companies are options enabled by configuration and disabled by default. If there is no conscious decision, leave them off. If you enable either of them, record the decision and add it to the risk analysis of the token.
Checklist
Video
Frequently asked questions
What does an empty token on the server side mean?
An installation without the integration enabled shares nothing. This is a safe default setting.
Can the panel be used to change the integration settings?
The settings in the panel are read-only, and keys never reach the browser. Changes are made in the configuration of the installation.
Why does token rotation require a risk assessment?
With registration from a poster enabled, the token can create accounts and companies and issue passes, so its leak has greater consequences than the disclosure of the work history alone.
Sources
Let's go through this list with your administrator
In a technical meeting we will verify the installation configuration point by point and leave you a ready list to repeat after every change.
Let's talk