Aller au contenu principal
Version : 0.4 · actuelle

Modèle de sécurité

ConceptRévisé le 11 octobre 2026
S'applique à :Excubius 0.4Rôles : Lecteur, Opérateur, Éditeur, Administrateur d'entité, Super-administrateur
PlansFree · Core · Pro · EnterpriseDéploiementAuto-hébergé

Excubius ne gère aucun mot de passe propre pour votre équipe : les utilisateurs se connectent avec le compte Microsoft ou Google que votre organisation gère déjà. Ce qu'ils peuvent voir et faire dépend ensuite du rôle qu'ils détiennent sur chaque branche de l'arborescence des entités, contrôlé de nouveau à chaque requête. Les secrets dont le collecteur a besoin sont stockés chiffrés et ne peuvent jamais être relus. Cet article explique chaque couche.

Connexion​

Excubius utilise OpenID Connect avec Microsoft Entra ID (un seul locataire) et Google, au moyen du flux de code d'autorisation avec PKCE, state et nonce. Aucun SDK de fournisseur ni aucun service d'identité payant n'intervient.

  • Le jeton d'ID est validé à chaque connexion : sa signature au regard des clés publiées par le fournisseur, l'émetteur (pour Entra ID, votre locataire), l'audience, l'expiration et le nonce de cette connexion.
  • La connexion en cours est conservée dans un cookie signé HttpOnly valable 10 minutes. La page vers laquelle revenir après la connexion doit appartenir au même site : un lien forgé ne peut donc envoyer personne ailleurs.
  • Les comptes sont identifiés par fournisseur et par sujet, c'est-à-dire l'ID d'objet de l'utilisateur dans Entra ID ou le sujet Google, jamais par la seule adresse e-mail.
  • Qui peut obtenir un compte se décide par entité : sur invitation, ou par un domaine de messagerie autorisé. Un compte Google ne compte pour un domaine que s'il s'agit d'un compte Google Workspace de ce domaine ; les comptes Google personnels nécessitent toujours une invitation.
  • Les secrets des fournisseurs proviennent uniquement de la configuration du serveur. Ni eux, ni les codes d'autorisation, ni les jetons ne sont stockés dans la base de données, renvoyés par l'API ou écrits dans les journaux.
FournisseurPlans
GoogleFree, Core, Pro, Enterprise
Microsoft Entra IDCore, Pro, Enterprise
Groupes Microsoft Entra ID comme titulaires de rôlesEnterprise

Authentification multifacteur​

La MFA est imposée par votre fournisseur d'identité : l'accès conditionnel d'Entra ID ou la validation en deux étapes de Google. Excubius n'inspecte pas encore les revendications MFA : exigez donc la MFA chez le fournisseur pour toutes les personnes qui peuvent se connecter, et surtout pour les administrateurs d'entité.

Sessions et jetons​

Une connexion réussie définit deux cookies, tous deux HttpOnly, Secure sur HTTPS et SameSite=Lax :

JetonDurée de vieRôle
Jeton d'accès15 minutesProuve votre identité à chaque requête
Jeton d'actualisation14 joursObtient une nouvelle paire de jetons ; chaque actualisation émet une nouvelle paire

Les autorisations ne sont pas contenues dans le jeton. Elles sont lues dans la base de données à chaque requête : désactiver un utilisateur, retirer un rôle ou modifier l'attribution d'un groupe prend effet à la requête suivante de cette personne. L'appartenance aux groupes d'annuaire est relue à chaque connexion.

remarque

Les jetons d'actualisation ne peuvent pas encore être révoqués individuellement. Pour mettre fin à l'accès d'une personne avant l'expiration de sa session, désactivez l'utilisateur. Se déconnecter d'Excubius ne vous déconnecte pas de Microsoft ni de Google.

Il n'existe pas encore de clés d'API : dans cette version, les scripts et les autres outils ne peuvent pas appeler l'API en leur propre nom.

Rôles sur l'arborescence des entités​

Un rôle est attribué à une personne, ou à un groupe d'annuaire, sur une entité, et s'applique à cette entité et à tout ce qui se trouve en dessous. Une personne peut être Entity admin pour un client et Operator pour un autre. Sur n'importe quelle entité, le rôle effectif est le plus élevé trouvé sur l'entité et ses ancêtres, en comptant les rôles propres de la personne et ceux de ses groupes.

RôlePeut
Viewer (Lecteur)Consulter les tableaux de bord, les alertes, les constats et le détail des ressources ; modifier ses propres paramètres
Operator (Opérateur)Tout ce que peut faire un lecteur, plus confirmer, mettre en sourdine, attribuer et résoudre des alertes, créer des tickets Jira et planifier des fenêtres de maintenance
Editor (Éditeur)Tout ce que peut faire un opérateur, plus modifier les vérifications et les seuils des ressources et accepter des risques de sécurité
Entity admin (Administrateur d'entité)Tout ce que peut faire un éditeur, plus gérer les entités de la branche, les valeurs par défaut des entités, les ressources, les informations d'identification, les sources, les personnes, les rôles, les invitations, les canaux de notification, les paramètres Jira et la page d'état
Super admin (Super-administrateur)Tout, sur toutes les branches, plus les paramètres de l'ensemble de l'installation. Attribué uniquement sur la racine, par un autre super-administrateur

Concrètement :

  • Chaque liste est limitée à vos branches : entités, ressources, alertes, tableau de bord Overview, informations d'identification, canaux et personnes. Si vos rôles commencent à Combray SA, l'arborescence des entités que vous voyez commence là aussi.
  • Tout ce qui se trouve hors de vos branches n'existe pas pour vous : ouvrir son adresse renvoie Not found, or no longer visible to you. Ce que vous pouvez voir sans pouvoir le modifier renvoie Your role does not allow this.
  • L'attribution de rôles reste dans votre branche et à votre niveau : un administrateur d'entité ne peut inviter des personnes et attribuer des rôles que sur les entités qu'il administre, et jamais un rôle supérieur au sien.
  • Une information d'identification appartient à l'entité qui la possède et peut être utilisée par les ressources de cette entité et des entités inférieures. Diriger le collecteur vers un hôte avec une information d'identification exige le rôle d'administrateur d'entité sur l'entité de cette information d'identification : l'administrateur d'un client ne peut donc pas diriger une connexion partagée depuis un niveau supérieur vers l'hôte de son choix.

Entités, étiquettes et héritage explique l'arborescence elle-même.

Secrets​

Les informations d'identification de surveillance, les clés d'API des sources, les secrets client et les clés des certificats téléversés sont en écriture seule :

  • Ils sont chiffrés dans la base de données avec AES et une signature HMAC (Fernet), au moyen d'une clé que le programme d'installation génère et conserve dans le fichier de configuration du serveur, et non dans la base de données. Une sauvegarde de la base de données ne révèle à elle seule aucun secret.
  • Les écrans et l'API indiquent seulement si un secret est défini, par exemple stored — leave empty to keep it. Personne ne peut relire un secret, quel que soit son rôle.
  • Un secret est déchiffré sur le serveur, ou envoyé au collecteur par le réseau interne du serveur lorsqu'une vérification en a besoin. Le collecteur le conserve en mémoire et ne l'écrit jamais dans les journaux.
  • Le conteneur du collecteur ne reçoit que son propre jeton et ses paramètres : jamais le mot de passe de la base de données, le secret de signature des sessions ni la clé de chiffrement. Les routes du collecteur sont refusées en bordure du serveur : il n'est donc joignable que depuis l'intérieur.

Les informations d'identification elles-mêmes sont provisionnées sans droit d'écriture ni d'installation sur les systèmes surveillés ; consultez Architecture.

Audit​

Chaque modification effectuée via l'API est écrite dans le journal d'audit avec l'utilisateur qui l'a faite, l'heure et l'adresse IP de la requête. Pour la connexion et l'accès, cela comprend :

ÉvénementEnregistré sous
Une connexionlogin
Un refus après la réponse du fournisseur, avec le motiflogin.failed
Un compte créé à la première connexionuser.create
Une invitation créée, acceptée ou suppriméeinvitation.create, invitation.accept, invitation.delete
Un rôle attribué ou retirérole.grant, role.revoke
Un changement de mode d'inscriptionregistration.update, registration.reset
Une modification d'un utilisateur ou de ses préférencesuser.update, user.preferences

Les actions sur les alertes, les modifications de seuils et de sources, les fenêtres de maintenance et les modifications de la page d'état sont auditées de la même façon. Le journal d'audit est conservé dans la base de données de la plateforme.