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 (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):

Figure 1. Windows

Figure 2. Linux/macOS, add in end of /etc/netid.conf

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.

Example 1. Use internal configuration command to store the values.

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.conf

Example 2. Using full image path

It 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 1. 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=logo48.png -credential -size 48 -match {MATCH}
02=logo.ico -credential -match {MATCH}
03=logo.ico -credential -loading
04=logo.ico -credential CHANGE_PASSWORD
05=logo.ico -credential -default
06=logo.ico -dialog -default