Usar o app GitHub no Google Chat

Use o app GitHub no Chat para receber notificações sobre eventos do GitHub, como problemas, solicitações de envio e comentários.

Antes de começar

Para usar o app GitHub para Chat:

• Você precisa da permissão do administrador do Google Workspace para instalar apps.
• Adicione o app ao Chat. Saiba como encontrar e adicionar apps ao Chat.
• Você precisa de uma conta do GitHub.
• Instale o app Google Chat para seu repositório do GitHub.

Entender os mecanismos de autenticação de apps do GitHub e OAuth

Isso descreve as características distintas e os modelos operacionais dos apps do GitHub e do OAuth, que servem como mecanismos principais para que serviços de terceiros se integrem e acessem recursos do GitHub. É fundamental entender essas diferenças para manter uma postura de segurança ideal em uma organização.

1. Análise comparativa: principais distinções

As diferenças fundamentais entre os dois modelos estão na identidade usada para acesso (o principal) e no mecanismo que rege a autorização de recursos.

Atributo	App GitHub (login recomendado)	App OAuth (login legado)
Identidade do principal	Atua como uma identidade de aplicativo independente, separada de qualquer usuário ou em nome do usuário autorizador, dependendo do caso de uso.	Atua em nome do usuário autorizador, herdando os privilégios dele.
Modelo de autorização	Permissões refinadas (recomendado): usam o princípio de privilégio mínimo, permitindo o acesso a repositórios e tipos de recursos específicos. Por exemplo: acesso de leitura somente para metadados.	Escopos amplos: o acesso é definido por escopos amplos, como a concessão de acesso a todos os recursos visíveis para o usuário autorizador.
Longevidade da credencial	Tokens de curta duração: os tokens de acesso têm uma vida útil limitada (normalmente 1 hora) e exigem renovação frequente, o que reduz significativamente o risco em caso de comprometimento.	Tokens de longa duração: os tokens de acesso persistem até serem revogados manualmente pelo usuário, representando um risco de exposição prolongada.
Requisito de instalação	Precisa ser instalado por um administrador ou proprietário da organização, estabelecendo um link formal com a conta ou organização e autorizado pelo usuário para casos de uso em que o app está agindo em nome dele.	Precisa ser autorizado por um usuário individual, vinculando o acesso diretamente à identidade dele.

Para uma documentação mais abrangente, consulte Diferenças entre apps do GitHub e apps OAuth.

2. Recomendação

Com base nas práticas recomendadas de segurança, o mecanismo de autenticação do app GitHub é recomendado para todas as integrações organizacionais e de terceiros. Esse modelo aplica o princípio do privilégio mínimo e usa credenciais robustas e com limite de tempo, mantendo um padrão mais alto de segurança e estabilidade operacional em comparação com o modelo de autoridade delegada dos apps OAuth.

Instale o app Google Chat para repositórios do GitHub.

Configurar o app GitHub no Chat

1. Abra o Chat.
2. Abra uma mensagem direta ou acesse um espaço com o app.
3. Para abrir a janela de configuração, clique em Fazer login.
4. Clique em Configurar acesso Fazer login no GitHub.
5. Conclua o processo de login e feche o pop-up.
6. Para atualizar a caixa de diálogo do Chat, clique em Atualizar.
7. Em Adicionar repositórios, digite o repositório do GitHub para o qual você quer receber notificações.
8. Marque as caixas dos eventos para os quais você quer receber notificações.
9. Clique em Salvar.

Dica: você precisa configurar as notificações em cada espaço ao adicionar o app. O app envia notificações em todos os espaços nos quais está incluído.

Migrar de um app OAuth (legado) para um app do GitHub (recomendado)

Para migrar sua conexão atual do método de autenticação do app OAuth mais antigo para o método de app GitHub recomendado:

1. Abra o Chat.
2. Abra uma mensagem direta ou um espaço com o app GitHub.
3. No campo de mensagem, clique em Ferramentas do Google Workspace .
4. Na lista de comandos, selecione GitHub Reauthorize.
5. Para concluir o processo de migração e nova autorização, siga as instruções na tela na caixa de diálogo do chat.

Usar o app GitHub nos espaços

Para usar o app em espaços, você precisa fazer uma @menção ou /mencionar o app em cada mensagem e nas respostas a ele.

A @menção ou o /mencionar confirma que você enviou a mensagem para o app, e não para outras pessoas no espaço.

1. Abra o app Chat .
2. Em um espaço, digite @github ou /github seguido pelo comando.
   • Quando você menciona @github ou /github, a mensagem é enviada para o app, e não para outras pessoas no espaço.

Alterar configurações do app

Nos espaços, só a pessoa que adicionou o app pode alterar as configurações.

1. Abra o Chat.
2. Abra uma mensagem direta ou acesse um espaço com o app.
3. Para abrir as configurações atuais do app, digite: /github_settings.
4. Mude as configurações que quiser.
5. Clique em Salvar.

Quando você remove o app de um espaço, as configurações dele são excluídas.

Saiba mais sobre os comandos do app GitHub no Chat

No campo de mensagem de uma mensagem direta ou espaço com o app GitHub no Chat, você pode usar:

• Comandos de barra:
  • /github_settings: abre a caixa de diálogo de configurações.
  • /github_reminders: para solicitações de envio abertas pessoais ou em equipe, configure e edite lembretes programados.
  • /github_subscribe: assina um <repoURL> ou <owner/repo> do GitHub.
  • /github_openIssue: abre um novo problema no GitHub.
  • /github_logout: faz logout da sua conta do GitHub.
  • /github_help: mostra a mensagem de ajuda.
  • /github_feedback: envie feedback sobre o app GitHub.
• Comandos rápidos: para acessar os comandos rápidos, clique em Ferramentas do Google Workspace .
  • GitHub Connect: mostra uma mensagem com as opções "Fazer login" e "Fazer login legado".
  • GitHub Reauthorize: permite migrar para um novo método de conexão.

Para conferir uma lista completa de comandos compatíveis:

1. No computador, abra o Chat.
2. Abra uma mensagem direta ou acesse um espaço em que o app GitHub esteja instalado.
3. Insira: /github_help.

Resolver problemas com o app GitHub no Chat

Se você receber um erro ao se inscrever para receber notificações em tempo real

App do GitHub

Para configurar notificações em tempo real nos espaços:

1. No navegador, acesse as Configurações do perfil do GitHub.
2. Em "Integrações", clique em Aplicativos Apps GitHub autorizados.
   • Depois de conectar o app GitHub no Google Chat, a lista de apps autorizados vai mostrar "Google Chat".
3. Instale o app Google Chat para o repositório do GitHub.
   • Ou você pode pedir a instalação ao proprietário da organização/repositório.
4. Aguarde a conclusão da instalação.
5. No Google Chat, abra uma mensagem direta ou um espaço com o app GitHub.
6. No campo de mensagem, para criar uma assinatura, digite: /github_subscribe [organisation/repo] ou /github_settings.

App OAuth

Para configurar notificações em tempo real nos espaços, você precisa:

• Ser proprietário da organização do repositório proposto.
• Autorizar o app na organização do GitHub.
  1. No navegador, acesse as Configurações do perfil do GitHub.
  2. Em "Integrações", clique em Aplicativos Apps OAuth autorizados.
     • Depois de conectar o app GitHub no Google Chat, a lista de apps autorizados vai mostrar "Google Chat".
  3. Conceda ao app acesso à organização que você quer acessar.

Se você receber muitas notificações do app GitHub

1. No campo de mensagem, digite: /github_settings.
2. Para editar as configurações de notificação do repositório, clique em Configurações de notificação.
3. Para filtrar as notificações, ao lado de cada tipo, clique na seta para baixo .
   • Ele mostra mais opções para filtrar notificações.
4. Marque as caixas das notificações que você quer.
5. Clique em Salvar.

Se você não receber @menções em lembretes programados

Para receber menções em lembretes programados, você precisa ter conectado sua conta do Google Chat à conta do GitHub.

1. No campo de mensagem, digite: /github_settings.
2. Para conectar sua conta:
   1. No pop-up, clique em Configurar acesso Fazer login no GitHub.
   2. Faça login na sua conta do GitHub.
   3. Autorize o app.
3. Na mensagem que você receber do app GitHub, selecione Programar lembretes para sua equipe.
4. No pop-up:
   1. Clique em Criar novo lembrete.
   2. Defina as configurações de lembrete.
   3. Clique em Salvar.

Se você não receber lembretes com o app GitHub

No repositório em que você quer receber lembretes, verifique a instalação do app Google Chat para GitHub.

_{Google, Google Workspace e marcas e logotipos relacionados são marcas registradas da Google LLC. Todos os outros nomes de empresas e produtos são marcas registradas das empresas às quais eles estão associados.}