2024 Update Rollup 1

Web Browser SettingsPermanent link for this heading

When installing the native client also extensions for Microsoft Edge, Google Chrome, Mozilla Firefox and Apple Safari are provided (see chapter 3.3 for Restrictions). Make sure that the extensions are allowed in the used web browser (“allow always”).

Microsoft Edge

“Settings and more” > “Extensions”

Google Chrome

“Customize and control Google Chrome” > “More tools” > “Extensions”

Mozilla Firefox

“Open menu” > “Add-ons” > “Extensions”

Apple Safari

“Safari” > “Preferences” > “Extensions”

Further configuration steps

If a web browser is not optimally configured, the Fabasoft Web Client shows the necessary configuration steps in the “Web Browser State”.

Microsoft EdgePermanent link for this heading

For Microsoft Edge beside the native client also an Edge extension is needed.

To install the Fabasoft Folio web browser extension, perform the following steps:

  1. Search in the Microsoft Edge Add-ons Store for the extension “Fabasoft Client”:
    https://microsoftedge.microsoft.com/addons/search/Fabasoft%20client?hl=en-US
  2. Click “Get”.
  3. Click “Add extension” to confirm adding the extension.

Note: If you want to use the extension in the Microsoft Edge InPrivate window, you have to select “Allow in InPrivate” for the extension.

If client certificates are used for authentication, it may be useful to automatically login with the corresponding certificate. This can be done the following way:

Example

// Define the following registry key to automatically select the wanted
//
certificate
[HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Microsoft\Edge\AutoSelectCertificateForUrls]
"1"="{\"pattern\":\"https://folio.example.com\",\"filter\":{\"ISSUER\":{\"CN\":\"Example CA\"}, \"SUBJECT\":{\"CN\":\"FirstName.LastName\"}}}"

More information about the Microsoft Edge policy can be found here:

https://docs.microsoft.com/en-us/deployedge/microsoft-edge-policies#autoselectcertificateforurls: new window

Security

The Fabasoft Folio web browser extension requires the following permissions:

Permission

Browser Description

Purpose

"cookies"

This permission is needed to read HTTP-only cookies issued from the server. These cookies are passed to the Fabasoft Folio Client so that the client can share the current session information.

"nativeMessaging"

Communicate with cooperating native applications

This permission is required to ensure a communication channel from the web browser to the Fabasoft Folio Client using the corresponding browser technology “nativeMessaging”.

"<all_urls>"

Read and change all your data on the websites that you visit

The Fabasoft Folio may run on different domains, so the use of the extension is not restricted by default. Please note the following information on how to apply restrictions.

To restrict the sites where the Fabasoft Folio web browser extension can be used, use the appropriate browser possibilities:

https://docs.microsoft.com/en-us/deployedge/microsoft-edge-manage-extensions-ref-guide: new window

To restrict the usage of the Fabasoft Folio web browser extension to “*.example.com” the following configuration may be used:

[HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Microsof\Edge\ExtensionSettings\alcgpfgkdjbabelklflpfkooadcfgoao\runtime_allowed_hosts]
"1"="*://*.example.com"

[HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Microsoft\Edge\ExtensionSettings\alcgpfgkdjbabelklflpfkooadcfgoao\runtime_blocked_hosts]
"1"="*://*"

Google ChromePermanent link for this heading

For Google Chrome beside the native client also a Chrome extension is needed.

To install the Fabasoft Folio web browser extension, perform the following steps:

  1. Search in the Google Chrome Web Store for the extension “Fabasoft Client”:
    https://chrome.google.com/webstore/search/fabasoft%20client
  2. Click “Add to Chrome”.
  3. Click “Add extension” to confirm adding the extension.

Note: If you want to use the extension in the Google Chrome incognito mode, you have to select “Allow in incognito” for the extension.

If client certificates are used for authentication, it may be useful to automatically login with the corresponding certificate. This can be done the following way:

Example

// Define the following registry key to automatically select the wanted
//
certificate
[HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Google\Chrome\AutoSelectCertificateForUrls]
"1"="{\"pattern\":\"https://folio.example.com\",\"filter\":{\"ISSUER\":{\"CN\":\"Example CA\"}, \"SUBJECT\":{\"CN\":\"FirstName.LastName\"}}}"

More information about the Google Chrome policy can be found here:

https://cloud.google.com/docs/chrome-enterprise/policies/?policy=AutoSelectCertificateForUrls: new window

Security

The Fabasoft Folio web browser extension requires the following permissions:

Permission

Browser Description

Purpose

"cookies"

This permission is needed to read HTTP-only cookies issued from the server. These cookies are passed to the Fabasoft Folio Client so that the client can share the current session information.

"nativeMessaging"

Communicate with cooperating native applications

This permission is required to ensure a communication channel from the web browser to the Fabasoft Folio Client using the corresponding browser technology “nativeMessaging”.

"<all_urls>"

Read and change all your data on the websites that you visit

The Fabasoft Folio may run on different domains, so the use of the extension is not restricted by default. Please note the following information on how to apply restrictions.

To restrict the sites where the Fabasoft Folio web browser extension can be used, use the appropriate browser possibilities:

https://chromeenterprise.google/policies/?policy=ExtensionSettings: new window

To restrict the usage of the Fabasoft Folio web browser extension to “*.example.com” the following configuration may be used:

[HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Google\Chrome\ExtensionSettings\alcgpfgkdjbabelklflpfkooadcfgoao\runtime_allowed_hosts]
"1"="*://*.example.com"

[HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Google\Chrome\ExtensionSettings\alcgpfgkdjbabelklflpfkooadcfgoao\runtime_blocked_hosts]
"1"="*://*"

Mozilla FirefoxPermanent link for this heading

For Mozilla Firefox beside the native client also a Firefox extension is needed.

To install the Fabasoft Folio web browser extension, perform the following steps:

  1. Open Fabasoft Folio
    https://<host>/<vdir>/
  2. In the web browser state, you will be notified to install the Fabasoft Folio Firefox Extension.
  3. Click “Add it now”.
  4. Click “Allow”.
  5. Click “Add” to confirm adding the extension.