Hetzner-Projekt verbinden
Projekte auf deinem Gerät sind kostenlos. Ein Projekt mit deinem Team zu verbinden ist Teil von Vaicoa Pro und Vaicoa Team.
Die Vaicoa-App liest ein Hetzner-Cloud-Projekt über ein einziges read-only API-Token. Füg das Projekt auf deinem Gerät hinzu, um seine Ressourcen und Kosten ohne Konto zu sehen. Oder verbinde es mit deinem Team: Dann liest Vaicoa es weiter, während die App geschlossen ist, mit Historie und Alarmen.
Ein read-only Token erstellen
Abschnitt betitelt „Ein read-only Token erstellen“- Öffne in der Hetzner Console das Projekt.
- Geh zu Security → API tokens und erzeuge ein Token mit der Berechtigung Read.
- Kopier das Token. Hetzner zeigt es nur einmal.
Ein Token gilt für ein Projekt. Vaicoa liest nur und braucht deshalb nie ein Token mit Schreibrechten.
Auf deinem Gerät oder mit deinem Team verbunden
Abschnitt betitelt „Auf deinem Gerät oder mit deinem Team verbunden“| Auf deinem Gerät | Mit deinem Team verbunden | |
|---|---|---|
| Voraussetzung | nichts, kein Konto (Gerätemodus) | Pro oder Team und die Rolle Administrator |
| Wie viele | beliebig viele | die Grenze deines Plans |
| Das Token | im Schlüsselbund des iPhones, nie an Vaicoa gesendet | verschlüsselt auf den Servern von Vaicoa, nie wieder angezeigt |
| Gelesen | von der App, solange sie geöffnet ist | von Vaicoa alle 5 Minuten, auch bei geschlossener App |
| Wer es sieht | dieses Gerät | jedes Teammitglied |
Ein Projekt auf deinem Gerät hinzufügen
Abschnitt betitelt „Ein Projekt auf deinem Gerät hinzufügen“Einstellungen → Auf diesem Gerät → Hetzner-Projekt hinzufügen. Solange das Gerät noch kein Projekt hat, bietet auch das Dashboard Hetzner-Projekt hinzufügen an. Trag unter Projektname einen Namen ein, füg das Token ein, tipp auf Token prüfen und dann auf Hinzufügen. Bist du als Team-Admin angemeldet, beginnt das Formular mit Hinzufügen zu: Lass es auf Dieses Gerät.
Projekte über iCloud synchronisieren in den Einstellungen (standardmäßig aus) bringt sie auch auf deine anderen iPhones.
Token prüfen fragt Hetzner auch, ob das Token schreiben kann. Kann es das, warnt die App „Token funktioniert, hat aber SCHREIBRECHTE“, lässt dich das Token aber trotzdem hinzufügen. Erstell stattdessen ein read-only Token.
Ein Projekt mit deinem Team verbinden
Abschnitt betitelt „Ein Projekt mit deinem Team verbinden“Nur Team-Admins können ein Projekt verbinden. In der App können Mitglieder Projekte nur auf ihrem eigenen Gerät hinzufügen.
- Öffne im Portal Hetzner-Projekte und klick auf Projekt hinzufügen.
- Trag unter Projektname einen Namen ein und füg das Token in Read-only API-Token ein.
- Klick auf Projekt verbinden. Das Portal prüft das Token bei Hetzner und lehnt es ab, wenn Hetzner es zurückweist oder wenn es schreiben kann.
Du kannst ein Projekt auch aus der App verbinden: Stell im Formular zum Hinzufügen Hinzufügen zu auf dein Team. Um ein Projekt zu verschieben, das schon auf deinem Gerät ist, geh zu Einstellungen → Auf diesem Gerät, wisch das Projekt nach rechts und tipp auf Verbinden. Das Token wandert zu Vaicoa, du musst es also nicht noch einmal eingeben. Die Kopie auf deinem Gerät wird gelöscht, sobald die Übertragung geklappt hat.
Ein Token ersetzen, ohne die Historie zu verlieren
Abschnitt betitelt „Ein Token ersetzen, ohne die Historie zu verlieren“So rotierst du ein Token oder reparierst eins, das nicht mehr funktioniert:
- Erstell in der Hetzner Console ein neues read-only Token.
- Öffne im Portal Hetzner-Projekte und klick beim Projekt auf das Schlüsselsymbol, API-Token ersetzen.
- Füg das Token in Neues read-only API-Token ein und klick auf Token ersetzen. Die Synchronisation läuft innerhalb einer Minute weiter.
- Lösch das alte Token in der Hetzner Console.
Das Projekt behält seine ID, Kostenhistorie und Ereignisse bleiben also erhalten. Trenn und verbinde es nicht stattdessen neu: Projekt trennen entfernt seine synchronisierten Daten aus Vaicoa. Nur Admins können ein Token ersetzen, und nur im Portal.
Wenn das Token eines Projekts nicht mehr funktioniert
Abschnitt betitelt „Wenn das Token eines Projekts nicht mehr funktioniert“Lehnt Hetzner das Token eines verbundenen Projekts bei drei Synchronisationen in Folge ab, über etwa zehn Minuten, markiert Vaicoa das Token als entzogen oder ungültig. Fast immer heißt das, dass jemand das Token in der Hetzner Console entzogen oder rotiert hat.
Ab dann wird das Projekt nicht mehr synchronisiert:
- Die App zeigt im Dashboard Token entzogen oder ungültig – im Portal ersetzen. Das Projekt behält seinen letzten synchronisierten Stand, und seine Zeile zeigt Token entzogen oder ungültig.
- Das Portal zeigt „Token ungültig“ auf der Karte Cloud-Projekte im Team-Dashboard und unter Hetzner-Projekte einen Hinweis, der das Projekt nennt.
- Die Admins des Teams bekommen dazu eine E-Mail.
So behebst du es: Ersetz das Token. Das können nur Admins; Mitglieder sehen „Frag ein Teammitglied mit Admin-Rechten, das Token zu ersetzen.“
Funktioniert das Token eines Projekts auf deinem Gerät nicht mehr, zeigt das Dashboard einen Fehler mit In Einstellungen beheben. Entferne das Projekt dort und füg es mit einem neuen Token wieder hinzu.