Skip to main content

Enterprise Server 3.15 actualmente está disponible como versión candidata para lanzamiento.

Acerca del uso de aplicaciones de GitHub

Obtén más información sobre qué es una GitHub App y por qué deberías usar una GitHub App.

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

No puedes instalar aplicaciones de terceros en la empresa. Si deseas usar la funcionalidad de una aplicación de terceros, puedes ponerte en contacto con el desarrollador de la aplicación para crear una aplicación a partir de un manifiesto o desde parámetros de dirección URL. Para más información, consulta "Registro de una aplicación de GitHub desde un manifiesto" y "Registro de una instancia de GitHub App mediante parámetros de dirección URL".

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 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».