Usar la aplicación GitHub en Google Chat

Con la aplicación GitHub, puedes recibir notificaciones en Chat sobre eventos de GitHub, como incidencias, solicitudes de extracción y comentarios.

Antes de empezar

Para usar la aplicación GitHub en Chat, sigue estos pasos:

• Necesitas permiso de tu administrador de Google Workspace para instalar aplicaciones.
• Añade la aplicación a Chat. Consulta cómo buscar aplicaciones y añadirlas a Chat.
• Necesitas una cuenta de GitHub.
• Debes instalar la aplicación Google Chat en tu repositorio de GitHub.

Información sobre los mecanismos de autenticación de aplicaciones GitHub y OAuth

En este artículo se describen las características y los modelos operativos de las aplicaciones GitHub y OAuth, que son los mecanismos principales para que los servicios de terceros se integren con los recursos de GitHub y accedan a ellos. Es fundamental comprender estas diferencias para mantener una postura de seguridad óptima en una organización.

1. Análisis comparativo: diferencias clave

Las diferencias fundamentales entre los dos modelos residen en la identidad utilizada para el acceso (el principal) y el mecanismo que rige la autorización de recursos.

Atributo	Aplicación GitHub (inicio de sesión recomendado)	Aplicación OAuth (inicio de sesión antiguo)
Identidad de la entidad	Actúa como una identidad de aplicación independiente, separada de cualquier usuario, o en nombre del usuario que autoriza, en función del caso práctico.	Actúa en nombre del usuario que autoriza y hereda sus privilegios.
Modelo de autorización	Permisos detallados (recomendado): utiliza el principio de mínimos accesos, que permite acceder a repositorios y tipos de recursos específicos. Por ejemplo, acceso de lectura solo para metadatos.	Permisos amplios: el acceso se define mediante permisos amplios, como conceder acceso a todos los recursos visibles para el usuario que autoriza.
Tiempo de validez de las credenciales	Tokens de corta duración: los tokens de acceso tienen una duración limitada (normalmente, 1 hora) y requieren una renovación frecuente, lo que reduce considerablemente el riesgo en caso de que se vean comprometidos.	Tokens de larga duración: los tokens de acceso se conservan hasta que el usuario los revoca manualmente, lo que supone un riesgo de exposición prolongado.
Requisito de instalación	Debe instalarla un administrador o el propietario de la organización, lo que establecerá un vínculo formal con la cuenta o la organización. El usuario debe autorizarla para los casos prácticos en los que la aplicación actúe en su nombre.	Debe autorizarla un usuario concreto, vinculando el acceso directamente a la identidad de ese usuario.

Para obtener una documentación más completa, consulta las diferencias entre las aplicaciones de GitHub y las aplicaciones OAuth.

2. Recomendación

Según las prácticas recomendadas de seguridad, se recomienda el mecanismo de autenticación de la aplicación de GitHub para todas las integraciones de terceros y de organizaciones. Este modelo aplica el principio de mínimos accesos y utiliza credenciales sólidas con un tiempo limitado, lo que permite mantener un estándar de seguridad y estabilidad operativa más alto en comparación con el modelo de autoridad delegada de las aplicaciones OAuth.

Instala la aplicación Google Chat para repositorios de GitHub.

Configurar la aplicación GitHub en Chat

1. Abre la aplicación Chat .
2. Abre un mensaje directo con la aplicación o ve a un espacio en el que esté.
3. Para abrir la ventana de configuración, toca Iniciar sesión.
4. Toca Configurar acceso Iniciar sesión en GitHub.
5. Completa el proceso de inicio de sesión y, a continuación, cierra la ventana emergente.
6. Para actualizar el cuadro de diálogo de Chat, toca Actualizar.
7. En Añadir repositorios, escribe el repositorio de GitHub sobre el que quieras recibir notificaciones.
8. Marca las casillas de los eventos sobre los que quieras recibir notificaciones.
9. Toca Guardar.

Nota: Debes configurar las notificaciones en todos los espacios en los que añadas la aplicación. La aplicación envía notificaciones a todos los espacios a los que pertenece.

Migrar de la aplicación OAuth (antigua) a la aplicación GitHub (recomendada)

Para migrar tu conexión actual del método de autenticación de la aplicación OAuth anterior al método de la aplicación GitHub recomendado:

1. Abre la aplicación Chat .
2. Abre un mensaje directo o un espacio con la aplicación GitHub.
3. En el campo del mensaje, toca Herramientas de Google Workspace .
4. En la lista de comandos, selecciona GitHub Reauthorize (Volver a autorizar GitHub).
5. Para completar el proceso de migración y reautorización, sigue las instrucciones que aparecen en pantalla en el cuadro de diálogo del chat.

Usar la aplicación GitHub en espacios

Para usar la aplicación en espacios, debes @mencionar o /mencionar la aplicación en cada mensaje y en las respuestas a los mensajes de la aplicación.

La @mención o el comando /mention confirman que has enviado el mensaje a la aplicación y no a otros usuarios del espacio.

1. Abre la aplicación Chat .
2. En un espacio, escribe @github o /github seguido del comando.
   • Cuando mencionas @github o /github, el mensaje se envía a la aplicación y no a otros usuarios del espacio.

Cambiar la configuración de la aplicación

En los espacios, solo puede cambiar la configuración de la aplicación la persona que la ha añadido.

1. Abre la aplicación Chat .
2. Abre un mensaje directo con la aplicación o ve a un espacio en el que esté.
3. Para abrir la configuración actual de la aplicación, escribe /github_settings.
4. Cambia la configuración según sea necesario.
5. Toca Guardar.

Al quitar la aplicación de un espacio, se elimina su configuración.

Información sobre los comandos de la aplicación GitHub en Chat

En el campo de mensaje de un mensaje directo o de un espacio con la aplicación GitHub en Chat, puedes usar lo siguiente:

• Comandos de barra inclinada:
  • /github_settings: abre el cuadro de diálogo de configuración.
  • /github_reminders: para solicitudes de extracción abiertas personales o del equipo, configura y edita recordatorios programados.
  • /github_subscribe: se suscribe a un <repoURL> o <owner/repo> de GitHub.
  • /github_openIssue: abre un nuevo problema de GitHub.
  • /github_logout: cierra sesión en tu cuenta de GitHub.
  • /github_help: muestra el mensaje de ayuda.
  • /github_feedback: envía comentarios sobre la aplicación GitHub.
• Comandos rápidos: para acceder a los comandos rápidos, toca Herramientas de Google Workspace .
  • GitHub Connect: muestra un mensaje con las opciones "Iniciar sesión" y "Iniciar sesión con la versión antigua".
  • Reautorización de GitHub: te permite migrar a un nuevo método de conexión.

Para obtener una lista completa de los comandos compatibles, sigue estos pasos:

1. En tu iPhone o iPad, abre la aplicación Chat .
2. Abre un mensaje directo o ve a un espacio en el que esté instalada la aplicación GitHub.
3. Escribe /github_help.

Solucionar problemas con la aplicación GitHub en Chat

Si aparece un error al suscribirte a notificaciones en tiempo real

Aplicación GitHub

Para configurar las notificaciones en tiempo real en los espacios, sigue estos pasos:

1. En tu navegador, ve a la configuración del perfil de GitHub.
2. En "Integraciones", toca Aplicaciones Aplicaciones GitHub autorizadas.
   • Una vez que hayas conectado la aplicación GitHub a Google Chat, aparecerá "Google Chat" en tu lista de aplicaciones autorizadas.
3. Instala la aplicación Google Chat para el repositorio de GitHub.
   • También puedes solicitar la instalación al propietario de la organización o del repositorio.
4. Espera a que se complete la instalación.
5. En Google Chat, abre un mensaje directo o un espacio con la aplicación GitHub.
6. En el campo del mensaje, para crear una suscripción, escribe /github_subscribe [organización/repositorio] o /github_settings.

Aplicación OAuth

Para configurar las notificaciones en tiempo real en los espacios, debes hacer lo siguiente:

• Ser propietario de la organización del repositorio propuesto.
• Autorizar la aplicación en la organización de GitHub.
  1. En tu navegador, ve a la configuración del perfil de GitHub.
  2. En "Integraciones", toca Aplicaciones Aplicaciones OAuth autorizadas.
     • Una vez que hayas conectado la aplicación GitHub a Google Chat, aparecerá "Google Chat" en tu lista de aplicaciones autorizadas.
  3. Conceder acceso a la aplicación a la organización a la que quieras acceder.

Si recibes demasiadas notificaciones de la aplicación de GitHub

1. En el campo del mensaje, introduce /github_settings.
2. Para editar la configuración de las notificaciones de tu repositorio, toca Ajustes de notificaciones.
3. Para filtrar las notificaciones, toca la flecha hacia abajo situada junto a cada tipo de notificación.
   • Se mostrarán opciones adicionales para filtrar las notificaciones.
4. Marca las casillas de las notificaciones que quieras recibir.
5. Toca Guardar.

Si no recibes ninguna @mención en recordatorios programados

Para que te mencionen en recordatorios programados, debes haber conectado tu cuenta de Google Chat a la cuenta de GitHub.

1. En el campo del mensaje, introduce /github_settings.
2. Para conectar tu cuenta, sigue estos pasos:
   1. En la ventana emergente, toca Configurar acceso Iniciar sesión en GitHub.
   2. Inicia sesión en tu cuenta de GitHub.
   3. Autoriza la aplicación.
3. En el mensaje que recibas de la aplicación GitHub, selecciona Schedule reminders for your team (Programar recordatorios para tu equipo).
4. En la ventana emergente:
   1. Toca Create new reminder (Crear nuevo recordatorio).
   2. Configura los ajustes de los recordatorios.
   3. Toca Guardar.

Si no recibes recordatorios con la aplicación GitHub

En el repositorio del que quieras recibir recordatorios, verifica que la aplicación Google Chat para GitHub esté instalada.

_{Google, Google Workspace, así como las marcas y los logotipos relacionados, son marcas de Google LLC. Todos los demás nombres de empresas y productos son marcas de las empresas con las que están asociadas.}