Paramètres du workspace
Options de collaboration et de partage
Les responsables d'équipe peuvent inviter des utilisateurs du workspace
Cette fonctionnalité est uniquement disponible pour les workspaces avec un plan Growth ou Enterprise.
Ces paramètres sont conçus pour donner aux utilisateurs non-managers la possibilité d'intégrer de nouveaux utilisateurs sur la plateforme, réduisant ainsi la charge administrative des managers du workspace.
L'activation de ce paramètre permet aux utilisateurs ayant le niveau d'accès Member d'inviter des personnes dans les équipes qu'ils dirigent. Les responsables d'équipe ne peuvent inviter de nouveaux utilisateurs qu'en les ajoutant à leurs équipes et ne peuvent pas inviter de nouveaux utilisateurs dans le workspace via la page Settings > Members.
Les utilisateurs nouvellement ajoutés se verront attribuer le niveau d'accès Member. Dès leur inscription, ils seront automatiquement ajoutés à l'équipe depuis laquelle ils ont été invités.
Ce paramètre est ON par défaut. Désactivez-le dans les paramètres de votre workspace si vous souhaitez que le privilège d'ajouter de nouveaux utilisateurs à votre workspace reste exclusif aux Managers.
Les permissions d'incident « Full access » permettent d'inviter des utilisateurs
Cette fonctionnalité est uniquement disponible pour les workspaces avec un plan Growth ou Enterprise.
De même, ce paramètre permet aux utilisateurs non-managers qui appartiennent à une équipe et disposent de la permission d'incident Full access d'inviter de nouveaux utilisateurs dans le workspace. L'objectif est de permettre aux membres d'équipe de confiance de jouer un rôle actif dans l'intégration de nouveaux utilisateurs, sans nécessiter un accès de niveau manager. Les utilisateurs disposant de la permission d'incident Full access ne peuvent inviter de nouveaux utilisateurs qu'en leur accordant l'accès à l'incident sur lequel ils disposent de la permission Full access, et ne peuvent pas inviter de nouveaux utilisateurs dans le workspace via la page Settings > Members.
Dès l'inscription :
- l'utilisateur nouvellement ajouté n'aura accès qu'à l'incident depuis lequel il a été invité
- pour éviter toute élévation de privilèges, le niveau d'accès du nouvel utilisateur sera le même que celui de la personne qui lui a accordé l'accès à l'incident :
- Si l'accès a été accordé par un utilisateur
Restricted, le nouvel utilisateur aura le niveau d'accèsRestricted. - Si l'accès a été accordé par un utilisateur
Member, le nouvel utilisateur aura le niveau d'accèsMember. - Si l'accès a été accordé par un utilisateur
Manager, le nouvel utilisateur aura le niveau d'accèsMembercar nous considérons que le niveau d'accès hautement privilégiéManagerne peut être attribué que spécifiquement sur la page Settings > Members.
- Si l'accès a été accordé par un utilisateur
Ce paramètre est ON par défaut. Désactivez-le dans les paramètres de votre workspace si vous souhaitez que le privilège d'ajouter de nouveaux utilisateurs à votre workspace reste exclusif aux Managers.
Partage public
Dans les paramètres du workspace, les Managers peuvent activer ou désactiver le partage public sur l'ensemble du workspace. L'activation du partage public permet aux utilisateurs d'accéder à un incident sans avoir besoin d'être enregistrés.
Pour plus de détails sur le partage public, veuillez consulter notre section Collaboration et partage.
Le partage public est disponible dans tous les plans :
- dans le plan
Free, les Managers comme les Members peuvent effectuer un partage public. - dans les plans
GrowthetEnterprise, seuls les utilisateurs disposant de la permission d'incidentFull_accesspeuvent effectuer un partage public.
Le partage public est OFF par défaut.
Par défaut, les utilisateurs sont notifiés par e-mail lorsqu'un nouvel incident est détecté
Cette fonctionnalité est uniquement disponible pour les workspaces avec un plan Growth ou Enterprise.
Lorsque ce paramètre est activé, les utilisateurs recevront automatiquement des notifications par e-mail chaque fois qu'un nouvel incident est détecté dans le périmètre d'équipe d'un membre. Cette notification peut être modifiée par les utilisateurs dans leurs paramètres personnels sous Secrets detection > Incident alerting, en remplaçant le paramètre du workspace si nécessaire.
Les Managers du workspace peuvent ajuster le paramètre de notification par défaut pour tous les utilisateurs via les paramètres du workspace. Si les notifications par e-mail pour les nouveaux incidents sont désactivées, les utilisateurs doivent s'appuyer sur le notificateur configuré au niveau de l'équipe. Pour plus de détails sur la configuration des alertes et des notifications, veuillez consulter la page Alerting and Notifications.
Ce paramètre est ON par défaut. Pour désactiver par défaut les notifications par e-mail pour les nouveaux incidents, tant pour les nouveaux que pour les utilisateurs existants, désactivez-le dans les paramètres de votre workspace.
Activer les commentaires et retours pour la permission « Can view »
Les Managers peuvent autoriser les membres d'équipe disposant de la permission d'incident Can view à fournir des commentaires et des retours sur les incidents. Activez ou désactivez cette option dans les paramètres de votre workspace pour élargir la collaboration sans accorder de droits d'édition.
Ce paramètre est OFF par défaut.
Périmètre d'équipe
Cette fonctionnalité est uniquement disponible pour les workspaces avec un plan Business.
Dans les paramètres du workspace, les Managers peuvent supprimer automatiquement des sources de tous les périmètres d'équipe, en fonction de leur statut. Lorsqu'une source quitte un périmètre d'équipe, les membres de cette équipe perdent l'accès à la source et à ses incidents. Les Managers conservent l'accès à ces sources et à leurs incidents.

| Paramètre | GitGuardian supprime la source lorsque | Par défaut |
|---|---|---|
| Sources supprimées | la source est supprimée chez le fournisseur | OFF |
| Sources archivées | la source est archivée chez le fournisseur. S'applique uniquement aux types de sources ayant un statut archivé, comme les dépôts GitHub ou GitLab | OFF |
| Sources non surveillées | la source n'est pas surveillée. Désactivez-le pour permettre aux équipes de conserver l'accès aux sources non surveillées et à leurs incidents existants | ON |
Cycle de vie des incidents
Régression
Lorsque le paramètre Regression est activé et que GitGuardian détecte une nouvelle occurrence sur un incident précédemment marqué comme résolu (manuellement ou par l'auto-resolver), l'incident est rouvert, son statut repasse à Triggered, et une notification est émise. La régression ne s'applique qu'aux occurrences détectées via le scan en temps réel des sources connectées : un incident résolu ne sera pas rouvert si une nouvelle occurrence est découverte par un scan historique.
Lorsqu'il est Off, GitGuardian rattache silencieusement la nouvelle occurrence à l'incident résolu existant sans envoyer de notification.
Configurez ce comportement dans les paramètres General de votre workspace. Ce paramètre est ON par défaut.
Pour plus de contexte sur la façon dont la régression s'intègre dans le cycle de vie de l'incident, consultez les pages de statut d'incident Internal Monitoring et Public Monitoring.
Options de sécurité
Durée de vie maximale des tokens d'accès personnels API
Cette fonctionnalité est uniquement disponible pour les workspaces avec un plan Growth ou Enterprise.
Dans les paramètres du workspace, les Managers peuvent imposer une durée de vie maximale aux tokens d'accès personnels API créés au sein de leur workspace. Cela s'applique que la création se fasse via la page API > Personal access tokens ou via ggshield à l'aide de la commande ggshield auth login.
Si des tokens d'accès personnels existants dépassent la nouvelle durée de vie maximale au moment de la modification du paramètre, GitGuardian forcera leur durée de vie à correspondre au nouveau paramètre, à compter du moment de la modification du paramètre.
Par défaut, aucune durée de vie maximale n'est imposée pour les tokens d'accès personnels API.
Restreindre la visibilité du patch git
Cette fonctionnalité est uniquement disponible pour les workspaces avec un plan Growth ou Enterprise.
Dans les paramètres du workspace, les Managers peuvent activer la restriction de visibilité du patch git.
Lorsque la restriction est activée, le patch git d'une occurrence sera visible pour un utilisateur si l'une des conditions suivantes est remplie :
- L'utilisateur est membre d'une équipe qui inclut le dépôt où l'occurrence a eu lieu. Il convient de noter que puisque les Managers du workspace font automatiquement partie de l'équipe « All-incidents », ils auront toujours accès à tous les patchs git.
- L'utilisateur est directement impliqué dans l'occurrence, c'est-à-dire que son e-mail correspond à l'e-mail du committer de l'occurrence.
Il est important de noter que, tant que la restriction de visibilité du patch git est en vigueur, les métadonnées d'une occurrence restent visibles pour les utilisateurs. Seul le patch git de l'occurrence sera impacté par la restriction.
Cela signifie qu'il peut y avoir des cas où un utilisateur a accès à un incident de secret qui contient plusieurs occurrences. L'utilisateur pourra voir les métadonnées de toutes les occurrences, mais seul un sous-ensemble d'entre elles aura des patchs git visibles.
Cette distinction est essentielle pour garantir une remédiation efficace lorsque plusieurs équipes sont impliquées et que la collaboration est nécessaire. En restreignant l'accès au code (patch git) des occurrences des autres, les équipes peuvent maintenir le niveau de confidentialité nécessaire tout en travaillant ensemble pour résoudre l'incident.
Lorsque la restriction de visibilité du patch git est activée, les patchs git des occurrences sont masqués sur la page de partage public d'un incident.
Activer les endpoints API pour récupérer les secrets détectés et le contenu des occurrences en clair
Cette fonctionnalité est uniquement disponible pour les workspaces avec un plan Growth ou Enterprise.
Dans les paramètres du workspace, les Managers peuvent contrôler l'accès aux valeurs des secrets et au contenu des occurrences en clair via l'API, pour l'automatisation de la sécurité et l'intégration avec les workflows existants. Le paramètre contrôle trois endpoints :
GET /v1/secrets/{secret_id}: la valeur d'un secret détecté et son détecteur.GET /v1/occurrences/secrets/{occurrence_id}/content: le contenu que GitGuardian a stocké pour une occurrence d'un incident interne, avec la position de chaque correspondance de secret.GET /v1/public-incidents/secrets/{incident_id}/occurrences/{occurrence_id}/content: la même chose pour une occurrence d'un incident public.
Les endpoints ne répondent que lorsque toutes ces conditions sont remplies :
- Paramètre du workspace : un Manager a activé le paramètre.
- Liste d'autorisation IP (SaaS uniquement) : la liste d'autorisation IP est activée. La désactiver désactive à nouveau les endpoints. La liste d'autorisation n'existe pas sur les instances self-hosted, cette condition ne s'applique donc pas dans ce cas.
- Personal Access Token (PAT) : l'appelant utilise un PAT avec le scope
secrets:read, plusincidents:readpour les deux endpoints de contenu d'occurrence. Les tokens de compte de service sont refusés. - Accès au dashboard : le propriétaire du token peut voir l'incident dans le dashboard. Lorsque la visibilité du patch git est restreinte (voir ci-dessus), le contenu de l'occurrence suit la même règle.
Durée de session
Dans les paramètres du workspace, les Managers peuvent personnaliser la durée d'une session du dashboard avant que les utilisateurs ne soient automatiquement déconnectés.
Choisissez l'une des durées prédéfinies ou sélectionnez Custom pour spécifier une durée de session en minutes. Laissez le champ de durée personnalisée vide pour revenir aux valeurs par défaut de GitGuardian.
La modification de la durée de session nécessite que tous les utilisateurs se reconnectent une fois le changement appliqué.
Restreindre les scopes des Personal Access Tokens
Cette fonctionnalité est uniquement disponible pour les workspaces avec un plan Growth ou Enterprise.
Dans les paramètres du workspace, les Managers peuvent restreindre les scopes disponibles pour les Members lors de la création de Personal Access Tokens (PAT). Cela permet aux Managers d'appliquer le principe du moindre privilège en limitant ce que les Members peuvent faire avec leurs tokens.
Cette restriction ne s'applique pas aux Managers.
Par défaut, il n'y a aucune restriction sur les scopes des PAT pour les Members.
Application du mode confidentialité
Cette fonctionnalité est uniquement disponible pour les workspaces avec un plan Growth ou Enterprise.
Dans les paramètres du workspace, le propriétaire du workspace peut imposer le mode confidentialité pour certains ou tous les utilisateurs, les empêchant de le désactiver. Ceci est utile pour les organisations qui exigent que les secrets soient toujours masqués en tant que politique de sécurité.
Ce paramètre est uniquement modifiable par le propriétaire du workspace. Les Managers et les membres peuvent le voir mais ne peuvent pas le modifier.
Quatre niveaux d'application sont disponibles :
- All users (par défaut) : aucune application — chaque utilisateur contrôle son propre réglage du mode confidentialité.
- Managers and owner only : le mode confidentialité est imposé ON pour les membres et les utilisateurs restricted, qui ne peuvent pas le désactiver. Les Managers et le propriétaire conservent le contrôle de leur propre réglage.
- Owner only : le mode confidentialité est imposé ON pour les managers, les membres et les utilisateurs restricted, qui ne peuvent pas le désactiver. Seul le propriétaire conserve le contrôle.
- No one : le mode confidentialité est imposé ON en permanence pour tout le monde, y compris le propriétaire.
Lorsque l'application s'applique à un utilisateur, le réglage du mode confidentialité dans la barre de navigation est désactivé et affiche une info-bulle expliquant qu'il est contrôlé par les paramètres du workspace.