Modèle de sécurité
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
noncede 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.
| Fournisseur | Plans |
|---|---|
| Free, Core, Pro, Enterprise | |
| Microsoft Entra ID | Core, Pro, Enterprise |
| Groupes Microsoft Entra ID comme titulaires de rôles | Enterprise |
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 :
| Jeton | Durée de vie | Rôle |
|---|---|---|
| Jeton d'accès | 15 minutes | Prouve votre identité à chaque requête |
| Jeton d'actualisation | 14 jours | Obtient 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.
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ôle | Peut |
|---|---|
| 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énement | Enregistré sous |
|---|---|
| Une connexion | login |
| Un refus après la réponse du fournisseur, avec le motif | login.failed |
| Un compte créé à la première connexion | user.create |
| Une invitation créée, acceptée ou supprimée | invitation.create, invitation.accept, invitation.delete |
| Un rôle attribué ou retiré | role.grant, role.revoke |
| Un changement de mode d'inscription | registration.update, registration.reset |
| Une modification d'un utilisateur ou de ses préférences | user.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.