lizard keys

API キーを作成、一覧表示、削除します。エイリアス: lizard apikey。

使い方

lizard keys create <name> [flags]
lizard keys list
lizard keys rm <name-or-id> [flags]

API キーは liz_ で始まります。ブラウザでログインできない場所で使います:

  • CI で CLI を使うときの LIZARD_TOKEN または LIZARD_API_KEY
  • マシン上での lizard login --token liz_…
  • Lizard SDK 用の LIZARD_API_KEY
  • sandbox 内の lizard にサインインするための lizard sandbox create --with-token liz_…。sandbox 内のキーを参照

サブコマンド

lizard keys create <name>

キーを作成し、一度だけ表示します。その場でコピーしてください。Lizard は再表示しません。スコープのないキーは、アクセスできるすべてのワークスペースとプロジェクトに完全にアクセスできます。次のフラグでスコープを限定できます。どのフラグも複数回指定できます:

フラグ説明
-p, --project <id>キーをこのプロジェクトに限定(名前、スラッグ、または ID)
-w, --workspace <id>キーをこのワークスペースに限定(名前、スラッグ、または ID)

スコープを限定したキーは、そのプロジェクトまたはワークスペースの中でだけ使えます。次のことはできません:

  • 請求、プラン、カード、アカウント全体の利用量を見る
  • API キーを作成、一覧表示、削除する。そのため、このキーでは lizard keys は失敗します
  • ワークスペースを作成する、自分のワークスペースの名前を変える・削除する、ワークスペースの上限や再販価格を変える
  • ワークスペースやプロジェクトのメンバーを見る・管理する
  • サービスの参照先を非公開の GitHub リポジトリにする。ただし、スコープ内のアプリがすでにそのリポジトリからビルドしている場合は除きます

スコープを限定したキーでサインインしている場合、lizard whoami はキーのスコープを表示し、その背後のアカウントは表示しません。ワークスペースの所有者が再販価格を設定している場合、キーにはその価格が表示されます。

lizard keys list

キーを、短いプレビュー、スコープ、作成日時、最終使用日時とともに一覧表示します(エイリアス ls)。プレビューはキーの先頭部分ではないため、キーは名前か ID で見分けてください。

lizard keys rm <name-or-id>

キーを削除します(エイリアス delete)。同じ名前のキーが 2 つある場合は、ID で削除してください。

フラグ説明
-y, --yes確認をスキップ

例

CI 用のキーを作成する

lizard keys create github-actions --project my-project

表示されたキーを、LIZARD_TOKEN という名前の CI secret として保存します。

sandbox 内の lizard にサインインする

lizard sandbox create --with-token liz_xxx

sandbox には専用の新しいキーが発行されます。このキーは sandbox のプロジェクトに限定され、sandbox とともに削除されます。lizard keys list には sandbox-session:<sandbox-id> として表示されます。渡した liz_ キーはリクエストの承認に使われるだけで、sandbox には入りません。値なしの --with-token では、CLI はサインイン中のキーを使います。これは liz_ キーである必要があります。

キーを削除する

lizard keys rm github-actions --yes

関連項目

更新日