Skip to main content

Managing allowed IP addresses for a GitHub App

You can add an IP allow list to your GitHub App to prevent your app from being blocked by an organization's own allow list.

About IP address allow lists for GitHub Apps

Enterprise and organization owners can restrict access to assets by configuring an IP address allow list. This list specifies the IP addresses that are allowed to connect. For more information, see "Enforcing policies for security settings in your enterprise."

When an organization has an allow list, third-party applications that connect via a GitHub App will be denied access unless both of the following are true:

  • The creator of the GitHub App has configured an allow list for the application that specifies the IP addresses at which their application runs. See below for details of how to do this.
  • The organization owner has chosen to permit the addresses in the GitHub App's allow list to be added to their own allow list. For more information, see "Managing allowed IP addresses for your organization."

Observação: os endereços na lista de IP 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 GitHub App à lista de permissão de uma organização não permite acesso a um usuário de GitHub Enterprise Cloud que se conecta a partir desse endereço IP.

Adding an IP address allow list to a GitHub App

Note: GitHub is gradually rolling out support for IPv6. As GitHub services continue to add IPv6 support, we will start recognizing IPv6 addresses of GitHub users. To prevent possible access interruptions, please ensure you have added any necessary IPv6 addresses to your IP allow list.

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

    • Para um GitHub App pertencente a uma conta pessoal, no canto superior direito de qualquer página, clique na foto do seu perfil e clique em Configurações. Ícone Settings (Configurações) na barra de usuário
    • Para um GitHub App pertencente a uma organização, no canto superior direito de qualquer página, clique na foto do seu perfil e clique em Suas organizações. Em seguida, à direita da organização, clique em Configurações. Suas organizações no menu do perfil O botão de configurações
  2. In the left sidebar, click Developer settings.

  3. Na barra lateral esquerda, clique em Aplicativos do GitHub. Seção Aplicativos do GitHub

  4. À direita do GitHub App que você deseja modificar, clique em Editar. Seleção do aplicativo

  5. Scroll down to the "IP allow list" section. Basic information section for your GitHub App

  6. Na parte inferior da seção "Lista de permissão de IP", insira um endereço IP ou uma série de endereços na notação CIDR. Campo de chave usado para adicionar um endereço IP

  7. Opcionalmente, insira uma descrição do intervalo ou endereço IP permitidos. Campo de chave usado para adicionar nome do endereço IP The description is for your reference and is not used in the allow list of organizations where the GitHub App is installed. Instead, organization allow lists will include "Managed by the NAME GitHub App" as the description.

  8. Clique em Adicionar. Botão para adicionar endereço IP permitido