Logos can be displayed for external authentication methods on the login screen.
Setup steps
1. template.properties
Method images are controlled by the template properties.
Example: Add following in default.properties/ <custom_template_name>.properties
File location: /usr/local/ubisecure/ubilogin-sso/ubilogin/custom/templates/default.properties or
/usr/local/ubisecure/ubilogin-sso/ubilogin/custom/templates/<custom_template_name>
usemethodlogoimages = true usemethodtextlink = true methodimage.index = methodimage.index |
usemethodlogoimages → This property defines if graphical logos will be shown for method selection buttons. Default is false. If true, methodimage.index must be defined.
Example: usemethodlogoimages = true
usemethodtextlink → This property defines if the name of the method is shown below the logo. Default is true. This may be a requirement for accessibility and screen reader support.
Example: usemethodtextlink = false
methodimage.index → This property defines the lookup table used when matching a method name to an image. Different templates can point to different methodimage.index files. The physical location of file is defined in the ubilogin/custom/resource.index file.
Example 1: methodimage.index = methodimage.index
2. methodimage.index
The methodimage.index file provides mappings from method name to image resource name. The image resources must also be defined in the resource.index file. Image localization is possible by localized resources.
Create the methodimage.index file at location:
/usr/local/ubisecure/ubilogin-sso/ubilogin/custom/templates/methodimage.index
# # methodimage.index # # This file defines the images of authentication methods. # This file is used only if its name is defined in # the 'methodimage.index' property of the template # # Each line has the following syntax: # authentication_method = image_file_name google.oauth2.1 = login_google.png |
An example of the corresponding properties in the resource.index is shown below.
3. resource.index
File location: /usr/local/ubisecure/ubilogin-sso/ubilogin/custom/resource.index
# # User Interface Resources # # custom/resource.index # # all logos referenced by tempates/methodimage.index are here google.oauth2.1 = login_google.png # resource/methodimage-accountchooser.index login_google.png = resources/login_google.png |
Place the logo at location specified in resource.index.
Logo location: /usr/local/ubisecure/ubilogin-sso/ubilogin/custom/resources/login_google.png
Testing
Add the Google Authentication method to any application to test.