{"meta":{"title":"Einrichtung von GitHub OAuth","intro":"Ermöglichen Sie Benutzern die Authentifizierung mit ihren GitHub-Konten, Copilot über Ihre Anwendung zu verwenden. Dies unterstützt einzelne Konten, Organisationsmitgliedschaften und Unternehmensidentitäten.","product":"GitHub Copilot","breadcrumbs":[{"href":"/de/copilot","title":"GitHub Copilot"},{"href":"/de/copilot/how-tos","title":"Vorgehensweisen"},{"href":"/de/copilot/how-tos/copilot-sdk","title":"Copilot SDK"},{"href":"/de/copilot/how-tos/copilot-sdk/setup","title":"Einrichten des Copilot SDK"},{"href":"/de/copilot/how-tos/copilot-sdk/setup/github-oauth","title":"GitHub OAuth"}],"documentType":"article"},"body":"# Einrichtung von GitHub OAuth\n\nErmöglichen Sie Benutzern die Authentifizierung mit ihren GitHub-Konten, Copilot über Ihre Anwendung zu verwenden. Dies unterstützt einzelne Konten, Organisationsmitgliedschaften und Unternehmensidentitäten.\n\n\n\n\n\n**Best for:** Multi-User Apps, interne Tools mit Organisationszugriffskontrolle, SaaS-Produkte, Apps, bei denen Benutzer über GitHub Konten verfügen.\n\n## So funktioniert es\n\nSie erstellen eine GitHub OAuth-App (oder GitHub App), benutzer autorisieren sie, und Sie übergeben ihr Zugriffstoken an das SDK. Copilot Anfragen werden im Namen jedes authentifizierten Benutzers unter Verwendung seines Copilot-Abonnements vorgenommen.\n\n![Diagramm: Sequenzdiagramm mit dem beschriebenen Prozess.](/assets/images/help/copilot/copilot-sdk/setup-github-oauth-diagram-0.png)\n\n**Wichtige Merkmale:**\n\n* Jeder Benutzer authentifiziert sich mit einem eigenen GitHub Konto\n* Die Copilot-Nutzung wird dem Abonnement jedes Benutzers in Rechnung gestellt.\n* Unterstützt GitHub Organisationen und Unternehmenskonten\n* Ihre App verarbeitet niemals Modell-API-Schlüssel – GitHub verwaltet alles\n\n## Aufbau\n\n![Diagramm: Flussdiagramm mit dem beschriebenen Prozess.](/assets/images/help/copilot/copilot-sdk/setup-github-oauth-diagram-1.png)\n\n## Schritt 1: Erstellen einer GitHub OAuth-App\n\n1. Wechseln Sie zu **GitHub Einstellungen → Entwicklereinstellungen → OAuth-Apps → neue OAuth-App** (oder für Organisationen: **Organisierungseinstellungen → Entwicklereinstellungen**)\n\n2. Ausfüllen:\n * **Anwendungsname**: Name Ihrer App\n * **Homepage-URL**: Url Ihrer App\n * **Autorisierungsrückruf-URL**: Ihr OAuth-Rückrufendpunkt (z. B. `https://yourapp.com/auth/callback`)\n\n3. Notieren Sie Sich Ihre **Client-ID**, und generieren Sie einen **geheimen Clientschlüssel**.\n\n> **GitHub App vs OAuth App:** Beide funktionieren. GitHub Apps bieten detailliertere Berechtigungen und werden für neue Projekte empfohlen. OAuth-Apps sind einfacher einzurichten. Der Tokenfluss ist aus Sicht des SDK identisch.\n\n## Schritt 2: Implementieren des OAuth-Flusses\n\nIhre Anwendung behandelt den Standard-GitHub OAuth-Fluss. Hier sehen Sie den serverseitigen Tokenaustausch:\n\n```typescript\n// Server-side: Exchange authorization code for user token\nasync function handleOAuthCallback(code: string): Promise {\n const response = await fetch(\"https://github.com/login/oauth/access_token\", {\n method: \"POST\",\n headers: {\n \"Content-Type\": \"application/json\",\n Accept: \"application/json\",\n },\n body: JSON.stringify({\n client_id: process.env.GITHUB_CLIENT_ID,\n client_secret: process.env.GITHUB_CLIENT_SECRET,\n code,\n }),\n });\n\n const data = await response.json();\n return data.access_token; // gho_xxxx or ghu_xxxx\n}\n```\n\n## Schritt 3: Übergeben des Tokens an das SDK\n\nErstellen Sie einen SDK-Client für jeden authentifizierten Benutzer, und übergeben Sie ihr Token:\n\n
\n
TypeScript
\n\n```typescript\nimport { CopilotClient } from \"@github/copilot-sdk\";\n\n// Create a client for an authenticated user\nfunction createClientForUser(userToken: string): CopilotClient {\n return new CopilotClient({\n gitHubToken: userToken,\n useLoggedInUser: false, // Don't fall back to CLI login\n });\n}\n\n// Usage\nconst client = createClientForUser(\"gho_user_access_token\");\nconst session = await client.createSession({\n sessionId: `user-${userId}-session`,\n model: \"gpt-5.4\",\n});\n\nconst response = await session.sendAndWait({ prompt: \"Hello!\" });\n```\n\n
\n\n
Python
\n\n```python\nfrom copilot import CopilotClient\nfrom copilot.session import PermissionHandler\n\ndef create_client_for_user(user_token: str) -> CopilotClient:\n return CopilotClient({\n \"github_token\": user_token,\n \"use_logged_in_user\": False,\n })\n\n# Usage\nclient = create_client_for_user(\"gho_user_access_token\")\nawait client.start()\n\nsession = await client.create_session(on_permission_request=PermissionHandler.approve_all, model=\"gpt-5.4\", session_id=f\"user-{user_id}-session\")\n\nresponse = await session.send_and_wait(\"Hello!\")\n```\n\n
\n\n
Go
\n\n```golang\nfunc createClientForUser(userToken string) *copilot.Client {\n return copilot.NewClient(&copilot.ClientOptions{\n GitHubToken: userToken,\n UseLoggedInUser: copilot.Bool(false),\n })\n}\n\n// Usage\nclient := createClientForUser(\"gho_user_access_token\")\nclient.Start(ctx)\ndefer client.Stop()\n\nsession, _ := client.CreateSession(ctx, &copilot.SessionConfig{\n SessionID: fmt.Sprintf(\"user-%s-session\", userID),\n Model: \"gpt-5.4\",\n})\nresponse, _ := session.SendAndWait(ctx, copilot.MessageOptions{Prompt: \"Hello!\"})\n```\n\n
\n\n
.NET
\n\n```csharp\nCopilotClient CreateClientForUser(string userToken) =>\n new CopilotClient(new CopilotClientOptions\n {\n GitHubToken = userToken,\n UseLoggedInUser = false,\n });\n\n// Usage\nawait using var client = CreateClientForUser(\"gho_user_access_token\");\nawait using var session = await client.CreateSessionAsync(new SessionConfig\n{\n SessionId = $\"user-{userId}-session\",\n Model = \"gpt-5.4\",\n});\n\nvar response = await session.SendAndWaitAsync(\n new MessageOptions { Prompt = \"Hello!\" });\n```\n\n
\n\n
Java
\n\n\n\n```java\nimport com.github.copilot.CopilotClient;\nimport com.github.copilot.rpc.*;\n\nCopilotClient createClientForUser(String userToken) throws Exception {\n var client = new CopilotClient(new CopilotClientOptions()\n .setGitHubToken(userToken)\n .setUseLoggedInUser(false)\n );\n client.start().get();\n return client;\n}\n\n// Usage — use try-with-resources to ensure cleanup\nvar userId = \"user1\";\ntry (var client = createClientForUser(\"gho_user_access_token\")) {\n var session = client.createSession(new SessionConfig()\n .setSessionId(String.format(\"user-%s-session\", userId))\n .setModel(\"gpt-5.4\")\n .setOnPermissionRequest(PermissionHandler.APPROVE_ALL)\n ).get();\n\n var response = session.sendAndWait(new MessageOptions()\n .setPrompt(\"Hello!\")).get();\n}\n```\n\n
\n\n
\n\n## Unternehmens- und Organisationszugriff\n\nGitHub OAuth unterstützt natürlich Unternehmensszenarien. Wenn sich Benutzer mit GitHub authentifizieren, kommen ihre Organisationsmitgliedschaften und Unternehmenszuordnungen zusammen.\n\n![Diagramm: Flussdiagramm mit dem beschriebenen Prozess.](/assets/images/help/copilot/copilot-sdk/setup-github-oauth-diagram-2.png)\n\n### Überprüfen der Organisationsmitgliedschaft\n\nÜberprüfen Sie nach OAuth, ob der Benutzer zu Ihrer Organisation gehört:\n\n```typescript\nasync function verifyOrgMembership(\n token: string,\n requiredOrg: string\n): Promise {\n const response = await fetch(\"https://api.github.com/user/orgs\", {\n headers: { Authorization: `Bearer ${token}` },\n });\n const orgs = await response.json();\n return orgs.some((org: any) => org.login === requiredOrg);\n}\n\n// In your auth flow\nconst token = await handleOAuthCallback(code);\nif (!await verifyOrgMembership(token, \"my-company\")) {\n throw new Error(\"User is not a member of the required organization\");\n}\nconst client = createClientForUser(token);\n```\n\n### Von Unternehmen verwaltete Benutzer (EMU)\n\nFür GitHub vom Unternehmen verwaltete Benutzer ist der Ablauf identisch – EMU-Benutzer authentifizieren sich über GitHub OAuth wie jeder andere Benutzer. Ihre Unternehmensrichtlinien (IP-Einschränkungen, SAML-SSO) werden von GitHub automatisch erzwungen.\n\n```typescript\n// No special SDK configuration needed for EMU\n// Enterprise policies are enforced server-side by GitHub\nconst client = new CopilotClient({\n gitHubToken: emuUserToken, // Works the same as regular tokens\n useLoggedInUser: false,\n});\n```\n\n## Unterstützte Tokentypen\n\n| Tokenpräfix | Source | Funktioniert? |\n| ------------- | -------------------------------------- | ------------- |\n| `gho_` | OAuth-Benutzerzugriffstoken | ✅ |\n| `ghu_` | GitHub App-Benutzerzugriffstoken | ✅ |\n| `github_pat_` | Feinkörniges persönliches Zugangstoken | ✅ |\n| `ghp_` | Klassisches persönliches Zugriffstoken | |\n| ❌ (veraltet) | | |\n\n## Tokenlebenszyklus\n\n![Diagramm: Flussdiagramm mit dem beschriebenen Prozess.](/assets/images/help/copilot/copilot-sdk/setup-github-oauth-diagram-3.png)\n\n**Wichtig:** Ihre Anwendung ist für die Tokenspeicherung, Aktualisierung und Ablaufbehandlung verantwortlich. Das SDK verwendet das von Ihnen bereitgestellte Token – er verwaltet nicht den OAuth-Lebenszyklus.\n\n### Tokenaktualisierungsmuster\n\n```typescript\nasync function getOrRefreshToken(userId: string): Promise {\n const stored = await tokenStore.get(userId);\n\n if (stored && !isExpired(stored)) {\n return stored.accessToken;\n }\n\n if (stored?.refreshToken) {\n const refreshed = await refreshGitHubToken(stored.refreshToken);\n await tokenStore.set(userId, refreshed);\n return refreshed.accessToken;\n }\n\n throw new Error(\"User must re-authenticate\");\n}\n```\n\n## Mehrbenutzermuster\n\n### Ein Client pro Benutzer (empfohlen)\n\nJeder Benutzer erhält einen eigenen SDK-Client mit einem eigenen Token. Dies bietet die stärkste Isolation.\n\n```typescript\nconst clients = new Map();\n\nfunction getClientForUser(userId: string, token: string): CopilotClient {\n if (!clients.has(userId)) {\n clients.set(userId, new CopilotClient({\n gitHubToken: token,\n useLoggedInUser: false,\n }));\n }\n return clients.get(userId)!;\n}\n```\n\n### Freigegebene CLI mit Token pro Anforderung\n\nFür einen leichteren Ressourcenbedarf können Sie einen einzelnen externen CLI-Server ausführen und Token pro Sitzung übergeben. Siehe [Einrichtung von Back-End-Diensten](/de/copilot/how-tos/copilot-sdk/setup/backend-services) für dieses Muster.\n\n## Einschränkungen\n\n| Einschränkung | Details |\n| ---------------------------------------------------- | ------------------------------------------------------- |\n| **Copilot-Abonnement erforderlich** | Jeder Benutzer benötigt ein aktives Copilot-Abonnement. |\n| **Die Tokenverwaltung liegt in Ihrer Verantwortung** | Speichern, aktualisieren und Ablauf verwalten |\n| **GitHub Konto erforderlich** | Benutzer müssen über GitHub Konten verfügen |\n| **Ratenbeschränkungen pro Benutzer** | Vorbehaltlich der Copilot-Ratenlimits jedes Benutzers |\n\n## Wann muss ich fortfahren?\n\n| Bedarf | Nächster Leitfaden |\n| ------------------------------------------------------------------------------------------- | ------------------ |\n| Benutzer ohne GitHub Konten | |\n| [Bring Your Own Key (BYOK)](/de/copilot/how-tos/copilot-sdk/auth/byok) | |\n| Ausführen des SDK auf Servern | |\n| [Einrichtung von Back-End-Diensten](/de/copilot/how-tos/copilot-sdk/setup/backend-services) | |\n| Behandeln vieler gleichzeitiger Benutzer | |\n| [Skalierung und Mehrinstanzenfähigkeit](/de/copilot/how-tos/copilot-sdk/setup/scaling) | |\n\n## Nächste Schritte\n\n* **[Authentication](/de/copilot/how-tos/copilot-sdk/auth/authenticate)**: Vollständige Authentifizierungsmethodereferenz\n* **[Einrichtung von Back-End-Diensten](/de/copilot/how-tos/copilot-sdk/setup/backend-services)**: Ausführen des serverseitigen SDK\n* **[Skalierung und Mehrinstanzenfähigkeit](/de/copilot/how-tos/copilot-sdk/setup/scaling)**: Viele Benutzer in großem Maßstab verwalten"}