diff --git a/de/Hilfe.md b/de/Hilfe.md index 788d6e268aba42def70dd78ffcbef8bd5eb2092b..0211157926e7886105d852558f71c8eaa5fba7e9 100644 --- a/de/Hilfe.md +++ b/de/Hilfe.md @@ -111,12 +111,12 @@ __Nachteile__ sind die erforderliche Einrichtung und Gewöhnung an den Umgang, d Ein [persönliches](https://docs.gitlab.com/ee/user/profile/personal_access_tokens.html) Access Token (PAT) erlaubt Berechtigungen auf alle Bereiche ihres Nutzungskontos (Git-über-HTTPS und API). Falls Sie für höhere Sicherheit [2-Faktor-Authentisierung](https://docs.gitlab.com/ee/user/profile/account/two_factor_authentication.html) nutzen wollen, müssen Sie für Authentifizierung über HTTPS ein PAT erstellen und nutzen (siehe unten). -Daneben gibt [Projekte](https://docs.gitlab.com/ee/user/project/settings/project_access_tokens.html) und [Gruppen](https://docs.gitlab.com/ee/user/group/settings/group_access_tokens.html). - Sie werden analog zu persönlichen Tokens benutzt, aber erlauben eine zusätzliche Berechtigungsbeschränkung auf einzelne Projekte oder Gruppen. +Neben *persönlichen* Access Tokens gibt es auch solche für [Projekte](https://docs.gitlab.com/ee/user/project/settings/project_access_tokens.html) und [Nutzergruppen](https://docs.gitlab.com/ee/user/group/settings/group_access_tokens.html). +Sie werden analog zu einem persönlichen Token benutzt, aber erlauben eine zusätzliche Berechtigungsbeschränkung auf einzelne Projekte, bzw. Gruppen. #### Erstellen eines persönlichen Access Tokens -Um ein persönliches Access Token (PAT) zu erstellen zu können, melden Sie sich per Browser an, klicken Sie rechts oben auf ihr Profil, wählen Sie *Edit profile* und anschließend *Access Tokens* im linken Seitenmenü. +Um ein persönliches Access Token (PAT) erstellen zu können, melden Sie sich per Browser an, klicken Sie rechts oben auf ihr Profil, wählen Sie *Edit profile* und anschließend *Access Tokens* im linken Seitenmenü. Alternativ können Sie auf auf [diesen Direktlink](https://gitlab.ub.uni-giessen.de/-/profile/personal_access_tokens) klicken. Um ein PAT zu erstellen: @@ -150,18 +150,20 @@ Das konfigurierte Hilfsprogramm kann über `git config credential.helper` einges Für _Windows_ und _macOS_ gibt es sinnvolle Standardeinstellungen (`manager-core`, bzw. `osxkeychain`), um den systemeigenen verschlüsselten Speicher zu nutzen. -Für Nutzende von _Linux_, oder falls Sie _Multifaktor-Authentisierung_ nutzen möchten, empfiehlt sich das Hilfsprogramm [Git Credential Manager (GCM)](https://github.com/GitCredentialManager/git-credential-manager#git-credential-manager). -Unter Linux müssen Sie sich nach [Installation und Konfiguration von GCM](https://github.com/GitCredentialManager/git-credential-manager#linux) außerdem für einen [`Credential Store` entscheiden](https://github.com/GitCredentialManager/git-credential-manager/blob/main/docs/credstores.md#credential-stores), beispielsweise für SecretService, per `git config --global credential.credentialStore secretservice`. +Für Nutzende von _Linux_, oder falls Sie _Multifaktor-Authentisierung_ nutzen möchten, empfiehlt sich das Hilfsprogramm [*Git Credential Manager (GCM)*](https://github.com/GitCredentialManager/git-credential-manager#git-credential-manager). +Unter Linux müssen Sie sich nach [Installation und Konfiguration von *GCM*](https://github.com/GitCredentialManager/git-credential-manager#linux) außerdem für einen [*Credential Store* entscheiden](https://github.com/GitCredentialManager/git-credential-manager/blob/main/docs/credstores.md#credential-stores), beispielsweise für *SecretService*, per `git config --global credential.credentialStore secretservice`. ##### Token sicher speichern und verwenden +Wenn die [Vorraussetzungen zum sicheren Speichern](##vorraussetzung-verschlüsselter-speicher-für-git-anmeldeinformationen) erfüllt sind und Sie ein [Token erstellt](#erstellen-eines-persönlichen-access-tokens) haben, bleiben nur zwei simple Schritte: + 1. Starten Sie von ihrem Gerät eine beliebige Git-Aktion, die eine Authentifizierung bei GitLab über HTTPS erfordert; beispielsweise Lesezugriff auf ein privates Projekt per `git pull` oder `git clone`. Achten Sie dabei darauf eine HTTPS-URL zu nutzen, die mit `https://` startet (prüfen Sie im Zweifel die eingestellte Git-Remote URL). 2. Tragen Sie bei Aufforderung ihrer Zugangsdaten ihr neues Token *anstelle ihres Passworts* ein: - Als Nutzername wählen Sie ihre HRZ-Kennung. - Als Passwort nutzen Sie die Token-Zeichenkette, die Sie beim [Erstellen](#erstellen-eines-persönlichen-access-tokens) erhalten, beispielsweise `aztGzZkCT-kGyRs1M6x1`. + - Als Nutzername wählen Sie ihre HRZ-Kennung. + - Als Passwort nutzen Sie die Token-Zeichenkette, die Sie beim [Erstellen](#erstellen-eines-persönlichen-access-tokens) erhalten, beispielsweise `aztGzZkCT-kGyRs1M6x1`. -Hier ein Screenshot des erwarteten Dialogfensters in Windows 10: +Hier ein Screenshot des erwarteten Dialogfensters von Windows 10:  diff --git a/images/dialog-win10-manager-core.png b/images/dialog-win10-manager-core.png index 047dacb36c050944ec24f777628bf174aa6656b6..77738f85c8850cc3edcc9718a98dfd626d4e607b 100644 Binary files a/images/dialog-win10-manager-core.png and b/images/dialog-win10-manager-core.png differ