Configuration browser

Installation manual
for system providers and tenants

3/20/2023

Product line Neo, version 7.x

Please note that you can always find the most up-to-date technical documentation and product updates in the partner area on our
website at https://www.asctechnologies.com.

Copyright © 2023 ASC Technologies AG. All rights reserved.

Windows is a registered trademark of Microsoft Corporation. VMware® is a registered trademark of VMware, Inc. All other marks
and names mentioned herein may be trademarks of their respective companies.

ASC Technologies AG - Seibelstr. 2-4 - 63768 Hösbach - Germany

 Contents

Contents

1 General information.................................................................................................... 4

2 Introduction................................................................................................................. 5

3 Configuration Microsoft Edge ................................................................................... 6

3.1 Install certificate ............................................................................................................ 6
3.2 Configure security exception for POWERplay Web...................................................... 8

4 Configuration Mozilla Firefox .................................................................................. 11

4.1 Configure security exception for POWERplay Web.................................................... 11
4.2 Configure Single Sign On ........................................................................................... 13
4.3 Mozilla Firefox default................................................................................................. 13
4.3.1 Configure pop-up blocker ........................................................................................... 13
4.3.2 Add security exception................................................................................................ 15
4.4 Mozilla Firefox ESR .................................................................................................... 16
4.4.1 Configure pop-up blocker ........................................................................................... 16
4.4.2 Add security exception................................................................................................ 18

5 Configuration Google Chrome ................................................................................ 20

6 Quick guide ............................................................................................................... 21

6.1 Configuration Microsoft Edge ..................................................................................... 21
6.2 Configuration Mozilla Firefox ...................................................................................... 21

Glossary .................................................................................................................... 25

Configuration browser - Neo 7.x Rev. 4 3 / 25

1 General information

1 General information

In the context of this document ASC represents ASC Technologies AG, its subsidiaries, branch
offices, and distributors. An up-to-date overview of the aforementioned entities can be found at
https://www.asctechnologies.com
ASC assumes no guarantee for the actuality, correctness, integrity or quality of the information
provided in the manuals.
ASC regularly checks the content of the released manuals for consistency with the described
hardware and software. Nevertheless, deviations cannot be excluded. Necessary revisions are
included in subsequent editions.
Some aspects of the ASC technology are described in general terms to protect the ownership
and the confidential information or trade secrets of ASC.
The software programs and the manuals of ASC are protected by copyright law. All rights on the
manuals are reserved including the rights of reproduction and multiplication of any kind, be it
photo mechanical, typographical or on digital data media. This also applies to translations.
Copying the manuals, completely or in parts, is only allowed with written authorization of ASC.
Representative, if not defined otherwise, is the technical status at the time of the delivery of the
software, the devices and the manuals of ASC. Technical changes without specified announce-
ments are reserved. Previous manuals lose their validity.
The general conditions of sales and delivery of ASC in their latest version apply.

Configuration browser - Neo 7.x Rev. 4 4 / 25

2 Introduction

2 Introduction

This document describes the configuration of the browsers for the ASC software.

Make sure that JavaScript has been activated.

Make sure that cookies have been allowed.

Configuration browser - Neo 7.x Rev. 4 5 / 25

3 Configuration Microsoft Edge

3 Configuration Microsoft Edge

3.1 Install certificate

The Browser Microsoft Edge does not offer any possibility to install a certificate. To install a cer-
tificate for the client computer nonetheless, use one of the following 2 options:
• Install certificate with the browser Internet Explorer
• Copy certificate to the client computer from the app server and install it

Install certificate with the browser Internet Explorer

1. Start the browser Internet Explorer.
2. Install the certificate. See chapter Add security exception.

Copy certificate to the client computer from the app server and install it
1. Copy the file C:\Program Files (x86)\ASC\ASC Product Suite\data\crypto\https.crt from the
app server to the desktop of the client computer.
2. On the desktop of the client computer, right-click on the file https.crt.
ð The following context menu appears:

Fig. 1: Install certificate

3. In the context menu, click on the menu item Install Certificate.

4. Click on the button Next.

Configuration browser - Neo 7.x Rev. 4 6 / 25

3 Configuration Microsoft Edge

Fig. 2: Certificate Import Wizard

5. If the certificate is supposed to be valid only for the current user of the client computer, se-
lect the option Current user as storage location.
If the certificate is supposed to be valid for all users of the client computer, select the option
Local computer as storage location.
6. Click on the button Next.
7. Activate the option Place all certificates in the following store.
8. Click on the button Browse.
9. Click on the directory Trusted Root Certification Authorities.

Fig. 3: Select certificate store

10. Click on the button OK.

Configuration browser - Neo 7.x Rev. 4 7 / 25

3 Configuration Microsoft Edge

11. Click on the button Next.

12. Click on the button Finish.

Fig. 4: Certificate Import Wizard

13. Click on the button Yes.

Fig. 5: Security warning

14. Click on the button OK.

Fig. 6: Certificate Import Wizard

3.2 Configure security exception for POWERplay Web

1. Start the browser.

Configuration browser - Neo 7.x Rev. 4 8 / 25

3 Configuration Microsoft Edge

2. Enter the following URL into the address bar:

https://<System-IP>/POWERplayWeb/
3. In the URL, replace the parameter <System-IP> with the IP address of the app server.
4. Press the [Enter] key.
ð The login screen appears.
5. Log in to the application with your user name and password.
ð The application opens.
The following window appears:

Fig. 7: Accept Websocket certificate

6. Click on the button OK.

ð The welcome screen of the application appears.

Fig. 8: Welcome screen

7. In the pop-up window Microsoft Edge blocked a pop-up from ... at the bottom of the main
view, click on the button Always allow.
8. Click on Details.

Configuration browser - Neo 7.x Rev. 4 9 / 25

3 Configuration Microsoft Edge

Fig. 9: Continue to this website

9. Click on Go on to webpage (Not recommended).

10. The server connection is refreshed automatically after a few seconds. Once the server con-
nection has been established, the icon is displayed in the Replay module.

Configuration browser - Neo 7.x Rev. 4 10 / 25

4 Configuration Mozilla Firefox

4 Configuration Mozilla Firefox

ASC recommends using the browser Mozilla Firefox ESR.

1. Start the browser to carry out the configurations described below.

4.1 Configure security exception for POWERplay Web

1. Enter the following URL into the address bar:
https://<System-IP>/POWERplayWeb/
2. In the URL, replace the parameter <System-IP> with the IP address of the app server.
3. Press the [Enter] key.
ð The login screen appears.
4. Log in to the application with your user name and password.
ð The application opens.
The following window appears:

Fig. 10: Accept Websocket certificate

5. Click on the button OK.

6. Click on the button Advanced.

Fig. 11: No secure connection

7. Click on the button Add Exception.

Configuration browser - Neo 7.x Rev. 4 11 / 25

4 Configuration Mozilla Firefox

Fig. 12: No secure connection

8. Click on the button Confirm Security Exception.

Fig. 13: Confirm security exception

9. Click on the icon (Logoff) to close the application.

Configuration browser - Neo 7.x Rev. 4 12 / 25

4 Configuration Mozilla Firefox

4.2 Configure Single Sign On

Single Sign On (SSO) only works in one domain for all web applications. For this reason, all
computers have to be included in one corresponding Windows domain.
1. Enter the URL about:config and confirm it by pressing the [Enter] key.
2. Confirm the security prompt.
3. In the entry field Search, enter the value network.negotiate-auth.trusted-uris.

Fig. 14: about:config > network.negotiate-auth.trusted-uris

4. Double-click on the entry network.negotiate-auth.trusted-uris.

5. In the entry field network.negotiate-auth.trusted-uris, enter the URL of the APP Server.

Fig. 15: Enter IP address (example)

6. Click on the button OK.

4.3 Mozilla Firefox default

4.3.1 Configure pop-up blocker

1. Click on the icon (Open menu) in the top right corner of the window.
2. Click on the menu item Options.

Configuration browser - Neo 7.x Rev. 4 13 / 25

4 Configuration Mozilla Firefox

Fig. 16: Firefox > Options

3. Click on the menu item Privacy & Security.

Fig. 17: Tab Content

4. Activate the option Block pop-up windows.

= Option has been activated.
= Option has been deactivated.
5. Click on the button Exceptions under Block pop-up window.
6. In the entry field Address of website, enter the URL of the APP Server.

Configuration browser - Neo 7.x Rev. 4 14 / 25

4 Configuration Mozilla Firefox

Fig. 18: Allowed Sites - Pop-ups (example)

7. Click on the button Allow.

8. Click on the button Save Changes.

4.3.2 Add security exception

1. Click on the icon (Open menu) in the top right corner of the window.
2. Click on the menu item Options.
3. Click on the menu item Privacy & Security.

Fig. 19: Encryption

4. Click on the button View Certificates.

5. Click on the tab Servers.

Configuration browser - Neo 7.x Rev. 4 15 / 25

4 Configuration Mozilla Firefox

Fig. 20: Certificate Manager

6. Click on the button Add Exception.

7. In the entry field Address, enter the URL of the APP Server.
8. Click on the button Download Certificate.
9. Click on the button Confirm Security Exception.
10. Click on the button OK.

4.4 Mozilla Firefox ESR

4.4.1 Configure pop-up blocker

1. Click on the icon (Open menu) in the top right corner of the window.
2. Click on the menu item Options.

Configuration browser - Neo 7.x Rev. 4 16 / 25

4 Configuration Mozilla Firefox

Fig. 21: Firefox > Options

3. Click on the menu item Content.

Fig. 22: Content

4. Activate the option Block pop-up windows.

= Option has been activated.
= Option has been deactivated.
5. Click on the button Exceptions under Block pop-up window.
6. In the entry field Address of website, enter the URL of the APP Server.

Configuration browser - Neo 7.x Rev. 4 17 / 25

4 Configuration Mozilla Firefox

Fig. 23: Allowed Sites - Pop-ups (example)

7. Click on the button Allow.

8. Click on the button Save Changes.

4.4.2 Add security exception

1. Click on the icon (Open menu) in the top right corner of the window.
2. Click on the menu item Options.
3. Click on the menu item Advanced.

Fig. 24: Certificates

4. Click on the tab Certificates.

5. Click on the button View Certificates.
6. Click on the tab Servers.

Configuration browser - Neo 7.x Rev. 4 18 / 25

4 Configuration Mozilla Firefox

Fig. 25: Certificate Manager

7. Click on the button Add Exception.

8. In the entry field Address, enter the URL of the APP Server.
9. Click on the button Download Certificate.
10. Click on the button Confirm Security Exception.

Configuration browser - Neo 7.x Rev. 4 19 / 25

5 Configuration Google Chrome

5 Configuration Google Chrome

Using the ASC software with Google Chrome does not require any special configuration.

Configuration browser - Neo 7.x Rev. 4 20 / 25

6 Quick guide

6 Quick guide

6.1 Configuration Microsoft Edge

• Install certificate:
Install certificate with the browser Internet Explorer:
Start the browser Internet Explorer > enter URL of the app server into the address bar, ac-
tivate > Continue to this website (not recommended) > Certificate Error > View Certifi-
cates > General > Install Certificate > Next > Current user (certificate only for the cur-
rent user of the client PC) or Local computer (certificate for all users of the client PC) >
Next > Place all certificates in the following store: > Browse > Trusted Root Certifica-
tion Authorities > OK > Next > Finish > confirm security prompt.
or
Copy certificate to the client computer from the app server and install it:
Copy the file C:\Program Files (x86)\ASC\ASC Product
Suite\data\crypto\https.crt from the app server to the desktop of the client computer
> on the desktop of the client computer, right-click on the icon of the file https.crt activate >
Install Certificate > Next > Current user (certificate only for the current user of the client
PC) or Local computer (certificate for all users of the client PC) > Next > Place all certifi-
cates in the following store: > Browse > Trusted Root Certification Authorities > OK >
Next > Finish > Yes > OK.
• Configure security exception for POWERplay Web:
Start browser Microsoft Edge > enter URL https://<System-IP>/POWERplayWeb/; in the
URL, replace the parameter <System-IP> with the URL of the app server > Enter key >
log in to the application > OK > Always allow > Details > Go on to webpage (Not recom-
mended).

6.2 Configuration Mozilla Firefox

• Configure security exception for POWERplay Web:
Enter URL https://<System-IP>/POWERplayWeb/; in the URL, replace the parameter
<System-IP> with the URL of the app server > Enter key > log in to the application > OK >
Advanced > Add exception > Confirm security exception > (Logoff).
• Configure Single Sign On:
Enter URL about:config > [Enter] key > confirm security prompt > Search: enter
network.negotiate-auth.trusted-uris > double-click on the entry network.negotiate-
auth.trusted-uris > enter URL of the app server > OK.

Mozilla Firefox default

• Configure pop-up blocker:
(Open menu) activate > Settings > Privacy & Security > Block pop-up window > Ex-
ceptions > enter URL of the app server > Allow > Save Changes.
• Add security exception:
(Open menu) > Settings > Privacy & Security > View Certificates > Servers > Add
Exception > enter URL of the app server > Download Certificate > Confirm Security Ex-
ception Rule > OK.

Mozilla Firefox ESR

• Configure pop-up blocker:
(Open menu) activate > Settings > Content > Block pop-up window > Exceptions >
enter URL of the app server > Allow > Save Changes.
• Add security exception:

Configuration browser - Neo 7.x Rev. 4 21 / 25

6 Quick guide

(Open menu) > Settings > Advanced > Certificates > View Certificates > Servers >
Add Exception > enter URL of the app server > Download Certificate > Confirm Secu-
rity Exception Rule.

Configuration browser - Neo 7.x Rev. 4 22 / 25

 List of figures

List of figures

Fig. 1 Install certificate ....................................................................................................... 6

Fig. 2 Certificate Import Wizard ......................................................................................... 7
Fig. 3 Select certificate store ............................................................................................. 7
Fig. 4 Certificate Import Wizard ......................................................................................... 8
Fig. 5 Security warning ...................................................................................................... 8
Fig. 6 Certificate Import Wizard ......................................................................................... 8
Fig. 7 Accept Websocket certificate................................................................................... 9
Fig. 8 Welcome screen ...................................................................................................... 9
Fig. 9 Continue to this website........................................................................................... 10
Fig. 10 Accept Websocket certificate................................................................................... 11
Fig. 11 No secure connection .............................................................................................. 11
Fig. 12 No secure connection .............................................................................................. 12
Fig. 13 Confirm security exception ...................................................................................... 12
Fig. 14 about:config > network.negotiate-auth.trusted-uris ................................................. 13
Fig. 15 Enter IP address (example) ..................................................................................... 13
Fig. 16 Firefox > Options ..................................................................................................... 14
Fig. 17 Tab Content ............................................................................................................. 14
Fig. 18 Allowed Sites - Pop-ups (example).......................................................................... 15
Fig. 19 Encryption................................................................................................................ 15
Fig. 20 Certificate Manager ................................................................................................. 16
Fig. 21 Firefox > Options ..................................................................................................... 17
Fig. 22 Content .................................................................................................................... 17
Fig. 23 Allowed Sites - Pop-ups (example).......................................................................... 18
Fig. 24 Certificates............................................................................................................... 18
Fig. 25 Certificate Manager ................................................................................................. 19

Configuration browser - Neo 7.x Rev. 4 23 / 25

 List of tables

List of tables

Configuration browser - Neo 7.x Rev. 4 24 / 25

 Glossary

Glossary

App server
Application server or web server. In the system architectures: the server on which the Enter-
prise Core and the Payara software have been installed.

SSO
Single Sign On; Simplified login mode. After a one-off authentication at one workplace users
will be able to use all services and applications that they have been authorized for from this
workplace. They do not have to authenticate for the individual applications again.

URL
Uniform resource locator. Identifies and locates a resource (e. g. a website) about the used
access method (e. g. the used network protocol as HTTP or FTP) and the location of the re-
source in the computer network. (Source: Wikipedia 20th November 2013)

Configuration browser - Neo 7.x Rev. 4 25 / 25