You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+44-20Lines changed: 44 additions & 20 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -399,33 +399,57 @@ There are five (5) possible options:
399
399
5. Other
400
400
- This certificate usage identifies all other certificates on the camera that do not fall under the pre-defined usages above.
401
401
402
-
> [!NOTE]
403
-
> A Reenrollment (ODKG) job will not allow enrollment of certificates with **Trust** assigned as the \`Certificate Usage\`.
404
-
> Trust CA certificates can be added to the camera via a Management - Add job.
405
-
> These CA certificates establish trust for TLS connections initiated by the camera.
402
+
403
+
## Enrollment Behavior
404
+
405
+
The following enrollment behaviors are specific to AXIS cameras and should be considered when designing certificate automation workflows.
406
+
407
+
### Alias Versioning
408
+
409
+
AXIS cameras require each Alias to be unique, and each Alias is tightly coupled with the private key used to generate its certificate. Because of this, certificates cannot be reenrolled in place by replacing the certificate and private key associated with an existing Alias.
410
+
411
+
To support certificate renewals and automation workflows, the orchestrator generates a unique Alias by appending the following suffix:
412
+
413
+
`_yyMMddHHmm`
414
+
415
+
where `yyMMddHHmm` represents the current UTC date and time.
416
+
417
+
From an automation perspective, the same Alias can continue to be reused, as uniqueness is enforced by the integration.
418
+
419
+
> [!NOTE]
420
+
> As of v1.1.0, Reenrollment jobs automatically manage versioned Aliases. When reenrolling a certificate using the same Alias, the integration creates a new certificate using a versioned Alias and removes the previously enrolled certificate associated with the same base Alias.
421
+
>
422
+
> Because AXIS cameras do not support in-place certificate replacement, a new versioned Alias is still created during reenrollment. The integration identifies and removes the previous certificate by matching the base Alias name and ignoring the timestamp suffix.
423
+
>
424
+
> If a new Alias is supplied during reenrollment, the original certificate (if one exists) associated with the selected `Certificate Usage` is **not** automatically removed from the camera. Because AXIS cameras have limited certificate and key storage capacity, users should periodically review and remove unused certificates through the AXIS Network Camera GUI.
425
+
426
+
### Certificate Usage Considerations (Trust)
406
427
407
428
> [!NOTE]
408
-
> As of Keyfactor Command v25.4, SANs can be provided for a Reenrollment (ODKG) job.
409
-
> You must also have installed, at minimum, the Keyfactor Universal Orchestator v25.1
410
-
> in order for the SANs to be sent to the orchestrator.
411
-
>
412
-
> The Axis IP Camera API *only* supports the addition of DNS and IP SANs. If you add other SAN types to the ODKG job, these will be ignored and not added to the certificate.
413
-
>
414
-
> * If SANs are NOT provided and the \`Certificate Usage\` assigned is **HTTPS**, IP and DNS will be automatically added as SANs to an enrolled certificate associated with a NEW alias.
429
+
> If a Reenrollment (ODKG) job is configured with `Trust` selected as the `Certificate Usage`, the job will return a warning indicating that the operation is not supported.
415
430
>
416
-
> * IP = Client Machine configured for the certificate store (excluding any port)
417
-
>
418
-
> * DNS = CN set in the Subject DN
431
+
> Trust CA certificates must be installed using a **Management - Add** job. These certificates establish trust for TLS connections initiated by the camera.
419
432
433
+
### Subject Alternative Names (SANs)
420
434
421
-
## Caveats
435
+
As of Keyfactor Command v25.4, Subject Alternative Names (SANs) can be specified for Reenrollment (ODKG) jobs. Support for passing SANs to the orchestrator also requires, at minimum, Keyfactor Universal Orchestrator v25.1.
422
436
423
-
> [!NOTE]
424
-
> v1.1.0 - A Reenrollment job will now replace the certificate contents for an existing alias on the camera, therefore, not requiring
425
-
> a new alias be supplied for every new certificate enrollment.
437
+
The AXIS IP Camera API only supports DNS and IP SAN types. Any other SAN types included in the Reenrollment job will be ignored and will not be added to the enrolled certificate.
438
+
439
+
> [!NOTE]
440
+
> If SANs are not provided and the selected `Certificate Usage` is `HTTPS`, IP and DNS SANs are automatically added when enrolling a certificate associated with a new Alias:
426
441
>
427
-
> If a new alias is supplied, a Reenrollment job will not remove the original certificate associated with the \`Certificate Usage\`.
428
-
> Since the camera has limited storage, it will be up to the user to remove any unused certificates via the AXIS Network Camera GUI.
442
+
> - **IP** = The Client Machine configured for the certificate store (excluding any port number)
443
+
> - **DNS** = The Common Name (CN) specified in the certificate Subject DN
444
+
445
+
## Operational Notes
446
+
447
+
### AXIS OS 12 Firmware Recommendation
448
+
449
+
> [!IMPORTANT]
450
+
> Devices running the AXIS OS 12 release track should always be updated to the latest firmware version available from Axis. Previous firmware versions are no longer supported once a newer release becomes available.
451
+
452
+
Axis identified a memory leak in older firmware releases that may cause device keystore storage to become exhausted over time. If keystore storage issues are observed, verify that the device is running the latest supported firmware version.
0 commit comments