Lokale Authentifizierung einrichten

Bevor Sie über Ihr System auf gehostete Repositories zugreifen oder damit interagieren können, müssen Sie die lokale Authentifizierung in Ihrer Umgebung einrichten.

Nachdem Sie die lokale Authentifizierung eingerichtet haben, können Sie auf gehostete Repositories zugreifen, für die Sie die entsprechenden Rollen und Berechtigungen haben. Sie können auch Git-Standardvorgänge wie git clone, git pull und git push ausführen. Die lokale Authentifizierung ist nicht erforderlich, um Vorgänge in der Google Cloud Console auszuführen, z. B. um den Inhalt eines Repositorys zu durchsuchen.

Cloud Source Repositories unterstützt die folgenden Authentifizierungstypen:

SSH
Google Cloud CLI
Manuell generierte Anmeldedaten

Mit SSH authentifizieren

Mit Cloud Source Repositories können Sie die SSH-Authentifizierung mit öffentlichem Schlüssel verwenden, um auf gehostete Repositories zuzugreifen. In diesem Szenario generieren Sie zuerst ein Schlüsselpaar auf dem lokalen System, von dem aus Sie auf das Repository zugreifen möchten. Dann registrieren Sie den öffentlichen Schlüssel bei Google Cloud. Wenn Sie bereits ein SSH-Schlüsselpaar auf Ihrem System haben, können Sie diese Schlüssel für die Authentifizierung wiederverwenden. Sie können pro Google-Konto bis zu 20 öffentliche Schlüssel registrieren.

Cloud Source Repositories unterstützt drei SSH-Schlüsseltypen:

RSA (nur für Schlüssel mit mehr als 2.048 Bit)
ECDSA
ED25519

Schlüsselpaar generieren

Das SSH-Schlüsselpaar besteht aus einem privaten Schlüssel, der sich auf Ihrem lokalen System befindet, und einem öffentlichen Schlüssel, den Sie bei Google Cloud registrieren.

Linux oder macOS

Sorgen Sie dafür, dass OpenSSH auf Ihrem lokalen System installiert ist.
Geben Sie an einer Eingabeaufforderung den folgenden Befehl ein:
```
ssh-keygen -t [KEY_TYPE] -C "[USER_EMAIL]"
```
Wobei:
- [USER_EMAIL] ist Ihre E-Mail-Adresse.
- [KEY_TYPE] ist einer der folgenden Werte:
  - rsa
  - ecdsa
  - ed25519
Beispiel:
```
ssh-keygen -t rsa -C "user@example.com"
```
1. Geben Sie bei entsprechender Aufforderung einen Dateinamen für die öffentliche Schlüsseldatei ein. Wenn Sie den Standardspeicherort für ~/.ssh übernehmen möchten, drücken Sie die Eingabetaste. Geben Sie andernfalls einen Dateinamen an.
2. Lassen Sie die Passphrase bei entsprechender Aufforderung leer und drücken Sie die Eingabetaste.
Schlüssel registrieren

Windows

Sorgen Sie dafür, dass PuTTY auf Ihrem lokalen System installiert ist.
Starten Sie PuTTYGen über das Windows-Startmenü.
Wählen Sie im angezeigten Fenster den Schlüsseltyp im Feld Parameters (Parameter) aus.
Klicken Sie auf Generate (Erstellen).

PuTTYGen zeigt den generierten öffentlichen Schlüsselstring an.
Geben Sie eine Passphrase an, um das Schlüsselpaar zu schützen.
Klicken Sie auf Save Public Key (Öffentlichen Schlüssel speichern) und Save Private Key (Privaten Schlüssel speichern), um das erzeugte Schlüsselpaar in Ihrem lokalen System zu speichern.

Vorhandene Schlüssel verwenden

Sie können auch ein vorhandenes Schlüsselpaar für die SSH-Authentifizierung verwenden.

Linux oder macOS

Öffentliche Schlüsseldateien befinden sich standardmäßig im Verzeichnis ~/.ssh.

Geben Sie an einer Eingabeaufforderung den folgenden Befehl ein:

ls -a ~/.ssh

Die Standarddateinamen sind:

id_rsa.pub
id_ecdsa.pub
id_ed25519.pub

Windows

Starten Sie PuTTYGen über das Windows-Startmenü.
Klicken Sie im angezeigten Fenster auf Load (Laden).
Suchen Sie im lokalen Dateisystem nach Ihrer öffentlichen Schlüsseldatei und wählen Sie die Datei aus.

PuTTYGen zeigt den öffentlichen Schlüsselstring an. Wenn Sie beim Speichern der Schlüsseldatei eine Passphrase angegeben haben, werden Sie von PuTTYGen zu deren Eingabe aufgefordert, bevor Sie den öffentlichen Schlüssel anzeigen können.

Öffentlichen Schlüssel registrieren

Öffnen Sie in der GCP Console die Seite SSH-Schlüssel verwalten.

Cloud Source Repositories öffnen
Klicken Sie auf SSH-Schlüssel registrieren.

Das Dialogfeld SSH-Schlüssel registrieren wird geöffnet.
Geben Sie im Feld Schlüsselname einen eindeutigen Namen für den Schlüssel ein.
Kopieren Sie im Feld Schlüssel den Schlüsselstring aus Ihrer öffentlichen Schlüsseldatei.
Klicken Sie auf Registrieren.

Wenn Sie die SSH-Authentifizierung eingerichtet haben, können Sie jedes Repository klonen, für das Sie die erforderlichen Rollen und Berechtigungen haben, oder den Inhalt eines lokalen Repositories in ein leeres gehostetes Repository verschieben.

Über die gcloud CLI authentifizieren

Bei Cloud Source Repositories können Sie sich über die gcloud CLI authentifizieren. In diesem Szenario führen Sie den Befehl gcloud init auf Ihrem System aus, um die lokale Authentifizierung einzurichten.

Prüfen Sie, ob die gcloud CLI auf Ihrem lokalen System installiert ist.
Führen Sie über eine Eingabeaufforderung gcloud init aus:
```
gcloud init
```
Folgen Sie der Anleitung.

Nachdem Sie die Authentifizierung mithilfe der gcloud CLI eingerichtet haben, können Sie Git-Standardbefehle verwenden, um mit dem gehosteten Repository in Cloud Source Repositories zu interagieren.

Mit manuell generierten Anmeldedaten authentifizieren

Sie können auch manuell erstellte Anmeldedaten für die Authentifizierung verwenden. Cloud Source Repositories bietet eine Reihe von Skripts, mit denen Sie manuell die Anmeldedaten generieren können, die Sie für den Zugriff auf gehostete Repositories benötigen.

Rufen Sie die Seite Configure Git (Git konfigurieren) auf, um Ihre Anmeldedaten zu generieren.

Zur Seite „Git konfigurieren“
Öffnen Sie ein Terminalfenster.
Geben Sie den folgenden Befehl ein:
```
git clone https://source.developers.google.com/p/PROJECT_ID/r/REPOSITORY_NAME
```
Wobei:
- PROJECT_ID ist der Name Ihres Projekts
- REPOSITORY_NAME ist der Name Ihres Repositorys

Nachdem Sie die Authentifizierung mit manuell generierten Anmeldedaten eingerichtet haben, können Sie mit den Git-Standardbefehlen mit dem gehosteten Repository in Cloud Source Repositories interagieren.