A newer version of this documentation is available.

View Latest

Dialog Presentation

This section is used to customize presentation for internal dialogs using the new web-based user-interface and Credential Provider dialogs.

The intention is to be able to show different information depending on the certificate, to enhance the user experience when selecting the certificate or enter the PIN. The information displayed is always one image and several text fields.

The following wild cards may be used below.

  • %cardlabel%

  • %cardnumber%

  • %expire%

  • %issuer.<object identifier>%

  • %keyusage%

  • %pinattempts%

  • %scenario%

  • %space%

  • %subject.<object identifier>%

  • %upn%

Card label and number are retrieved from the smart card. Key usage and expire will be retrieved from the certificate. For issuer and subject values, the object identifiers will be used to specify the values retrieved from the issuer respective subject fields of the certificate. The UPN value is the user principal name from the certificate. The PIN attempts will be available with a warning message when 0, 1 and 2 attempts remains. The space value is a single white space. The scenario is only available for Credential Provider and specifies the active scenario: CREDUI/LOGON/UNLOCK_WORKSTATION.

Language

To handle different strings for different language entries: Title, SubTitle, TextAbove and TextBelow may be prefixed with a short name of the language.

Title=eID Card %cardlabel%
en_Title=eID Card %cardlabel%
se_Title=eID Kort %cardlabel%

Multiple Choices

To handle different strings for different type of certificates: Image, Title, SubTitle, TextAbove and TextBelow may be specified with multiple choices, first combination that generates a non-empty string will be used. Separate with ; and will check from left to right.

Title=%subject.2.5.4.3%;%cardlabel%
Since character ; is used as separator, it may not be used as a part of the value.

Image

This entry specifies a list of images which may be used to display a certificate, bmp and ico files are supported. Use the wild cards above, wild cards will always be replaced, not found will generate an empty value. The search will try to find an entry in the same section with the generated string after wild card replacement.

Image=BMP(%issuer.2.5.4.3%);
BMP(SecMaker CA v2)=iidxca2.ico
BMP(SecMaker CA v3)=iidxca3.ico

or

Image=BMP(CA);
BMP(CA)=iidxca_%issuer.2.5.4.3%.ico

It is also possible to specify a nomatch and default image that will be shown for unknown certificates, without this entry Microsoft standard bitmap will be used.

BMP(Default)=iidxdef.bmp
BMP(NoMatch)=iidxnomatch.bmp

Unknown certificate means that the certificate is external, or that no smart card is present.

Image=BMP(%issuer%.2.5.4.3);BMP(NoMatch)
BMP(SecMaker CA v2)=iidxca2.ico
BMP(SecMaker CA v3)=iidxca3.ico
BMP(Default)=iidxdef.ico
BMP(NoMatch)=iidxnomatch.ico

Title

This entry specifies the title for selection entry. Use any combination of static text and wild cards above.

Default value is certificate common name. This value is always visible.

Title=%subject.2.5.4.3%

SubTitle

This entry specifies the subtitle for selection entry. Use any combination of static text and wild cards above.

Default value is static text "Smart card logon", translated to local language. This value is always visible.

SubTitle=%issuer.2.5.4.3%

TextAbove

This entry specifies an extra text field for the selection entry, located above the PIN entry edit field. Use any combination of static text and wild cards above.

Default value is user principle name from the certificate. This value is visible when selection entry is selected.

TextAbove=%cardlabel%

TextBelow

This entry specifies an extra text field for selection entry, located below the PIN entry edit field. Use any combination of static text and wild cards above.

Default value is none. This value is visible when selection entry is selected.

TextBelow=%pinattempts%