Overlay - Portal

Change look and feel for Portal. Add new and/or update existing languages.

Scenario

In this use case we are going to change the look and feel for the Fortified ID application Portal. We will also add a language (Norwegian) and add information to the Swedish language file.

Prerequisite

There are some prerequisite for this use case.

• Current version of Fortified ID Portal installed.

• Download ZIP-file with example customer folder for Portal.

Add ZIP content to you installation

1. First, make a backup of your existing customer folder.

   1. Open folder C:\Program Files\FortifiedID\portal

   2. Rename customer folder to customer_ORG

2. From the downloaded ZIP-file, add the example customer folder to: C:\Program Files\FortifiedID\portal\

3. The result should look like:

   

   Portal overlay structure

Folder contents:

0_look_and_feel, contains assets for logo, favorite icon and css. The file ui_config_overrides.json contain all settings.

1_portal, contains custom locals

images, contains application images

Start Portal sevice

Note. Since we use the NoOp authenticator there will be no login and use of Fortified ID Web/IdP.

1. Start the Fortified ID Portal service. Verify the service is running.

Test the overlay

If you have added the folder structure and example config.json file used in this use case.

1. Open a browser

2. Browse to http:/localhost:8090/portal

   1. New language option (Norwegian)

      1. Verify that Norwegian exists as language option

      2. Change to Norwegian

      3. Change back to English

   2. favicon.ico is different from default

   3. Logo should be Litho Acme logo in top left corner

   4. Top bar should be Litho colors

   5. Below screenshot should be the result you should see

Example config.json

Below is an example config.json file with focus only on this use case. We use the NoOp authenticator so no need for an IdP (e.g. Fortified ID Web). This example config.json also maps to the overlay folder created for this use case.

{
    "globals": "@include:globals.json",
    "modules": [
        {
            "name": "CefEventModule",
            "config": {}
        },
        {
            "name": "HttpClient",
            "config": {
                "name": "default",
                "ssl_trust_all": true,
                "idle_timeout_ms": 5000,
                "connect_timeout_ms": 5000
            }
        },
        {
            "name": "Portal",
            "config": {
                "webroot_dir": "resources/web",
                "http_port": "${globals.http.port}",
                "http_use_ssl": true,
                "http_keystore_ref": {
                    "type": "${globals.keystore.https.ref.type}",
                    "path": "${globals.keystore.https.ref.path}",
                    "password": "${globals.keystore.https.ref.password}"
                },
                "http_keystore_type": "${globals.keystore.https.type}",
                "http_key_alias": "${globals.keystore.https.http_key_alias}",
                "http_key_password": "${globals.keystore.https.http_key_password}",
                "http_context": "/portal",
                "http_auth_redirect_url": "/portal/authn/login",
                "overlay_dirs": [
                    "${globals.file_paths.base_dir}/config/resources_external/overlays/0_look_and_feel",
                    "${globals.file_paths.base_dir}/config/resources_external/overlays/1_portal",
                    "${globals.file_paths.base_dir}/config/resources_external/overlays/"
                ],
                "applications": "@include:resources_internal/applications"
            }
        },
        {
            "name": "AuthN",
            "config": {
                "http_context": "/authn",
                "http_port": "${globals.http.port}",
                "http_use_ssl": true,
                "http_keystore_ref": {
                    "type": "${globals.keystore.https.ref.type}",
                    "path": "${globals.keystore.https.ref.path}",
                    "password": "${globals.keystore.https.ref.password}"
                },
                "http_keystore_type": "${globals.keystore.https.type}",
                "http_key_alias": "${globals.keystore.https.http_key_alias}",
                "http_key_password": "${globals.keystore.https.http_key_password}",
                "authenticators": [
                    {
                        "id": "test_auth",
                        "type": "NoOp",
                        "config": {
                            "context_path": "/portal/authn/login",
                            "success_location": "/portal/",
                            "logout_location": "https://www.fortifiedid.se",
                            "properties": {
                                "display_name": "John Doe"
                            }
                        }
                    }
                ]
            }
        }
    ]
}