Last updated on June 11, 2018

Configure Instance Settings and Account Authentication

Access Instance Settings, and Account Authentication tabs via Admin > Settings from the Appspace Menu navigation bar.


Settings Interface

Instance Settings

The Instance Settings page allows you to personalize the account for cloud and on-premises instances such as custom logo header, header background color, time zone, API key, and Google Analytics Tracking ID.


In an on-premises instance, you will have the following fields, which are hidden from a cloud account:

  • Appspace Domain - Administrators can set up their own Appspace subdomain or use a custom domain.
  • Custom Sign In Page - Administrators can create a custom login page.
  • Custom Logo Header - Administrators can change the logo in the header to use their own custom company or product logo.

Personalizing Appspace

Important

Appspace 7 is only available in English, and does not support multiple languages. If you choose any other language, it will default back to English. The Language field in the UI is scheduled to be removed soon.

This article provides the instructions to customize and personalize your Appspace instance, as follows:

  • Cloud and On-Premises

    • Default time zone – Users can set the default time zone to display date and time in the Appspace instance.
    • Custom website logo – Administrators can customize the Appspace logo with the company or product logo.
    • Background header color – Administrators can customize the Appspace header with a custom brand color.

  • On-Premises only

    • Custom domain – Administrators can set up their own Appspace subdomain or use a custom domain.
    • Custom sign in page – Administrators can create a custom login page for Appspace users to sign in.

Default Time Zone

  1. Click Admin > Settings from the Appspace Menu navigation bar, and click the Instance Settings tab.

  2. Select the desired time zone from the Time Zone drop-down menu.


  3. Click Save once done.


Background Header Color

  1. Click Admin > Settings from the Appspace Menu navigation bar, and click the Instance Settings tab.

  2. Click the Header Background Color color picker, and select the desired color for the header background.


  3. Click Save once done.


Important

The personalizations below are only available on Appspace On-Premises deployments.


Custom Domain

  1. Click Admin > Settings from the Appspace Menu navigation bar, and click the Instance Settings tab.

  2. In the Appspace Domain section, select the desired domain option to be used.

    • Default

    • Appspace Domain

      1. Select the Appspace Domain option, and enter in the desired subdomain.

    • Your Custom Domain

      1. Select the Your Custom Domain option, and enter in the custom domain URL.


  3. Click Save once done.


Custom Sign In Page

  1. Create a custom sign in page.

    To create the page, the login form must have the username and password HTML text inputs with the following names:

    <input type=”text” name=”nexuslogin” id=”nexuslogin” />
    <input type=”password” name=”nexuspassword” id=”nexuspassword” />
    

    The login form must post to Appspace login page URL, for e.g. “http://appspace.nexusondemand.com/app/login.aspx”. After the custom login page is created, upload it to your public server.

    The following is a sample custom login page and the associated HTML code behind it.

    <html>
    <head>
    <title>My Custom Login Page</title>
    </head>
    
    <body>
    <div id=”stylized” class=”myform”>
      <form id=”form” name=”form” method=”post” action=”http://appspace.nexusondemand.com/app/login.aspx”>
        <h1>Your custom login page</h1>
        <p>your company details here</p>
    
        <label>Username <span class=”small”>your appspace login</span> </label>
        <input type=”text” name=”nexuslogin” id=”nexuslogin” />
        <label>Password <span class=”small”>your appspace password</span> </label>
        <input type=”password” name=”nexuspassword” id=”nexuspassword” />
        <button type=”submit”>Login</button>
      </form>
    </div>
    </body>
    </html>
    

  2. Click Admin > Settings from the Appspace Menu navigation bar, and click the Instance Settings tab.

  3. In the Custom Sign In Page section, select Your Custom Login Page, and enter in the custom login page URL.


  4. Click Save once done.


Subscription

The Subscription page, reminds Account Owners to visit the that Account Management Portal to view subscription details, manage ID usage and licenses.


Account Authentication

The Account Authentication configuration page allows Account Owners to configure your Single Sign-On (SSO), SAML Identity Provider (IdP) information, service provider metadata settings, and pass-through authentication using Basic IDs for on-premises.

This tab will only be visible if SSO has been turned on via System > Configuration in the Appspace console.

Note

Cloud users, please contact Appspace Support to turn on SSO, and enable this tab.