Lorsque vous avez activé GitHub Copilot dans une organisation ou une entreprise, vous pouvez configurer un flux de travail libre-service pour permettre aux utilisateurs de demander des licences. Cela vous permet d’allouer des licences à des personnes qui les souhaitent et signifie que les utilisateurs peuvent commencer Copilot rapidement.
GitHub a constaté que de nombreux déploiements réussis offrent un modèle entièrement libre-service où les développeurs peuvent revendiquer une licence sans approbation.
Cet article décrit deux approches que votre entreprise peut adopter :
- GitHubfonctionnalité d’accès aux demandes pour Copilot Business, qui ne nécessite aucune configuration, mais nécessite des approbations explicites d’un administrateur
- Votre propre intégration avec l’API de GitHub, qui vous permet de créer votre propre flux de travail avec un accès immédiat
Approche 1 : Utiliser GitHubla fonctionnalité « demander l’accès »
Si vous disposez d’un forfait Copilot Business, les membres d’une organisation peuvent demander l’accès à Copilot depuis leur page de paramètres. Ensuite, un propriétaire de l’organisation doit passer en revue et approuver chaque demande.
Le processus, que vous devez communiquer aux utilisateurs, est le suivant.
- Le propriétaire d’une organisation ou d’une entreprise s’assure que Copilot Business est activé dans l’organisation où vous souhaitez gérer les accès.
- Les membres de l’organisation accédent à leur page paramètres personnels à https://github.com/settings/copilot, puis cliquez sur Ask admin for access.
- Le propriétaire d’une organisation passe en revue et approuve les demandes sur la page « Demandes des membres » de l’organisation. Consultez Gestion des demandes de GitHub Copilot Business dans votre organisation.
Vous devez configurer un processus dans lequel les demandes sont examinées régulièrement, afin que les utilisateurs intéressés puissent accéder Copilot rapidement.
Les utilisateurs peuvent également demander l’accès à partir d’organisations où Copilot Business il n’est pas activé. Dans ce cas, les propriétaires de l’organisation seront invités à demander au propriétaire de l’entreprise d’activer Copilot pour l’organisation.
Approche 2 : Intégrer avec l’API
Pour une approche plus rationalisée, vous pouvez configurer un processus libre-service en intégrant l’API GitHub. Les avantages de cette approche sont qu’elle vous permet de créer le processus dans vos outils existants et vous donne la possibilité d’autoriser les utilisateurs à recevoir des access instantanément, sans processus d’approbation manuel.
Selon la façon dont votre entreprise gère les Copilot licences, vous pouvez utiliser l’un des points de terminaison suivants :
- Pour les affectations au niveau de l’organisation, utilisez le point de terminaison Ajouter des utilisateurs à l’abonnement Copilot d’une organisation.
- Pour l’attribution directe d’utilisateurs au niveau de l’entreprise (disponible pour Copilot Business uniquement), utilisez le point de terminaison Ajouter des utilisateurs à l’abonnement Copilot pour une entreprise.
Par exemple, l’appel d’API dans un GitHub Actions flux de travail peut se présenter comme suit, où l’organisation et les noms d’utilisateur sélectionnés sont fournis par le contexte du déclencheur de flux de travail :
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'
}
})
Exemples d’implémentations
- Vous pouvez créer l’intégralité du processus dans GitHub, en permettant aux utilisateurs de créer des tickets pour demander l’accès, puis d’utiliser un workflow GitHub Actions pour appeler l’API. Pour obtenir une démonstration de cette approche, consultez le référentiel microsoft/GitHubCopilotLicenseAssignment. Notez qu’il s’agit d’un exemple externe qui n’est pas couvert par Support GitHub.
- Vous pouvez ajouter un bouton « Demander l’accès » aux profils des utilisateurs sur le site web interne de votre entreprise, qui transmet le nom d’utilisateur de GitHub l’utilisateur à l’API. Vous pouvez accorder access instantanément ou valider l’utilisateur en premier, par exemple vérifier son appartenance à une certaine équipe.