{"meta":{"title":"Проверка подлинности между серверами","intro":"Используйте маркер доступа к установке с коротким сроком действия, когда служба должна выполнять Copilot запросы от имени организации без учетных данных пользователя. В GitHub Actions используйте встроеннуюGITHUB_TOKEN.","product":"GitHub Copilot","breadcrumbs":[{"href":"/ru/copilot","title":"GitHub Copilot"},{"href":"/ru/copilot/how-tos","title":"Инструкции"},{"href":"/ru/copilot/how-tos/copilot-sdk","title":"Второй пилот SDK"},{"href":"/ru/copilot/how-tos/copilot-sdk/auth","title":"Проверка подлинности"},{"href":"/ru/copilot/how-tos/copilot-sdk/auth/server-to-server-tokens","title":"Маркеры между серверами"}],"documentType":"article"},"body":"# Проверка подлинности между серверами\n\nИспользуйте маркер доступа к установке с коротким сроком действия, когда служба должна выполнять Copilot запросы от имени организации без учетных данных пользователя. В GitHub Actions используйте встроеннуюGITHUB_TOKEN.\n\n\n\n\n\n## GitHub Actions\n\nДля рабочих процессов в репозитории, принадлежащем организации, предоставьте встроенному маркеру разрешение на выполнение Copilot запросов:\n\n```yaml\npermissions:\n contents: read\n copilot-requests: write\n\njobs:\n copilot:\n runs-on: ubuntu-latest\n steps:\n - uses: actions/checkout@v6\n - run: your-application\n env:\n GITHUB_TOKEN: $\n```\n\n**Необходимо включить использование Copilot CLI, выставленной** в политику организации. Этот подход не требует GitHub приложения или сохраненного секрета проверки подлинности. Дополнительные сведения см. в разделе [Использование Copilot CLI в GitHub Actions с GITHUB\\_TOKEN](/ru/copilot/how-tos/copilot-cli/use-copilot-cli-in-actions).\n\n## Другие службы и системы CI\n\nДля служб за пределами GitHub Actions:\n\n1. Создайте приложение GitHub с разрешением репозитория **запросов Copilot** для **чтения и записи**.\n\n2. Установите его в организации, которая должна быть выставлена счета. Для текущей проверки разрешений Copilot требуется доступ **ко всем репозиториям**.\n\n3. [Генерация токена доступа для установки приложения GitHub](/ru/apps/creating-github-apps/authenticating-with-a-github-app/generating-an-installation-access-token-for-a-github-app) с идентификатором репозитория и разрешением Copilot:\n\n ```json\n {\n \"repository_ids\": [123456789],\n \"permissions\": {\n \"copilot_requests\": \"write\"\n }\n }\n ```\n\n4. Передайте полученный `ghs_` маркер в среду выполнения в качестве `COPILOT_GITHUB_TOKEN`.\n\nОрганизация должна быть включена для Copilot запросов из GitHub установки приложений. Срок действия маркеров установки истекает через один час.\n\n> \\[!WARNING]\n> Не передайте маркер установки через параметр пакета SDK `gitHubToken``github_token`или эквивалентный параметр. Этот параметр предназначен для маркеров пользователей. Маркеры установки должны использовать путь проверки подлинности среды выполнения.\n\n## Настройка среды выполнения\n\nВ следующих примерах предполагается, что токен монетного двора находится в `INSTALLATION_TOKEN`. Они передают его только дочерней среде выполнения и отключают резервные копии для сохраненных учетных данных пользователя.\n\n
\n
TypeScript
\n\n```typescript\nimport { CopilotClient, RuntimeConnection } from \"@github/copilot-sdk\";\n\nconst token = process.env.INSTALLATION_TOKEN;\nif (!token) throw new Error(\"INSTALLATION_TOKEN is required\");\n\nconst client = new CopilotClient({\n connection: RuntimeConnection.forStdio(),\n env: {\n ...process.env,\n COPILOT_GITHUB_TOKEN: token,\n },\n useLoggedInUser: false,\n});\n```\n\n
\n\n
Python
\n\n```python\nimport os\n\nfrom copilot import CopilotClient, RuntimeConnection\n\nclient = CopilotClient(\n connection=RuntimeConnection.for_stdio(),\n env={**os.environ, \"COPILOT_GITHUB_TOKEN\": os.environ[\"INSTALLATION_TOKEN\"]},\n use_logged_in_user=False,\n)\n```\n\n
\n\n
Go
\n\n```golang\npackage main\n\nimport (\n \"log\"\n \"os\"\n\n copilot \"github.com/github/copilot-sdk/go\"\n)\n\nfunc main() {\n token, ok := os.LookupEnv(\"INSTALLATION_TOKEN\")\n if !ok {\n log.Fatal(\"INSTALLATION_TOKEN is required\")\n }\n client := copilot.NewClient(&copilot.ClientOptions{\n Connection: copilot.StdioConnection{},\n Env: append(os.Environ(), \"COPILOT_GITHUB_TOKEN=\"+token),\n UseLoggedInUser: copilot.Bool(false),\n })\n _ = client\n}\n```\n\n
\n\n
Rust
\n\n```rust\nuse github_copilot_sdk::{ClientOptions, Transport};\n\nfn main() {\n let token = std::env::var(\"INSTALLATION_TOKEN\").expect(\"INSTALLATION_TOKEN is required\");\n let options = ClientOptions::new()\n .with_transport(Transport::Stdio)\n .with_env([(\"COPILOT_GITHUB_TOKEN\", token)])\n .with_use_logged_in_user(false);\n drop(options);\n}\n```\n\n
\n\n
.NET
\n\n```csharp\nusing System.Collections;\nusing GitHub.Copilot;\n\nvar token = Environment.GetEnvironmentVariable(\"INSTALLATION_TOKEN\")\n ?? throw new InvalidOperationException(\"INSTALLATION_TOKEN is required\");\nvar environment = Environment.GetEnvironmentVariables()\n .Cast()\n .ToDictionary(entry => (string)entry.Key, entry => entry.Value?.ToString() ?? \"\");\nenvironment[\"COPILOT_GITHUB_TOKEN\"] = token;\n\nawait using var client = new CopilotClient(new CopilotClientOptions\n{\n Connection = RuntimeConnection.ForStdio(),\n Environment = environment,\n UseLoggedInUser = false,\n});\n```\n\n
\n\n
Java
\n\n```java\nimport com.github.copilot.CopilotClient;\nimport com.github.copilot.rpc.CopilotClientOptions;\nimport java.util.HashMap;\nimport java.util.Objects;\n\nvar environment = new HashMap<>(System.getenv());\nvar token = Objects.requireNonNull(\n System.getenv(\"INSTALLATION_TOKEN\"), \"INSTALLATION_TOKEN is required\");\nenvironment.put(\"COPILOT_GITHUB_TOKEN\", token);\n\ntry (var client = new CopilotClient(new CopilotClientOptions()\n .setEnvironment(environment)\n .setUseLoggedInUser(false))) {\n // Use the client.\n}\n```\n\n
\n\n
\n\nДля встроенного FFI установите `COPILOT_GITHUB_TOKEN` в среде узла перед загрузкой среды выполнения. Параметры среды для каждого клиента не поддерживаются. Для существующего URI среды выполнения задайте его в этом процессе выполнения.\n\n## токены обновления\n\nПомите новый маркер установки до истечения срока действия текущего маркера. Для дочернего процесса перезапустите клиент ПАКЕТА SDK с новой средой. Для внутрипроцессной или существующей среды выполнения перезапустите среду выполнения узла с новым маркером.\n\n## Billing\n\nИспользование присваивается и выставляется счет учетной записи, которая владеет установкой GitHub приложения. Использование установки организации для выставления счетов организации; Атрибуты установки учетной записи пользователя для этого пользователя.\n\n## Troubleshooting\n\n| Симптом | Проверьте |\n| ------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------- |\n| `401 Unauthorized` | Убедитесь, что организация поддерживает проверку подлинности GitHub установки приложений для Copilot. |\n| `403 Resource not accessible by integration` или ошибка с указанием сведений о пользователе | Убедитесь, что маркер установки включен `COPILOT_GITHUB_TOKEN`, а не параметр явного маркера пакета SDK. |\n| `403 Forbidden`из API Copilot | Убедитесь, что запрос маркера `repository_ids` содержит и `copilot_requests: write`. |\n| `403 Forbidden` с требуемым запросом маркера | Убедитесь, что установка приложения имеет доступ **ко всем репозиториям** , а затем помят новый маркер. |\n| Запрошенная модель недоступна | Убедитесь, что политика Copilot организации позволяет модели и пакетной среде выполнения поддерживать ее. |\n| Счета за неправильную учетную запись | Убедитесь, что установка принадлежит предполагаемой организации. |\n\n## Дополнительные материалы\n\n* [Проверка подлинности](/ru/copilot/how-tos/copilot-sdk/auth/authenticate): другие методы проверки подлинности и приоритет\n* [Генерация токена доступа для установки приложения GitHub](/ru/apps/creating-github-apps/authenticating-with-a-github-app/generating-an-installation-access-token-for-a-github-app): создание маркера приложения GitHub"}