Cuando un OAuth app quiere identificarte mediante tu cuenta de GitHub, verás una página con la información de contacto del desarrollador de la aplicación y una lista de los datos específicos que se están solicitando.
Acceso a OAuth app
Las OAuth apps pueden tener acceso de lectura o escritura a sus datos de GitHub.
-
**El acceso de lectura** solo permite que una aplicación _examine los_ datos. -
**El acceso de escritura** permite a una aplicación _cambiar_ los datos.
Sugerencia
Te recomendamos que revises frecuentemente tus integraciones autorizadas. Elimina cualquier aplicación y tokens que no se hayan utilizado en mucho tiempo. Para más información, consulta Revisión de las aplicaciones autorizadas de OAuth.
Acerca de los alcances de OAuth
Los scopes son grupos definidos de permisos que una OAuth app puede solicitar para acceder tanto a datos públicos como no públicos.
Cuando quieres usar una instancia de OAuth app que se integra con GitHub, la aplicación te indica qué tipo de acceso a tus datos serán necesarios. Si otorgas acceso a la app, la app podrá realizar acciones en tu nombre, como leer o modificar datos. Por ejemplo, si quiere usar una aplicación que solicita el ámbito user:email, la aplicación tendrá acceso de solo lectura a las direcciones de correo electrónico privadas. Para más información, consulta Ámbitos para las aplicaciones de OAuth.
Nota:
Actualmente, no se puede definir el alcance del acceso al código fuente como de solo lectura.
Un token tiene las mismas funcionalidades para acceder a los recursos y realizar acciones en esos recursos que las que tiene el propietario del token, y está limitado aún más por los ámbitos o permisos que se le hayan concedido. Un token no puede conceder funcionalidades de acceso adicionales a un usuario. Por ejemplo, una aplicación puede crear un token de acceso configurado con un ámbito admin:org, pero, si el usuario de la aplicación no es propietario de la organización, la aplicación no tendrá acceso administrativo a esta organización.
Hay un límite de diez tokens que se emiten por combinación de usuario/aplicación/ámbito y un límite de frecuencia de diez tokens creados por hora. Si una aplicación crea más de diez tokens para el mismo usuario y los mismos alcances, se revocarán los tokens más antiguos con la misma combinación de usuario/aplicación/alcance. Sin embargo, alcanzar el límite de volumen por hora no revocará el token más antiguo. En su lugar, desencadenará una solicitud de nueva autorización en el explorador, y se pedirá al usuario que compruebe los permisos que concede a la aplicación. Este mensaje está pensado interrumpir cualquier bucle infinito posible en el que la aplicación está atrapada, ya que hay pocos o ningún motivo para que una aplicación solicite diez tokens al usuario en un plazo de una hora.
Tipos de datos solicitados
Las OAuth apps pueden solicitar diferentes tipos de datos.
| Tipo de datos | Descripción |
|---|---|
| Estado de confirmación | Puedes otorgar acceso para una app para que informe tu estado de confirmación. El acceso al estado de commit permite que las aplicaciones determinen si una compilación ha tenido éxito en relación con un commit específico. Las aplicaciones no tendrán acceso a tu código, pero podrán leer y escribir información de estado en relación con un commit específico. |
| Implementaciones | El estado de implementación permite que las apps determinen si una implementación es exitosa frente a una confirmación específica para repositorios públicos y privados. Las apps no tendrán acceso a tu código. |
| Gists | El acceso a Gist permite que las aplicaciones lean o escriban en los Gists públicos y secretos. |
| Ganchos | El acceso a webhooks permite a las aplicaciones leer o escribir configuraciones de enlace en repositorios que usted administra. |
| Notificaciones | El acceso a las notificaciones permite que las aplicaciones lean tus notificaciones de GitHub, como comentarios sobre incidencias y solicitudes de cambios. Sin embargo, las aplicaciones no pueden acceder a tus repositorios. |
| Las organizaciones y los equipos | El acceso a organizaciones y equipos permite que las apps accedan y administren la membresía de la organización y del equipo. |
| Datos de usuario personales | Entre los datos del usuario se incluye información que se encuentra en tu perfil de usuario, como tu nombre, dirección de correo electrónico y ubicación. |
| Repositorios | La información del repositorio incluye los nombres de los colaboradores, las ramas que creaste y los archivos actuales dentro de tu repositorio. Las apps pueden solicitar acceso a repositorios públicos o privados a nivel del usuario. |
| Eliminación de repositorio | Las apps pueden solicitar la eliminación de los repositorios que administras,, pero no tendrán acceso a tu código. |
Solicitar permisos actualizados
Cuando las OAuth apps solicitan permisos de acceso nuevos, te notificarán sobre las diferencias entre los permisos actuales y los permisos nuevos.