# GitHub verbinden

Costfluent liest Ihre Ausgaben für GitHub aus dem Nutzungsbericht der Organisation, mit einem
feingranularen persönlichen Zugriffstoken, das Sie dafür anlegen. Eine Verbindung ist eine
GitHub-Organisation, mit allem, was GitHub ihr nach Nutzung berechnet: Actions, Packages, Git LFS,
Codespaces, Copilot und gemeinsam genutzter Speicher.

## Wie Costfluent verbindet

Sie geben Costfluent das Token und den Namen der Organisation. Costfluent speichert beides
verschlüsselt und verwendet das Token für eine Art von Abfrage: den Nutzungsbericht der
Organisation für einen UTC-Tag, aus der Abrechnungs-API von GitHub. An der Organisation erkennt
Costfluent die Verbindung, und das Token wird nur für diese Verbindung verwendet. Ein
Enterprise-Konto verbindet jede seiner Organisationen einzeln.

:::caution
Lesezugriff auf „Administration“, den der Abrechnungsbericht braucht, lässt das Token auch die
Einstellungen der Organisation lesen, ändern kann es aber nichts. Legen Sie das Token nur für Costfluent
an, damit Sie es widerrufen können, ohne etwas anderes zu berühren.
:::

## Voraussetzungen

1. Die Organisationsrolle Eigentümer oder Integrationsverantwortliche Person in Costfluent.
2. Ein Owner der GitHub-Organisation, der das Token anlegt: Ein Token liest die Abrechnung nur,
   solange sein Inhaber Owner der Organisation ist.
3. Die Organisation auf der erweiterten Abrechnungsplattform von GitHub (enhanced billing platform).
   Nur für Organisationen darauf liefert GitHub den Nutzungsbericht.

## Verbinden

### Token auf GitHub anlegen

<Stepper>

1. Öffnen Sie, angemeldet als Owner der Organisation, die „Settings“ Ihres Kontos, dann „Developer
   settings“, „Personal access tokens“, „Fine-grained tokens“, und wählen Sie „Generate new token“.
2. Benennen Sie es nach Costfluent, setzen Sie „Resource owner“ auf die Organisation und wählen Sie eine
   Gültigkeit.
3. Wählen Sie unter „Repository access“ „Public repositories“. Der Abrechnungsbericht braucht keine
   Repository-Berechtigung.
4. Setzen Sie unter den Organisationsberechtigungen „Administration“ auf „Read-only“ und fügen Sie keine
   weitere Berechtigung hinzu.
5. Erzeugen Sie das Token und kopieren Sie es. GitHub zeigt es nur einmal an.
6. Verlangt die Organisation eine Genehmigung für feingranulare Tokens, genehmigen Sie die Anfrage in den
   „Settings“ der Organisation unter „Personal access tokens“, „Pending requests“.

</Stepper>

### In Costfluent verbinden

<Stepper>

1. Öffnen Sie **Einstellungen**, dann **Integrationen**, wählen Sie **GitHub** und öffnen Sie den Tab
   **Verbinden**.
2. Wählen Sie **Zugriffstoken hinzufügen**, übernehmen Sie unter **Anzeigename** den vorgeschlagenen Namen oder geben Sie einen
   eigenen ein, fügen Sie das Token in
   **Persönliches Zugriffstoken** ein und geben Sie in **Organisation** den Namen der Organisation aus
   ihrer Adresse ein, `github.com/<name>`.
3. Wählen Sie **Verbindung testen**, um jede Prüfung zu sehen, oder **Verbinden**, um zu speichern.

</Stepper>

Costfluent liest mit dem Token die Nutzung der Organisation, bevor es etwas speichert. Eine
Verbindung, die sich speichern lässt, kann also Ihre Kosten lesen. Ein Token, das die Abrechnung
der Organisation nicht lesen darf, wird abgelehnt, ebenso eine Verbindung mit derselben
Organisation wie eine bestehende. GitHub unterscheidet im Namen einer Organisation nicht zwischen
Groß- und Kleinschreibung, Costfluent daher auch nicht.

## Daten und Aktualität

Beim Verbinden werden Kosten so weit zurück importiert, wie der rückwirkende Import Ihres Plans reicht,
höchstens sechs Monate ([Verbindungen verwalten](/de/connect/manage-connections#wie-es-sich-verhält)),
soweit GitHub so weit zurück Nutzung meldet. Kosten kommen pro UTC-Tag in US-Dollar an, der
Währung, in der GitHub abrechnet.

:::note
Spätere Synchronisierungen lesen die jüngsten Tage erneut, sodass ein Tag, dessen Nutzung GitHub
nachträglich ändert, aktualisiert wird. Die abgerechneten Kosten sind der Nettobetrag von GitHub:
der Bruttobetrag abzüglich der Nutzung, die Ihr GitHub-Plan enthält und die GitHub als Rabatt
ausweist. Der Bruttobetrag sind die Listenkosten. Nutzung innerhalb dessen, was Ihr Plan enthält,
hat daher Listenkosten und abgerechnete Kosten von null.
:::

:::note
Die API von GitHub meldet die Nutzung nur nach Produkt, SKU und Repository. Kosten pro Person oder
pro Workflow gibt es nicht: GitHub nennt sie nur im detaillierten Nutzungsbericht, den es per
E-Mail verschickt.
:::

## Berichtsdimensionen

- **Unterkonto** ist die Organisation.
- **Dienst** ist das GitHub-Produkt, unter dem die Nutzung abgerechnet wird, etwa Actions,
  Codespaces oder Copilot.
- **Dienstkategorie** ist AI and Machine Learning für Copilot, mit der **Dienstunterkategorie**
  Generative AI, und Developer Tools für jedes andere Produkt.
- **SKU** ist die SKU von GitHub für das, was genutzt wurde.
- **Ressource** ist das Repository, zu dem die Nutzung gehört. Eine Gebühr für die Organisation als
  Ganzes, etwa ein Copilot-Platz, hat keines.
- Das Rechnungskonto ist die Organisation, und der Abrechnungszeitraum ist der UTC-Kalendermonat.

## Aktualisieren oder trennen

### Nach dem Verbinden

Der Tab **Verwalten** listet die Verbindung unter ihrem Anzeigenamen, mit ihrer GitHub-Organisation.
Über das Zahnrad daneben sehen Sie, ob die Nutzung noch lesbar ist, welche Workspaces die Verbindung
speist und welche Monate importiert wurden. **Prüfungen ausführen** führt die Prüfungen auf Anfrage
erneut aus.

### Zugriff rotieren oder entfernen

GitHub rotiert das Token nicht für Sie. Läuft es ab oder verlässt sein Inhaber die Organisation,
stoppt die Erfassung, bis Sie ein neues einfügen. Legen Sie vorher auf dieselbe Weise ein neues Token an,
wählen Sie auf der Verbindungsseite **Zugangsdaten aktualisieren** und fügen Sie es mit dem Namen derselben
Organisation ein; löschen Sie danach das alte Token unter „Fine-grained tokens“. Eine andere
Organisation wird abgelehnt.

Um die Verbindung aufzugeben, entfernen Sie sie in Costfluent und löschen Sie ihr Token auf GitHub. Das
Entfernen löscht die von ihr importierten Kosten
([Verbindung entfernen](/de/connect/manage-connections#verbindung-entfernen)).

## Fehlerbehebung

- **GitHub refused this token.** Die Meldung erscheint auch in der deutschen Oberfläche auf
  Englisch. Das Token ist falsch, abgelaufen oder widerrufen, oder sein Resource owner ist nicht die
  Organisation. Legen Sie ein feingranulares persönliches Zugriffstoken an, dessen Resource owner die
  Organisation ist, und fügen Sie es ein.
- **This token may not read the billing of organization …** Dem Token fehlt die
  Organisationsberechtigung „Administration“ mit Lesezugriff, sein Inhaber ist kein Owner der
  Organisation, oder die Organisation verlangt eine Genehmigung für feingranulare Tokens und hat es
  noch nicht genehmigt. Geben Sie ihm die Berechtigung, prüfen Sie die Rolle seines Inhabers und genehmigen Sie die
  offene Anfrage.
- **GitHub found no billing usage for organization …** Der Name der Organisation ist falsch, der
  Resource owner des Tokens ist eine andere Organisation, oder die Organisation ist noch nicht auf
  der erweiterten Abrechnungsplattform von GitHub, die der Nutzungsbericht braucht.
- **A GitHub organization's name is the one in its address, `github.com/<name>`: letters, digits and
  single hyphens, at most 39 characters.** Das Eingegebene ist nicht der Name der Organisation, zum
  Beispiel ihr Anzeigename oder die ganze Adresse. Geben Sie den Namen ein, der auf `github.com/` folgt.
- **This key belongs to another organization.** Die Meldung erscheint beim Aktualisieren der
  Zugangsdaten, auch in der deutschen Oberfläche auf Englisch: Die eingegebene
  Organisation ist nicht die, die diese Verbindung erfasst. Verbinden Sie diese Organisation als neue
  Verbindung.
