Organizations

Overview

Organizations are the root object in the hierarchy of the Digital Spine IAM solution. They are administrators that govern the creation and management of Applications and Roles, and by extension Topics and Channels - all of these objects are nested under the Organization object.

Organizations are identified by a namespace using the pattern organization.iam.ewc.

Hierarchy Diagram (placeholder)

User Guide

Pre-requisites

  • User logged into Switchboard

Create an Organization

The “Create Organization” button allows creating only one organization per a wallet. After using, the button is hidden from UI.

  1. In the home page, click on the Governance menu

Governance menu

  1. Click on Create Organization button

Create organization button

  1. Fill in the form and submit the request

Create organization form

Modify an Organization

  1. In the Organization Management page, click on the action button right next to the organization that you want to edit

Edit organization

  1. Update organization and scroll down to click Next and confirm your changes

Update organization

  1. Confirm the details and click Next

Confirm details

  1. Organization updated

Remove an Organization

  1. In the Organization Management page, click on the action button right next to the organization that you want to delete

Delete organization

Organization options

Assume that you already own an organization, on the Organization management tab you can perform several options related to your organization and its EWNS namespace, each using the options under the three vertical dots button (next to an organization namespace in the list).

Symbol

Name

Description

View Details

View the basic details of your organization, including the logo, namespace, organization name, website, description, and other data.

Create Sub-Organization

Create a new sub-organization owned by the organization. This allows you to define applications and roles for specific subsidiaries or business units within your organizational umbrella. For example, you might create “subsidiary1.exampleco.iam.ewc” and “subsidiary2.exampleco.iam.ewc” so that you can define applications and roles specific to those subsidiaries (as described in the following sections of this document).

View Applications

View the applications owned by this organization (i.e., go to application management tab).

View Roles

View the roles associated with this organization or with any application owned by this organization (i.e., go to role governance tab).

Note that that are two kinds of roles:

  1. Roles associated with an organization - these roles are independent of any particular application. For example, you might create the role “global dApp admin” to manage all of your organization’s applications.

  2. Roles associated with an application - these roles are specific to a particular application. For example, you might create the role “installer” or “renewable energy buyer” in an application that you own. These roles are not necessarily part of your organization.

Create Application

Create a new application owned by the organization.

Create Role

Create a new role associated with either this organization or a specific application owned by this organization.

Edit

Change the details of your organization. Please note that it is not possible to change the root namespace of an organization. For example, after you have defined “exampleco.iam.ewc" as your namespace, you could define subdomains (e.g., "roles.exampleco.iam.ewc" or "applications.exampleco.iam.ewc"), or you could define a new root namespace (e.g., "exampleorg.iam.ewc"), but you are not able to change the root namespace "exampleco.iam.ewc" into something different.

The “others (JSON)” field allows you to specify formatting-related details (e.g., color scheme) that should be applied, so that when you integrate the system into your decentralized applications the branding is consistent. For example, you could add into this field the text:

{"bgcolor":"CDD3FF","txtcolor":"FF0000"}

The above text will set the background color for the system in your application to be the light blue color with hex code CDD3FF and the text color to be red with hex code FF0000. You can experiment with different formatting options.

Transfer Ownership

Transfer ownership of your organization and its root namespace to another address.

Delete

Delete your organization.

PreviousTechnical GuideNextApplications

Last updated