Ephemeral のすべては、組織に属します。人はロールを持って組織に参加し、ソフトウェアはそれぞれ独自のロールを持つ組織の API キーを使います。この 2 種類のロールは別のものです。
人
| ロール | できること |
|---|---|
| オーナー | 管理者ができることすべてに加えて、ロールの変更、管理者の削除、オーナー権限の移譲。オーナーは組織に 1 人です。 |
| 管理者 | メンバーができることすべてに加えて、接続、メンバー、招待、API キー、請求、デプロイメントのライセンスの管理。 |
| メンバー | 実行の開始、閲覧、キャンセル。ファイルとワークフローの管理。名前を指定した接続の使用。 |
組織を作成した人が、その組織のオーナーになります。管理者は、管理者またはメンバーとして人を招待でき、メンバーを削除できます。管理者の削除とロールの変更ができるのは、オーナーだけです。オーナーを削除することはできません。オーナーを退くには、既存のメンバーにオーナー権限を移譲します。移譲されたメンバーがオーナーになり、あなたは管理者になります。
API キー
API キーは、その組織の代理として動作します。各キーには、作成時に選ぶ member または admin のロールがあります。キーのシークレットは 1 度だけ表示されます。サーバー上で保管し、漏えいした場合はキーを失効させてください。失効はただちに反映されます。
- 実行を開始するアプリケーションのコードには、member キーを使います。これがデフォルトです。
- admin キーは、接続の作成や変更も必要な、信頼できるセットアップ用ツールにのみ使ってください。
どちらのロールも、組織全体が対象です。member キーは読み取り専用ではなく、特定のワークフローやファイルだけに限定できるキーもありません。そのような分離が必要な場合は、組織を分けてください。
各ロールにできること
| 操作 | メンバーのユーザーまたはキー | 管理者キー | オーナーまたは管理者のユーザー |
|---|---|---|---|
| 実行の開始、閲覧、キャンセル | 可 | 可 | 可 |
| ファイルのアップロード、名前の変更、削除 | 可 | 可 | 可 |
| ワークフローの保存と削除 | 可 | 可 | 可 |
| 利用可能な接続の一覧表示と、名前を指定した使用 | 可 | 可 | 可 |
| 接続の設定の読み取りと変更、OAuth の開始 | 不可 | 可 | 可 |
| メンバー、招待、API キー、請求、ライセンスの管理 | 不可 | 不可 | 可 |
管理者キーでは組織を管理できません
ホスト型サービスでは、メンバー、招待、API キー、クレジット、デプロイメントのライセンスを管理できるのは、ログインしているオーナーまたは管理者だけです。これらの操作では admin の API キーは拒否されます。そのため、キーが漏えいしても、クレジットの購入、人の追加、新しいキーの発行はできません。
ホスト型とセルフホストのキー
| ホスト型サービス | セルフホストのインストール | |
|---|---|---|
| キーのプレフィックス | eak_ | eph_ |
| 作成する場所 | ダッシュボードの API キー、または組織 API | ダッシュボードのキー、または POST /v1/keys |
| キーを作成できる人 | ログインしているオーナーまたは管理者 | 管理者キー |
| 最初のキー | サインアップ後にご自身で作成 | セットアップ時のブートストラップリクエストで発行 |
セルフホストのインストールにはカスタマーアカウントがないため、管理者キーがインストールのキーも管理します。最初のキーについてはセルフホスト、ホスト型のキーのエンドポイントについては組織をご覧ください。
ホスト型のダッシュボードでは、個人としてログインし、自分のメンバーシップのロールで操作します。ブラウザーからのリクエストでは、
X-Ephemeral-Organization ヘッダーで組織を選びます。API キーは、すでに 1 つの組織に属しています。