Skip to main content

Switching organizations

Reading time: 0 minute(s) (0 words)

As a part of this feature, Nobl9 offers the ability to toggle between organizations easily and securely.

For example, Nobl9 users can leverage this feature to switch between their production and sandbox organizations to experiment with the Nobl9 Platform and their SLOs in a safe environment that doesnโ€™t disrupt their production environment and SLOs.

Create new organizationโ€‹

You can request to create a new non-production organization:

Manage your organizationsโ€‹

You can identify the organization youโ€™re currently in by checking the label in the top-right corner of your screen, next to your userโ€™s icon:

org switcher prompt
Image 1: Organization label

You can switch between different organizations youโ€™re assigned to in the UI or via sloctl.

Switch organizations in the UIโ€‹

To switch organizations in the UI:

  1. Click your user icon in the top-right corner of the screen.

  2. In the drop-down menu, click the organization's name with a caret icon next to it:

    org switcher caret
    Image 2: Organization switcher
  3. Choose the organization youโ€™d like to switch to and click it.

tip

You can also switch organizations using deep links.

Switch organizations in sloctlโ€‹

You can also switch through organizations by using sloctl config commands. For more details, refer to sloctl user guide.

tip

Use the sloctl config add-context command to add a new organization context to sloctl.

For example, to preview available organizations, use the sloctl config get-contexts -v command, which will produce the following output:

All available contexts: [production, sandbox]

Context: production
ClientID: # secret
ClientSecret: # secret
Project: default
Organization: production

Context: sandbox
ClientID: # secret
ClientSecret: # secret
Project: default
Organization: sandbox

Invite users to an organizationโ€‹

Organization admins can invite users to an organization:

  1. Switch to the organization you want to invite users to.
  2. Go to Settings > Users.
  3. Add the users you want to invite, one at a time.

Invitation emailsโ€‹

Invited users will receive the following e-mail from Nobl9:

invitation email
Image 4: Invitation e-mail from Nobl9

When a user clicks the button link, they can either:

  • Manually switch to the organization by clicking on their screenโ€™s user icon in the top-right corner of the app:
org switcher
Image 5: Switching organization
  • Accept a prompt from the Nobl9 Platform to change their current organization:
org switcher prompt
Image 6: Switch organizations prompt

After completing one of the above steps, users can leverage resources within the selected organization per the assigned role.

Switching organizations - rules at glanceโ€‹

The ID of the current organization is stored in the URL that you can check in your browserโ€™s address bar. The following link shows an example of a deep link to the main page of the Service Health Dashboard in the production organization:

app.nobl9.com/service-health?org=production&page=1

The org parameter notesโ€‹

  • Deep links without the org parameter automatically redirect to a default organization, which is individual for every user.

  • When a user has no access to the organization specified with the org parameter, they cannot access the indicated resource.

  • You can switch organizations with deep links.
    For this, replace the value of the org parameter with the required organization ID in the address bar.

  • When you switch organizations with the deep link, and:

    • โ€ข The specified organization doesn't exist, or
      โ€ข You have no access to the specified organization, then
  • You're redirected to the Need permission screen.
    Additionally, you are prompted to select an organization available for you:

    need permission
    Image 7: Need permission page
caution

You canโ€™t migrate SLOs between organizations and retain their historical data.