Index Files

The main customization index file is config.index, which is by default located at the root of the Ubisecure SSO installation directory. This file contains the locations of other index files. These other index files are located in the custom directory under the root directory of the Ubisecure SSO installation.

The index files contain entries that point to other customization files. The value of each entry must be a relative file path pointing to the actual file. The pointed file must be located at the same directory as the index file or in a subdirectory directly under it. Absolute file paths are not supported.

config.index

The config.index file points to the locations of the template.index, resource.index, message.index, method.index and optionally also to the locations of external directory configuration files.

#
# Ubisecure SSO Authentication Server Configuration Files
#
# config.index
#

# User Interface Templates
template.index = custom/template.index


# User Interface Resources
resource.index = custom/resource.index


# User Interface Messages
message.index = custom/message.index


# Authentication Method and Context Class Strength
authncontext.strength = methods/authncontext.strength


# External LDAP Connections
# directory.1 = custom/jndi1.properties

resource.index

The resource.index file holds an index of images that are made available under the path resource at Ubisecure SSO Authentication Server's network path. Each entry is of type:

...

#
# User Interface Resources
#
# custom/resource.index
# 


example.png = resources/example.png

template.index

The template.index file holds an index of UI template files used for customizing the visual appearance of the login screens in Ubisecure SSO Server. The format of each entry is as follows:

...

template1 = templates/template1.properties
template2 = templates/template2.properties

message.index

The message.index file holds an index of UI message files. All the texts shown to users during the login phase come from customizable message files. The message bundle files contain a list of message key and value pairs. Messages are divided into two groups; the error messages are in the errors-group and other normal UI and help messages are in the uas-group.

...

Template specific UI message files can be defined by adding entries names as <template_name>[_<language code>] or errors/<template_name>[_<language_code>]. The language codes have to be lowercase two letter ISO-689 codes.

method.index

The method.index file holds an index of authentication method libraries and it is not directly related to UI customization.