Acerca de las GitHub Apps
Las GitHub Apps son herramientas que amplían la funcionalidad de GitHub. Las GitHub Apps pueden realizar acciones en GitHub, como abrir incidencias, comentar solicitudes de cambios y administrar proyectos. También pueden realizar acciones fuera de GitHub en función de los eventos que se producen en GitHub. Por ejemplo, una GitHub App puede publicar en Slack cuando se abre una incidencia en GitHub.
Búsqueda de GitHub Apps
Puedes detectar GitHub Apps en GitHub Marketplace.
Note
Las aplicaciones de GitHub Marketplace no están disponibles actualmente en GHE.com.
También puedes crear tus propias GitHub App. Para obtener más información, vea «Acerca de la creación de GitHub Apps».
Uso de GitHub Apps
Para usar una GitHub App, debes instalar la aplicación en la cuenta de usuario u organización. Al instalar la aplicación, se concede permiso a la aplicación para leer o modificar los datos del repositorio y la organización. Los permisos específicos dependen de la aplicación y GitHub te indicará qué permisos solicitó la aplicación antes de instalar la aplicación. Al instalar la aplicación, también especificarás a qué repositorios puede acceder la aplicación. Si la aplicación requiere alguna configuración adicional, te indicará cómo hacerlo. Para más información, consulta "Instalación de una instancia de GitHub App desde GitHub Marketplace en tu cuenta personal," "Instalación de una instancia de GitHub App desde GitHub Marketplace en las organizaciones," "Instalación de una instancia de GitHub App desde un tercero" y "Instalación de tu propia instancia de GitHub App".
También puede que tengas que autorizar a una GitHub App para que compruebe tu identidad, saber a qué recursos puedes acceder o realizar acciones en tu nombre. Si necesitas autorizar la aplicación, esta te solicitará que lo hagas. Para obtener más información, vea «Autorizar GitHub Apps».
En algunas ocasiones, la GitHub App solicitará permisos actualizados. GitHub te notificará cuando esto ocurra. Para que la aplicación siga funcionando, tendrás que revisar y aprobar los permisos actualizados. Para obtener más información, vea «Aprobación de permisos actualizados para una aplicación de GitHub».
Antes de instalar o autorizar una GitHub App, debes asegurarte de que confías en el desarrollador de la aplicación. Si ya no usas la aplicación, debes suspenderla o desinstalarla, o revocar la autorización de la misma. Para obtener más información, vea «Revisión y modificación de las Aplicaciones de GitHub instaladas» y «Revisión y revocación de autorización de aplicaciones de GitHub».
GitHub Apps y OAuth apps
GitHub también admite OAuth apps. A diferencia de las GitHub Apps, no instalas una OAuth app ni controlas a qué repositorios puede acceder.
Tanto las OAuth apps como las GitHub Apps usan OAuth 2.0.
Las OAuth apps solo pueden actuar en nombre de un usuario, mientras que las GitHub Apps pueden actuar en nombre de un usuario o con independencia de él.
Para obtener más información, vea «Diferencias entre aplicaciones de GitHub y aplicaciones de OAuth» y «Autorización de aplicaciones de OAuth».