Creating custom roles in an enterprise

Create roles with fine-grained permissions for consistent access to settings and resources.

Neste artigo

Observação

The ability for enterprise owners to create custom roles for an organization or enterprise is in public preview and subject to change.

To tailor access management to your company's needs, you can create custom roles for your enterprise account and organizations.

Custom roles are sets of permissions for settings and resources that you can assign to users and teams. To learn best practices for using roles on GitHub, see Identifying the roles required by your enterprise.

Creating enterprise custom roles

Enterprise custom roles grant access to a subset of enterprise settings, such as viewing audit logs and creating organizations. GitHub plans to expand the list of available permissions over time.

  1. No canto superior direito do GitHub, selecione sua imagem de perfil.
  2. Dependendo do ambiente, selecione Sua empresa ou Suas empresas e escolha a empresa que deseja ver.
  3. Na parte superior da página, clique em People.{ % else %}No lado esquerdo da página, na barra lateral da conta empresarial, clique em People.
  4. In the left sidebar, click Enterprise roles, then click Role management.
  5. Click Create custom role.
  6. Enter the details, then click Create role.

Creating organization custom roles

Organization custom roles grant access to organization settings and repositories. Custom organization roles created at the enterprise level use the same permissions and base roles as roles created at the organization level. For more information, see Sobre as funções da organização personalizadas.

Enterprise owners can create and edit custom organization roles, but cannot assign them. Organization owners can assign custom roles in an organization.

Observação

An enterprise can create up to 20 custom organization roles. This limit applies to the enterprise: each organization can also create up to 20 custom organization roles.

  1. No canto superior direito do GitHub, selecione sua imagem de perfil.
  2. Dependendo do ambiente, selecione Sua empresa ou Suas empresas e escolha a empresa que deseja ver.
  3. Na parte superior da página, clique em People.{ % else %}No lado esquerdo da página, na barra lateral da conta empresarial, clique em People.
  4. In the left sidebar, select Organization roles.
  5. Click Create custom role.
  6. Enter the details, then click Create role.

Next steps

You can manage role assignments at scale using teams. Learn about teams in your enterprise and organizations in Teams in an enterprise.