Gerenciar o acesso a outros repositórios em seu codespace

Visão geral

Por padrão, o codespace recebe um token com escopo com a permissão ou e a permissão para o repositório do qual foi criado. O escopo desse token é alterado automaticamente nas circunstâncias a seguir.

• Se você criar um codespace para um repositório no qual só tem acesso de leitura e fizer um commit no codespace ou efetuar push de um novo branch, o GitHub Codespaces vinculará automaticamente seu codespace a um fork novo ou existente do repositório e atualizará o token para ter as permissões e para o fork. Para saber mais, confira AUTOTITLE.
• Se você criar um codespace a partir de um modelo e publicar o codespace em um novo repositório, GitHub Codespaces atualizará o token para conceder as permissões necessárias ao novo repositório. Para saber mais, confira AUTOTITLE.

Para saber mais, confira AUTOTITLE.

Se o projeto precisar de permissões adicionais para outros repositórios, você poderá configurá-lo no arquivo , conforme descrito em Configurar permissões de repositório adicionais posteriormente neste artigo. Quando as permissões forem listadas no arquivo , você será solicitado a examinar e autorizar as permissões adicionais como parte da criação do codespace para esse repositório. Depois de autorizar as permissões listadas, GitHub Codespaces lembrarão de sua escolha e não solicitarão autorização, a menos que as permissões no arquivo sejam alteradas.

Criar codespaces com permissões personalizadas

Para criar um codespace com permissões personalizadas, é necessário usar um dos seguintes:

• A interface do usuário da Web GitHub
• CLI na versão 2.5.2 ou posterior do GitHub

•         [GitHub Codespaces Visual Studio Code extension](https://marketplace.visualstudio.com/items?itemName=GitHub.codespaces) 1.5.3 ou posterior
  

Configurar permissões de repositório adicionais

Você configura permissões de repositório para GitHub Codespaces em um arquivo . Quaisquer permissões personalizadas que você adicionar ou alterar só serão aplicadas a novos codespaces criados depois que suas alterações forem confirmadas no repositório. Se você adicionar ou alterar permissões de dentro de um codespace, essas permissões não se aplicarão ao codespace atual, mesmo se você recriá-lo.

1. Se o repositório ainda não contiver um arquivo , adicione-o agora. Para saber mais, confira AUTOTITLE.

2. Edite o arquivo , adicionando o nome do repositório e as permissões necessárias ao objeto :

   JSON

   {
     "customizations": {
       "codespaces": {
         "repositories": {
           "my_org/my_repo": {
             "permissions": {
               "issues": "write"
             }
           }
         }
       }
     }
   }
   

   Observação

   • Você só pode referenciar repositórios que pertencem à mesma conta pessoal ou organização que o repositório em que você está trabalhando no momento.
   • Você pode usar o caractere curinga para conceder permissões a vários repositórios em uma organização. Por exemplo, para conceder permissões a todos os repositórios na organização , use . Essa sintaxe apenas é válida para codespaces. Em todos os arquivos usados para pré-compilações, você deve definir permissões para cada repositório separadamente. Para saber mais, confira AUTOTITLE.

   Você pode conceder quantas quiser das seguintes permissões para cada repositório listado:

   • – leitura/gravação
   • – leitura/gravação
   • – leitura/gravação
   • – leitura/gravação
   • – leitura/gravação
   • – leitura/gravação
   • – leitura
   • – leitura/gravação
   • – leitura/gravação
   • – leitura/gravação
   • – leitura/gravação
   • – escrever

   Para definir uma permissão para um repositório em uma organização, você deverá adicionar explicitamente esse nome de repositório no objeto .

   {
     "customizations": {
       "codespaces": {
         "repositories": {
           "my_org/my_repo": {
             "permissions": {
               "issues": "write"
             }
           }
         }
       }
     }
   }
   

   Para definir todas as permissões para um determinado repositório, use ou no objeto de repositório.

   {
     "customizations": {
       "codespaces": {
         "repositories": {
           "my_org/my_repo": {
             "permissions": "write-all"
           }
         }
       }
     }
   }
   

Autorizar permissões solicitadas

Se permissões de repositório adicionais forem definidas no arquivo , você será solicitado a revisar e, opcionalmente, autorizar as permissões ao criar um codespace ou uma configuração de prebuild para esse repositório. Quando você autoriza permissões para um repositório, GitHub Codespaces não irá solicitar novamente, a menos que tenha mudado o conjunto de permissões solicitadas para o repositório.

Você só deve autorizar permissões para repositórios que você conhece e confia. Se você não confiar no conjunto de permissões solicitadas, clique em Continuar sem autorizar para criar o codespace com o conjunto de permissões base. Rejeitar permissões adicionais pode afetar a funcionalidade do seu projeto dentro do codespace, pois o codespace só terá acesso ao repositório do qual ele foi criado.

Você só pode autorizar permissões que sua conta pessoal já possui. Se um codespace solicitar permissões para repositórios aos quais você não tem acesso no momento, entre em contato com um proprietário ou administrador do repositório para obter acesso suficiente e tente criar um codespace novamente.

Leitura adicional

• AUTOTITLE
• AUTOTITLE