Cuando hayas habilitado GitHub Copilot en una organización o empresa, puede configurar un flujo de trabajo de autoservicio para permitir que los usuarios soliciten licencias. Esto te permite asignar licencias a las personas que las necesiten y significa que pueden empezar a trabajar con Copilot rápidamente.
GitHub ha detectado que muchos lanzamientos correctos ofrecen un modelo de autoservicio completo donde los desarrolladores pueden reclamar una licencia sin aprobación.
En este artículo, se describen dos enfoques que puede adoptar tu empresa:
- Característica solicitar acceso de GitHub para Copilot Business, que no requiere ninguna configuración, pero sí aprobaciones explícitas por parte de un administrador
- Tu propia integración con API de GitHub, que te permite crear tu propio proceso con acceso instantáneo
Enfoque 1: usar la característica "solicitar acceso" de GitHub
Si tienes una suscripción de Copilot Business, los miembros de una organización pueden solicitar acceso a GitHub Copilot en su página de configuración. A continuación, un propietario de la organización debe revisar y aprobar cada solicitud.
El proceso, que debe comunicarse con los usuarios, es el siguiente.
- Un propietario de una organización o empresa garantiza que Copilot Business esté habilitado en la organización donde quieres administrar el acceso.
- Los miembros de la organización van a su página de configuración personal en https://github.com/settings/copilot y hacen clic en Ask admin for access.
- Un propietario de la organización revisa y aprueba las solicitudes en la página "Solicitudes de miembros" de la organización. Consulta Administración de solicitudes de Copilot Business en tu organización.
Debes configurar un proceso en el que las solicitudes se revisan periódicamente para que los usuarios interesados puedan acceder rápidamente a Copilot.
Los usuarios también pueden solicitar acceso desde organizaciones en las que los datos Copilot Business no esté habilitado. En este caso, se indicará a los propietarios de la organización que pidan a un propietario de la empresa que habilite Copilot para la organización.
Enfoque 2: integración con la API
Para un enfoque más simplificado, puedes configurar un proceso de autoservicio mediante la integración con la API de GitHub. Las ventajas de este enfoque son que te permite crear el proceso en las herramientas existentes y te ofrece la opción de permitir que los usuarios reciban acceso al instante, sin un proceso de aprobación manual.
Para configurar la integración, usarás el punto de conexión de Add users to the Copilot subscription for an organization y proporcionarás el nombre de usuario del usuario que ha solicitado acceso.
Por ejemplo, la llamada API en un flujo de trabajo de GitHub Actions podría tener el siguiente aspecto, donde el contexto del desencadenador de flujo de trabajo proporciona la organización y los nombres de usuario seleccionados:
const { Octokit } = require("@octokit/action");
const octokit = new Octokit();
const response = await octokit.request('POST /orgs/{org}/copilot/billing/selected_users', {
org: context.repo.owner,
selected_usernames: [context.payload.sender.login],
headers: {
'X-GitHub-Api-Version': '2022-11-28'
}
})
Note
Este punto de conexión solo funciona si utilizas organizaciones en GitHub. Si GitHub te ha proporcionado una empresa dedicada para administrar licencias de Copilot Business, deberás añadir usuarios a equipos empresariales en su lugar. Para solicitar la documentación de la API, ponte en contacto con el administrador de cuentas.
Implementaciones de ejemplo
- Puedes crear el proceso completamente dentro de GitHub, hacer que los usuarios creen incidencias para solicitar acceso y, a continuación, usar un flujo de trabajo de GitHub Actions para llamar a la API. Para ver una demo de este enfoque, consulta el repositorio microsoft/GitHubCopilotLicenseAssignment . Ten en cuenta que esto es un ejemplo externo que no está cubierto por Soporte de GitHub.
- Puedes añadir un botón "Request access" a los perfiles de los usuarios en el sitio web interno de la empresa, que pasará el nombre de usuario GitHub al nombre de usuario de la API. Puedes conceder acceso al instante o validar primero al usuario, como por ejemplo comprobar su pertenencia a un determinado equipo.