auto-enroll

Function

The auto-enroll command enables automatic certificate enrollment and update.

The undo auto-enroll command disables automatic certificate enrollment and update.

By default, the automatic certificate enrollment and update are disabled.

Format

auto-enroll [ percent ] [ regenerate [ key-bit ] ]

undo auto-enroll

Parameters

Parameter	Description	Value
percent	Specifies the percentage of the certificate's validity period after which a new certificate is requested automatically.	The value is an integer that ranges from 10 to 100. The default value is 100. When the old certificate expires, the system requests a new certificate.
regenerate	Indicates the RSA key pair will be generated during certificate updates.	-
key-bit	Specifies the number of bits in the RSA key pair generated during certificate updates.	The value is an integer that ranges from 2048 to 4096 bit. The default value is 2048 bit.

Parameter

Description

Value

percent

Specifies the percentage of the certificate's validity period after which a new certificate is requested automatically.

The value is an integer that ranges from 10 to 100.

The default value is 100. When the old certificate expires, the system requests a new certificate.

regenerate

Indicates the RSA key pair will be generated during certificate updates.

key-bit

Specifies the number of bits in the RSA key pair generated during certificate updates.

The value is an integer that ranges from 2048 to 4096 bit. The default value is 2048 bit.

Views

PKI realm view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Automatic certificate enrollment: When the certificates are unavailable, will expire, or have expired, an entity automatically requests a new certificate or renews the certificate using the Simple Certification Enrollment Protocol (SCEP).

By default, the automatic certificate enrollment and update function is disabled. When a certificate has expired, you must request a certificate for an entity manually. You can still request a certificate for an entity manually when the automatic certificate enrollment and update function is enabled.

Precautions

If you do not specify regenerate, the system uses the original RSA key pairs during automatic updates.
If you specify regenerate, the system generates new RSA key pairs during certificate updates for certificate requests and overwrites the original certificates and RSA key pairs with the new ones.

Example

# Enable automatic certificate enrollment and update for the PKI realm abc.

<sysname> system-view
[sysname] pki realm abc
[sysname-pki-realm-abc] auto-enroll 50 regenerate