2019-08-23 14:22:47 -07:00
---
2023-06-02 21:41:36 -07:00
title_tag: "Pulumi Cloud: Teams and RBAC"
2023-05-15 15:25:28 -07:00
title: "Teams & RBAC"
2023-04-11 13:40:50 -07:00
meta_desc: The Pulumi Cloud offers role-based access control (RBAC) using teams. Learn how how to create and manage teams in this guide.
2023-05-15 15:25:28 -07:00
h1: "Teams & Role-based access control (RBAC)"
2023-06-08 16:15:52 -07:00
meta_image: /images/docs/meta-images/docs-meta.png
2021-04-13 10:41:56 -07:00
menu:
2023-05-15 15:25:28 -07:00
pulumicloud:
weight: 1
parent: access-management
2019-08-23 14:22:47 -07:00
aliases:
- /docs/reference/service/teams/
- /docs/console/collaboration/teams/
2022-01-14 12:55:13 -08:00
- /docs/intro/console/collaboration/
- /docs/intro/console/collaboration/teams/
- /docs/intro/console/teams/
2023-04-11 16:50:51 -07:00
- /docs/intro/pulumi-service/teams/
2023-05-15 15:25:28 -07:00
- /docs/intro/pulumi-cloud/teams/
2019-08-23 14:22:47 -07:00
---
2021-05-07 15:23:02 -07:00
{{% notes "info" %}}
2022-03-02 20:14:55 -08:00
Teams are only available to organizations using Pulumi Enterprise Edition and Pulumi Business Critical Edition.
2022-10-26 07:22:15 -07:00
To learn more about editions visit the [pricing page ](/pricing/ ).
2021-05-07 15:23:02 -07:00
{{% /notes %}}
2019-08-23 14:22:47 -07:00
2023-04-11 13:40:50 -07:00
The Pulumi Cloud offers role-based access control (RBAC) using teams. Teams allow organization admins to assign a set of stack permissions to a group of users.
2019-08-23 14:22:47 -07:00
2021-07-09 10:36:53 -07:00
## Creating a Team{#creating-a-team}
2019-08-23 14:22:47 -07:00
2021-06-24 05:58:24 -07:00
By default, all organization admins can create new teams.
To create a team:
2022-08-27 07:13:21 -07:00
1. Navigate to **Settings** > **Teams** .
2021-06-24 05:58:24 -07:00
1. Select **Create team** .
To give members permission to create teams:
2022-08-27 07:13:21 -07:00
1. Navigate to **Settings** > **Access Management** .
2021-06-24 05:58:24 -07:00
1. Use the toggle to turn on the **Allow organization members to create teams** setting.
2019-08-23 14:22:47 -07:00
2021-07-09 10:36:53 -07:00
## GitHub-based Teams
2019-08-23 14:22:47 -07:00
2019-08-29 14:09:44 -07:00
If your Pulumi organization is backed by GitHub, you can import your existing
2019-08-23 14:22:47 -07:00
GitHub teams into Pulumi.
For these teams, membership is managed on GitHub, while the set of stack
2023-04-11 13:40:50 -07:00
permissions granted to team members is managed in the Pulumi Cloud.
2019-08-23 14:22:47 -07:00
2021-07-09 10:36:53 -07:00
## Team Permissions
By default only organization admins can create teams.
To allow all members to create teams:
2022-08-27 07:13:21 -07:00
1. Navigate to **Settings** > **Access Management** .
2021-07-09 10:36:53 -07:00
1. Use the toggle to turn on the Allow organization members to create teams setting.
2019-08-23 14:22:47 -07:00
2021-07-09 10:36:53 -07:00
### Granting Access to Stacks within Teams
Teams can be granted access to stacks, which grants all team members access to those stack based on the selected permission level.
2019-08-23 14:22:47 -07:00
2021-04-13 10:41:56 -07:00

2021-07-09 10:36:53 -07:00
### Team Roles
Members of a team can be granted `Team admin` or `Team member` permissions. Team admins can add members to a
team. By default, any new team members will be assigned the team member role.
To change a team member's role:
2022-08-27 07:13:21 -07:00
1. Navigate to **Settings** > **Teams** and then the specific team.
1. In the **Members** section use the action menu item at the end of the table row and select **Change role to** .