Usa la app de GitHub en Google Chat

Usa la app de GitHub en Chat para recibir notificaciones sobre los eventos de GitHub, como problemas, solicitudes de extracción y comentarios.

Antes de comenzar

Para usar la app de GitHub para Chat, haz lo siguiente:

• Necesitas permiso del administrador de Google Workspace para instalar apps.
• Agrega la app a Chat. Más información para buscar apps y agregarlas a Chat.
• Necesitas una cuenta de GitHub.
• Debes instalar la app de Google Chat para tu repositorio de GitHub.

Comprende los mecanismos de autenticación de las apps de GitHub y las apps de OAuth

En este documento, se describen las características distintivas y los modelos operativos de las apps de GitHub y las apps de 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 dentro de una organización.

1. Análisis comparativo: Distinciones clave

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

Atributo	App de GitHub (se recomienda acceder)	App de OAuth (acceso heredado)
Identidad principal	Actúa como una identidad de aplicación independiente, separada de cualquier usuario, o en nombre del usuario autorizante, según el caso de uso.	Actúa en nombre del usuario que autoriza y hereda sus privilegios.
Modelo de autorización	Permisos detallados (recomendado): Utiliza el principio de mínimo privilegio, que permite el acceso a repositorios y tipos de recursos específicos. Por ejemplo, acceso de lectura solo para los metadatos.	Permisos amplios: El acceso se define por permisos amplios, como otorgar acceso a todos los recursos visibles para el usuario que autoriza.
Duración de las credenciales	Tokens de corta duración: Los tokens de acceso tienen una vida útil limitada (por lo general, 1 hora) y requieren una renovación frecuente, lo que mitiga significativamente el riesgo en caso de vulneración.	Tokens de larga duración: Los tokens de acceso persisten hasta que el usuario los revoca manualmente, lo que representa un riesgo de exposición prolongado.
Requisito de instalación	El administrador o el propietario de la organización debe instalar la app, lo que establece un vínculo formal con la cuenta o la organización, y el usuario debe autorizarla para los casos de uso en los que la app actúa en nombre del usuario.	Debe estar autorizado por un usuario individual, lo que vincula el acceso directamente a la identidad de ese usuario.

Para obtener documentación más completa, consulta Diferencias entre las apps de GitHub y las apps de OAuth.

2. Recomendación

Según las prácticas recomendadas de seguridad, se recomienda el mecanismo de autenticación de la app de GitHub para todas las integraciones organizativas y de terceros. Este modelo aplica el principio de privilegio mínimo y emplea credenciales sólidas y de tiempo limitado, lo que mantiene un estándar más alto de seguridad y estabilidad operativa en comparación con el modelo de autoridad delegada de las apps OAuth.

Instala la app de Google Chat para repositorios de GitHub.

Cómo configurar la app de GitHub en Chat

1. Abre Chat.
2. Abre un mensaje directo con la app o ve a un espacio en el que esté la app.
3. Para abrir la ventana de configuración, haz clic en Acceder.
4. Haz clic en Configurar acceso Acceder a GitHub.
5. Completa el proceso de acceso y, luego, cierra la ventana emergente.
6. Para actualizar el diálogo de Chat, haz clic en Actualizar.
7. En Agregar repositorios, escribe el repositorio de GitHub del que deseas recibir notificaciones.
8. Marca las casillas de los eventos para los que deseas recibir notificaciones.
9. Haz clic en Guardar.

Nota: Debes configurar las notificaciones en cada espacio en el que agregues la app. Esta enviará notificaciones a todos los espacios de los que sea miembro.

Migra de la app de OAuth (heredada) a la app de GitHub (recomendada)

Para migrar tu conexión actual del método de autenticación de la app de OAuth anterior al método recomendado de la app de GitHub, haz lo siguiente:

1. Abre Chat.
2. Abre un mensaje directo o un espacio con la app de GitHub.
3. En el campo de mensaje, haz clic en Herramientas de Google Workspace .
4. En la lista de comandos, selecciona GitHub Reauthorize.
5. Para completar el proceso de migración y reautorización, sigue las instrucciones en pantalla del diálogo de chat.

Usa la app de GitHub en espacios

Para usar la app en los espacios, debes @mencionarla o /mencionarla en cada mensaje y en las respuestas a los mensajes de la app.

La @mención o /mención confirma que enviaste el mensaje a la app y no a otras personas en el espacio.

1. Abre la app de Chat .
2. En un espacio, ingresa @github o /github seguido del comando.
   • Cuando mencionas @github o /github, el mensaje se envía a la app y no a otras personas en el espacio.

Cómo cambiar la configuración de las apps

En los espacios, solo la persona que agregó la app puede cambiar la configuración.

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

Si quitas la app de un espacio, se borrará la configuración correspondiente.

Conoce los comandos de la app de GitHub en Chat

En el campo de mensaje de un mensaje directo o un espacio que tenga la app de GitHub en Chat, puedes usar lo siguiente:

• Comandos de barra:
  • /github_settings: Abre el diálogo de configuración.
  • /github_reminders: Para solicitudes de extracción personales o de equipo abiertas, configura y edita recordatorios programados.
  • /github_subscribe: Se suscribe a un <owner/repo> o <repoURL> de GitHub.
  • /github_openIssue: Abre un nuevo problema de GitHub.
  • /github_logout: Sale de tu cuenta de GitHub.
  • /github_help: Muestra el mensaje de ayuda.
  • /github_feedback: Envía comentarios sobre la app de GitHub.
• Comandos rápidos: Para acceder a los comandos rápidos, haz clic en Herramientas de Google Workspace .
  • GitHub Connect: Muestra un mensaje con las opciones “Sign in” y “Legacy Sign in”.
  • GitHub Reauthorize: Te permite migrar a un nuevo método de conexión.

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

1. En tu computadora, abre Chat.
2. Abre un mensaje directo o ve a un espacio en el que esté instalada la app de GitHub.
3. Ingresa: /github_help.

Soluciona problemas con la app de GitHub en Chat

Si recibes un error cuando te suscribes a las notificaciones en tiempo real

App de GitHub

Sigue estos pasos para configurar las notificaciones en tiempo real en los espacios:

1. En tu navegador, ve a la configuración del perfil de GitHub.
2. En "Integrations", haz clic en Applications Authorized GitHub apps.
   • Después de conectar la app de GitHub en Google Chat, en la lista de apps autorizadas aparecerá “Google Chat”.
3. Instala la app de Google Chat para el repositorio de GitHub.
   • También puedes solicitar la instalación al propietario de la organización o el repositorio.
4. Espera a que se complete la instalación.
5. En Google Chat, abre un mensaje directo o un espacio con la app de GitHub.
6. En el campo de mensaje, para crear una suscripción, ingresa /github_subscribe [organización/repositorio] o /github_settings.

App de OAuth

Para configurar notificaciones en tiempo real en los espacios, debes cumplir estos requisitos:

• Ser propietario de la organización del repositorio propuesto
• Autorizar la app en la organización de GitHub
  1. En tu navegador, ve a la configuración del perfil de GitHub.
  2. En "Integrations", haz clic en Applications Authorized OAuth apps.
     • Después de conectar la app de GitHub en Google Chat, en la lista de apps autorizadas aparecerá "Google Chat".
  3. Otorga a la app acceso a la organización a la que deseas acceder.

Si recibes demasiadas notificaciones de la app de GitHub

1. En el campo de mensaje, ingresa /github_settings.
2. Para editar la configuración de notificaciones del repositorio, haz clic en Configuración de notificaciones.
3. Para filtrar las notificaciones, junto a cada tipo de notificación, haz clic en la flecha hacia abajo .
   • Se mostrarán opciones adicionales para filtrar notificaciones.
4. Marca las casillas de las notificaciones que deseas recibir.
5. Haz clic en Guardar.

Si no recibes @menciones en los recordatorios programados

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

1. En el campo de mensaje, ingresa /github_settings.
2. Para conectar tu cuenta, sigue estos pasos:
   1. En la ventana emergente, haz clic en Configurar acceso Acceder a GitHub.
   2. Accede a tu cuenta de GitHub.
   3. Autoriza la app.
3. En el mensaje que recibes de la app de GitHub, selecciona Programar recordatorios para tu equipo.
4. En la ventana emergente, haz lo siguiente:
   1. Haz clic en Crear recordatorio nuevo.
   2. Define la configuración del recordatorio.
   3. Haz clic en Guardar.

Qué hacer si no recibes recordatorios con la app de GitHub

En el repositorio del que deseas recibir recordatorios, verifica la instalación de la app de Google Chat para 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.