Civo API キーを Mac につなぐのは、一度だけ。

最終更新 2026年10月18日著者: Marcel R. G. Berger

Civo ダッシュボードでキーを発行し、一度貼り付ければ、あとは macOS Keychain が持っていてくれます。

Mac で Civo を使う日は、どれも同じところから始まります。API キーがなければ何も動きません。よくある道筋は Civo CLI です。キーはホームディレクトリのただの JSON ファイルに書き込まれ、その先の管理はあなたに任されます。CivoCloudManager は同じキーを受け取り、オンボーディングの途中で Civo REST API v2 に問い合わせて検証し、dotfile ではなく macOS Keychain に収めます。ここでは両方の道筋を並べます。自分に合うほうを選んでください。

CivoCloudManager でキーをつなぐ

01

メニューバーの盾を開く。

初回起動でメニューバーに盾のアイコンが出ます。クリックすると 6 ステップのオンボーディングが始まります。作るアカウントもサインアップもありません。アプリが Civo と直接話すからです。
02

API キーを貼って検証する。

キーはセキュアテキストフィールドに入れます。「検証」を押すと、先へ進む前にアプリがそのキーで Civo を呼びます。打ち間違いや再生成済みの古いキーは、3 画面先ではなくここで落ちます。有効なキーはその場で確認されます。
03

リージョンを選ぶ。

アプリはアカウントから最新のリージョン一覧を読み込み、国名を添えて並べます。選んだリージョンは、リージョンを必要とするリクエストの既定値になります。個別のリクエストで別のリージョンを明示することもできます。
04

管理するファイアウォールを選び、それぞれにポートを決める。

オンボーディングはアカウント内のファイアウォールをリージョンごとにまとめて見つけ、メニューバーから操作したいものにチェックを入れさせます。それぞれにポートが付き、既定値は Kubernetes API サーバの 6443 です。ここは飛ばして後から設定しても構いません。
05

必要なら「ログイン時に起動」をオンにする。

SMAppService にアプリを登録するので、再起動後もメニューバーに盾が残ります。時間指定のファイアウォールアクセスを使うなら効いてきます。開けたルールを閉じるには、アプリが動いていて Civo に届く必要があるからです。

Civo API キーはどこで作るのか

キーを作る場所は Civo のダッシュボードだけで、どのクライアントでもありません。サインインしてアカウント画面の Security セクションを開くと API キーが並んでいます。dashboard.civo.com/security で直接行けます。ローテーションについても Civo 自身のドキュメントが書いています。キーの横の Regenerate を押せばリセットされ、変更は即時で、以後のリクエストはすべて新しいキーを使わなければなりません。値はパスワードと同じ扱いにしてください。アカウントへの全権を持ちます。手元のキーが最新かどうか自信がないなら、401 を追いかけるより再生成して貼り直すほうが早いです。

比較のための CLI の道筋

公式の Civo CLI はキーに名前を付けて保存します。追加は civo apikey add <name> <key>、有効化は civo apikey current <name>、一覧は civo apikey list です。すべてはホームディレクトリの .civo.json に、リージョンなどの設定と一緒に置かれます。場所は CIVO_CONFIG 環境変数か --config フラグで動かせます。CI/CD とスクリプトにはこれが正解ですし、はっきり書いておきます。名前付きの複数アカウントの扱いは、アプリより CLI のほうが上です。CLI がやらないのは、ファイルパーミッション以上の保護をキーに与えることです。

キーは Mac の中でどう扱われるか

CivoCloudManager はキーを macOS Keychain の generic password 項目として書き込みます。読めるのは Mac がロック解除されている間だけで、ホームディレクトリの設定ファイルに落ちることはありません。インスタンスのパスワード、データベースのパスワード、Object Store のシークレットアクセスキーなど、保管済みのシークレットを画面に出すときは LocalAuthentication 経由の Touch ID が挟まります。Civo のキーが送られる先は api.civo.com、つまり Civo REST API v2 の一つだけです。その経路に発行元のサーバは存在せず、テレメトリも集めません。アプリは App Sandbox の中で動き、エンタイトルメントは 4 つです。sandbox、送信ネットワーククライアント、エクスポート用のユーザ選択ファイルの読み書き、app-scoped bookmark。正直に脚注を一つ置きます。現在のアドレス向けにファイアウォールを開けるには、メニューバーがパブリック IP を知る必要があり、そのために公開の IP エコーサービスへ問い合わせます。このリクエストに Civo の認証情報は乗りません。

同じキーが Kubernetes API まで届くので、kubectl は任意

API キーは Civo からクラスタの kubeconfig を取ってきます。Kubernetes へのアクセス権が実際に入っているのは、その kubeconfig です。アプリは kubeconfig を Swift で解析し、PEM の証明書と秘密鍵を SecItemImport で読み込み、SecIdentityCreate で一組にして、URLSession からクライアント証明書 mTLS を張ります。kubectl も openssl も外部プロセスも介しません。その接続の信頼アンカーは kubeconfig の CA だけなので、ホストが違っても、無関係な CA でも、リーフ証明書が期限切れでも、受理される道はありません。Pod ログ、ワークロード、イベント、ノードのメトリクスはこの接続を通ります。kubeconfig を .yaml ファイルとして書き出して、好きなときに kubectl を使うこともできます。

キーを使うために何かを買う必要はない

メニューバーのファイアウォール管理はずっと無料です。現在のパブリック IP 向けの開閉、ファイアウォールごとのポート、名前付きの IP プリセット、15 分・30 分・1 時間・2 時間の時間指定アクセス、そして一括クローズ。リソースダッシュボード一式は初回起動から 7 日間は無料で、そのあとは Mac App Store での買い切りになります。ファミリー共有に対応。カード登録もサブスクリプションもなく、こちら側にアカウントもありません。動作環境は macOS 15 以降、Apple シリコンでも Intel でも構いません。

Civo API キーについてよく聞かれること

Civo の API キーはどこで確認できますか?

Civo ダッシュボードのアカウント内、Security セクションです。dashboard.civo.com/security で直接開けます。キーはそこに並び、それぞれに Regenerate ボタンが付いています。CLI やサードパーティのアプリでキーが作られることはありません。どれもダッシュボードで発行したキーを使うだけです。

Civo の API キーを Mac に保存しても安全ですか?

保存先によります。Civo CLI はホームディレクトリの .civo.json にキーを書きます。ファイルパーミッションだけが守る平文のファイルです。CivoCloudManager は macOS Keychain の generic password 項目として書き込み、読めるのは Mac がロック解除されている間だけで、ほかの保管済みシークレットの表示には Touch ID を挟みます。どちらにしてもキーはアカウントへの全権を持つので、パスワードと同じ扱いにしてください。

Civo の API キーをローテーションしたり無効にしたりするとどうなりますか?

Civo ダッシュボードでの再生成は即時に効くので、古い値を持つクライアントは次のリクエストから失敗し始めます。直す場所は一か所です。アプリの設定に新しいキーを貼れば Keychain の項目が置き換わります。CLI なら civo apikey add <name> <key> のあとに civo apikey current <name> です。ほかに変えるものはありません。リージョン、ファイアウォールの選択、IP プリセットは別に保存されています。

Civo のアカウントを複数使えますか?

CivoCloudManager では同時には使えません。アプリが Keychain に持つ API キーは一つで、アカウントの切り替えはそのキーの置き換えになります。ここは Civo CLI のほうが優れています。名前付きのキーを複数保存し、civo apikey current <name> で切り替えられます。一日中アカウントを行き来するなら、その用途は CLI に任せて、アプリは実際に見張っているアカウントに使ってください。

Civo CLI はまだ必要ですか?

CI/CD、スクリプト、人が介在せずに走るものには必要ですし、そこは CLI の領分です。Mac での日々の作業には要りません。アプリは同じ Civo REST API v2 と話し、kubectl なしでクライアント証明書 mTLS から Kubernetes API に届き、Pod ログ、S3 のオブジェクト閲覧、コストの数字など CLI にない部分まで覆います。結局は両方を使う人が多いです。

ガイド

手順を追って、そして率直な比較を。

詳細解説

Civo のプロダクトごとに、掘り下げた解説を。

CivoCloudManager が触れる Civo の各領域には、仕様、トレードオフ、アーキテクチャの詳細をまとめた専用ページがあります。いまの仕事に一番近いものから読んでください。

メニューバーのファイアウォールは無料です。

Mac App Store から CivoCloudManager をダウンロードし、キーを一度貼るだけ。現在の IP 向けのファイアウォール開閉はメニューバーから無料で使えます。購入は必要ありません。

Mac App Store からダウンロード

macOS 15 (Sequoia) 以降が必要です。

概要に戻る