Skip to main content

Organizations Configuration

Overview

Organizations Configuration allows businesses to manage multiple organizations, set up and integrate custom Identity Providers (IDPs), and enable Just-In-Time (JIT) provisioning. By leveraging this functionality, developers can integrate and automate organizational management, enabling seamless authentication and provisioning workflows that drive operational efficiency and security compliance.

Configuration Guide

To learn more about configuring an organization, inviting and adding users, or assigning specific roles, refer to the details below.

Accessing the Admin Console

  1. Log in to the Admin Console.
  2. Navigate to the Organization tab in the left sidebar.
  3. The Organization dashboard displays all existing organizations' details like Organization name, ID, SSO status, and creation date.

Creating an Organization

  1. Click the Create Organization button.
  2. Enter the organization details:
    • Organization Name: A unique name for identifying the organization.
    • Domain: Configure multiple domains to set up Custom IDP and enable Just-in-Time (JIT) membership for users whose email addresses match the specified domains.
  3. Click Save to create the organization. A unique Org ID will be generated upon creation and can be used to access the organization at the API level.
  4. The organization appears in the Organization List for further configuration.

Managing Organization Details

  1. Select an organization from the list.
  2. Modify organization settings such as name, domain, and status.
  3. Click Save Changes to update the organization.
  4. Organizations can be deactivated to restrict access without deleting data. When an organization is deactivated, all end users will lose access until it is reactivated.
  5. To delete an organization permanently, click Delete Organization (This action cannot be undone).

Viewing and Searching Organizations

  1. Use the search bar to locate organizations by name.
  2. Click on an organization to view its associated users, authentication settings, and roles.

Managing Users in an Organization

Managing users within an organization ensures proper access control and role assignment. Admins can add users, invite new members, assign roles, and remove users as needed. This helps in structuring access based on responsibilities while maintaining security and compliance. Below are the steps to manage users effectively.

  1. Navigate to the Users tab within the organization.
  2. Click on the All Users tab to see the list of available users within the organization.
  3. Click on Add User to initiate adding a new user.
  4. Select the user’s email address and assign a specific role from the drop-down menu.
    📌Note: The new user must first be part of the tenant users before they can be added to the organization using the Add User functionality.

Configuring Roles in an Organization

Roles define the level of access users have within an organization. Configuring roles ensures appropriate access control and security within the system.

  1. Navigate to the Roles tab inside an organization.
  2. Click Create Role.
  3. Enter the Role Name and Description.
  4. Permissions can only be created at the tenant level. If no permissions are made, you should create relevant permissions under Customer >> Roles and Permissions.
  5. Click Save to create the role.

📌Note: When a new user joins via Just-In-Time (JIT) provisioning, a default role will automatically be assigned to them. It's important to note that a maximum of one role can be set as the default role for any user.