Use a app GitHub no Google Chat

Utilize a app GitHub no Chat para receber notificações sobre eventos do GitHub, como problemas, pedidos de envio e comentários.

Antes de começar

Para usar a app GitHub para o Chat:

• Precisa de autorização do administrador do Google Workspace para instalar apps.
• Adicione a app ao Chat. Saiba como encontrar apps e adicioná-las ao Chat.
• Precisa de uma conta do GitHub.
• Tem de instalar a app Google Chat para o seu repositório do GitHub.

Compreenda os mecanismos de autenticação da app GitHub e da app OAuth

Este artigo descreve as características distintas e os modelos operacionais das apps GitHub e das apps OAuth, que servem como mecanismos principais para os serviços de terceiros se integrarem e acederem aos recursos do GitHub. Uma compreensão abrangente destas diferenças é fundamental para manter uma postura de segurança ideal numa organização.

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

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

Atributo	App GitHub (início de sessão recomendado)	App OAuth (início de sessão antigo)
Identidade principal	Atua como uma identidade da aplicação independente, separada de qualquer utilizador ou em nome do utilizador que autoriza, consoante o exemplo de utilização.	Atua em nome do utilizador que autoriza, herdando os respetivos privilégios.
Modelo de autorização	Autorizações detalhadas (recomendado): usa o princípio do menor privilégio, permitindo o acesso a repositórios e tipos de recursos específicos. Por exemplo: acesso de leitura apenas para metadados.	Âmbitos amplos: o acesso é definido por âmbitos amplos, como a concessão de acesso a todos os recursos visíveis para o utilizador que autoriza.
Longevidade das credenciais	Tokens de curta duração: os tokens de acesso têm um tempo de vida limitado (normalmente, 1 hora) e requerem uma renovação frequente, o que mitiga significativamente o risco em caso de comprometimento.	Tokens de longa duração: os tokens de acesso persistem até serem revogados manualmente pelo utilizador, o que representa um risco de exposição prolongado.
Requisito de instalação	Tem de ser instalada por um administrador ou proprietário da organização, estabelecendo uma associação formal à conta ou à organização e autorizada pelo utilizador para exemplos de utilização em que a app está a agir em nome do utilizador.	Tem de ser autorizada por um utilizador individual, associando o acesso diretamente à identidade desse utilizador.

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

2. Recomendação

Com base nas práticas recomendadas de segurança, recomenda-se o mecanismo de autenticação da app GitHub para todas as integrações organizacionais e de terceiros. Este modelo aplica o princípio do menor privilégio e usa credenciais robustas e com limite de tempo, mantendo assim um padrão de segurança e estabilidade operacional mais elevado em comparação com o modelo de autoridade delegada das apps OAuth.

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

Configure a app GitHub no Chat

1. Abra o Chat.
2. Abra uma mensagem direta com a app ou aceda a um espaço com a app.
3. Para abrir a janela de configuração, clique em Iniciar sessão.
4. Clique em Configurar acesso Iniciar sessão no GitHub.
5. Conclua o processo de início de sessão e, em seguida, feche o pop-up.
6. Para atualizar a caixa de diálogo do chat, clique em Atualizar.
7. Em Adicionar repositórios, introduza o repositório do GitHub cujas notificações quer receber.
8. Selecione as caixas dos eventos cujas notificações quer receber.
9. Clique em Guardar.

Dica: tem de configurar as notificações em cada espaço ao qual adiciona a app. A app envia notificações para todos os espaços nos quais é membro.

Migre da app OAuth (antiga) para a app GitHub (recomendada)

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

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

Use a app GitHub em espaços

Para usar a app em espaços, tem de @mencionar ou /mencionar a app em cada mensagem e nas respostas às mensagens da app.

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

1. Abra a app Chat .
2. Num espaço, introduza @github ou /github seguido do comando.
   • Quando menciona @github ou /github, a mensagem é enviada para a app e não para outras pessoas no espaço.

Altere as definições da app

Nos espaços, apenas a pessoa que adicionou a app pode alterar as definições.

1. Abra o Chat.
2. Abra uma mensagem direta com a app ou aceda a um espaço com a app.
3. Para abrir as definições atuais da app, introduza: /github_settings.
4. Altere as definições conforme necessário.
5. Clique em Guardar.

Remover a app de um espaço elimina as definições da mesma.

Saiba mais sobre comandos para a app GitHub no Chat

No campo de mensagens de uma mensagem direta ou de um espaço com a app GitHub no Chat, pode usar:

• Comandos com barra:
  • /github_settings: abre a caixa de diálogo de definições.
  • /github_reminders: para pedidos de envio abertos pessoais ou de equipa, configure e edite lembretes agendados.
  • /github_subscribe: subscreve a um <repoURL> ou <owner/repo> do GitHub.
  • /github_openIssue: abre um novo problema do GitHub.
  • /github_logout: termina sessão na sua conta do GitHub.
  • /github_help: apresenta a mensagem de ajuda.
  • /github_feedback: envie feedback sobre a app GitHub.
• Comandos rápidos: para aceder aos comandos rápidos, clique em Ferramentas do Google Workspace .
  • GitHub Connect: apresenta uma mensagem com uma opção "Início de sessão" e "Início de sessão antigo".
  • GitHub Reauthorize: permite-lhe migrar para um novo método de associação.

Para consultar uma lista completa de comandos compatíveis:

1. No computador, abra o Chat.
2. Abra uma mensagem direta ou aceda a um espaço com a app GitHub instalada.
3. Introduza: /github_help.

Resolva problemas com a app GitHub no Chat

Se receber um erro quando subscreve a notificações em tempo real

App GitHub

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

1. No navegador, aceda às definições do perfil do GitHub.
2. Em "Integrações", clique em Aplicações Apps GitHub autorizadas.
   • Depois de associar a app GitHub no Google Chat, a sua lista de apps autorizadas vai apresentar "Google Chat".
3. Instale a app Google Chat para o repositório do GitHub.
   • Em alternativa, pode pedir a instalação ao proprietário da organização/repositório.
4. Aguarde até que a instalação esteja concluída.
5. No Google Chat, abra uma mensagem direta ou um espaço com a app GitHub.
6. No campo de mensagens, para criar uma subscrição, introduza: /github_subscribe [organisation/repo] ou /github_settings.

App OAuth

Para configurar notificações em tempo real em espaços, tem de:

• Ser proprietário da organização do repositório proposto.
• Autorizar a app na organização do GitHub.
  1. No navegador, aceda às definições do perfil do GitHub.
  2. Em "Integrações", clique em Aplicações Apps OAuth autorizadas.
     • Depois de associar a app GitHub no Google Chat, a sua lista de apps autorizadas vai apresentar "Google Chat."
  3. Permita que a app aceda à organização à qual quer aceder.

Se receber demasiadas notificações da app GitHub

1. No campo de mensagens, introduza: /github_settings.
2. Para editar as definições de notificação do repositório, clique em Definições de notificação.
3. Para filtrar as notificações, clique na seta de menu pendente junto a cada tipo de notificação.
   • Esta ação mostra opções adicionais para filtrar as notificações.
4. Selecione as caixas para as notificações que quer.
5. Clique em Guardar.

Se o seu nome não for @mencionado em lembretes agendados

Para que o seu nome seja mencionado em lembretes agendados, tem de ter a sua conta do Google Chat associada à sua conta do GitHub.

1. No campo de mensagens, introduza: /github_settings.
2. Para associar a sua conta:
   1. No pop-up, clique em Configurar acesso Iniciar sessão no GitHub.
   2. Inicie sessão na sua conta do GitHub.
   3. Autorize a app.
3. Na mensagem que receber da app GitHub, selecione Agendar lembretes para a sua equipa.
4. No pop-up:
   1. Clique em Criar novo lembrete.
   2. Configure as definições de lembretes.
   3. Clique em Guardar.

Se não receber lembretes com a app GitHub

No repositório a partir do qual quer receber lembretes, verifique a instalação da app Google Chat para o GitHub.

Google, Google Workspace, and related marks and logos are trademarks of Google LLC. All other company and product names are trademarks of the companies with which they are associated.