Gerenciamento de endereços IP permitidos para um aplicativo GitHub

Você pode adicionar uma lista de permissões de IP ao seu cadastro GitHub App para evitar que seu aplicativo seja bloqueado pela lista de permissões própria de uma empresa ou organização.

Neste artigo

Sobre listas de permissões de endereço IP para GitHub Apps

Os proprietários da empresa e da organização podem restringir o acesso aos ativos configurando uma lista de endereços IP permitidos. Esta lista especifica os endereços IP que indivíduos podem usar para acessar seus recursos. Para saber mais, confira Como restringir o tráfego de rede para sua empresa com uma lista de permissões de IP.

Se uma organização ou empresa tiver uma lista de permissões, os aplicativos de terceiros que se conectarem por meio de GitHub App terão o acesso negado, a menos que um dos seguintes conjuntos de condições seja atendido:

  • O criador do GitHub App aplicativo configurou uma lista de permissões para o aplicativo que especifica os endereços IP nos quais o aplicativo é executado. Veja abaixo detalhes de como fazer isso e
  • O proprietário da organização ou da empresa decidiu permitir que os endereços na lista de permissões de GitHub App sejam adicionados à lista de permissões da própria organização ou empresa. Para obter mais informações, consulte Gerenciamento de endereços IP permitidos para sua organização.

ou

  • O proprietário da organização ou empresa adicionou uma entrada de lista de permissões de IP para os endereços IP dos quais o aplicativo é executado. Consulte Como adicionar um endereço IP permitido.

Observação

Os endereços na lista de IPs permitidos de um GitHub App só afetam as solicitações feitas por instalações do GitHub App. A adição automática do endereço IP de um GitHub App à lista de permissão de uma organização não permite acesso a um usuário do GitHub que se conecta a partir desse endereço IP.

Adicionar uma lista de permissões de IP a um registro GitHub App

Observação

A GitHub está distribuindo gradualmente o suporte para IPv6. À medida que os serviços do GitHub continuarem a adicionar suporte a IPv6, começaremos a reconhecer endereços IPv6 de usuários do GitHub. Para evitar possíveis interrupções de acesso, verifique se você adicionou todos os endereços IPv6 necessários à sua lista de permissões de IP.

Observação

Devido ao cache, a inclusão ou a remoção endereços IP pode levar alguns minutos para entrar totalmente em vigor.

  1. No canto superior direito de qualquer página do GitHub, clique na foto do seu perfil.

  2. Acesse as configurações da sua conta.

    • Para um aplicativo de propriedade de uma conta pessoal, clique em Configurações.
    • Para um aplicativo de propriedade de uma organização:
      1. Clique em Suas organizações.
      2. À direita da organização, clique em Configurações.
    • Para um aplicativo de propriedade de uma empresa:
      1. Se você usar Enterprise Managed Users, clique em Sua empresa para ir diretamente para as configurações da conta corporativa.
      2. Se você usar contas pessoais, clique em Suas empresas e, à direita da empresa, clique em Configurações.

  3. Navegue até as configurações GitHub App.

    • Para um aplicativo pertencente a uma conta pessoal ou a uma organização:
      1. Na barra lateral esquerda, clique em Developer settings e clique em GitHub Apps.
    • Para um aplicativo de propriedade de uma empresa:
      1. Na barra lateral esquerda, em "Configurações", clique em GitHub Apps.

  4. À direita do GitHub App que você deseja modificar, clique em Editar.

  5. Na parte inferior da seção "Lista de permissões de IP", no campo "Endereço IP ou intervalo na notação CIDR", digite um endereço IP ou um intervalo de endereços na notação CIDR.

    Captura de tela das configurações da lista de permissões de IP. Um campo de texto, rotulado como "Endereço IP ou intervalo na notação CIDR", é realçado com um contorno laranja.

  6. Opcionalmente, no campo "Breve descrição do endereço IP ou intervalo", insira uma descrição do endereço IP ou intervalo permitido. A descrição serve apenas como referência e não é usada na lista de permissões de organizações em que o GitHub App está instalado. Em vez disso, as listas de permissões da organização incluirão "Gerenciado pelo NOME GitHub App" como a descrição.

  7. Clique em Add.