Skip to main content

Tornando um aplicativo GitHub público ou privado

Ao registrar um GitHub App, você pode torná-los públicos para que outras contas GitHub possam instalar o aplicativo ou privadas para que você só possa instalá-lo na conta que possui o aplicativo.

Sobre a visibilidade para GitHub Apps

Um GitHub App pode ser público, privado ou interno. Se você definir o registro do GitHub App como público, qualquer usuário no GitHub poderá instalá-lo e autorizá-lo. Se você definir o registro do GitHub App como privado, ele só poderá ser instalado na conta que possui o aplicativo. Somente os membros da organização que é a proprietária podem autorizá-la.

GitHub Apps pertencentes a uma conta corporativaou por um conta de usuário gerenciada em uma empresa, têm visibilidade "interna". Aplicativos internos só podem ser instalados por essa empresa e organizações da empresa e só podem ser autorizados por usuários da empresa. Membros da empresa e usuários não afiliados podem autorizar esses aplicativos, mas colaboradores externos, não.

Se você quiser que o aplicativo de propriedade da organização seja instalado em sua empresa, transfira-o para a empresa ou torne-o public ou internal. Se for private, só poderá ser instalado na organização.

Se você quiser que o GitHub App esteja disponível para organizações em uma instância do GitHub Enterprise Server da qual você não faz parte, será necessário seguir outras etapas. Para saber mais, confira Disponibilizando seu aplicativo GitHub para GitHub Enterprise Server.

Se for importante que GitHub Enterprise Server possam usar sua ferramenta, use GitHub Actions em vez de um GitHub App. As ações públicas estão disponíveis em instâncias GitHub Enterprise Server com GitHub Connect. Para saber mais, confira Habilitar o acesso automático a ações de GitHub.com usando GitHub Connect e Sobre GitHub Actions para empresas na documentação do GitHub Enterprise Server.

Para obter informações sobre como alterar a visibilidade do registro do GitHub App, confira Modificando um registro de aplicativo GitHub.

Fluxo de instalação para uso público

Os GitHub Apps públicos têm uma página de destino com um botão Instalar para que outras pessoas possam instalar o aplicativo em suas contas. Se o GitHub App for público para todos os usuários no GitHub, você também poderá publicá-los no GitHub Marketplace. Para saber mais, confira Sobre GitHub Marketplace para aplicativos.

Fluxo privado de instalação

GitHub Apps particulares só podem ser instalados na conta do usuário ou da organização do proprietário do aplicativo. Haverá informações limitadas sobre o aplicativo em uma página de destino, e o botão Instalar só estará disponível para os proprietários e administradores de aplicativos da organização proprietária do aplicativo, ou para a conta pessoal se o GitHub App pertencer a uma conta individual.

Fluxo de instalação "interno"

GitHub Apps de propriedade de organizações e aplicativos de contas de usuário gerenciadas só podem ser instalados nas empresas desse e organizações da empresa usando a URL de instalação. O aplicativo não pode ser instalado em contas de usuário.