Koppel je Civo API-sleutel op je Mac, één keer.
Laatst bijgewerkt Door Marcel R. G. Berger
Genereer de sleutel in het Civo-dashboard, plak hem één keer, en laat de macOS Keychain hem daarna bewaren.
Elk Civo-account begint op een Mac hetzelfde: zonder API-sleutel werkt er niets. Meestal loopt dat via de Civo CLI, die de sleutel als platte JSON in je home-map zet en het beheer verder aan jou laat. CivoCloudManager neemt dezelfde sleutel, controleert hem tijdens de onboarding tegen de Civo REST API v2 en legt hem in de macOS Keychain in plaats van in een dotfile. Beide routes staan hieronder, dan kies je zelf.
De sleutel koppelen in CivoCloudManager
-
01
Klik op het schildje in de menubalk.
Bij de eerste start zet de app een schildje in de menubalk. Eén klik start een onboarding van zes stappen. Er valt geen account aan te maken en je hoeft je nergens voor aan te melden, want de app praat rechtstreeks met Civo.
-
02
Plak de API-sleutel en valideer hem.
De sleutel gaat in een beveiligd tekstveld. Druk op ‘Valideren’ en de app belt Civo ermee voordat je verder mag, dus een typefout of een al opnieuw gegenereerde sleutel loopt hier stuk en niet drie schermen later. Een geldige sleutel wordt meteen bevestigd.
-
03
Kies je regio.
De app haalt de actuele regiolijst uit je account op en toont elke regio met het bijbehorende land. De gekozen regio wordt de standaard voor requests die er een nodig hebben. Losse requests kunnen nog steeds expliciet een andere regio aanspreken.
-
04
Selecteer de firewalls die je wilt beheren en zet per stuk een poort.
De onboarding vindt de firewalls in je account, gegroepeerd per regio, en je vinkt aan welke de menubalk mag bedienen. Elke firewall krijgt een poort, standaard 6443 voor de Kubernetes API-server. Je kunt dit overslaan en later instellen.
-
05
Zet desgewenst ‘Starten bij inloggen’ aan.
Dat registreert de app bij SMAppService, zodat het schildje na een herstart weer in de menubalk staat. Het telt als je met tijdgebonden firewalltoegang werkt, want de app moet draaien en Civo kunnen bereiken om een regel te sluiten die hij zelf heeft geopend.
Waar de Civo API-sleutel vandaan komt
De sleutel maak je in het Civo-dashboard, niet in een client. Log in, ga naar het accountgedeelte en open Security, rechtstreeks te bereiken via dashboard.civo.com/security, waar je API-sleutels staan. Civo beschrijft daar ook de rotatie: druk je op Regenerate naast een sleutel, dan wordt hij gereset, de wijziging geldt meteen en elk volgend request moet de nieuwe sleutel gebruiken. Behandel de waarde als een wachtwoord, want hij geeft volledige toegang tot je account. Twijfel je of een sleutel nog de actuele is, genereer hem dan opnieuw en plak de nieuwe waarde, in plaats van een 401 te gaan debuggen.
De CLI-route, ter vergelijking
De officiële Civo CLI bewaart sleutels onder een naam. Toevoegen doe je met civo apikey add <name> <key>, actief maken met civo apikey current <name>, en wat je hebt zie je met civo apikey list. Alles belandt in een bestand .civo.json in je home-map, samen met instellingen als de regio. Het pad verplaats je met de omgevingsvariabele CIVO_CONFIG of met de vlag --config. Voor CI/CD en scripting is dit het juiste gereedschap, en het mag hardop gezegd: de CLI gaat beter om met meerdere accounts naast elkaar dan de app. Wat hij niet doet, is de sleutel beschermen met meer dan bestandsrechten.
Wat er op je Mac met de sleutel gebeurt
CivoCloudManager schrijft de sleutel als generic password-item naar de macOS Keychain, alleen leesbaar zolang de Mac ontgrendeld is, nooit naar een configbestand in je home-map. Opgeslagen geheimen tonen in de app, zoals instance-wachtwoorden, databasewachtwoorden en secret access keys van object stores, gaat via Touch ID met LocalAuthentication. Je Civo-sleutel gaat naar één host, api.civo.com, de Civo REST API v2. Er zit geen server van de uitgever in dat pad en de app verzamelt geen telemetrie. Hij draait in de App Sandbox met vier entitlements: sandbox, uitgaande netwerkclient, door de gebruiker gekozen bestanden lezen en schrijven voor exports, en app-scoped bladwijzers. Eén eerlijke voetnoot: om een firewall te openen voor je huidige adres moet de menubalk je publieke IP kennen, en dat vraagt hij aan een publieke IP-echodienst. Dat request bevat geen Civo-inloggegevens.
Dezelfde sleutel komt bij de Kubernetes-API, dus kubectl is optioneel
Je API-sleutel haalt de kubeconfig van het cluster bij Civo op, en in die kubeconfig zit de echte Kubernetes-toegang. De app leest de kubeconfig in Swift, importeert het PEM-certificaat en de private sleutel met SecItemImport, koppelt ze met SecIdentityCreate en opent mTLS met clientcertificaat vanuit URLSession. Geen kubectl, geen openssl, geen extern proces. De CA uit de kubeconfig is het enige vertrouwensanker voor die verbinding, dus een verkeerde host, een vreemde CA of een verlopen leaf-certificaat komt er niet doorheen. Pod-logs, workloads, events en node-metrics lopen over die verbinding. Je kunt de kubeconfig nog altijd als .yaml exporteren en kubectl gebruiken wanneer je dat prettiger vindt.
Je hoeft niets te kopen om de sleutel te gebruiken
Firewallbeheer vanuit de menubalk blijft voor altijd gratis: toegang openen en sluiten voor je huidige publieke IP, een poort per firewall, IP-presets met een naam, tijdgebonden toegang van 15 minuten, 30 minuten, één uur of twee uur, en een bulk close. Het volledige resource-dashboard is zeven dagen gratis vanaf de eerste start, daarna vraagt het een eenmalige aankoop in de Mac App Store, met delen met gezin. Geen kaart, geen abonnement, geen account aan onze kant. Vereist macOS 15 of nieuwer, Apple Silicon of Intel.
Wat mensen vragen over Civo API-sleutels
Waar vind ik mijn Civo API key?
Is het veilig om een Civo API-sleutel op mijn Mac te bewaren?
Wat gebeurt er als ik mijn Civo API-sleutel roteer of intrek?
<name> <key> gevolgd door civo apikey current <name> voor de CLI. Verder hoeft er niets mee, want de regio, de firewallselectie en de IP-presets staan apart opgeslagen. Kan ik meerdere Civo-accounts gebruiken?
<name>. Jongleer je de hele dag met accounts, houd de CLI daarvoor en gebruik de app voor het account dat je echt in de gaten houdt. Heb ik de Civo CLI nog nodig?
Handleidingen
Stap voor stap, en eerlijke vergelijkingen.
- 01 Firewall openen voor je IP De handmatige procedure, de valkuil van een wisselend IP, en een gratis route vanuit de menubalk die de regel op een deadline sluit.
- 02 vs Lens, OpenLens en k9s Drie cluster-onafhankelijke tools, één Civo-specifieke. Dat verschil bepaalt welke je open wilt hebben.
- 03 Civo Object Storage via S3 De regionale endpoint, werkende configuratie voor s3cmd, rclone en de AWS CLI, en wat een native client anders doet.
- 04 Civo DNS op de Mac Wijs een domein naar de nameservers van Civo en houd de zone daarna in een native app in plaats van in een browsertabblad.
- 05 Changelog Elke uitgebrachte release, nieuwste eerst, met het detail dat niet in een storevermelding past.
Verdieping
Gerichte verdieping per Civo-product.
Elk Civo-onderdeel dat CivoCloudManager aanraakt heeft een eigen pagina met de details, de afwegingen en de architectuur erachter. Kies het onderdeel dat het dichtst bij je dagelijkse werk ligt.
- 01 Civo CLI-alternatief voor Mac Waar de GUI wint van de CLI, waar niet, en hoe ze naast elkaar bestaan.
- 02 Civo Kubernetes GUI voor Mac Live clusterdashboard, realtime pod-logs, geen kubectl nodig.
- 03 Civo Object Storage-browser voor Mac Native S3-bestandsbrowser. Zet ongebruikte buckets op pauze in een centrale kluis.
- 04 Civo-firewall vanuit de Mac-menubalk Per firewall met een klik open of dicht, automatische IP-detectie, auto-close-timer.
- 05 Civo-kostendashboard voor Mac Echte kosten uit de Civo charges API. Periodekiezer en prognose voor het maandeinde.
- 06 Civo-regio's Welke Civo-producten in welke regio draaien, waar de GPU's staan en hoe CivoCloudManager vier regio's in één venster houdt.
De firewall in de menubalk kost niets.
Download CivoCloudManager in de Mac App Store, plak je sleutel één keer, en open of sluit firewalltoegang voor je huidige IP vanuit de menubalk, gratis en zonder aankoop.