Nouveau : le pare-feu IA surveille toute la plateforme et explique chaque incident en termes simples. Découvrez comment ça marche

Politiques d’accès

Règles basées sur les attributs, au-dessus des rôles et des groupes – évaluation, éditeur de règles, mode shadow, testeur d'accès, journal des décisions et limites.

Les politiques d’accès ajoutent des règles basées sur les attributs (ABAC) aux rôles et aux groupes. Une politique examine qui fait la demande, ce qu’il veut faire et dans quel contexte, puis autorise ou refuse. Utilisez les politiques pour restreindre ce que les rôles et les groupes autoriseraient sinon, par exemple « personne ne peut envoyer de commandes critiques depuis l’extérieur du réseau de l’usine » ou « le firmware ne peut être affecté qu’à partir d’une session ouverte avec une passkey ». Les politiques sont un outil avancé : la plupart des organisations n’ont besoin que des rôles et des groupes.

Vous devez avoir le rôle Owner. Ouvrez Settings > Access Policies (adresse /admin/access-policies).

Comment une décision est prise

Pour chaque requête soumise à contrôle :

  1. Chaque politique active dont la cible correspond (ses actions et ses types de ressources) et dont toutes les conditions sont vérifiées est collectée, par ordre de priorité (la plus basse s’exécute en premier).
  2. Si l’une d’elles refuse, la requête est rejetée. Le refus l’emporte toujours.
  3. Sinon, si une politique autorise, la requête est acceptée.
  4. Si aucune politique ne s’applique, la décision issue du rôle, du groupe et de la matrice est maintenue (« RBAC fallback »).

Les politiques sont des restrictions cumulatives : formulez les exigences sous forme de politiques Deny. Une politique Permit dont les conditions ne sont pas vérifiées ne refuse rien ; la requête revient simplement à la décision du rôle.

Les requêtes vues par les politiques

Les politiques sont vérifiées sur les routes qui appellent le moteur de politiques. La plupart des pages et des routes d’API de Hermetry le font ; quelques-unes non, car il n’y a pas de membre connecté à juger (la connexion elle-même, les connexions des appareils, les callbacks de webhooks, les tâches planifiées, les requêtes utilisant le contrat propre d’une clé d’API, comme SCIM). La page Coverage indique précisément quelles routes atteignent le moteur et, pour les autres, « What guards it instead ». Consultez-la avant de vous fier à une politique.

Important

Les pages IoT et l’API IoT transmettent aux politiques l’action (la permission) et l’appelant, mais aucun attribut d’appareil. Vous ne pouvez pas écrire une politique pour un seul appareil ou un seul site, et un membre autorisé à voir les appareils voit tous les appareils de l’organisation. Si des groupes de personnes ne doivent jamais voir les appareils des autres, placez ces appareils dans des organisations distinctes. La séparation entre organisations est appliquée dans la base de données par la sécurité au niveau des lignes (row-level security). Testez toujours une politique dans le testeur d’accès et en mode shadow au préalable.

Créer une politique

  1. Sélectionnez New policy (ou Load examples pour partir de politiques prêtes à l’emploi).
  2. Saisissez un Name, l’Effect (Permit, ou Deny (overrides any permit)) et la Priority (lower runs first). Sélectionnez Create & edit.
  3. Dans Definition, renseignez :
    • Actions (comma-separated, empty = all) : identifiants de permissions, par exemple iot_rpc.send.critical, iot_ota.assign.
    • Types de ressources (séparés par des virgules, vide = tous).
    • Description : la raison d’être de la politique.
    • Status : Active ou Inactive. Sélectionnez Save definition.
  4. Sous Conditions, sélectionnez Add condition pour chaque test. « Toutes les conditions doivent être vérifiées (ET) pour que la politique s’applique. » Sélectionnez Save conditions.

Une politique sans condition s’applique à toute requête correspondant à sa cible.

Conditions

Chaque condition se compose d’un Attribute, d’un Operator et d’une Value (ou de Values (comma-separated)).

AttributSignification
subject.roleLe rôle intégré : OWNER, ADMIN, USER
subject.rolesLe rôle plus les clés de groupes du membre
subject.permissionsLes permissions accordées par les groupes du membre
subject.id, subject.emailLe membre
subject.department, subject.jobTitleIssus du profil du membre, lorsqu’ils sont renseignés
subject.amrMode de connexion de la session : pwd, otp, mfa, hwk (passkey), fed:saml, fed:<provider>
subject.acrLe niveau d’assurance qui en découle : NONE, LOW (mot de passe ou fédération seul), SUBSTANTIAL (un second facteur vérifié), HIGH (une passkey)
environment.ipL’adresse de l’appelant
environment.now, environment.method, environment.userAgent, environment.hostHeure, méthode HTTP, navigateur, nom d’hôte
actionLa permission vérifiée

Opérateurs : equals, not equals, in list, not in list, contains, greater than, less than, exists, matches regex, DN equals (RDN).

Un attribut absent est lu comme vide, ce qui satisfait not equals et not in list. C’est pourquoi les règles de refus sont sûres et les règles d’autorisation ne le sont pas.

Exemples

Refuser les commandes critiques et brutes sauf si la session a utilisé un second facteur ou une passkey :

ChampValeur
EffetRefuser
Actionsiot_rpc.send.critical, iot_rpc.send.raw
Conditionsubject.acr n’est pas dans la liste SUBSTANTIAL, HIGH

Empêcher les membres d’un groupe contractors d’écrire des attributs ou d’envoyer des commandes, quel que soit leur rôle :

ChampValeur
EffetRefuser
Actionsiot_device.attributes.write, iot_rpc.send.basic, iot_rpc.send.privileged
Conditionsubject.roles contient contractors

Pour accorder un droit à un seul groupe, la matrice Access Rights est généralement plus simple qu’une politique : décochez la permission pour Admin et cochez-la pour le groupe. Voir Groups and permissions.

Mode shadow, testeur d’accès et journal des décisions

OutilEmplacementUsage
Mode ShadowSettings sur la page des politiques (Access Control Settings)« Les politiques sont évaluées et les décisions sont journalisées, mais un refus NE bloque JAMAIS la requête. » Désactivé par défaut. Activez-le avant d’appliquer une nouvelle politique, surveillez le journal, puis désactivez-le.
Testeur d’accèsSimulateur« Simule une décision avec les politiques en vigueur, sans rien enregistrer ni journaliser. » Saisissez le Subject id, le Subject role, l’Action, le Resource type, le Resource ownerId, l’Environment IP et un RBAC fallback role, puis sélectionnez Evaluate. La Policy trace affiche la cible et les règles de chaque politique.
Journal des décisionsJournal des décisionsChaque requête évaluée avec son Effect, son Action, sa Reason (Policy permit, Explicit deny, RBAC fallback, Default deny, Not applicable) et son Subject. Les refus en mode shadow sont marqués Shadow.

Decision Log Mode (All decisions, Deny only, Off ; par défaut all) et Permit Log Sample Rate (%) déterminent la quantité d’informations inscrites dans le journal d’audit. Les refus sont toujours journalisés.

Bonnes pratiques

  • Commencez par Load examples et lisez-les avant d’écrire vos propres politiques.
  • Utilisez des politiques de refus avec des listes d’actions restreintes. Évitez les politiques sans action : elles jugent chaque requête.
  • Ne bloquez jamais les owners : testez chaque politique avec le rôle d’un owner dans le testeur d’accès.
  • Les modifications prennent effet immédiatement sur tous les nœuds.