Skip to main content

Workspaces

A workspace is a collection of resources whichs implement an application. It is a logical container on which resources are isolated from other workspaces.

We recommend to create one workspace for each user application. A workspace can support several applications platforms (ex: a mobile app and a SaaS), so the workspace granularity should be strictly logical.

The particularity of workspaces is that every resource inside of it communicate with each other. Indeed, this allow to implement features without the need of caring about networking, rights, identities, etc.

Relation with organizations​

A workspace is related to an organization. The organization represents an entreprise, or association and is used to manage the global administration of one or several workspaces (billing, super administrators, etc.). A workspace can be attached to only one organization. More information about organizations can be found in the organizations documentation.

When to create a workspace?​

As workspaces are the highest level of the platform, the resources it contains are isolated (they can not reference resources from other workspaces). We recommand to create a workspace for each application. N.b. workspaces have a logical value, do not use them to isolate resources. If you need to isolate resources, you should use the perimeters segmentation inside a workspace.

Example: The organization ACME Inc. has a product called "AliceApp" and a product called "BobApp". As the two products have separate users, teams, they should be in separate workspaces. Moreover, the IT system of ACME Inc. is also managed in OwlGrid, so it has also a dedicated workspace.

Workspaces properties​

A workspace has the following properties.

Identifer​

Each workspace has an unique identifier that is auto-generated. This identifier is used in API requests, or technical references.

Base URL​

To access to the workspace, a technical default URL is generated based on the workspace id. This URL is composed of the workspace id and OwlGrid base URL. For example, if the workspace id is "xxxxxxx" and the OwlGrid base URL is "owlgrid.com", the base URL of the workspace will be "xxxxxxx.owlgrid.com".

This URL can be override using a custom domain name. More information about custom domain names can be found in the custom domain names documentation.

Organization​

Organization: the organization the workspace is attached to. The organization can be changed after the creation of the workspace.

Operations​

To manage workspaces, please refer to the workspace technical documentation.