A newer version of this documentation is available.

View Latest

Custom

[Custom]
AdminCertificateIssuer={issuer:2.5.4.3}
AdminTokenDescription={token-number-string}
AdminTokenName={token-name}
AutoRenewServer=
AutoRenewTask=
AutoRenewTokenModel=*
AutoRenewIssuerName=*

AdminCertificateIssuer

Presentation of Issuer field in administration utility.

AdminTokenDescription

Presentation of Token description field in administration utility.

AdminTokenName

Presentation of Token name field in administration utility.

Token and certificate auto renewal

Here are the properties to use when you use the token and certificate auto renewal function.

AutoRenewServer

To use the token and certificate auto renewal function, setting the AutoRenewServer property is mandatory. If it has no value, the function is turned off.

Examples

Example 1. Set up the Net iD Portal renewal server.

To set up the server, use the host name of the Net iD Portal that you use.

[Custom]
AutoRenewServer=nip.example.com (1)
1 Net iD Portal server host name

AutoRenewTask

The AutoRenewTask sets which task to run. The setting is optional, and if no task is given a task is chosen automatically.

If a task exists, it will be used. If more than one task exists, a task containing both the words "token" and "renew" is used. The words are case insensitive so both "RenewToken" and "renewtoken" can be used, but "RenewToken" is the default task type name in Net iD Portal.

It is recommended to not set this property, and make sure to configure Net iD Portal so that there is only one applicable task type available for self-service.

Examples

Use the task RenewToken in Net iD Portal.

To use the task RenewToken in Net iD Portal, set the AutoRenewTask property to:

[Custom]
AutoRenewTask=RenewToken

AutoRenewTokenModel

The AutoRenewTokenModel property sets the token model to use by matching conditions to activate the autorenew dialog. To set this property is mandatory, but if it is set to the wildcard * it matches all cards.

Examples

Example 2. Only allow IDEMIA smart cards to be renewed.

To only allow, for example, IDEMIA smart cards, use the following setting.

[Custom]
AutoRenewTokenModel=IAS ECC*

AutoRenewIssuerName

The AutoRenewIssuerName is the common name used by matching conditions to activate the autorenew dialog. To set this property is mandatory. If it is set to the wildcard * it matches all cards.

This property makes a check of the issuer common name, that is, 2.5.4.3 in the issuer field.

Examples

Example 3. Only allow smart cards with common names starting with YourName to be renewed.

To only allow smart cards with a common name starting with YourName, use the following setting.

[Custom]
AutoRenewIssuerName=YourName*