Configurer les préférences
Afin de configurer les préférences pour affiner votre instance GitGuardian, naviguez vers Settings > General > Preferences.
Veuillez faire attention, certaines préférences vous permettent d'activer des fonctionnalités en mode bêta. En cas de doute, veuillez demander conseil à l'équipe GitGuardian.
Tableau des préférences
General
| Préférence | Valeur par défaut | Description |
|---|
token_expire_in_days | 7 | Durée de vie, en jours, des invitations et des liens de réinitialisation de mot de passe |
presence_check_enabled | true | Active la vérification de présence des secrets. Pour plus d'informations, veuillez consulter la page Examiner les incidents |
presence_check_display_enabled | true | Active l'affichage des vérifications de présence des secrets |
background_presence_check_enabled | true | Active la vérification automatique de présence des secrets dans les tâches d'arrière-plan |
validity_check_enabled | true | Active la vérification de validité des secrets |
background_validity_check_enabled | true | Active la vérification automatique de validité des secrets dans les tâches d'arrière-plan |
validity_check_for_invalid_secrets_enabled | true | Indique s'il faut inclure les secrets invalides dans les vérifications de validité périodiques (utile car certains secrets peuvent être temporairement invalides). Désactivez pour réduire la charge sur les workers. |
SAML SSO
Pour plus d'informations, veuillez consulter la page SAML SSO.
| Préférence | Valeur par défaut | Description |
|---|
use_model_signature_settings | true | Active les configurations manuelles des exigences de signatures SAML |
is_custom_nameid_format_enabled | false | Active le choix du format NameID |
Bitbucket
Pour plus d'informations, veuillez consulter la documentation d'intégration de Bitbucket.
| Préférence | Valeur par défaut | Description |
|---|
min_delay_between_syncs | 60 | Délai minimum, en minutes, entre deux synchronisations consécutives d'une installation Bitbucket |
auth_error_grace_period | 0 | Période minimale, en minutes, d'erreurs d'authentification répétées après laquelle un token doit être révoqué |
On Premise
| Préférence | Valeur par défaut | Description |
|---|
bitbucket_disable_admin_check | false | Désactive la vérification Admin de l'intégration Bitbucket lors de la création de l'intégration |
prometheus_metrics_active | false | Active l'exportateur de métriques Prometheus sur /metrics. Pour plus d'informations, veuillez consulter la page Métriques applicatives |
custom_telemetry_active | true | Active l'envoi des métriques de télémétrie à GitGuardian |
tls_client_force_second_factor_auth | false | Option d'authentification multifacteur pour l'authentification basée sur certificat |
version_update_notifications_active | true | Active les notifications de mise à jour de version (carte de la barre latérale, page de licence et alertes par e-mail) |
support_bundle_admin_area_enabled | true | Active la génération et le téléversement d'un bundle de support depuis l'Admin Area. Pour plus d'informations, veuillez consulter la page Support. |
Notifier
Pour plus d'informations, veuillez consulter la page Webhook personnalisé.
| Préférence | Valeur par défaut | Description |
|---|
max_webhooks_per_integration_type | 1000 | Nombre maximum de webhooks configurés par type d'intégration |
Source Scanner (VCS)
Pour plus d'informations, veuillez consulter la page Scan historique.
| Préférence | Valeur par défaut | Description |
|---|
minutes_between_scans_per_source | 0 | Minutes minimum entre deux scans sur la même source. (0 = désactivé) |
vcs_clone_fetch_all_refs_enabled | true | Récupère toutes les références exposées par le dépôt distant lors des scans historiques (références de pull/merge request, notes Git, références keep-around GitLab, références de changement Gerrit, etc.) en plus des branches et tags standards. Pour plus d'informations, veuillez consulter la page Scan historique. |
Sources Integrations
Pour plus d'informations, veuillez consulter la documentation d'intégration de Gerrit.
| Préférence | Valeur par défaut | Description |
|---|
is_gerrit_enabled | false | Active l'intégration Gerrit. |
is_gerrit_historical_scan_enabled | false | Active les scans historiques sur les sources Gerrit. |
Source Scanner
| Préférence | Valeur par défaut | Description |
|---|
servicenow_data_source_recurrent_scan_interval | 21600 | Secondes minimum entre deux scans récurrents sur les sources ServiceNow. |
aws_ecr_recurrent_scan_interval | 172800 | Secondes minimum entre deux scans récurrents sur les sources Amazon ECR. |
azure_cr_recurrent_scan_interval | 172800 | Secondes minimum entre deux scans récurrents sur les sources Azure Container Registry. |
google_artifact_recurrent_scan_interval | 172800 | Secondes minimum entre deux scans récurrents sur les sources Google Artifact Registry. |
docker_hub_recurrent_scan_interval | 172800 | Secondes minimum entre deux scans récurrents sur les sources Docker Hub. |
jfrog_artifact_recurrent_scan_interval | 172800 | Secondes minimum entre deux scans récurrents sur les sources JFrog Container Registry. |
microsoft_teams_recurrent_scan_interval | 21600 | Secondes minimum entre deux scans récurrents sur les sources Microsoft Teams. |
microsoft_teams_recurrent_scan_window | 1209600 | Fenêtre de temps, en secondes, pour les scans récurrents Microsoft Teams. |
jfrog_package_registry_recurrent_scan_interval | 28800 | Secondes minimum entre deux scans récurrents sur les sources JFrog Package Registry. |
harbor_recurrent_scan_interval | 172800 | Secondes minimum entre deux scans récurrents sur les sources Harbor. |
red_hat_quay_recurrent_scan_interval | 172800 | Secondes minimum entre deux scans récurrents sur les sources Red Hat Quay. |
sharepoint_online_recurrent_scan_interval | 21600 | Secondes minimum entre deux scans récurrents sur les sources SharePoint Online. |
microsoft_onedrive_recurrent_scan_interval | 21600 | Secondes minimum entre deux scans récurrents sur les sources Microsoft OneDrive. |
confluence_cloud_recurrent_scan_interval | 21600 | Secondes minimum entre deux scans récurrents sur les sources Confluence Cloud. |
jira_cloud_recurrent_scan_interval | 21600 | Secondes minimum entre deux scans récurrents sur les sources Jira Cloud. |
Container Registries
| Préférence | Valeur par défaut | Description |
|---|
enable_repository_scoped_layers_cache | false | Inclut le nom du dépôt dans les clés de cache des couches pour délimiter le cache par dépôt. Cela permet de créer plusieurs occurrences de secret au lieu d'une seule lorsque nous rencontrons la même couche avec le même secret sur différentes images. |
Policy
| Préférence | Valeur par défaut | Description |
|---|
is_repo_size_controlled | false | Limite la taille des dépôts pour le scan historique. (supprimé dans 2024.9.0) |
repo_scan_size_limit | 1073741824 | Taille maximale de dépôt pour le scan historique, en octets. Pour plus d'informations, veuillez consulter la page suivante. |
repo_scan_pending_limit_in_hours | 168 | Délai d'expiration, en heures, du temps d'attente en file du scan historique d'un dépôt. Pour plus d'informations, veuillez consulter la page suivante. |
repo_scan_time_limit_in_sec | 7200 | Délai d'expiration, en secondes, du scan historique d'un dépôt. Pour plus d'informations, veuillez consulter la page suivante. |
maximum_scan_size | 1048576 | Taille maximale de document pour le scan de détection de secrets via l'API, en octets. |
repo_scan_max_commit_length | 1073741824 | Longueur totale maximale d'un commit à scanner, en octets, les commits plus volumineux sont tronqués (-1 = illimité). |
displayed_content_max_size | 10485760 | Taille maximale du contenu affiché, en octets. Introduit dans 2023.11. |
displayed_content_max_lines | 100000 | Nombre maximal de lignes de contenu affiché. Introduit dans 2023.11. |
skip_unchanged_scans | True | Ce paramètre permet d'ignorer le scan historique d'un dépôt s'il n'a pas changé depuis le dernier scan. |
Public API
Pour plus d'informations, veuillez consulter notre documentation API.
| Préférence | Valeur par défaut | Description |
|---|
maximum_multifile_documents | 20 | Nombre maximum de fichiers dans un document multi-fichiers pour le scan via l'API |
maximum_token_per_account | 150 | Nombre maximum de clés API autorisées par workspace |
maximum_token_per_member | 5 | Nombre maximum de tokens d'accès personnels autorisés par membre |
quotas | 10000000 | Quotas glissants mensuels pour les appels API (supprimé dans 2024.7.0) |
max_page_size | 100 | Limite supérieure du paramètre per_page dans l'API publique qui contrôle le nombre de données renvoyées dans les endpoints paginés. |
GitHub
Pour plus d'informations, veuillez consulter la documentation d'intégration de GitHub.
| Préférence | Valeur par défaut | Description |
|---|
is_actionable_checkrun_enabled | false | Active les boutons d'action sur les checkruns (supprimé dans 2024.2.0) |
check_runs_overrides_labels_ghe | false | Active le remplacement des paramètres de check run par les labels de dépôt sur GitHub Enterprise Server |
enable_check_runs_scans | true | Fonctionne conjointement avec check_runs_skip_too_large_pr. Lorsque les deux feature flags sont activés, GitGuardian exécute des évaluations basées sur le scan pour les check runs dont les pull requests sont trop volumineuses pour l'évaluation en temps réel basique. Les évaluations basées sur le scan reposent sur un git clone et consomment donc beaucoup moins de quota de limite de débit. |
check_runs_skip_too_large_pr | true | Ignore l'évaluation en temps réel des check runs lorsque leur pull request est trop volumineuse, afin que les pull requests très volumineuses ne consomment pas l'intégralité du quota de limite de débit. Utilisé conjointement avec les paramètres pr_max_commits_for_check_run, pr_max_files_for_check_run et pr_max_changes_for_check_run. |
disable_check_run_softtimelimit_retry | true | Les check runs disposent d'un temps limité pour terminer leur évaluation en temps réel. Par défaut, une fois ce temps atteint, l'évaluation est réessayée avec une limite de temps plus longue, ce qui consomme généralement beaucoup de quota de limite de débit. Activez ce feature flag pour désactiver la nouvelle tentative. |
pr_max_commits_for_check_run | 200 | Seuil de nombre de commits au-dessus duquel le check run est ignoré. Définissez sur 0 pour désactiver ce seuil. |
pr_max_files_for_check_run | 60000 | Seuil de nombre de fichiers mis à jour au-dessus duquel le check run est ignoré. Définissez sur 0 pour désactiver ce seuil. |
pr_max_changes_for_check_run | 300000 | Seuil de nombre de lignes modifiées au-dessus duquel le check run est ignoré. Définissez sur 0 pour désactiver ce seuil. |
commit_collector_max_workers | 4 | Nombre maximum d'appels par worker pour le collecteur de commits. Un nombre plus élevé accélérera la collecte des commits, mais est plus susceptible d'atteindre les limites de débit de GitHub. Valeur attendue entre 1 et 4. |
Health Checks
Pour plus d'informations, veuillez consulter la page Vérification de l'état de l'environnement.
| Préférence | Valeur par défaut | Description |
|---|
periodic_enabled | true | Active les vérifications périodiques de l'état. |
periodic_interval | 1h | Supprimé dans 2024.7.0, désormais configurable avec spread_periodic_range_minutes. |
spread_periodic_range_minutes | 60 | Intervalle entre deux exécutions des vérifications périodiques de l'état (en minutes). |
Teams
Pour plus d'informations, veuillez consulter la page équipes.
| Préférence | Valeur par défaut | Description |
|---|
max_teams | 500 | Nombre maximum d'équipes autorisées sur un compte. ⚠️ Dépasser cette limite peut affecter les performances. |
Pour plus d'informations, veuillez consulter la page Suivi de la remédiation.
| Préférence | Valeur par défaut | Description |
|---|
scan_after_push_force_rate_limit | 300 | Limite de débit en secondes pour le scan démarré par le moteur de suivi des fichiers. Appliquée par source, branche et type de scan. |
| Préférence | Valeur par défaut | Description |
|---|
max_custom_tag_keys_per_workspace | 50 | Nombre maximum de clés de tags personnalisés par workspace. Les tags personnalisés oneword comptent pour 1 clé |
max_custom_tag_values_per_key_per_workspace | 50 | Nombre maximum de valeurs de tags personnalisés pour une clé donnée. Les tags personnalisés oneword comptent pour 1 valeur pour la clé oneword |
max_custom_tags_per_resource | 100 | Nombre maximum de tags personnalisés liés à 1 ressource (p. ex. honeytoken, incident privé, etc.) |
|
Multi-Factor Authentication
Pour plus d'informations, veuillez consulter la page Paramètres du compte.
| Préférence | Valeur par défaut | Description |
|---|
is_mfa_enabled | false | Active l'authentification multifacteur pour le workspace. |
sudo_mode_duration | 30 | Durée, en minutes, d'une session élevée (sudo) avant qu'une nouvelle authentification ne soit requise. |
Background Presence Check Frequencies
Pour plus d'informations, veuillez consulter la page Examiner les incidents.
| Préférence | Valeur par défaut | Description |
|---|
ignored_old | 0 | Fréquence, en jours, des vérifications automatiques de présence dans l'historique git pour les incidents de secrets ignorés de plus d'un an |
ignored_recent | 178 | Fréquence, en jours, des vérifications automatiques de présence dans l'historique git pour les incidents de secrets ignorés de moins d'un an |
open_old | 7 | Fréquence, en jours, des vérifications automatiques de présence dans l'historique git pour les incidents de secrets ouverts de plus d'un an |
open_recent | 1 | Fréquence, en jours, des vérifications automatiques de présence dans l'historique git pour les incidents de secrets ouverts de moins d'un an |
resolved_old | 178 | Fréquence, en jours, des vérifications automatiques de présence dans l'historique git pour les incidents de secrets résolus de plus d'un an |
resolved_recent | 30 | Fréquence, en jours, des vérifications automatiques de présence dans l'historique git pour les incidents de secrets résolus de moins d'un an |
Background Validity Check Frequencies
Pour plus d'informations, veuillez consulter la page Vérifications de validité.
| Préférence | Valeur par défaut | Description |
|---|
ignored_old | 178 | Fréquence, en jours, des vérifications automatiques de validité des secrets pour les incidents de secrets ignorés de plus d'un an |
ignored_recent | 30 | Fréquence, en jours, des vérifications automatiques de validité des secrets pour les incidents de secrets ignorés de moins d'un an |
open_old | 7 | Fréquence, en jours, des vérifications automatiques de validité des secrets pour les incidents de secrets ouverts de plus d'un an |
open_recent | 1 | Fréquence, en jours, des vérifications automatiques de validité des secrets pour les incidents de secrets ouverts de moins d'un an |
resolved_old | 178 | Fréquence, en jours, des vérifications automatiques de validité des secrets pour les incidents de secrets résolus de plus d'un an |
resolved_recent | 30 | Fréquence, en jours, des vérifications automatiques de validité des secrets pour les incidents de secrets résolus de moins d'un an |
