Quando você estiver habilitado GitHub Copilot em uma organização ou empresa, poderá configurar um fluxo de trabalho de autoatendimento para permitir que os usuários solicitem licenças. Isso permite que você aloque licenças para pessoas que as desejam e significa que as pessoas podem começar a usar Copilot rapidamente.
GitHub descobriu que muitas distribuições bem-sucedidas oferecem um modelo totalmente de autoatendimento em que os desenvolvedores podem solicitar uma licença sem aprovação.
Este artigo descreve duas abordagens que sua empresa pode adotar:
- o recurso solicitar acesso de GitHub para Copilot Business, que não exige configuração, mas requer aprovações explícitas de um administrador
- Sua própria integração com a API de GitHub, que permite criar seu próprio processo com acesso instantâneo
Abordagem 1: usar o recurso "solicitar acesso" de GitHub
Se você tiver um plano Copilot Business, os membros de uma organização poderão solicitar acesso ao Copilot na página de configurações. Em seguida, um proprietário da organização deve examinar e aprovar cada solicitação.
Veja o processo a seguir, que você deve comunicar aos usuários.
- Um proprietário da organização ou da empresa deve garantir que Copilot Business esteja habilitado na organização em que você deseja gerenciar o acesso.
- Os membros da organização vão para a página de configurações pessoais em https://github.com/settings/copilot e clicam em Pedir acesso ao administrador.
- Um proprietário da organização examina e aprova solicitações na página "Solicitações de membros" na organização. Consulte Gerenciando solicitações para GitHub Copilot Business em sua organização.
Você deve estabelecer um processo no qual as solicitações sejam revisadas regularmente, para que os usuários interessados possam obter acesso a Copilot rapidamente.
Os usuários também podem solicitar acesso de organizações em que Copilot Business não está habilitado. Nesse caso, os proprietários da organização serão orientados a pedir a um proprietário da empresa que habilite Copilot para a organização.
Abordagem 2: integrar com a API
Para uma abordagem mais direta, você pode implementar um processo de autoatendimento por meio da integração com a API de GitHub. Os benefícios dessa abordagem são que ela permite que você crie o processo em suas ferramentas existentes e oferece a opção de permitir que os usuários recebam access instantaneamente, sem um processo de aprovação manual.
Dependendo de como sua empresa gerencia licençasCopilot, você pode usar um dos seguintes endpoints:
- Para atribuições em nível de organização, use o endpoint Adicionar usuários à Copilot assinatura de uma organização.
- Para atribuição direta de usuários no nível empresarial (disponível apenas para Copilot Business), use o endpoint Adicionar usuários à assinatura Copilot de uma empresa.
Por exemplo, a chamada à API em um GitHub Actions fluxo de trabalho pode ter a seguinte aparência, em que a organização e os nomes de usuário selecionados são fornecidos pelo contexto do gatilho de fluxo de trabalho:
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'
}
})
Implementações de exemplo
- Você pode criar o processo inteiramente dentro GitHub, fazendo com que os usuários criem problemas para solicitar acesso e, em seguida, usando um GitHub Actions fluxo de trabalho para chamar a API. Para obter uma demonstração dessa abordagem, consulte o repositório microsoft/GitHubCopilotLicenseAssignment. Observe que este é um exemplo externo que não é coberto por Suporte do GitHub.
- Você pode adicionar um botão "Solicitar acesso" aos perfis dos usuários no site interno da sua empresa, que passará o nome de usuário do GitHub usuário para a API. Você pode conceder acesso instantaneamente ou validar o usuário primeiro, tais como verificar sua associação a uma determinada equipe.