Events
Events can occur when there is a change in the lifecycle of objects (for example, change of state, performed action, etc.). Monitoring events fire as part of scheduled monitoring, when an object's state or properties require user attention.
Events are linked to a resource to specify the type of objects that are the subject of the event (e.g. certificate, discovery, etc.).
Events automation
The platform provides a sophisticated workflow system that can be utilized for automation. Each event can be associated with triggers that are executed when the event occurs. Triggers can be configured in platform settings or on an overriding resource object. To inspect what happened when triggers ran, use the Event Viewer.
Event triggers are automated mechanisms that respond to specific events within the platform and allow you to:
- Automate responses to certificate lifecycle events
- Implement custom business logic for event handling
- Create complex workflow automation
- Ensure compliance with organizational policies
- Integrate with external systems and processes
- Notify based on configured notification profiles
Supported events
| Event | Resource | Overridden By | Monitoring | Description | Event Data |
|---|---|---|---|---|---|
| Certificate status changed | Certificate | RA profile, Group | NO | Occurs when the certificate validation status changes | CertificateStatusChangedEventData |
| Certificate action performed | Certificate | RA profile, Group | NO | Occurs after certificate operation (e.g.: issue, renew, rekey, revoke, etc.) was completed | CertificateActionPerformedEventData |
| Certificate expiring | Certificate | RA profile, Group | YES | Occurs every hour when there are expiring certificates that do not contain a valid replacement | CertificateExpiringEventData |
| Certificate not compliant | Certificate | RA profile, Group | NO | Occurs when the certificate is evaluated as not compliant | CertificateNotCompliantEventData |
| Certificate discovered | Certificate | Discovery | NO | Occurs when the certificate has been newly discovered | CertificateDiscoveredEventData |
| Certificate uploaded | Certificate | NO | Occurs when a certificate is uploaded or imported | CertificateEventData | |
| Certificate registered | Certificate | RA profile, Group | NO | Occurs when a challenge-protected certificate registration completes, carrying the credential and completion deadline to finish issuance | CertificateRegisteredEventData |
| Discovery finished | Discovery | NO | Occurs when discovery process has been finished | DiscoveryFinishedEventData | |
| Approval requested | Approval | NO | Occurs when requesting approval | ApprovalEventData | |
| Approval closed | Approval | NO | Occurs after approval was closed | ApprovalEventData | |
| Comment created | Comment | Group | NO | Occurs when a thread or a reply is written on an object | CommentEventData |
| Comment resolved | Comment | Group | NO | Occurs when a thread is resolved or reopened | CommentEventData |
| CBOM synced | CBOM | NO | Occurs once for each CBOM, when its cryptographic assets have been added to the inventory for the first time | CbomSyncedEventData | |
| Cryptographic asset not PQC ready | Cryptographic Asset | NO | Occurs when the post-quantum readiness verdict of a cryptographic asset becomes Not PQC ready | CryptoAssetPqcNotReadyEventData | |
| Scheduled job finished | Scheduled job | NO | Occurs when scheduled job execution finished | ScheduledJobFinishedEventData |
External notifications can also carry data about the event's object, when the notification profile enables event data.
Certificate Uploaded event
The Certificate Uploaded event fires when a certificate is uploaded or imported. It does not fire for certificates that enter the inventory through issuance or discovery — those have their own events.
When the event fires, the platform evaluates the triggers configured for it in Settings → Events in two stages:
- Ignore triggers are evaluated first. If the certificate matches any ignore trigger, it is rejected and not added to the inventory.
- Action triggers are evaluated for certificates that pass the ignore stage. They categorize the certificate — setting its Groups, RA profile, Owner, and custom attributes — and can send notifications through the configured notification profiles.
Unlike most certificate events, Certificate Uploaded cannot be overridden per RA profile or Group. Its triggers are configured only at the platform level.
Custom attribute values supplied in the upload request take precedence: they are applied after the action triggers run and override any conflicting values the triggers set.
The upload can be processed synchronously or asynchronously. A synchronous upload returns once the certificate has been processed and added to the inventory. An asynchronous upload returns immediately, and the certificate appears in the inventory once processing — including trigger evaluation — has completed.
Rejected uploads
A certificate upload is rejected in either of these cases:
- Ignore trigger match — the certificate matches one of the configured ignore triggers.
- Duplicate — a certificate with the same fingerprint already exists in the inventory.
In both cases the certificate is not added to the inventory.
Ignore-trigger rejections are recorded in the Certificate Uploaded event history together with the matching ignore trigger, so administrators can see that an upload was rejected. The event history does not retain the rejected certificate's own details. To identify the specific certificate, use one of:
- The audit logs, with verbose audit logging enabled in the logging settings.
- The notification message produced by the configured notification profile for this event. The notification carries the event's
CertificateEventDatapayload, which identifies the certificate but does not include the complete certificate.
Duplicate rejections are detected before the Certificate Uploaded event fires and are therefore not recorded in its event history; the duplicate is reported by the upload request itself.
Certificate Registered event
The Certificate Registered event fires when a challenge-protected certificate registration completes successfully — the moment its placeholder reaches the Registered state, ready for the holder to complete issuance. It fires exactly once per registration, on both the synchronous and asynchronous registration-completion paths, and does not fire for ordinary issuance. A pre-registration created without an authorization secret does not raise this event — there is no credential to deliver.
Its payload carries the certificate identity, the issuance-completion deadline, and the one-time credential the recipient presents to complete issuance. By default the event notifies the certificate owner; the recipient is configurable through the notification profile.
Delivering the credential requires an external notification provider. The credential is included only in the payload sent to an external notification provider (for example e-mail) configured for this event — it is deliberately excluded from the in-platform (internal) notification, from event history, and from logs. If no external notification provider is configured for the event, the platform does not deliver the credential automatically: the operator who set the challenge relays it to the recipient out of band.
Comment events
The Comment created and Comment resolved events fire for comments on any commentable object. The event is linked to the comment, and the payload carries the comment text exactly as written, the object it belongs to, and, for resolution, who resolved the thread and when. Reopening a resolved thread raises Comment resolved with the thread marked as not resolved.
The triggers of these events can be overridden per Group: a trigger associated with a group applies to comments on objects that belong to that group, in addition to the triggers configured in Settings → Events. Nothing is delivered through a notification profile unless one of these triggers uses it, in a Send Notification execution of its action; see Send notifications on events.
The owner of the object and the participants of the thread are notified internally without any association. See Notifications for details, including the note on who receives the comment text.