Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

The parts of Smart ID Digital Access component that end-users can access can be branded, in order to achieve a corporate look-and-feel. Branding and customization can be performed on different levels, ranging from replacing the logotype in the application portal to customizing the appearance of the entire application access procedure: from the software token used for web authentication, through log in pages, and the portal itself.

Expand
titlePrerequisites

In Digital Access Admin there is a “Browse” button that leads to a file browser with all files that builds up the portal (the access-point/built-in-files/wwwroot/ folder and sub-folders structure). Copy the files that shall be changed to access-point/custom-files/wwwroot/ within the same file structure before branding starts.

Note

Do not change the original files The reason for this is that changes will be lost when upgrading the system.


Info

Files placed in the …/custom-files/wwwroot/wa folder and sub-folders structure override corresponding files in …/built-in-files/wwwroot/wa folder and sub-folders structure.

 

...

Click here to expand

.

Expand
titleCustomize text or buttons in log in pages

To customize texts and buttons in individual log in pages, there are template files that must be edited. These template files are located in different folders.

Note

Customizing template files requires adequate HTML proficiency.

  1. In Digital Access Admin, click Browse.
  2. Copy the template files from the folder structure in /access-point/built-in-files/wwwroot/wa to the corresponding folder structure in /custom-files/.
  3. Edit any template file that needs to be changed.
  4. Click Publish to publish the customized file.

These are the template files located in access-point/built-in-files/wwwroot/wa.

Expand
title

File name

Description

User variables

_auto_reauthmessage

Page displayed when the user has to log off and re-authentication is required.


_chooseAuthmech

Page displayed when authentication method is to be selected.

name
displayname

_closedown_message

Page displayed when user is timed out from the Access Point.


_deleteLogonCred

Page displayed when password database has been cleared.


_error

Error message displayed to the user.

errmsg

_InternalAuthentication

The Internal Authentication form.

ssodomain
ssohost
iuid
idom

_logoutPage

Page displayed when user has logged off.


_no_session

Page displayed when a session has timed out.


_popup_msg

Page used to display a popup message to the user.

location errmsg

_reauthmessage

Time-out message displayed to user.


_refresh_top

Page displayed when a user needs to refresh the browser.


_securitywarning

Page displayed for security warnings.

errmsg

_TimedoutPage

Page displayed when a user is temporarily locked until a specific time out occurs (currently concerns only SecurID).

auth_timeout

302

Page displayed to redirect the user when a page has moved.

location

302_top

Page displayed to redirect the user when a page has moved.

location

400

Page displayed subsequent to a bad request.


401E

Page displayed subsequent to external authentication failure due to mismatching credentials, if the authentication method on the device is set to Basic authentication.

authmech location

401I

Page displayed subsequent to an internal authentication failure due to mismatching credentials, if the authentication method on the device is set to Basic authentication.


401WIL

Displayed when a user fails to log on using Windows Integrated Login.


403

Page displayed when a client requests a forbidden resource, that is, Access Control denies the resource to be accessed.

eprot
ehost
uri

404

Page displayed when a requested file on the Access Point does not exist.

eprot
ehost
file

405

Page displayed when a HTTP-method which is not allowed has been used in a client request.

eprot
ehost
uri

method allow

500

Page displayed when a server error occurs.

errmsg

TestLogonLoginPage

Log in page for TestLogon, that is, when a user requests http://127.0.0.1:19146/ wa/auth?authmech=TestLogon on the local computer where the Access Point is installed.



These are the template files located in access-point/built-in-files/wwwroot/wa/authmech/base.

ExpandtitleClick here to expand

.

File Name

Description

User variables

GenericForm.html

Base Template for log in forms used in conjunction with Template Specifications of type “GenericForm”. The template specifications form the appearance of the log page for the authentication method by supplying the content of the user variables.

heading
errmsg
explanation
message
nolocalstoreText
textText
textValue
readonlyText
readonlyValue
passwordText
checkboxText
checkboxValue
tokenText
oath-newdevice-link
reset-password-lin

Dialog.html

Base template used in conjunction with template specifications of type “Dialog”.

heading
errmsg
explanation
message
buttonText

Applet.html

Base template used in conjunction with template specifications of type “Applet”.

heading
errmsg
buttonText

Json,html



SelfServiceForm.html

SelfServiceFormPIN.html

SelfServiceUserChallenge.html

SigningForm.html



Expand
titleCustomize colors and fonts in log in pages

Stylesheets control colors and fonts in log in pages. Use your browser to inspect the log in page and locate where different elements are customized within the stylesheets (css files)​.

To customize the colors and fonts, use the files in this directory: built-in-files/wwwroot/wa/css.

  1. In Digital Access Admin, click Browse.
  2. Copy the css files from the folder structure in built-in-files/wwwroot/wa/css to the corresponding folder structure in /custom-files/.
  3. Edit the files.
  4. Click Publish to publish the customized file.

...