組織
組織は、複数のユーザーで共有できるように1人のオーナーの下に認証情報をグループ化します。具体的には、JSON API用のAPIキーとproxy port用のproxyユーザーです。組織の認証情報によって消費された分はすべて、リクエストを実行した個人ではなく、組織のオーナーのプランに対して課金されます。
確認場所
dashboardにサインインし、サイドバーの Organizations を開きます。所属している各組織が行として表示されます。
| 列 | 表示内容 |
|---|---|
| Organization | 組織名。クリックするか、Open をクリックして組織の個別ページに移動します。 |
| Your role | Owner、Admin、またはMember |
| Members | オーナーを含む所属人数 |
| Keys | 組織が保持するAPIキーの数 |
| Created | 作成日時 |
| Actions | Open |
組織の作成
New organization をクリックし、2〜60文字の名前を入力して確定します。作成者がオーナーになります。名前に使用できる文字は英数字、スペース、および . , & + ( ) - _ ' で、最大8単語まで、Webアドレスは含められません。名前を変更する際にも同じルールが適用されます。ラテン文字(a〜z)または数字を少なくとも1文字含める必要があり、既存の組織名と重複することはできません(大文字と小文字は区別されず、ラテン文字と数字のみが比較対象となり、その他はすべて無視されます)。
組織の作成には、複数人に対応したプランが必要です。現在のプランが対応しているかどうかは、Usage & Limits の Organizations you own 行で確認できます。
ロール
ロールは3つあり、すべての組織には必ず1人のオーナーが存在します。
| ロール | 権限 |
|---|---|
| Member | 組織のAPIキーおよびproxyユーザーの作成と使用、APIキーの名前変更、組織のメンバーおよびチームの閲覧 |
| Admin | Memberの全権限に加え、ユーザーの追加と削除、ロールの変更、組織の全認証情報の管理、組織名の変更 |
| Owner | Adminの全権限に加え、組織の所有権の他者への譲渡。組織の全認証情報の請求先となるプランを保持します。 |
オーナーを削除すること、脱退させること、降格させることはできません。所有権の移動は譲渡による一方向のみです。
組織に所属することで、その認証情報へのアクセス権が付与されます。管理権限のないメンバーであっても、会社負担となるキーやproxyユーザーを作成できます。これは意図された動作です。コレクターを作成する開発者が個人の認証情報を使用し、会社ではなく個人に請求が発生してしまう事態を防ぐためです。
組織ページ
任意の行で Open をクリックすると、その組織のページに移動します。上部に6つのカードが表示されます: Members(下にオーナー、admin、memberの内訳を表示)、Your role、Owner、API keys、Proxy users、Teams。その下には2つのタブがあります。
- Members: 組織内のユーザー、および各自のロールに応じた操作機能。
- Teams: この組織内で所属しているチーム(読み取り専用)。
オーナーと管理者は、ページヘッダーの Rename ボタンも利用できます。
ユーザーの追加
オーナーと管理者は、Membersテーブルの上にAdd a memberカードが表示されます。メールアドレスを入力し、MemberまたはAdminを選択して送信してください。
その後の処理はアドレスによって異なり、ダッシュボードにその結果が表示されます。
- アドレスにすでにFourAアカウントがある場合: 即座に参加となり、組織名、追加したユーザー、そのロールで実行可能な操作が記載されたメールが届きます。
- アドレスのアカウントがない場合: FourAから招待メールが送信され、そのアドレスでサインインした瞬間に参加となります。リンクをクリックする必要はなく、新規登録でも未アクセスの既存アカウントでも招待は機能します。
招待の有効期限は14日間です。同じアドレスを再度追加しても招待が重複することはありません。FourAは、同一アドレスおよび同一組織に対して24時間に1通の招待を送信します(取り消された招待もカウントされます)。この期間内の再試行は**We already sent an invitation to this address today. Try again tomorrow.**として拒否されますが、送信済みの招待は有効なままです。各ユーザーは、所属するすべての組織を合わせて24時間に20件の招待を送信できます。
新しく参加したユーザーがオーナーのクレジットを消費するため、誰かが参加するたびにオーナーへメールが届きます。自身のアクションに対する確認メールは送信されません。
保留中の招待
1件以上の未承認の招待がある場合、オーナーと管理者に表示されるInvitationsテーブルがMembersの上に配置されます。アドレス、割り当て予定のロール、招待者、日時が一覧表示されます。期限切れの招待もマーク付きで表示されたまま残るため、参加しなかった理由を確認できます。行のアクションを使用して招待を取り消すことができます。
ロールの変更
オーナーと管理者は、Role列のドロップダウンを使用してメンバーをMemberとAdminの間で変更できます。3つのルールがあります。
- 自身のロールは変更できません。他の管理者に依頼するか、脱退してください。
- ここではオーナーのロールを編集できません。代わりにMake ownerを使用してください。
- すべての変更で事前に確認が求められ、変更後にそのユーザーが実行できる操作が表示されます。
メンバーの削除と組織の脱退
オーナーと管理者の画面では、自身とオーナー以外のすべての行にRemoveが表示されます。自身の行には代わりにLeaveが表示されますが、オーナーである場合はCarries the billingと表示されます。
ユーザーを削除すると組織のチームからも外されるため、組織の認証情報は即座に参照できなくなります。認証情報自体には影響しません。組織のキーやproxyユーザーは、作成者ではなく組織に属します。
オーナーは削除することも脱退することもできません。先に組織を譲渡してください。
組織の譲渡
この操作を実行できるのはオーナーのみです。Membersタブで引き継ぐユーザーのMake ownerをクリックし、確認します。
組織はそのユーザーのプランへ移行します。その瞬間から、組織のキーによるすべてのrequestおよびproxyユーザーが開くすべてのトンネルは、引き継ぎ先のクレジット、トラフィック、制限、請求にカウントされます。前オーナーは管理者となり、管理者が実行可能なすべての権限を維持します。
表示されるキー
組織が所有するすべてのキーは、組織内の全員に表示されます。権限によって可能な操作が異なります。
| アクション | Member | Admin | Owner |
|---|---|---|---|
| キーの使用、表示、新しい組織キーの作成 | はい | はい | はい |
| 名前の変更、説明の編集 | はい | はい | はい |
| 再生成、無効化、削除 | いいえ | はい | はい |
| 組織外へのキーの移動 | いいえ | いいえ | はい |
キーの名前変更による影響はありません。一方、キーの再生成や無効化は、実行した瞬間にそれを使用している同僚全員の処理を停止させるため、これらの操作は管理者権限となっています。キーの組織外への移動は、会社の資産を持ち出して使用量を移行先のアカウントのプランに付け替える操作となるため、Ownerのみに制限されています。
詳細な手順については、Managing API Keysを参照してください。
表示されるProxy User
proxy userも同様の理由から、同じ3つの権限レベルに従います。
| アクション | Member | Admin | Owner |
|---|---|---|---|
| 使用、パスワードの確認、新規作成 | はい | はい | はい |
| 新しいパスワードの設定、無効化、削除、保存されたターゲティングの変更 | いいえ | はい | はい |
| 組織外への移譲 | いいえ | いいえ | はい |
保存されたターゲティングの変更がMemberではなくAdminに制限されているのは、接続先を変更すると、その認証情報を使用している組織全体の全接続先が暗黙的に変更されるためです。新しいパスワードの設定も同様に、その認証情報が設定されているすべての構成ファイルを破損させるため制限されています。
会社のダウンローダーには、組織のproxy userを使用してください。個人の認証情報を使用した場合、その担当者が退職した時点で動作が停止し、請求もその個人に対して発生します。手順については、Proxy Usersを参照してください。
Ownerフィルター
組織に参加すると、Overview、Metrics、Activity、API Keys、Proxyの上にOwnerドロップダウンが表示されます。オプションには、Everything、Personal、および組織ごとのエントリーの3種類があります。選択内容はセッション間で保持され、これら5つのページすべてに適用されます。
Usage & LimitsおよびBillingには、意図的にこのフィルターが適用されません。これらは「何が見えるか」ではなく「誰に請求されるか」を示すページであり、メンバーにOwnerのクォータが表示されることはありません。
請求の帰属
組織所有のキーで行われたすべてのrequest、および組織所有のproxy userで確立されたすべてのトンネルは、実行者に関係なく組織のOwnerに請求されます。これこそが認証情報を組織に移す理由です。クレジット、トラフィック、プラン上限、請求書の集計先を切り替えることができます。
OwnerのUsage & Limitsページでは、API keysタブとProxy usersタブで個人の認証情報とともに組織の認証情報が集計され、支出の内訳が明確に把握できるように両者が分割表示されます。
チーム
すべての組織には、Everyoneというデフォルトのチームが用意されています。新しいキーは自動的にこのチームに分類され、組織に参加した全員がここに追加されるため、メンバーシップによってキーへのアクセスが可能になります。
Teamsタブには、所属するチーム、各チームでのロール、メンバー数、使用可能なキー(使用可能なキー)が表示されます。チームの作成および編集機能は、現在ダッシュボードには実装されていません。
関連ドキュメント
- APIキーの管理: 組織内でのキーの作成、移行、管理
- プロキシユーザー: 組織内でのプロキシユーザーの作成と移行
- 使用状況と制限: チームメンバー、組織、およびプランの許容量
- 請求とサブスクリプション: オーナーのプランにおける組織キー使用量の適用範囲
- ダッシュボードの概要: すべてのダッシュボードセクション