{"meta":{"title":"Como controlar o acesso a executores maiores","intro":"Você pode usar políticas para limitar o acesso a executor avançados que foram adicionados a uma organização ou empresa.","product":"GitHub Actions","breadcrumbs":[{"href":"/pt/enterprise-cloud@latest/actions","title":"GitHub Actions"},{"href":"/pt/enterprise-cloud@latest/actions/how-tos","title":"Instruções"},{"href":"/pt/enterprise-cloud@latest/actions/how-tos/manage-runners","title":"Gerenciar corredores"},{"href":"/pt/enterprise-cloud@latest/actions/how-tos/manage-runners/larger-runners","title":"Executores avançados"},{"href":"/pt/enterprise-cloud@latest/actions/how-tos/manage-runners/larger-runners/control-access","title":"Controlar o acesso"}],"documentType":"article"},"body":"# Como controlar o acesso a executores maiores\n\nVocê pode usar políticas para limitar o acesso a executor avançados que foram adicionados a uma organização ou empresa.\n\n## Controlar o acesso a executores avançados\n\n> \\[!NOTE]\n> Antes que seus fluxos de trabalho possam enviar trabalhos para executor avançados, primeiro você deve configurar permissões para o grupo de executores. Confira as seções a seguir para obter mais informações.\n\nOs grupos de executores são usados para controlar quais repositórios podem executar trabalhos em seus executor avançados. Você deve gerenciar o acesso ao grupo em cada nível da hierarquia de gerenciamento, dependendo de onde você definiu o executor avançado:\n\n* \\*\\*Corredores no nível da empresa:\\*\\*Por padrão, os repositórios na organização não têm acesso a grupos de executores de nível empresarial. Para fornecer aos repositórios acesso aos grupos de executores corporativos, os proprietários da organização devem configurar cada grupo de executores corporativos e escolher quais repositórios têm acesso.\n* \\*\\*Corredores no nível da organização:\\*\\*Por padrão, todos os repositórios em uma organização recebem acesso aos grupos de executores no nível da organização. Para restringir quais repositórios têm acesso, os proprietários da organização e os usuários com a permissão \"Gerenciar executores e grupos de executores da organização\" configurar grupos de executores da organização e escolher quais repositórios têm acesso.\n\nPor exemplo, o diagrama a seguir tem um grupo de executores chamado `grp-ubuntu-24.04-16core` no nível da empresa. Para que o repositório chamado `octo-repo` possa usar os executores do grupo, você deve primeiro configurar o grupo no nível da empresa para permitir o acesso à organização `octo-org`. Em seguida, você precisará configurar o grupo no nível da organização para permitir o acesso ao `octo-repo`.\n\n\n\n## Como criar um grupo de executores para uma organização\n\n> \\[!WARNING]\n> Se você estiver usando um intervalo de IP fixo, a recomendação será usar apenas executor avançado com repositórios particulares. Bifurcações do seu repositório podem executar códigos perigosos em seu executor avançado criando uma solicitação de pull que executa o código em um fluxo de trabalho.\n\n> \\[!NOTE]\n> Ao criar um grupo de executores, você deve escolher uma política que defina quais repositórios e fluxos de trabalho têm acesso ao grupo de executores. Para alterar quais repositórios e fluxos de trabalho podem acessar o grupo de executores, os proprietários da organização e os usuários com a permissão \"Gerenciar corredores e grupos de executores\" podem definir uma política para a organização. Para saber mais, confira [Gerenciar o acesso a executores auto-hospedados usando grupos](/pt/enterprise-cloud@latest/actions/how-tos/manage-runners/self-hosted-runners/manage-access#changing-which-repositories-can-access-a-runner-group).\n\nTodas as organizações têm um único grupo de runners padrão.\nOs proprietários da organização e os usuários com a permissão \"Gerenciar executores da organização e grupos de executores\" podem criar grupos de executores adicionais no nível da organização.\nPara obter mais informações sobre funções de organização personalizadas, consulte [Permissões de funções de organização personalizadas](/pt/enterprise-cloud@latest/organizations/managing-peoples-access-to-your-organization-with-roles/permissions-of-custom-organization-roles).\n\nSe nenhum grupo for especificado durante o processo de registro, os executores serão adicionados automaticamente ao grupo padrão. Mais tarde, você pode mover o runner do grupo padrão para um grupo personalizado.\n\nPara obter informações sobre como criar um grupo de executores com a API REST, confira [Endpoints da API REST para Ações do GitHub](/pt/enterprise-cloud@latest/rest/actions#self-hosted-runner-groups).\n\n1. Em GitHub, acesse a página principal da organização.\n\n2. No nome da organização, clique em ** Settings**. Caso não consiga ver a guia \"Configurações\", selecione o menu suspenso **** , clique em **Configurações**.\n\n \n\n3. Na barra lateral esquerda, clique em ** Actions** e escolha **Runner groups**.\n\n4. Na seção \"Grupos de executores\", clique em **Novo grupo de executores**.\n\n5. Digite um nome para o grupo do seu executor.\n\n6. Atribua uma política para acesso ao repositório.\n\n Você pode configurar um grupo de executores para ser acessível a uma lista específica de repositórios ou a todos os repositórios na organização. Por padrão, somente repositórios privados podem acessar executores em um grupo de executores, mas você pode substituir isso. Essa configuração não poderá ser substituída se você configurar um grupo de executores da organização que tenha sido compartilhado por uma empresa.\n\n7. Atribua uma política para acesso ao fluxo de trabalho.\n\n Você pode configurar um grupo de executores para ser acessível a uma lista específica de fluxos de trabalho ou a todos os fluxos de trabalho. Essa configuração não poderá ser substituída se você estiver configurando o grupo de executores de uma organização que foi compartilhado por uma empresa. Se você especificar o fluxo de trabalho que pode acessar o grupo de executores, precisará usar o caminho completo para o fluxo de trabalho, incluindo o nome e o proprietário do repositório, e fixar o fluxo de trabalho em um branch, uma tag ou um SHA completo. Por exemplo: `octo-org/octo-repo/.github/workflows/build.yml@refs/tags/v2, octo-org/octo-repo/.github/workflows/deploy.yml@d6dc6c96df4f32fa27b039f2084f576ed2c5c2a5, monalisa/octo-test/.github/workflows/test.yml@refs/heads/main`.\n\n É uma prática recomendada qualificar totalmente refs ambíguos. Por exemplo, em vez de fornecer `main` como um ref, forneça `refs/heads/main`.\n\n Somente os trabalhos definidos diretamente nos fluxos de trabalho selecionados terão acesso ao grupo de executores. Os grupos de runners pertencentes à organização não podem acessar fluxos de trabalho de outra organização dentro da empresa; em vez disso, você deve criar um grupo de runners pertencente à empresa.\n\n8. Clique em **Criar grupo** para criar o grupo e aplicar a política.\n\n## Como criar um grupo de executores para uma empresa\n\n> \\[!WARNING]\n> Se você estiver usando um intervalo de IP fixo, a recomendação será usar apenas executor avançado com repositórios particulares. Bifurcações do seu repositório podem executar códigos perigosos em seu executor avançado criando uma solicitação de pull que executa o código em um fluxo de trabalho.\n\nAs empresas podem adicionar os executores delas a grupos para gerenciamento de acesso. As empresas podem criar grupos de executores acessíveis por meio de organizações específicas na conta da empresa ou por fluxos de trabalho específicos. Os proprietários da organização podem atribuir políticas adicionais de acesso do repositório granular ou políticas de acesso do fluxo de trabalho para os grupos de executores da empresa. Para obter informações sobre como criar um grupo de executores com a API REST, confira os pontos de extremidade da empresa na [API REST de GitHub Actions](/pt/enterprise-cloud@latest/rest/actions#self-hosted-runner-groups).\n\nSe nenhum grupo for especificado durante o processo de registro, os executores serão adicionados automaticamente a um grupo padrão. Posteriormente, você pode mover o executor do grupo padrão para um grupo personalizado.\n\nAo criar um grupo, você deve escolher uma política que defina quais organizações têm acesso ao grupo de executores.\n\n1. Navegue até sua empresa. Por exemplo, na página [Enterprises](https://github.com/settings/enterprises?ref_product=ghec\\&ref_type=engagement\\&ref_style=text) em GitHub.com.\n\n2. Na parte superior da página, clique ** em Políticas**.\n\n3. Em \" Policies\", clique em **Actions**.\n\n4. Clique na guia **Grupos de executores**.\n\n5. Clique em **Novo grupo de executores**.\n\n6. Em \"Nome do grupo\", digite um nome para o grupo de executores.\n\n7. Para escolher uma política para o acesso da organização, selecione o menu suspenso **Acesso à organização** e clique em uma política. Você pode configurar um grupo de executor para que possa ser acessado por uma lista específica de organizações ou a todas as organizações da empresa.\n\n8. Atribua uma política para acesso ao fluxo de trabalho.\n\n Você pode configurar um grupo de executores para ser acessível a uma lista específica de fluxos de trabalho ou a todos os fluxos de trabalho. Essa configuração não poderá ser substituída se você estiver configurando o grupo de executores de uma organização que foi compartilhado por uma empresa. Se você especificar o fluxo de trabalho que pode acessar o grupo de executores, precisará usar o caminho completo para o fluxo de trabalho, incluindo o nome e o proprietário do repositório, e fixar o fluxo de trabalho em um branch, uma tag ou um SHA completo. Por exemplo: `octo-org/octo-repo/.github/workflows/build.yml@refs/tags/v2, octo-org/octo-repo/.github/workflows/deploy.yml@d6dc6c96df4f32fa27b039f2084f576ed2c5c2a5, monalisa/octo-test/.github/workflows/test.yml@refs/heads/main`.\n\n É uma prática recomendada qualificar totalmente refs ambíguos. Por exemplo, em vez de fornecer `main` como um ref, forneça `refs/heads/main`.\n\n Somente os trabalhos definidos diretamente nos fluxos de trabalho selecionados terão acesso ao grupo de executores.\n\n9. Clique em **Salvar grupo** para criar o grupo e aplicar a política.\n\n## Usar nomes exclusivos para grupos de executores\n\nGitHub Actions exige que os nomes de grupos de executores precisem ser exclusivos no nível da organização. Isso significa que uma organização não poderá mais criar um grupo de executores com o mesmo nome que um na empresa. Além disso, os usuários verão uma faixa de aviso em qualquer grupo de executores que compartilhem o mesmo nome de um grupo na empresa, sugerindo que o grupo da organização deve ser renomeado.\n\nPara evitar ambiguidade, um fluxo de trabalho falhará se houver grupos de executores duplicados na organização e na empresa. Para resolver isso, você pode renomear um dos grupos de executores na organização ou na empresa ou atualizar o arquivo de fluxo de trabalho para adicionar um prefixo ao nome do grupo de executores:\n\n* `org/` ou `organization/`\n* `ent/` ou `enterprise/`\n\n### Exemplo: usar prefixos para diferenciar grupos de executores\n\nPor exemplo, se você tiver um grupo de executores chamado `my-group` na organização e outro chamado `my-group` na empresa, poderá atualizar seu arquivo de fluxo de trabalho para usar `org/my-group` ou `ent/my-group` para diferenciar os dois.\n\nUsando `org/`:\n\n```yaml\nruns-on:\n group: org/my-group\n labels: [ self-hosted, label-1 ]\n```\n\nUsando `ent/`:\n\n```yaml\nruns-on:\n group: ent/my-group\n labels: [ self-hosted, label-1 ]\n```\n\n## Alterar quais organizações podem acessar um grupo de executores\n\n> \\[!WARNING]\n> Se você estiver usando um intervalo de IP fixo, a recomendação será usar apenas executor avançado com repositórios particulares. Bifurcações do seu repositório podem executar códigos perigosos em seu executor avançado criando uma solicitação de pull que executa o código em um fluxo de trabalho.\n\nPara grupos de executores em uma empresa, você pode alterar quais organizações na empresa podem acessar um grupo de executores.\n\n1. Navegue até sua empresa. Por exemplo, na página [Enterprises](https://github.com/settings/enterprises?ref_product=ghec\\&ref_type=engagement\\&ref_style=text) em GitHub.com.\n\n2. Na parte superior da página, clique ** em Políticas**.\n\n3. Em \" Policies\", clique em **Actions**.\n\n4. Clique na guia **Grupos de executores**.\n\n5. Em \"Acesso à organização\", use o menu suspenso para clicar em **Organizações selecionadas**.\n 1. À direita do menu suspenso, clique em .\n 2. Na janela pop-up, use as caixas de seleção para selecionar organizações que podem usar esse grupo de executores.\n\n6. Clique em **Salvar grupo**.\n\n## Como alterar quais repositórios podem acessar um grupo de executores\n\n> \\[!WARNING]\n> Se você estiver usando um intervalo de IP fixo, a recomendação será usar apenas executor avançado com repositórios particulares. Bifurcações do seu repositório podem executar códigos perigosos em seu executor avançado criando uma solicitação de pull que executa o código em um fluxo de trabalho.\n\nPara grupos de executores em uma organização, você pode alterar quais repositórios na organização podem acessar um grupo de executores.\n\n1. Acesse a página principal da organização em que os grupos de executores estão localizados.\n\n2. Clique em ** Settings**.\n\n3. Na barra lateral esquerda, clique em ** Actions** e escolha **Runner groups**.\n\n4. Na lista de grupos, clique no grupo de executores que deseja configurar.\n\n5. Em “Acesso ao repositório”, use o menu suspenso para clicar em **Repositórios selecionados**.\n 1. À direita do menu suspenso, clique em .\n 2. Na janela pop-up, use as caixas de seleção para selecionar os repositórios que podem acessar esse grupo de executores.\n\n6. Clique em **Salvar grupo**.\n\n## Como alterar quais fluxos de trabalho podem acessar um grupo de executores\n\n> \\[!WARNING]\n> Se você estiver usando um intervalo de IP fixo, a recomendação será usar apenas executor avançado com repositórios particulares. Bifurcações do seu repositório podem executar códigos perigosos em seu executor avançado criando uma solicitação de pull que executa o código em um fluxo de trabalho.\n\nVocê pode configurar um grupo de executores para executar fluxos de trabalho selecionados ou todos os fluxos de trabalho. Por exemplo, você pode usar essa configuração para proteger segredos armazenados em executores auto-hospedados ou para padronizar os fluxos de trabalho de implantação restringindo um grupo de executores a fim de executar apenas um fluxo de trabalho reutilizável específico. Esta configuração não pode ser substituída se você configurar o grupo de executores da organização que foi compartilhado por uma empresa.\n\n* [Como alterar quais fluxos de trabalho podem acessar um grupo de executores da organização](#changing-which-workflows-can-access-an-organization-runner-group)\n* [Como alterar quais fluxos de trabalho podem acessar um grupo de executores da organização](#changing-which-workflows-can-access-an-enterprise-runner-group)\n\n### Como alterar quais fluxos de trabalho podem acessar um grupo de executores da organização\n\n1. Acesse a página principal da organização em que os grupos de executores estão localizados.\n\n2. Clique em ** Settings**.\n\n3. Na barra lateral esquerda, clique em ** Actions** e escolha **Runner groups**.\n\n4. Na lista de grupos, clique no grupo de executores que deseja configurar.\n\n5. Em **Acesso ao fluxo de trabalho**, selecione o menu suspenso e clique em **Fluxos de trabalho selecionados**.\n\n6. Clique em .\n\n7. Insira uma lista separada por vírgulas dos fluxos de trabalho que podem acessar o grupo de executores. Use o caminho completo, incluindo o nome e proprietário do repositório. Fixar o fluxo de trabalho em um ramo, tag ou SHA completo. Por exemplo: `octo-org/octo-repo/.github/workflows/build.yml@v2, octo-org/octo-repo/.github/workflows/deploy.yml@d6dc6c96df4f32fa27b039f2084f576ed2c5c2a5, monalisa/octo-test/.github/workflows/test.yml@main`.\n\n Apenas trabalhos definidos diretamente nos fluxos de trabalho selecionados terão acesso ao grupo de executores.\n\n Os grupos de executores pertencentes à organização não podem acessar os fluxos de trabalho de uma organização diferente na empresa. Em vez disso, você deve criar um grupo de executores pertencente à empresa.\n\n8. Clique em **Salvar**.\n\n### Como alterar quais fluxos de trabalho podem acessar um grupo de executores corporativos\n\n1. Navegue até sua empresa. Por exemplo, na página [Enterprises](https://github.com/settings/enterprises?ref_product=ghec\\&ref_type=engagement\\&ref_style=text) em GitHub.com.\n\n2. Na parte superior da página, clique ** em Políticas**.\n\n3. Em \" Policies\", clique em **Actions**.\n\n4. Clique na guia **Grupos de executores**.\n\n5. Na lista de grupos, clique no grupo de executores que deseja configurar.\n\n6. Em **Acesso ao fluxo de trabalho**, selecione o menu suspenso e clique em **Fluxos de trabalho selecionados**.\n\n7. Clique em .\n\n8. Insira uma lista separada por vírgulas dos fluxos de trabalho que podem acessar o grupo de executores. Use o caminho completo, incluindo o nome e proprietário do repositório. Fixar o fluxo de trabalho em um ramo, tag ou SHA completo. Por exemplo: `octo-org/octo-repo/.github/workflows/build.yml@v2, octo-org/octo-repo/.github/workflows/deploy.yml@d6dc6c96df4f32fa27b039f2084f576ed2c5c2a5, monalisa/octo-test/.github/workflows/test.yml@main`.\n\n Apenas trabalhos definidos diretamente nos fluxos de trabalho selecionados terão acesso ao grupo de executores.\n\n Os grupos de executores pertencentes à organização não podem acessar os fluxos de trabalho de uma organização diferente na empresa. Em vez disso, você deve criar um grupo de executores pertencente à empresa.\n\n9. Clique em **Salvar**.\n\n## Configurar o acesso à rede privada para executores maiores\n\nVocê pode usar executores hospedados no GitHub em uma VNET do Azure. Isso permite usar a infraestrutura gerenciada pela GitHub para CI/CD e, ao mesmo tempo, fornece controle total sobre as políticas de rede dos seus executores. Para obter mais informações sobre VNETs do Azure, consulte [O que é uma Rede Virtual do Azure?](https://learn.microsoft.com/en-us/azure/virtual-network/virtual-networks-overview), na documentação do Azure.\n\nSe você configurou sua empresa ou organização para se conectar a uma VNET Azure, poderá conceder aos grupos executores acesso à rede virtual. Para saber mais, confira [Rede privada com executores hospedados pelo GitHub](/pt/enterprise-cloud@latest/actions/concepts/runners/private-networking#using-an-azure-virtual-network-vnet).\n\nNão é possível atribuir macOS executor avançadoa um grupo de executores que tenha uma configuração de rede. Da mesma forma, você não pode adicionar uma configuração de rede a um grupo de executores que contenha macOS executor avançados.\n\n## Alterando o nome de um grupo de runners\n\nVocê pode renomear grupos de runners nos níveis da empresa e da organização.\n\n* [Como alterar o nome de um grupo de executores da organização](#changing-the-name-of-an-organization-runner-group)\n* [Alterar o nome de um grupo de executores corporativos](#changing-the-name-of-an-enterprise-runner-group)\n\n### Como alterar o nome de um grupo de executores da organização\n\n1. Acesse a página principal da organização em que os grupos de executores estão localizados.\n2. Clique em ** Settings**.\n3. Na barra lateral esquerda, clique em ** Actions** e escolha **Runner groups**.\n4. Na lista de grupos, clique no grupo de executores que deseja configurar.\n5. Insira o novo nome do grupo de executores no campo de texto em \"Nome do grupo\".\n6. Clique em **Save** (Salvar).\n\n### Alterar o nome de um grupo de executores corporativos\n\n1. Navegue até sua empresa. Por exemplo, na página [Enterprises](https://github.com/settings/enterprises?ref_product=ghec\\&ref_type=engagement\\&ref_style=text) em GitHub.com.\n2. Na parte superior da página, clique ** em Políticas**.\n3. Em \" Policies\", clique em **Actions**.\n4. Clique na guia **Grupos de executores**.\n5. Na lista de grupos, clique no grupo de executores que deseja configurar.\n6. Insira o novo nome do grupo de executores no campo de texto em \"Nome do grupo\".\n7. Clique em **Save** (Salvar).\n\n## Como mover um executor para um grupo\n\nSe você não especificar o grupo de um executor durante o processo de registro, seus novos executores são automaticamente atribuídos ao grupo padrão e poderão ser transferidos para outro grupo.\n\n* [Como mover um executor da organização para um grupo](#moving-an-organization-runner-to-a-group)\n* [Como mover um executor corporativo para um grupo](#moving-an-enterprise-runner-to-a-group)\n\n### Como mover um executor da organização para um grupo\n\n1. Em GitHub, acesse a página principal da organização.\n2. No nome da organização, clique em ** Settings**. Caso não consiga ver a guia \"Configurações\", selecione o menu suspenso **** , clique em **Configurações**.\n\n \n3. Na barra lateral esquerda, clique em ** Actions** e clique em **Runners**.\n4. Na lista de \"Executores\", clique no executor que você deseja configurar.\n5. Selecione o menu suspenso **Grupo de executores**.\n6. Em \"Transferir executor para o grupo\", escolha um grupo de destino para o executor.\n\n### Como mover um executor corporativo para um grupo\n\n1. Navegue até sua empresa. Por exemplo, na página [Enterprises](https://github.com/settings/enterprises?ref_product=ghec\\&ref_type=engagement\\&ref_style=text) em GitHub.com.\n2. Na parte superior da página, clique ** em Políticas**.\n3. Em \" Policies\", clique em **Actions**.\n4. Clique na guia **Executores**.\n5. Na lista de \"Executores\", clique no executor que você deseja configurar.\n6. Selecione o menu suspenso **Grupo de executores**.\n7. Em \"Transferir executor para o grupo\", escolha um grupo de destino para o executor.\n\n## Como remover um grupo de executores\n\nPara remover um grupo de executores, primeiro você deve mover ou remover todos os executores do grupo.\n\n* [Como remover um grupo de executores de uma organização](#removing-a-runner-group-from-an-organization)\n* [Como remover um grupo de executores de uma empresa](#removing-a-runner-group-from-an-enterprise)\n\n### Como remover um grupo de executores de uma organização\n\n1. Acesse a página principal da organização em que os grupos de executores estão localizados.\n2. Clique em ** Settings**.\n3. Na barra lateral esquerda, clique em ** Actions** e escolha **Runner groups**.\n4. Na lista de grupos, à direita do grupo que você deseja excluir, clique em .\n5. Para remover o grupo, clique em **Remover grupo**.\n6. Revise as solicitações de confirmação e clique em **Remover este grupo de executores**.\n\n### Como remover um grupo de executores de uma empresa\n\n1. Navegue até sua empresa. Por exemplo, na página [Enterprises](https://github.com/settings/enterprises?ref_product=ghec\\&ref_type=engagement\\&ref_style=text) em GitHub.com.\n2. Na parte superior da página, clique ** em Políticas**.\n3. Em \" Policies\", clique em **Actions**.\n4. Clique na guia **Grupos de executores**.\n5. Na lista de grupos, à direita do grupo que você deseja excluir, clique em .\n6. Para remover o grupo, clique em **Remover grupo**.\n7. Revise as solicitações de confirmação e clique em **Remover este grupo de executores**."}