Configuration d’un processus en libre-service pour les licences GitHub Copilot

Découvrez comment les utilisateurs peuvent demander une licence et en obtenir l’accès immédiatement.

Dans cet article

Lorsque vous avez activé GitHub Copilot dans une organisation ou une entreprise, vous pouvez configurer un flux de travail en libre-service pour permettre aux utilisateurs de demander des licences. Cela vous permet d’attribuer des licences aux personnes intéressées et de permettre à ces dernières de commencer rapidement à utiliser Copilot.

GitHub a constaté que de nombreux déploiements réussis proposent un modèle entièrement en libre-service où les développeurs peuvent demander une licence sans approbation.

Cet article décrit deux approches que votre entreprise peut adopter :

  • La fonctionnalité demander l’accès de GitHub pour Copilot Business, qui ne nécessite aucune configuration mais requiert les autorisations explicites d’un administrateur
  • Votre propre intégration avec l’API de GitHub qui vous permet de créer votre propre processus avec un accès instantané

Approche 1 : utiliser la fonctionnalité « demander l’accès » de GitHub

Si vous disposez d’un abonnement Copilot Business, les membres d’une organisation peuvent demander l’accès à GitHub Copilot sur leur page de paramètres. Ensuite, un propriétaire d’organisation doit passer en revue et approuver chaque demande.

Le processus, que vous devez communiquer aux utilisateurs, est le suivant.

  1. 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 l’accès.
  2. Les membres de l’organisation accèdent à leur page de paramètres personnels sur https://github.com/settings/copilot et cliquent sur Demander l’accès à l’administrateur.
  3. Le propriétaire d’une organisation passe en revue et approuve les demandes sur la page « Demandes des membres » de l’organisation. Consultez Gérer les demandes d’accès à 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 rapidement à Copilot.

Les utilisateurs peuvent également demander l’accès à des organisations où Copilot Business n’est pas activé. Dans ce cas, les propriétaires d’organisation seront invités à demander à un propriétaire d’entreprise d’activer Copilot pour l’organisation.

Approche 2 : intégrer à l’API

Pour une approche plus rationalisée, vous pouvez configurer un processus en libre-service en intégrant l’API de GitHub. Cette approche présente plusieurs avantages : elle vous permet d’intégrer le processus à vos outils existants et vous donne la possibilité d’accorder aux utilisateurs un accès instantané, sans processus d’approbation manuel.

Pour configurer l’intégration, vous utiliserez le point de terminaison Ajouter des utilisateurs à l’abonnement Copilot pour une organisation, en fournissant le nom d’utilisateur de l’utilisateur qui a demandé l’accès.

Par exemple, l’appel d’API dans un flux de travail GitHub Actions 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'
  }
})

Note

Ce point de terminaison fonctionne uniquement si vous utilisez des organisations sur GitHub. Si GitHub vous a fourni une entreprise dédiée pour la gestion des licences Copilot Business, vous devrez plutôt ajouter des utilisateurs aux équipes de l’entreprise. Pour demander la documentation API, veuillez contacter votre gestionnaire de compte.

Exemples d’implémentations

  • Vous pouvez créer le processus entièrement dans GitHub, en demandant aux utilisateurs de créer des problèmes pour demander l’accès, puis en utilisant un flux de travail GitHub Actions pour appeler l’API. Pour obtenir une version de démonstration de cette approche, consultez le référentiel microsoft/GitHubCopilotLicenseAssignment. Veuillez noter 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 transmettra le nom d’utilisateur GitHub de l’utilisateur à l’API. Vous pouvez accorder l’accès instantanément ou valider d’abord l’utilisateur, par exemple en vérifiant son appartenance à une certaine équipe.

Pour aller plus loin