Configuring Space Settings

Anne Ramey
Platform Admins

Space settings are divided into 5 categories: Details, Attributes, Filestore, OAuth, Security. Each contributes important components to the space set-up.

Details

The details section is really in two parts. Basic details at the top, and then a section driven by the Display Type field. SpaceDetails1

First there are some basic space details:

  • Space Name: This is the displayed name of the space.
  • Space Slug: This is the unique identifier of the space. You will see it in the URL when accessing the space.
  • Inactive Session Limit: Number of seconds the session can be inactive before it ends.
  • Bundle Path: The server path to the bundle (if not using a shared bundle)
  • Display Type: This can be set to three values and controls the rest of the page.

SpaceDetails2a

  • Display Page: Uses a JSP to display the space and allows you to configure what JSP should be rendered.

    • Space Display Page: Page in the bundle used to display the space
    • After Logout Page: URL to go to after logout
    • Login Page: Page in the bundle the to use for login
    • Reset Password Page: Page in the bundle to use for password reset requests.

SpaceDetails2b

  • Redirect: Redirects a user when they try to display the space and allows you to enter a Redirect URL.

SpaceDetails2c

  • Single Page App (** this option was added in Version 2.1.0): Configures the system to use a client side bundle and configure it's location. This setting disables display settings at the Kapp level and assumes all routing will happen client side.

Attributes

SpaceAttributes

The Attributes tab is where any space level attributes are set. Note that attributes are defined here (Space Attribute Definitions), but the values in each attribute are set in this tab.

The attributes defined here are generally things that will be used in workflow and/or the theme/bundle and are used across all kapps. Things such as:

  • Task Server URL
  • Web Server URL
  • Admin Kapp Slug
  • Header Bundle Path

Also here are fallback attributes for kapps and forms, in case attributes are not defined at those levels, such as:

  • Approval Form Slug
  • Submission Workflow
  • Form Workflow

Filestore

SpaceFilestore

This is where the filestore created in Filehub is connected to this particular space for use in storing attachments for this space's forms. You will need the listed information, which is available when you set up the filestore in Filehub.

OAuth

SpaceOauth

This is where the Single Sign On information is, either for another system to be a client of the Space or the information to make the Space a client of another system.

Security

The security for the space has three components: Access security for the Space, Users, and Teams and Trusted Domains, both for frames and not frames.

SpaceSecurity1

The first settings are who has access to display the space, users, and teams. This is generally set to authenticated users and then tighter restrictions are placed on the more specific kapps and forms as necessary.

SpaceSecurity2

This will allow you to set up another server/url as a trusted domain. This can help you address any CORS issues you may be running into but it does introduce security risks. Please use this cautiously.

SpaceSecurity3

This is the same as the above except specifically for urls that will be displayed/access in frames.