Permissions et héritage

GitBook dispose d'un modèle de permissions flexible qui vous permet d'avoir autant, ou aussi peu, de contrôle sur les permissions que nécessaire. Le modèle de permissions dans GitBook est un modèle basé sur les rôles, en cascade . Cela signifie que vous définissez des valeurs par défaut puis, à n'importe quel niveau de contenu, décidez d'hériter ou non de ces valeurs par défaut.

Rôles par défaut de l'organisation

Lorsque vous ajoutez un membre à votre organisation, vous définissez son rôle par défaut. Ce rôle s'applique à tout contenu qui hérite de ses permissions des valeurs par défaut de l'organisation.

Gestion de l'héritage

À chaque fois que vous créez une collection ou un espace, vous pourrez définir le type d'héritage souhaité. Vous avez trois grandes options lors de la définition de l'héritage pour un contenu :

Hériter

Définir l'héritage sur hériter fera en sorte que l'espace ou la collection hérite des rôles attribués au contenu du niveau parent. Pour les espaces ou collections de premier niveau, ce parent est l'organisation, ils hériteraient donc des rôles par défaut de l'organisation. Pour les espaces ou sous-collections à l'intérieur d'une collection, le parent sera la collection dans laquelle se trouve le contenu.

Accès par rôle spécifique

Sélectionner un rôle spécifique lors de la définition de l'héritage des permissions d'une collection ou d'un espace va réinitialiser les rôles par défaut de l'organisation et attribuer à chaque membre non administrateur ce rôle au sein de la collection ou de l'espace. Par exemple, si vous définissez l'héritage sur lecteur, tout le monde dans l'organisation aurait un accès en lecture seule à l'espace ou à la collection, quel que soit leur rôle par défaut.

Aucun accès

Vous pouvez également révoquer complètement l'accès à tout membre non administrateur de l'organisation au niveau d'un espace ou d'une collection. Cela masquera le contenu à tout le monde sauf aux administrateurs et à la personne qui a créé l'espace ou la collection.

L'option d'héritage par défaut pour tout espace ou collection nouvellement créé est hériter. Cela signifie que chaque fois qu'un contenu est créé, il héritera par défaut des permissions de son parent.

Définir des permissions spécifiques au contenu

Une fois que vous avez décidé de l'héritage des permissions pour votre espace ou collection, vous pouvez personnaliser davantage l'accès en donnant aux équipes ou aux membres un accès direct.

Donner un accès direct à une équipe

Vous pouvez ajouter une équipe directement à une collection ou à un espace avec un rôle spécifique. Cela donnera à toute personne de cette équipe l'accès spécifié au contenu.

L'accès par équipe est un excellent moyen de garantir que les bonnes personnes ont accès au bon contenu ; chaque fois qu'une personne est ajoutée à une équipe ou en est retirée, elle obtiendra ou perdra, respectivement, les permissions définies sur le contenu.

Accorder un accès direct à un membre

De la même manière que pour les équipes, vous pouvez également donner un accès direct aux membres. C'est la façon la plus granulaire de gérer les permissions. En donnant à des membres individuels un accès direct à une collection ou à un espace, vous remplacez toutes les permissions héritées qu'ils pourraient avoir. L'accès direct pour les membres est idéal si vous avez besoin d'un contrôle très précis sur les collaborateurs.

Garder le contrôle des permissions

Bien que cela puisse sembler assez complexe au départ, le modèle de permissions de GitBook vous donne le contrôle si vous en avez besoin, et se met en retrait si vous n'en avez pas besoin. Pour de nombreuses équipes, une approche définir-et-oublier de la gestion des permissions est tout ce dont elles ont besoin. Pour d'autres équipes, en particulier les organisations plus importantes, ce niveau de contrôle sur l'accès et le flux de travail est essentiel.

Définir et oublier

Si vous souhaitez simplement que vos coéquipiers s'inscrivent et modifient le contenu avec vous, vous n'aurez peut-être jamais besoin de regarder les permissions. Invitez des personnes, définissez leur rôle par défaut, et tout contenu que vous créez héritera par défaut de ces rôles. Inutile d'entrer dans les détails !

Contrôle de l'accès et du flux de travail

Pour les organisations plus grandes, les équipes qui divisent leur organisation en collections distinctes, ou les équipes qui ont besoin d'un contrôle très granulaire sur le flux de travail ; entrer dans les détails est exactement ce qui est nécessaire. En utilisant une combinaison d'héritage, de remplacement, d'accès direct par équipe et d'accès direct par utilisateur, vous pouvez créer des flux de travail et des modèles d'accès qui vous maintiennent en contrôle.