1
0
mirror of synced 2026-01-06 06:02:35 -05:00
Files
docs/translations/pt-BR/content/developers/apps/building-github-apps/creating-a-github-app.md
docubot a5dc6bdcc0 New translation batch for pt (#26297)
* Add crowdin translations

* Run script/i18n/homogenize-frontmatter.js

* Run script/i18n/fix-translation-errors.js

* Run script/i18n/lint-translation-files.js --check parsing

* Run script/i18n/lint-translation-files.js --check rendering

* run script/i18n/reset-files-with-broken-liquid-tags.js --language=pt

* run script/i18n/reset-known-broken-translation-files.js

Co-authored-by: Robert Sese <rsese@github.com>
2022-03-17 21:03:06 +00:00

7.2 KiB

title, intro, redirect_from, versions, topics
title intro redirect_from versions topics
Criar um aplicativo GitHub {% data reusables.shortdesc.creating_github_apps %}
/early-access/integrations/creating-an-integration
/apps/building-integrations/setting-up-and-registering-github-apps/registering-github-apps
/apps/building-github-apps/creating-a-github-app
/developers/apps/creating-a-github-app
fpt ghes ghae ghec
* * * *
GitHub Apps

{% ifversion fpt or ghec %}Para aprender como usar manifestos do aplicativo GitHub que permitem que pessoas criem aplicativos GitHub pré-configurados, consulte "Criando aplicativos GitHub a partir de um manifesto.{% endif %}

{% ifversion fpt or ghec %} {% note %}

Observação: {% data reusables.apps.maximum-github-apps-allowed %}

{% endnote %} {% endif %}

{% data reusables.apps.settings-step %} {% data reusables.user-settings.developer_settings %} {% data reusables.user-settings.github_apps %}

  1. Clique em Novo aplicativo GitHub. Botão para criar um novo aplicativo GitHub
  2. Em "Nome do aplicativo GitHub App", digite o nome do seu aplicativo. Campo para o nome do seu aplicativo GitHub

Dê um nome claro e sucinto ao seu aplicativo. Seu aplicativo não pode ter o mesmo nome de uma conta existente no GitHub, a menos que seja o seu próprio nome de usuário ou da sua organização. Uma versão movida do nome do seu aplicativo será exibida na interface do usuário quando sua integração realizar uma ação.

  1. Opcionalmente, em "Descrição", digite uma descrição do aplicativo que os usuários irão ver. Campo para uma descrição do seu aplicativo GitHub
  2. Em "URL da página inicial", digite a URL completa do site do seu aplicativo. Campo para a URL da página inicial do seu aplicativo GitHub {% ifversion fpt or ghes or ghec %}
  3. Em "URL de retorno de chamada", digite a URL completa para redirecionar após um usuário autorizar a instalação. Esta URL é usada se o aplicativo precisar identificar e autorizar solicitações de usuário para servidor.

Você pode usar Adicionar URL de retorno de chamada para fornecer URLs de retorno de chamadas adicionais até o limite máximo de 10.

Botão para 'Adicionar URL de retorno de chamada' e campo para URL de retorno de chamada {% else %}

  1. Em "URL de chamada de retorno de autorização do usuário", digite a URL completa para redirecionamento após um usuário autorizar uma instalação. Esta URL é usada se o aplicativo precisar identificar e autorizar solicitações de usuário para servidor. Campo para a URL de chamada de retorno de autorização do usuário do seu aplicativo GitHub

{% endif %}

  1. Por padrão, para melhorar a segurança de seus aplicativos, seus aplicativos usarão os tokens de autorização do usuário. Para optar por não usar tokens do usuário expirados, você deverá desmarcar "Expirar tokens de autorização do usuário". Para saber mais sobre como configurar o fluxo de atualização do token e os benefícios de expirar os tokens do usuário, consulte "Atualizando tokens de acesso do usuário para o servidor." Opção para expirar os tokens dos usuários durante a configuração dos aplicativos GitHub
  2. Se seu aplicativo autoriza usuários a usar o fluxo OAuth, você pode selecionar Solicitar autorização de usuário (OAuth) durante a instalação para permitir que pessoas autorizem o aplicativo ao instalá-lo, economizando uma etapa. Se você selecionar esta opção, a "URL de configuração" irá tornar-se indisponível e os usuários serão redirecionados para a "URL de retorno de chamada de autorização do usuário" após a instalação do aplicativo. Consulte "Autorizando usuários durante a instalação" para obter mais informações. Request user authorization during installation{% if device-flow-is-opt-in %}
  3. If your GitHub App will use the device flow to identify and authorize users, click Enable Device Flow. For more information about the device flow, see "Authorizing OAuth Apps." Screenshot showing field for enabling device flow{% endif %}
  4. Se for necessária uma configuração adicional após a instalação, adicione um "Configurar URL" para redirecionar os usuários após a instalação do seu aplicativo. Campo para a URL de configuração do seu aplicativo GitHub

{% note %}

Observação: Ao selecionar Solicitar autorização do usuário (OAuth) durante a instalação na etapa anterior, este campo irá tornar-se indisponível e as pessoas serão redirecionadas para a "URL de chamada de retorno de autorização do usuário" após a instalação do aplicativo.

{% endnote %}

  1. Na "URL Webhook", digite a URL para a qual os eventos serão POST. Cada aplicativo recebe o seu próprio webhook, que irá notificá-lo sempre que o aplicativo for instalado ou modificado, bem como quaisquer outros eventos que o aplicativo assinar. Campo para a URL do webhook do seu aplicativo GitHub

  2. Opcionalmente, no "Segredo do webhook", digite um token secreto opcional usado para proteger seus webhooks. Campo para adicionar um token secreto para seu webhook

{% note %}

Observação: É altamente recomendável que você defina um token secreto. Para obter mais informações, consulte "Protegendo seus webhooks".

{% endnote %}

  1. Em "Permissões", escolha as permissões que o seu aplicativo irá solicitar. Para cada tipo de permissão, use o menu suspenso e clique em somente leitura, leitura & gravação ou Sem acesso. Várias permissões para o seu aplicativo GitHub
  2. Em "Assinar eventos", escolha os eventos que você deseja que seu aplicativo receba.
  3. Para escolher o local onde o aplicativo pode ser instalado, selecione somente nesta conta ou qualquer conta. Para obter mais informações sobre as opções de instalação, consulte "Tornando um aplicativo GitHub público ou privado". Opções de instalação para o seu aplicativo GitHub
  4. Click Criar aplicativo GitHub. Botão para criar o seu aplicativo GitHub