Manage users in orgs and spaces

In this Topic you will learn how to manage users and roles within your organisation and space. You can add other users with specific rights to your organisation, or just to a number of spaces within your organisation. You must at least have the role of an org-manager or space-manager to add other users to your org or space.

You can learn more about the concept of Cloud Foundrys User Roles in organisations, spaces and user-roles.

List users in your org and space

Once you have logged in and targeted your org and space with the CF CLI you can get a list of users and their assigned roles within your org and space.

In order to see the users with assigned roles in a space, use the following command:

cf space-users

In order to see the users with assigned roles in an org, use the following command:

cf org-users

This will result in an output like in the following example:

cf org-users

Getting users in org example-org as username@example.com...

ORG MANAGER
  username@example.com

BILLING MANAGER
  another@example.com
  yetanother@example.com

ORG AUDITOR
  thelast@example.com

Add/remove users to/from orgs

In order to add a User with a specific role to an organisation, you have to be org manager.

You can set roles to users with the following command:

cf set-org-role <USERNAME> <ORG> <ROLE>

You add users to an org with the roles: OrgManager, BillingManager, OrgAuditor. Learn more about the roles in organisations, spaces and user-roles.

Since within STACKIT usernames are the email adress of a user, this would look like the following example:

cf set-org-role username@example.com example-org OrgManager

You can remove the roles form users within your org again with the following command:

cf unset-org-role <USERNAME> <ORG> <ROLE>

Add/remove users to/from spaces

In order to add a User with a specific role to an organisation, you have to be org manager or space manager.

You can set roles to users with the following command:

cf set-space-role <USERNAME> <ORG> <SPACE> <ROLE>

You add users to a space with the roles: SpaceManager, SpaceDeveloper, SpaceAuditor. Learn more about the roles in organisations, spaces and user-roles.

Since within STACKIT usernames are the email adress of a user, this would look like the following example:

cf set-space-role username@example.com example-org example-space SpaceDeveloper

You can remove the roles form users within your space again with the following command:

cf unset-space-role <USERNAME> <ORG> <SPACE> <ROLE>