Quelle verbinden

GitHub verbinden

Fügen Sie ein feingranulares persönliches Zugriffstoken und den Namen Ihrer Organisation ein, und Costfluent importiert die nutzungsbasierten GitHub-Kosten der Organisation nach Tag, Produkt und Repository.

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.

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

  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“.

In Costfluent verbinden

  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.

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), soweit GitHub so weit zurück Nutzung meldet. Kosten kommen pro UTC-Tag in US-Dollar an, der Währung, in der GitHub abrechnet.

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.

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).

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.