{"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/actions","title":"GitHub Actions"},{"href":"/pt/actions/how-tos","title":"Instruções"},{"href":"/pt/actions/how-tos/manage-runners","title":"Gerenciar corredores"},{"href":"/pt/actions/how-tos/manage-runners/larger-runners","title":"Executores avançados"},{"href":"/pt/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 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 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 \"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/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 que usam o plano GitHub Team podem criar grupos de executores adicionais no nível da organização.\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/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. Clique em **Criar grupo** para criar o grupo e aplicar a política.\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## 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 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/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\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## 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\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 remover um grupo de executores\n\nPara remover um grupo de executores, primeiro você deve mover ou remover todos os executores do grupo.\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**."}