---
title: Repository verbinden
question: Wie verbinde ich mein GitLab- oder GitHub-Repository mit Diavi?
description: Mit der Forge anmelden, dem Bereich Zugriff auf die Repositories geben und das Repository wählen, an dem Diavi arbeitet.
section: start
order: 1
---
Klicken Sie auf **Weiter mit GitLab** oder **Weiter mit GitHub**: Ihre Forge bestätigt, wer Sie sind, ohne dass ein Passwort anzulegen wäre. Der Zugriff auf die Repositories läuft über das Token des Bereichs, das der Inhaber einmal hinterlegt; jedes Mitglied arbeitet danach damit, ohne sein eigenes anzugeben.

## Wie melde ich mich an?

- **Mit Ihrer Forge** (empfohlen): ein Klick, und GitLab oder GitHub bestätigt Ihre Identität. Für eine selbst gehostete GitLab-Instanz klappen Sie das optionale Feld auf und geben deren URL an, mit `https://`.
- **Mit E-Mail-Adresse und Passwort**: festzulegen unter **Einstellungen → Anmeldung und Sicherheit**, nachdem Sie sich einmal mit Ihrer Forge angemeldet haben. Praktisch dort, wo die Forge nicht für alle offen ist.
- **Mit einem persönlichen Token**: nur, solange Ihre Instanz noch keine Anmelde-Anwendung hinterlegt hat. Es belegt Ihre Identität einmal und wird danach nicht aufbewahrt.

## Welche Rechte braucht das Token des Bereichs?

Das Minimum, um ein Issue zu lesen, das Repository zu klonen und einen Merge Request zu öffnen.

- **GitLab**: die Scopes `api` und `read_user`.
- **GitHub**: der Scope `repo`.

Es wird unter **Einstellungen → Forge** hinterlegt und vor dem Speichern gegen Ihre Forge geprüft: Ist es abgelaufen oder fehlt ein Scope, erfahren Sie es sofort und nicht erst beim ersten fehlgeschlagenen Run.

## Kann jemand das Token wieder auslesen?

Nein, und das ist Absicht. Es ist in der Datenbank verschlüsselt, und keine Oberfläche zeigt es erneut an — weder Ihre noch die Konsole von Diavi. Wenn Sie es verlieren, erzeugen Sie auf Ihrer Forge ein neues und ersetzen es; es gibt keine Wiederherstellung, nur einen Austausch. Diavi warnt Sie, wenn es das von Ihnen festgelegte Alter erreicht, und sobald die Forge es ablehnt.

## Und wenn die Person geht, die das Token hinterlegt hat?

Mit einem persönlichen Token hängt der Bereich von dieser Person ab: Verlässt sie das Team oder läuft ihr Token ab, stoppen die Runs. Hinterlegen Sie auf GitLab besser ein **Gruppen-Zugriffstoken** (oder Projekt-Token): Es handelt im Namen eines Bots, der niemandem gehört, und Diavi erkennt es selbst — der Bildschirm zeigt „Token des Bots“. Installieren Sie auf GitHub die **Diavi-Anwendung** in Ihrer Organisation unter **Einstellungen → Forge**, sobald sie angeboten wird: Ihr Token erneuert sich selbst. Anmeldungen von Mitgliedern ersetzen keines von beiden.

## Und danach?

Nach der Anmeldung sieht Diavi die Projekte, auf die das Token des Bereichs Zugriff gibt. Sie wählen beim Start, auf welchem Sie einen Run starten — nichts ist auf ein einziges Repository festgelegt.