2022 June Release

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 chapters 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 Cloud web browser extension, perform the following steps:

  1. Search in the Microsoft Edge Add-ons Store for the extension:
    https://microsoftedge.microsoft.com/addons/search/Fabasoft%20Cloud?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

// Use the URL parameter motoky_params=cert_autologin to automatically
// login with a
n installed certificate (can be selected)
https://at.cloud.fabasoft.com/folio/homelocation?motoky_params=cert_autologin

// Define the following registry key to automatically select the wanted
//
certificate
[HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Microsoft\Edge\AutoSelectCertificateForUrls]
"1"="{\"pattern\":\"https://at-cert.idp.cloud.fabasoft.com\",\"filter\":{\"ISSUER\":{\"CN\":\"Example CA\"}, \"SUBJECT\":{\"CN\":\"FirstName.LastName\"}}}"
"2"="{\"pattern\":\"https://de-cert.idp.cloud.fabasoft.com\",\"filter\":{\"ISSUER\":{\"CN\":\"Example CA\"}, \"SUBJECT\":{\"CN\":\"FirstName.LastName\"}}}"
"3"="{\"pattern\":\"https://ch-cert.idp.cloud.fabasoft.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

Security

The Fabasoft Cloud 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 Cloud 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 Cloud Client using the corresponding browser technology “nativeMessaging”.

Google ChromePermanent link for this heading

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

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

  1. Search in the Google Chrome Web Store for the extension:
    https://chrome.google.com/webstore/search/fabasoft%20cloud
  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

// Use the URL parameter motoky_params=cert_autologin to automatically
// login with a
n installed certificate (can be selected)
https://at.cloud.fabasoft.com/folio/homelocation?motoky_params=cert_autologin

// Define the following registry key to automatically select the wanted
//
certificate
[HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Google\Chrome\AutoSelectCertificateForUrls]
"1"="{\"pattern\":\"https://at-cert.idp.cloud.fabasoft.com\",\"filter\":{\"ISSUER\":{\"CN\":\"Example CA\"}, \"SUBJECT\":{\"CN\":\"FirstName.LastName\"}}}"
"2"="{\"pattern\":\"https://de-cert.idp.cloud.fabasoft.com\",\"filter\":{\"ISSUER\":{\"CN\":\"Example CA\"}, \"SUBJECT\":{\"CN\":\"FirstName.LastName\"}}}"
"3"="{\"pattern\":\"https://ch-cert.idp.cloud.fabasoft.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

Security

The Fabasoft Cloud 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 Cloud 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 Cloud Client using the corresponding browser technology “nativeMessaging”.

Mozilla FirefoxPermanent link for this heading

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

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

  1. Open the Fabasoft Cloud or Fabasoft Private Cloud.
    https://at.cloud.fabasoft.com/folio/
    https://<host private cloud>/cloud/
  2. In the welcome screen, you will be notified to install the Fabasoft Cloud Firefox Extension.
  3. Click “Add it now”.
  4. Click “Allow”.
  5. Click “Add” to confirm adding the extension.

Security

The Fabasoft Cloud 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 Cloud 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 Cloud Client using the corresponding browser technology “nativeMessaging”.

"<all_urls>"

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

Since customers can operate a Fabasoft Private Cloud using specific domain names (resp. hostnames), it is not possible to restrict the web browser extension only to *.fabasoft.com domains in general.