Manage organizations

In Hub, an organization helps centrally control user access to the administrative functions for an instance. Your initial organization access will vary based on how you registered for Hub:

• If you registered for Hub independently, a default organization was created with your username. After logging in to your default organization, you can manage it or any organization you are an owner of. You can create new Hub organizations, add or remove Hub users from the organization, and change the role of an organization for an instance.
• If you were invited to register for Hub in order to join an existing organization, then you will have view access to that organization and its resources when you log in, and you can create additional organizations. If you are designated as an owner of the organization, and not just a member of it, then you may also have the ability to make changes to the organization and its resources.

Add a new Hub organization

Creating new Hub organizations other than your default organization allows you to then add users to the different organizations, and create aiWARE instances associated with specific organizations.

Before you begin

If you'd like to add a logo for the organization, the file must meet the following specifications:

• .jpeg or .png
• Max file size: 5MB

Steps

1. In the left sidebar, click + Add New > + Add New Organization. The Create Organization panel opens.
2. Enter an Organization Name.
3. Optional: Add a logo for the organization by clicking the camera icon, then select an image file, edit it using the built-in image editor, and click Upload.
4. Click Save. The new organization appears on the Organizations table.

Edit an organization's properties

Hub users who are owners of an organization can change some of the metadata for an organization, including the name, and change or edit the logo.

Steps

1. On an organization on the Organizations table, click More Actions > Edit. The Update Organization dialog opens.
2. Do one or more of the following:
   • Enter an Organization Name.
   • Add or change the logo for the organization by clicking the camera icon, then select an image file, edit it using the built-in image editor, and click Upload.
   • Delete an organization's logo by clicking the Trash icon next to the image.
3. Click Save.

Switch organizations

When working in Hub, you are working within the context of an organization, and only that organization's instances and users are accessible. If you are associated with additional Hub organizations, you can access those instances and users by switching organizations.

Before you begin

You need to have at least one other organization set up in the Organizations table, in addition to the default organization that was created with your username when you registered for Hub. See Add an organization.

Steps

1. At the lower left, click the current Organization icon.

   A menu of available organizations appears.

2. Select an organization from the list or use the search field to search for one, and click it.
   The aiWARE Instance table is now populated with the instances associated with the chosen organization.

Add Hub users to an organization

Only owners of a Hub organization can add existing users to the organization. When a user is added to an organization, that user can access all the users, instances, and packages associated with the organization. Whether that user has view access only, or can make changes to the resources of an organization, depends on the user's role. By default, new users are members of the organization. To change a user's permissions, see Change a user's role.

[note] This process only applies to existing Hub users. To invite new users to Hub see Add a user to Hub.

Steps

1. Select an organization in the Organizations table. The Organization Detail panel opens.
2. Click the Users tab > Add Users, enter the email address of one or more existing Hub users, then click the Add Users button. If the user does not already exist, you won't be able to click the Add Users button. The users are added as members of the organization, which means they have view access only.

Remove a user from an organization

Only owners of a Hub organization can remove users. When you remove a user you are removing them from the currently active organization. It does not affect their status in any other organization they may be a part of.

[note] A user cannot be removed from an organization if they are the only user in that organization.

Steps

1. Select an organization in the Organizations table. The Organization Detail panel opens.
2. Click the Users tab > More Actions > Edit.
3. In the Users list, click More Actions on the line for the user you want to change, then click Remove, then click Yes at the prompt. The user is removed from the organization.

• To learn how to add an organization to an existing aiWARE instance, see Add an organization to an instance.
• For a description of the roles and permissions in Hub, see Roles and permissions.
• To learn how to manage Hub users, see Manage users.

• Add new Hub organizations that can be used to deploy instances
• Edit an organization's properties
• Switch to a different organization
• Add users to an organization
• Remove users from an organization