Apidog では、組織は複数のチームおよびメンバーを一元管理するために使用されます。組織を使用すると、権限の制御、ロールの割り当て、社内全体での効率的なコラボレーションを実現できます。組織の作成#
1 つ以上の組織を作成できます。新しい組織を作成するには、次の手順に従います。1.
メインウィンドウで、左側のナビゲーションパネルから Organizations をクリックし、組織管理ページを開きます。
2.
左下の + New Organization ボタンをクリックします。
4.
Create をクリックします。これで新しい組織のセットアップが完了します。
組織のメンバーとロール#
メンバーを組織に招待し、異なるロールを割り当てることができます。Org Admin: 最も高い権限を持ちます（組織の所有者を除く）。組織のメンバー、チーム、組織設定を管理できます。
Org Member: 組織およびそのチームに参加し、プロジェクトで共同作業できます。組織設定は変更できません。
組織へのメンバー招待#
組織の所有者または管理者として、組織レベルから企業内に担当者を直接追加できます。これは、人事部門や IT 部門が入社する従業員向けにアカウントを一元配布する場合に非常に適しています。💡 前提条件:
組織への招待を送信する前に、組織には 少なくとも 1 つの作成済みチーム が必要です。そうでない場合、チームロールを割り当てる場所がありません。
メンバーを組織に招待するには、組織配下の Members に移動します。Invite をクリックすると、招待方法を選択し、それに応じて権限を付与できます。Organization Role: 一般的に、新入社員には一律で Member ロールを割り当てます。
All Team Roles: 企業に招待すると同時に、対応する下位の業務プールへ直接追加できます。すべてのチームに同じロールを一括設定することも、"Custom" をクリックして詳細を開き、「Team A には Member としてのみ参加し、Team B には未参加のままにする」といった指定を正確に行うこともできます。
2.
メール経由で招待（または一括インポート）:
チームレベルと同様に、各メールアドレスごとの個別設定 および CSV 一括インポート をサポートしていることに加え、上部の一括設定ツールを使用して、このグループのユーザーに対する Organization Role と、具体的に割り当てる Team Roles を迅速かつ一律に設定できます。
権限のカスケードとデフォルトロールのマッピング#
組織ロールとチーム／プロジェクトロールは、2 つの独立した仕組みで動作する ことを理解することが重要です。ロールを割り当てる際には、権限がどのようにカスケードするか、またはカスケードしないかを理解することが不可欠です。組織ロールとチームアクセス: 組織管理者は、会社の構造（例: チームの作成、請求管理、メンバーディレクトリの監督）に対する管理権限を持ちます。ただし、個別プロジェクト内の API データへのアクセス権が自動的に付与されるわけではありません。 プロジェクトにアクセスまたは編集するには、Org Admin であっても該当するチームまたはプロジェクトに追加される必要があります。
Team Admin → Project Editor: Team Admin として割り当てられたユーザーには、そのチーム内のすべてのプロジェクトに対する Editor 権限が自動的に付与されます。
Team Member → Project Read-Only: 標準の Team Member として割り当てられたユーザーには、デフォルトでチームのプロジェクトに対する安全な Read-Only アクセスが付与されます。
Forbidden / Unjoined: ユーザーがチームに割り当てられていない場合（または Forbidden に設定されている場合）、そのチーム内のプロジェクトアクセス権は付与されません。
注:
これらは初期のベースライン権限にすぎません。チーム内に入った後、Team Admin は実際のビジネスニーズに基づいて、プロジェクト権限を個別に調整したり、ロールをカスタマイズしたりできます。
カスタムプロジェクトロール#
カスタムロールは プロジェクトレベル のみをサポートしています。組織ロールは現在、カスタマイズをサポートしていません。
組織とチームの関係#
組織: 会社または大規模なグループを表す、最上位の管理単位です。複数のチームを管理します。
チーム: 組織内のサブ単位で、通常は部門または小規模なグループです。複数のプロジェクトを管理します。
組織とチーム — どちらを選ぶべきですか？#
Apidog を使用する際によくある質問は、すべてを 組織 の直下で管理すべきか、それとも主に チーム に依存すべきか、というものです。答えは主に、チーム規模とビジネス範囲の 2 点によって決まります。チームが小規模で集中している場合#
同じ製品ラインに取り組むメンバーが約 10 人いるとします。その場合、単一の チーム で十分です。チームは、プロジェクト、API、メンバーを 1 か所で管理できます。組織による追加の管理負荷なしに、シンプルかつ効率的に運用できます。会社が大規模で分散している場合#
多数のメンバーがいて、相互に関連しない複数の事業ラインがある場合は、まず 組織 を作成し、その中に各事業領域ごとの個別の チーム を設定するのが最適です。各チームは、自身のプロジェクトとメンバーを明確な境界のもとで管理でき、重複を避けられます。組織情報の更新#
管理者は Settings から組織名または詳細を更新できます。すべてのメンバーに更新後の情報が表示されます。組織の移管#
組織の所有者は、Organization Settings → Danger Zone → Transfer から、所有権を別のメンバーに移管できます。組織の解散#
組織の所有者は、Organization Settings → Danger Zone → Dismiss Organization から、組織を完全に削除できます。組織の解散は永続的であり、元に戻すことはできません。組織内のすべてのチームおよびプロジェクトが削除されます。
