Erstellen eines persönlichen Zugriffstokens

Informationen zu personal access token

Personal access token stellen eine Alternative für die Verwendung von Kennwörtern für die Authentifizierung bei GitHub über die GitHub-API oder die Befehlszeile dar.

Personal access token sind für den Zugriff auf GitHub-Ressourcen in deinem Namen vorgesehen. Für den Zugriff auf Ressourcen im Auftrag einer Organisation oder für langfristige Integrationen sollte eine GitHub App verwendet werden. Weitere Informationen findest du unter Informationen zu Apps.

Arten von personal access token

GitHub unterstützt derzeit zwei Arten von personal access token: fine-grained personal access token und personal access tokens (classic). GitHub empfiehlt, nach Möglichkeit fine-grained personal access token anstelle von personal access tokens (classic) zu verwenden.

Organisationsbesitzer*innen können eine Richtlinie festlegen, um den Zugriff von personal access tokens (classic) auf ihre Organisation zu beschränken. Weitere Informationen findest du unter Festlegen einer Richtlinie für persönliche Zugriffstoken für deine Organisation.

Fine-grained personal access tokens

Fine-grained personal access token hat gegenüber personal access tokens (classic) einige Sicherheitsvorteile:

• Jedes Token kann nur auf Ressourcen zugreifen, die einem oder einer einzelnen Benutzer*in oder einer Organisation gehören.
• Jedes Token kann nur auf bestimmte Repositorys zugreifen.
• Jedes Token erhält bestimmte Berechtigungen, die mehr Kontrolle bieten als die Berechtigungen, die personal access tokens (classic) erteilt werden.
• Jedes Token muss über ein Ablaufdatum verfügen.
• Organisationsinhaber*innen können die Genehmigung für alle fine-grained personal access token erzwingen, die auf Ressourcen in der Organisation zugreifen können.

Personal access tokens (classic)

Wenn du ein personal access token (classic) verwendest, solltest du bedenken, dass es den Zugriff auf alle Repositorys innerhalb der Organisation, auf die du Zugriff hast, sowie auf alle persönlichen Repositorys in deinem persönlichen Konto gewährt.

Als Sicherheitsmaßnahme entfernt GitHub automatisch ein personal access token, das seit einem Jahr nicht verwendet wurde. Um die Sicherheit weiter zu verstärken, empfiehlt es sich, ein personal access token mit einem Ablaufdatum zu versehen.

Schützen deiner personal access token

Personal access token sind wie Kennwörter und weisen dieselben inhärenten Sicherheitsrisiken auf. Bevor du ein neues personal access token erstellst, solltest du überlegen, ob es eine sicherere Methode für die Authentifizierung gibt:

• Um über die Befehlszeile auf GitHub zuzugreifen, kannst du die GitHub CLI oder Git Credential Manager verwenden, anstatt ein personal access token zu erstellen.
• Wenn du ein personal access token in einem GitHub Actions-Workflow verwendest, solltest du prüfen, ob du stattdessen das integrierte GITHUB_TOKEN verwenden kannst. Weitere Informationen findest du unter Automatische Tokenauthentifizierung.

Wenn diese Optionen nicht möglich sind und du ein personal access token erstellen musst, solltest du die Verwendung eines anderen Diensts (z. B. 1Password CLI) zum sicheren Speichern deines Tokens oder des GitHub-Shell-Plug-Ins von 1Password zum sicheren Authentifizieren bei der GitHub CLI erwägen.

Wenn du ein personal access token in einem Skript verwendest, kannst du dein Token als Geheimnis speichern und dein Skript über GitHub Actions ausführen. Weitere Informationen findest du unter Verschlüsselte Geheimnisse.Du kannst dein Token auch als Codespaces-Geheimnis speichern und dein Skript in Codespaces ausführen. Weitere Informationen findest du unter Verwalten verschlüsselter Geheimnisse für Codespaces.

Erstellen eines fine-grained personal access token

1. Verifiziere deine E-Mail-Adresse, falls du das noch nicht getan hast. 1. Klicke auf einer beliebigen Seite in der oberen rechten Ecke auf dein Profilfoto und anschließend auf Einstellungen.

   

2. Klicke in der linken Seitenleiste auf Entwicklereinstellungen.

3. Klicke in der linken Randleiste unter Personal access token auf Differenzierte Token.

4. Klicke auf Neues Token generieren.

5. Gib unter Tokenname einen Namen für das Token ein.

6. Wählen unter Ablauf ein Ablaufdatum für das Token aus.

7. Füge optional unter Beschreibung eine Notiz hinzu, um den Zweck des Token zu beschreiben.

8. Wähle unter Ressourcenbesitzer einen Ressourcenbesitzerin aus. Das Token kann nur auf Ressourcen zugreifen, die dem oder der ausgewählten Ressourcenbesitzer*in gehören. Organisationen, bei denen du Mitglied bist, werden nicht angezeigt, es sei denn, die Organisation hat fine-grained personal access token aktiviert. Weitere Informationen findest du unter Festlegen einer Richtlinie für persönliche Zugriffstoken für deine Organisation.

9. Wenn der Ressourcenbesitzer eine Organisation ist, die eine Genehmigung für fine-grained personal access token vorschreibt, gib optional im Feld unter „Ressourcenbesitzer“ eine Begründung für die Anforderung ein.

10. Wähle unter Repositoryzugriff die gewünschten Repositorys aus, auf die das Token zugreifen soll. Du solltest nur den mindestens erforderlichen Repositoryzugriff für deine Zwecke auswählen. Token haben immer schreibgeschützten Zugriff auf alle öffentlichen Repositorys auf GitHub.

11. Wenn du Nur ausgewählte Repositorys im vorherigen Schritt ausgewählt hast, wähle im Dropdownmenü Ausgewählte Repositorys die Repositorys aus, auf die du zugreifen möchtest.

12. Wähle unter Berechtigungen aus, welche Berechtigungen dem Token erteilt werden sollen. Je nachdem, welchen Ressourcenbesitzerin und welchen Repositoryzugriff du angegeben hast, gibt es Repository-, Organisations- und Kontoberechtigungen. Du solltest nur die mindestens erforderlichen Berechtigungen für deine Zwecke auswählen. Weitere Informationen zu den Berechtigungen, die für die unterschiedlichen REST-API-Vorgänge erforderlich sind, findest du unter Erforderliche Berechtigungen für differenzierte persönliche Zugangstoken.

13. Klicke dann auf Token generieren.

Wenn du eine Organisation als Ressourcenbesitzer ausgewählt hast und die Organisation eine Genehmigung für fine-grained personal access token vorschreibt, wird dein Token bis zur Überprüfung durch einen Organisationsadministratorin mit pending gekennzeichnet. Bis zur Genehmigung kann dein Token nur öffentliche Ressourcen lesen. Wenn du eine Inhaberin der Organisation bist, wird deine Anforderung automatisch genehmigt. Weitere Informationen findest du unter Überprüfen und Widerrufen persönlicher Zugriffstoken in deiner Organisation.

Erstellen eines personal access token (classic)

1. Verifiziere deine E-Mail-Adresse, falls du das noch nicht getan hast. 1. Klicke auf einer beliebigen Seite in der oberen rechten Ecke auf dein Profilfoto und anschließend auf Einstellungen.

   

2. Klicke in der linken Seitenleiste auf Entwicklereinstellungen.

3. Klicke in der linken Randleiste unter Personal access token auf Token (klassisch) . 1. Wähle Neues Token generieren aus, und klicke dann auf Neues Token generieren (klassisch) .

4. Gib dem Token einen beschreibenden Namen.

5. Wenn du für dein Token eine Ablaufzeit festlegen möchtest, wähle das Dropdownmenü Ablauf aus, und klicke dann auf eine Standardeinstellung, oder verwende die Kalenderauswahl.

6. Wähle die Berechtigungen aus, die du diesem Token erteilen möchtest. Um das Token für den Zugriff auf Repositorys über die Befehlszeile zu verwenden, wähle Repository aus. Ein Token ohne zugewiesene Bereiche kann nur auf öffentliche Informationen zugreifen. Weitere Informationen findest du unter Bereiche für OAuth-Apps.

7. Klicke dann auf Token generieren.

8. Um dein Token für den Zugriff auf Ressourcen im Besitz einer Organisation zu verwenden, die SAML Single Sign-On nutzt, autorisiere das Token. Weitere Informationen findest du unter Ein persönliches Zugriffstoken für die Verwendung mit SAML Single Sign-On autorisieren in der GitHub Enterprise Cloud-Dokumentation.

Verwenden eines personal access token in der Befehlszeile

Sobald Du über ein Token verfügst, kannst Du es anstelle Deines Passworts eingeben, wenn Du Git-Vorgänge über HTTPS durchführst.

So würdest Du beispielsweise Folgendes an der Befehlszeile eingeben:

$ git clone https://github.com/USERNAME/REPO.git
Username: YOUR_USERNAME
Password: YOUR_TOKEN

Personal access token können nur für Git-Vorgänge mit HTTPS verwendet werden. Wenn dein Repository eine SSH-Remote-URL verwendet, musst du das Remoterepository von SSH auf HTTPS umstellen.

Wenn du nicht nach einem Benutzernamen und einem Passwort gefragt wirst, wurden deine Anmeldeinformationen möglicherweise auf deinem Computer zwischengespeichert. Du kannst deine Anmeldeinformationen in der Keychain aktualisieren, um das alte Kennwort durch das Token zu ersetzen.

Statt dein personal access token manuell bei jedem Git-Vorgang mit HTTPS einzugeben, kannst du dein personal access token bei einem Git-Client zwischenspeichern. Git speichert deine Anmeldeinformationen vorübergehend im Arbeitsspeicher, bis ein Ablaufintervall abgelaufen ist. Du kannst das Token auch in einer Nur-Textdatei speichern, die Git vor jeder Anforderung lesen kann. Weitere Informationen findest du unter Zwischenspeichern von GitHub Anmeldeinformationen in Git.

Weiterführende Themen

• Informationen zur Authentifizierung für GitHub
• Tokenablauf und Sperrung