Ignoring revisions in .git-blame-ignore-revs. Click here to bypass and see the normal blame view.

74 lines
2.5 KiB
Markdown
Raw Permalink Normal View History

2019-08-23 14:22:47 -07:00
---
2023-06-02 21:41:36 -07:00
title_tag: "Pulumi Cloud: Teams and RBAC"
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.
h1: "Teams & Role-based access control (RBAC)"
2023-06-08 16:15:52 -07:00
meta_image: /images/docs/meta-images/docs-meta.png
menu:
pulumicloud:
weight: 1
parent: access-management
2019-08-23 14:22:47 -07:00
aliases:
- /docs/reference/service/teams/
- /docs/console/collaboration/teams/
- /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/
- /docs/intro/pulumi-cloud/teams/
2019-08-23 14:22:47 -07:00
---
{{% notes "info" %}}
Teams are only available to organizations using Pulumi Enterprise Edition and Pulumi Business Critical Edition.
To learn more about editions visit the [pricing page](/pricing/).
{{% /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
## Creating a Team{#creating-a-team}
2019-08-23 14:22:47 -07:00
By default, all organization admins can create new teams.
To create a team:
1. Navigate to **Settings** > **Teams**.
1. Select **Create team**.
To give members permission to create teams:
1. Navigate to **Settings** > **Access Management**.
1. Use the toggle to turn on the **Allow organization members to create teams** setting.
2019-08-23 14:22:47 -07:00
## GitHub-based Teams
2019-08-23 14:22:47 -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
## Team Permissions
By default only organization admins can create teams.
To allow all members to create teams:
1. Navigate to **Settings** > **Access Management**.
1. Use the toggle to turn on the Allow organization members to create teams setting.
2019-08-23 14:22:47 -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
![Editing team stacks and permissions](/images/docs/reference/service/editing-stack-permissions.png)
### 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:
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**.