Permissions et héritage

GitBook dispose d'un modèle d'autorisations flexible qui vous permet d'avoir autant, ou aussi peu, de contrôle sur les autorisations que vous le souhaitez. Le modèle d'autorisations 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, vous décidez si vous souhaitez hériter de ces valeurs par défaut ou non.

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 autorisations 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 pouvez définir le type d'héritage que vous souhaitez. 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 dans le contenu du niveau parent. Pour les espaces ou collections de niveau supérieur, ce parent est l'organisation, donc ils hériteraient 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 à un rôle spécifique

Sélectionner un rôle spécifique lors de la définition de l'héritage des autorisations d'une collection ou d'un espace réinitialisera les rôles par défaut de l'organisation et attribuera chaque 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 à tous sauf aux administrateurs et à la personne ayant 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 autorisations de son parent.

Définir des autorisations spécifiques au contenu

Une fois que vous avez décidé de l'héritage des autorisations 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 s'assurer que les bonnes personnes ont accès au bon contenu ; chaque fois que quelqu'un est ajouté ou retiré d'une équipe, il gagnera ou perdra, respectivement, les autorisations définies sur le contenu.

Donner 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 autorisations. Lorsque vous donnez un accès direct à des membres individuels à une collection ou un espace, vous remplacez toutes les autorisations héritées qu'ils pourraient avoir. L'accès direct aux membres est idéal si vous avez besoin d'un contrôle très spécifique sur les collaborateurs.

Garder le contrôle des autorisations

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

Définir et oublier

Si vous souhaitez simplement intégrer vos coéquipiers et éditer du contenu avec eux, alors vous n'aurez peut-être jamais besoin de regarder les autorisations. 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. Pas besoin de se compliquer la vie !

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

Pour les grandes organisations, 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 ; alors se plonger dans les détails est exactement ce qu'il faut. 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 gardent maître de la situation.