Sobre o GitHub Marketplace
Este artigo se aplica à instalação e compra de GitHub Apps de GitHub Marketplace. Para obter mais informações sobre como instalar GitHub Apps de uma fonte diferente do GitHub Marketplace, confira Instalando um Aplicativo GitHub de terceiros.
Observação
Atualmente, os aplicativos do GitHub Marketplace não estão disponíveis no GHE.com.
Se você instalar um GitHub App na sua conta da organização e escolher um plano pago, pagará pela assinatura do aplicativo na data de cobrança atual da sua organização usando a forma de pagamento existente da sua organização.
Se você escolher um plano pago com um teste gratuito, você pode cancelar a qualquer momento durante o seu período de teste sem ser cobrado, mas você perderá o acesso automaticamente ao aplicativo. A assinatura paga começará a ser contada no fim da versão de avaliação de 14 dias. Para saber mais, confira assinaturas de aplicativo do GitHub Marketplace.
Para mais informações sobre como instalar um OAuth app em vez de um GitHub App do GitHub Marketplace, confira Instalar um aplicativo OAuth na organização.
Sobre a instalação de GitHub Apps
Para usar um GitHub App em seus recursos, você deve instalar o aplicativo em sua conta corporativa, organizacional ou pessoal. Você pode instalar o mesmo GitHub App em várias contas. Por exemplo, se você instalar o aplicativo em sua conta pessoa ou em algumas organizações que possui, poderá usar o aplicativo nos repositórios pessoais, nas organizações em que instalou o aplicativo e em repositórios que são propriedade dessas organizações.
Ao instalar um aplicativo, você concede a permissão do aplicativo para acessar os recursos corporativos ou organizacionais e de repositório que ele solicitou. Durante o processo de instalação, GitHub informará quais permissões o GitHub App solicitou. Para obter mais informações sobre as solicitações que a API REST GitHub App pode fazer com essas permissões, consulte Permissões necessárias para aplicativos GitHub.
Ao instalar um aplicativo que solicita permissões de repositório, você também escolherá a quais repositórios conceder o GitHub App acesso.
Antes de instalar um GitHub App, você deve garantir que confie no proprietário do GitHub App. Você também deve examinar as permissões que está GitHub App solicitando e certificar-se de que está confortável concedendo essas permissões. Para obter mais informações sobre as solicitações que a API REST GitHub App pode fazer com essas permissões, consulte Permissões necessárias para aplicativos GitHub.
Não há limite na quantidade de aplicativos que você pode instalar.
Diferença entre instalação e autorização
Depois de instalar um GitHub App, você também poderá ser solicitado a autorizar o aplicativo.
Ao instalar uma GitHub App em sua conta ou organização, você concede a permissão do aplicativo para acessar os recursos da organização e do repositório solicitados. Você também especifica quais repositórios o aplicativo pode acessar. Durante o processo de instalação, o GitHub App indicará quais permissões de repositório e organização você está concedendo. Para obter mais informações sobre quais permissões diferentes permitem GitHub App fazer, consulte Escolhendo permissões para um aplicativo GitHub.
Por exemplo, você pode conceder a GitHub App permissão para ler metadados do repositório e problemas de gravação e conceder o GitHub App acesso a todos os seus repositórios.
Ao autorizar um GitHub App, você concede ao aplicativo acesso à sua GitHub conta, com base nas permissões de conta solicitadas pelo aplicativo. Durante o processo de autorização, o aplicativo indicará quais recursos o aplicativo pode acessar em sua conta. Ao autorizar um GitHub App, você também concede a permissão do aplicativo para agir em seu nome.
Por exemplo, você pode conceder à GitHub App permissão para ler seus endereços de e-mail e criar gists.
Você pode instalar um GitHub App sem autorizar o aplicativo. Da mesma forma, é possível autorizar o aplicativo sem instalá-lo.
Para obter mais informações sobre como autorizar GitHub Apps, confira Autorizando aplicativos GitHub.
Requisitos para instalar um GitHub App em uma organização
Os proprietários da organização podem instalar GitHub Apps em sua organização.
Para empresas que pagam por cartão de crédito, os proprietários da empresa que também são proprietários da organização podem instalar GitHub Apps em organizações dentro da empresa.
Os administradores do repositório poderão instalar GitHub Apps na organização que possui o repositório se o aplicativo não solicitar permissões de organização nem a permissão de "administração do repositório". Ao fazer isso, eles só podem instalar o aplicativo com acesso aos repositórios que eles administram. Os proprietários da organização podem restringir GitHub App a instalação por administradores de repositório. Quando essa restrição está habilitada, os administradores do repositório não podem instalar GitHub Apps e, em vez disso, devem solicitar que os proprietários da organização instalem o aplicativo desejado. Para obter mais informações, consulte Limitando as solicitações de acesso e instalações de aplicativos OAuth e GitHub App.
A função "gerente de aplicativos" não dá a uma pessoa a capacidade de instalar um GitHub App na organização ou empresa. Para saber mais, confira Sobre Gerenciadores de Aplicativos do GitHub.
Para contas de usuário gerenciadas pela empresa, somente os proprietários da empresa podem comprar e instalar um GitHub App pago para uma organização na empresa. Os membros da empresa não podem comprar um GitHub App pago. Os proprietários da organização com uma conta de usuário gerenciada pela empresa ainda podem instalar um GitHub App gratuito.
Instalar um GitHub App em sua organização
-
Para abrir GitHub Marketplace, no canto superior esquerdo do GitHub, selecione e clique em Marketplace.
-
. Navegue até o app que gostaria de instalar e clique no nome do app.
-
Na página do aplicativo, em "Preços e configuração", clique no plano de preços que você gostaria de usar.
-
Clique em Instalá-lo gratuitamente, Comprar com o GitHub ou Experimentar gratuitamente por 14 dias.
-
Escolha uma organização de instalação para o aplicativo. Dependendo dos termos de serviço da organização, esse processo será um pouco diferente.
- Se você deu permissão a GitHub para coletar informações de nome e endereço para sua organização, na seção "Informações de cobrança", selecione o menu suspenso Alternar conta de cobrança e clique na organização na qual deseja instalar o aplicativo.
- Caso contrário, em "Examinar seu pedido", selecione o menu suspenso Conta e clique na organização na qual você deseja instalar o aplicativo.
Observação
Se a organização usa o SSO do SAML, mas não aparece listada, pode ser necessário iniciar uma sessão SAML ativa para ela. Para saber mais, confira Aplicativos SAML e GitHub.
-
Se você escolheu um plano pago, revise o seu método de pagamento.
- Para alterar a forma de pagamento existente registrada para a organização, clique em Editar e preencha o formulário para adicionar uma nova forma de pagamento.
- Se não houver uma forma de pagamento registrada para a organização, clique em Adicionar uma Forma de Pagamento e preencha o formulário para adicionar um cartão de crédito ou uma conta do PayPal.
-
Selecione Concluir pedido e iniciar instalação.
-
Caso o aplicativo exija o acesso aos repositórios, selecione Todos os repositórios ou Selecionar apenas repositórios.
Se o aplicativo cria algum repositório, ele também terá acesso a esses repositórios automaticamente.
-
Se você escolheu dar acesso ao aplicativo para repositórios limitados em vez de todos os seus repositórios, digite o nome de cada repositório que você deseja dar acesso ao aplicativo e, em seguida, clique no nome do repositório para selecioná-lo.
-
Revise as permissões de acesso do aplicativo e clique em Instalar.
