Table of Contents
Last updated: 2024-11-14

ShareAspace web client installation

Prerequisites

The installation of the ShareAspace Web Client component [Web User Interface for ShareAspace] has the following prerequisites:

Note

The ShareAspace Web Client can be installed on the same machine as the one used hosting the Reverse Proxy (Gateway).

ShareAspace Web client setup

ShareAspace Web Client Setup

Installation steps

Run the installer

  • Run installer NovaWeb-x.y.z.build.msi to install the ShareAspace Web Client on a Web Server (IIS)
Note

When installing the ShareAspace Web Client an Application Pool named "NovaWeb" is created in IIS.

By default the account running the Application Pool is the built-in account "ApplicationPoolIdentity".

If another account has to be used for running the "NovaWeb" application pool, the account running the "NovaWeb" Application Pool must have read access to the ShareAspace Nova Web Client installation folder.

Configuration

Setup the ShareAspace web OAuth 2.0 configuration by opening the config.json file (normally found at C:\Program Files\Eurostep\ShareAspace\Web\config.json).

If the identity provider is hosted on a separate domain from ShareAspace web, open the web.config (normally found at C:\Program Files\Eurostep\ShareAspace\Web\web.config).

Add the identity provider domain to the Content-Security-Policy header configuration.

<?xml version="1.0" encoding="UTF-8"?>
<configuration>
    <system.webServer>
        <httpRedirect enabled="false" destination="" childOnly="false" />
        <httpProtocol>
            <customHeaders>
                <add name="Content-Security-Policy" value="default-src 'self' <identity-provider-fqdn>; frame-src https:; style-src 'self' 'unsafe-inline'; img-src 'self' data:;  script-src 'self' 'unsafe-eval'" />
            </customHeaders>
        </httpProtocol>
    </system.webServer>
</configuration>

Example:

<add name="Content-Security-Policy" value="default-src 'self' developerlogin.eurostep.com; frame-src https:; style-src 'self' 'unsafe-inline'; img-src 'self' data:;  script-src 'self' 'unsafe-eval'" />

Using developer login

{
    "apiPath":  "/api",
    "client_id":  "NovaWeb",
    "scope":  "All",
    "response_type":  "code",
    "authorizationUrl":  "https://<developer-login-fqdn>/DeveloperLogin/oauth/authorize",
    "tokenUrl":  "https://<developer-login-fqdn>/DeveloperLogin/oauth/token",
    "redirect_uri":  "https://<sas-web-fqdn>/sasweb/Callback.html",
    "signOut_uri":  "https://<developer-login-fqdn>/DeveloperLogin/SignOut",
    "application_id":  "sasweb",
    "accessTokenExpireWarningTimeMinutes": 10
}

Using email authentication

{
    "apiPath":  "/api",
    "client_id":  "NovaWeb",
    "scope":  "All",
    "response_type":  "code",
    "authorizationUrl":  "https://<developer-login-fqdn>/EmailAuthentication/oauth/authorize",
    "tokenUrl":  "https://<developer-login-fqdn>/EmailAuthentication/oauth/token",
    "redirect_uri":  "https://<sas-web-fqdn>/sasweb/Callback.html",
    "signOut_uri":  "https://<developer-login-fqdn>/EmailAuthentication/SignOut",
    "application_id":  "sasweb",
    "accessTokenExpireWarningTimeMinutes": 10
}

Using OpenID Connect

See OpenID Connect

Documentation configuration

The documentation used in ShareAspace web can be altered to point at a custom documentation or at the ShareAspace documentation deployed on premise.

{
  ...
  "documentationLinks": {
    "about": "https://docs.shareaspace.com/v1-7/sas/administration.html#about",
    "alert": "https://docs.shareaspace.com/v1-7/sas/administration.html#alerts",
    "application": "https://docs.shareaspace.com/v1-7/sas/administration.html#applications",
    "extensions": "https://docs.shareaspace.com/v1-7/features/external-extensions/user-interface.html",
    "langauges": "https://docs.shareaspace.com/v1-7/sas/administration.html#languages",
    "license": "https://docs.shareaspace.com/v1-7/sas/administration.html#licence",
    "monitoring": "https://docs.shareaspace.com/v1-7/sas/administration.html#monitoring",
    "news": "https://docs.shareaspace.com/v1-7/sas/administration.html#news",
    "spaces": "https://docs.shareaspace.com/v1-7/sas/administration.html#spaces",
    "templates": "https://docs.shareaspace.com/v1-7/sas/administration.html#templates",
    "files": "https://docs.shareaspace.com/v1-7/features/file-management/user-interface.html"
  }
}