Dialog Image
Dialog images are used by the credential provider and sometimes the internal dialogs. The internal dialogs are fully customizable so there is no telling whether the image will be used even if the information is sent. The configuration is used to send the information. The dialog implementation will decide whether it is used or not.
The configuration is a list of available images and will search from 1 until an image with matching criteria is found.
[Dialog Image]
01=logo.ico
02=logo_({issuer:2.5.4.3}).ico
03=logo_admin.ico -match {CertificateAdmin} -dialog (1)| 1 | For more information about matching conditions, see Match. |
The specified file image can be stored in different locations depending on your package, and is assumed to be present.
It is possible to dynamically change the image without requesting a new installation package. The recommended solution is to use the global configuration. All image files can be read from the "data" location, so the "logo" example above is stored in the following location (or use the GPO location):
The data is either stored as binary value or base64-encoded string for Registry. The data must be stored as base64-encoded value for file.
Run command as administrator/root
> netid.exe -config set -name logo.ico -value C:\Temp\logo.ico -path HKLM\SOFTWARE\Pointsharp\NetiD\Client
> netid -config set -name logo.ico -value /tmp/logo.ico -path /etc/netid.confIt is possible to specify full path to an image location direct, and even use environment variables.
[Dialog Image]
01=file:///C:\Temp\logo.ico
02=file:///%TEMP%\logo.ico| This is not recommended because of security reasons so only use while testing. |
#, number sign
The hash or number sign, also called octothorpe, is a number starting from 01. Each number is a dialog image and its settings.
Options
- -dialog
-
Only used by internal dialog
- -credential <USAGE>
-
Only used by credential provider, LOGON/UNLOCK_WORKSTATION/CHANGE_PASSWORD/CREDUI usage scenario not required
- -size number
-
Only used when a specific size is requested
- -default
-
Default image, will match anything
- -match {MATCH}
-
Matching condition
- -loading
-
Show image during loading
[Dialog Image]
01=tile_load.png -loading -dialog
02=tile_load.ico -loading -credential
03=tile_missing.png -match {TokenMissing} -dialog
04=tile_missing.ico -match {TokenMissing} -credential
05=tile_empty.png -match {TokenEmpty} -dialog
06=tile_empty.ico -match {TokenEmpty} -credential
07=tile_({subject:2.5.4.10})_locked.png -match {TokenLockedPIN} -dialog
08=tile_({subject:2.5.4.10})_locked.ico -match {TokenLockedPIN} -credential
09=tile_({subject:2.5.4.10})_admin.png -match {CertificateAdmin} -dialog
10=tile_({subject:2.5.4.10})_admin.ico -match {CertificateAdmin} -credential
11=tile_({subject:2.5.4.10}).png -dialog
12=tile_({subject:2.5.4.10}).ico -credential
13=tile_({issuer:2.5.4.3})_locked.png -match {TokenLockedPIN} -dialog
14=tile_({issuer:2.5.4.3})_locked.ico -match {TokenLockedPIN} -credential
15=tile_({issuer:2.5.4.3})_admin.png -match {CertificateAdmin} -dialog
16=tile_({issuer:2.5.4.3})_admin.ico -match {CertificateAdmin} -credential
17=tile_({issuer:2.5.4.3}).png -dialog
18=tile_({issuer:2.5.4.3}).ico -credential
19=tile_locked.png -match {TokenLockedPIN} -dialog
20=tile_locked.ico -match {TokenLockedPIN} -credential
21=tile_admin.png -match {CertificateAdmin} -dialog
22=tile_admin.ico -match {CertificateAdmin} -credential
23=tile.png -default -dialog
24=tile.ico -default -credential