権限と継承

GitBook には柔軟な権限モデルがあり、必要に応じて権限を大きくも小さくも制御できます。GitBook の権限モデルは 役割ベースのカスケード型の モデルです。つまり、デフォルト値を設定し、その後コンテンツのどの階層でも、そのデフォルトを継承するかどうかを決められます。

組織のデフォルト役割

組織にメンバーを追加するときに、 そのメンバーのデフォルト役割を設定します。この役割は、権限を組織のデフォルトから継承するあらゆるコンテンツに適用されます。

継承の管理

コレクションやスペースを作成するたびに、希望する継承の種類を設定できます。コンテンツの継承を設定する際には、大きく3つの選択肢があります。

継承する

継承を 継承 に設定すると、スペースまたはコレクションは、 親レベルのコンテンツで割り当てられた役割を継承します。最上位のスペースやコレクションの場合、この親は組織なので、組織のデフォルト役割を継承します。コレクション内のスペースやサブコレクションの場合、親はそのコンテンツが属するコレクションになります。

特定の役割へのアクセス

コレクションまたはスペースの権限継承を設定するときに特定の役割を選ぶと、 リセットし て組織のデフォルト役割を無効にし、コレクションまたはスペース内のすべての 管理者以外 にその役割を割り当てます。たとえば、継承を 閲覧者に設定すると、デフォルトの役割に関係なく、組織の全員がそのスペースまたはコレクションに読み取り専用でアクセスできるようになります。

アクセスなし

スペースまたはコレクションのレベルで、管理者以外の組織メンバーのアクセスを完全に取り消すこともできます。これにより、管理者と、そのスペースまたはコレクションを作成した人以外にはコンテンツが表示されなくなります。

新しく作成されたスペースまたはコレクションのデフォルトの継承オプションは 継承です。つまり、コンテンツが作成されるたびに、デフォルトで親から権限を継承します。

コンテンツ固有の権限の設定

スペースまたはコレクションの権限継承を決めたら、チームやメンバーに 直接アクセス.

チームに直接アクセスを付与する

特定の役割を付けて、チームをコレクションやスペースに直接追加できます。これにより、そのチームの全員に、指定したアクセス権がそのコンテンツに対して付与されます。

チームアクセスは、適切な人が適切なコンテンツにアクセスできるようにする優れた方法です。誰かがチームに追加または削除されるたびに、そのコンテンツに設定された権限を、それぞれ取得または失います。

メンバーに直接アクセスを付与する

チームと同様に、メンバーにも直接アクセスを付与できます。これは権限を管理するうえで最も細かい方法です。個々のメンバーにコレクションやスペースへの直接アクセスを付与すると、それまでに持っていた継承済みの権限は上書きされます。共同編集者に対して非常に細かな制御が必要な場合、メンバーへの直接アクセスは非常に有効です。

権限を常に把握する

最初はかなり複雑に見えるかもしれませんが、GitBook の権限モデルは、必要なときには制御でき、不要なときには前に出ません。多くのチームにとっては、 設定したらあとは放置する 権限管理のアプローチだけで十分です。別のチーム、特に大規模な組織では、アクセスとワークフローをここまで制御できることが不可欠です。

設定したら放置

チームメンバーを参加させて一緒にコンテンツを編集できればよいだけなら、権限をまったく確認しないままでも問題ないかもしれません。人を招待し、デフォルト役割を設定すれば、作成するすべてのコンテンツはこれらの役割を継承するのが既定になります。細かい設定まで気にする必要はありません。

アクセスとワークフローの制御

大規模な組織、組織を個別のコレクションに分けるチーム、あるいはワークフローを非常に細かく制御する必要があるチームにとっては、細部まで踏み込むことこそが必要です。継承、上書き、チームへの直接アクセス、ユーザーへの直接アクセスを組み合わせることで、制御を維持しながらワークフローとアクセスモデルを作成できます。