La question qui arrive avant le menu
Dans un bon restaurant, la question arrive avant le menu. « Avez-vous des allergies, ou des choses que vous ne mangez pas ? » Elle tient en dix mots et elle change tout ce qui suit : le plat qu'on propose, la poêle qu'on utilise, la planche sur laquelle on coupe.
Posée au dessert, la même question ne sert plus à rien. Le beurre est déjà dans la sauce.
Les exigences de sécurité sont cette question. Elles se recueillent avant la conception, auprès de ceux qui savent ce qu'il faut protéger, et elles s'écrivent de façon à ce que quelqu'un puisse vérifier qu'on les a tenues. Ce billet montre d'où elles viennent, à quoi ressemble une exigence bien écrite, et comment une obligation légale devient une ligne de backlog.
Cinq sources, une seule liste
Une exigence de sécurité ne s'invente pas. Elle se déduit, et elle a toujours une origine qu'on doit pouvoir citer. On en compte cinq. La figure 1 les rassemble.
biens et
impacts"] --> E["Exigences de sécurité"] T["Menaces
cas d'abus,
modèle de menaces"] --> E C["Conformité
lois, contrats,
standards"] --> E O["Organisation
politiques
internes"] --> E X["Exploitation
ce qu'il faut
pour opérer"] --> E E --> D["Conception"] E --> V["Tests"] class E fort
- La liste à laquelle la conception et les tests se réfèrent
| Source | Ce qu'elle apporte | Qui la porte | Exemple |
|---|---|---|---|
| Métier | Ce qui a de la valeur, et ce que coûterait sa perte | Le responsable produit | « Une commande validée ne peut plus être modifiée » |
| Menaces | Ce qu'un adversaire tentera | L'architecte, l'équipe | « Cinq échecs de connexion ralentissent les suivants » |
| Conformité | Ce que la loi, le contrat ou le secteur imposent | Le juridique, la conformité | « Le cryptogramme de la carte n'est jamais conservé » |
| Organisation | Ce que la maison a décidé pour tous ses logiciels | La sécurité | « Tout accès d'administration passe par une authentification à deux facteurs » |
| Exploitation | Ce dont on a besoin pour surveiller et réparer | L'exploitation | « Chaque refus d'accès est journalisé avec l'identité et la ressource » |
La première source est celle qu'on saute le plus souvent. Elle demande de parler à quelqu'un qui ne fait pas de technique, et de lui poser les questions du billet P1 : quel bien, quelle propriété, quel impact. Sans elle, on écrit des exigences génériques qui protègent tout de la même façon, donc rien en particulier.
La quatrième évite de tout redécouvrir à chaque projet. Les politiques et standards du billet P5 fournissent un socle. Le projet ne rédige que ce qui lui est propre.
Ce que le système fait, et comment il le fait
Le plan d'examen du CSSLP distingue deux natures d'exigences. La distinction paraît scolaire. Elle évite pourtant un oubli classique.
Une exigence fonctionnelle décrit un comportement : ce que le système fait. Authentifier un utilisateur, refuser un accès, chiffrer un champ, écrire une ligne de journal, expirer une session. On peut en faire un récit utilisateur et le démontrer.
Une exigence non fonctionnelle décrit une qualité : comment le système se comporte, à quel niveau, sous quelle contrainte. Tenir mille connexions simultanées sans dégrader l'authentification. Redémarrer en moins de quinze minutes après une panne. Conserver les journaux douze mois. Pouvoir changer d'algorithme de chiffrement sans réécrire l'application.
| Sujet | Exigence fonctionnelle | Exigence non fonctionnelle |
|---|---|---|
| Authentification | Le système exige un second facteur pour les rôles d'administration | La vérification du second facteur répond en moins de deux secondes |
| Journalisation | Chaque accès à une donnée sensible produit une entrée de journal | Les journaux sont conservés douze mois et ne sont pas modifiables par les administrateurs applicatifs |
| Chiffrement | Les allergies déclarées sont chiffrées au repos | La rotation de la clé ne provoque pas d'interruption de service |
| Disponibilité | Le service bascule sur un second site en cas de panne | La bascule s'effectue en moins de quinze minutes, sans perte de commande validée |
| Session | Une session inactive est fermée | Le délai d'inactivité est de quinze minutes et se règle sans redéploiement |
L'oubli classique porte sur la colonne de droite. Les exigences fonctionnelles se voient : il y a un écran, un bouton, un message d'erreur. Les qualités ne se voient que le jour où elles manquent, souvent en production. Or ce sont elles qui pèsent le plus sur l'architecture. Une durée de conservation des journaux décide d'un volume de stockage. Un délai de bascule décide d'une topologie.
La figure 2 reprend ces deux exemples.
des journaux"] -->|"décide de"| S["Volume de stockage"] B["Délai de bascule"] -->|"décide de"| T["Topologie"] class J,B focus
- Exigence non fonctionnelle
On range aussi parmi les non fonctionnelles les contraintes de déploiement et d'exploitation : sur quels environnements le logiciel tourne, avec quels droits, derrière quels équipements. Elles reviennent en détail au billet P13.
Écrire une exigence qu'on peut échouer
Une exigence utile est une exigence qu'un test peut faire échouer. Tout le reste est de l'intention. Six qualités permettent d'y arriver.
| Qualité | Ce que cela veut dire | Le signe qu'elle manque |
|---|---|---|
| Précise | Un seul sens possible | Des mots comme « sécurisé », « robuste », « approprié » |
| Testable | Un critère d'acceptation observable | Personne ne sait écrire le test |
| Atomique | Une seule chose par énoncé | Des « et » en série |
| Traçable | Une source citée | « On a toujours fait comme ça » |
| Réaliste | Atteignable avec les moyens du projet | Tout est noté « critique » |
| Indépendante de la solution | Dit quoi, pas comment | Un nom de produit dans l'énoncé |
La dernière qualité mérite une nuance. Une exigence dit le résultat attendu et laisse la conception choisir le moyen. « Les mots de passe sont stockés de façon à résister à une attaque hors ligne » est une exigence. « Utiliser telle bibliothèque en version 3 » est une décision de conception, qui a sa place ailleurs.
Voici cinq énoncés tels qu'on les trouve souvent, et ce qu'ils deviennent une fois réécrits.
| Avant | Après |
|---|---|
| L'application doit être sécurisée | Supprimé : ce n'est pas une exigence |
| Les données doivent être protégées | Les allergies déclarées ne sont lisibles que par les rôles salle et passe ; toute lecture est journalisée |
| Gérer correctement les erreurs | Aucune réponse d'erreur ne contient de trace d'exécution, de nom de table ni de version de composant |
| Mots de passe forts | Un mot de passe compte au moins douze caractères et n'apparaît pas dans une liste de mots de passe compromis |
| Les utilisateurs ne voient que leurs données | Une requête portant sur une commande dont le demandeur n'est pas le propriétaire reçoit la même réponse qu'une commande inexistante |
Le dernier exemple montre ce qu'apporte la précision. La version courte laisse ouverte une question que la version longue tranche : que répond-on à celui qui demande la commande d'un autre ? Répondre « interdit » confirme que la commande existe. Répondre « introuvable » ne dit rien.
Dans une équipe agile, l'exigence prend la forme d'un récit avec ses critères d'acceptation. Écrits sous forme de scénario, ils deviennent presque directement un test.
Scénario: un client ne peut pas lire la commande d'un autre
Étant donné un client A authentifié
Et une commande appartenant au client B
Quand A demande cette commande
Alors la réponse est "introuvable"
Et un refus d'accès est journalisé avec l'identité de A
La figure 3 rejoue ce scénario.
- Le client A, authentifié, demande une commande appartenant au client B
- La réponse est « introuvable », la même que pour une commande inexistante
- Un refus d'accès est journalisé avec l'identité de A
Il reste une famille qu'on oublie presque toujours : les exigences négatives. Elles disent ce que le système ne doit pas faire. Ne pas journaliser un secret. Ne pas conserver une donnée après usage. Ne pas exposer une interface d'administration sur Internet. Personne ne les réclame, parce qu'aucun utilisateur ne demande l'absence d'une fonction. Le cas réel de ce billet repose sur l'une d'elles.
Ne pas partir de la page blanche
Personne n'a besoin de réinventer la liste des exigences d'une application web. Des catalogues publics existent, et le plus utilisé est l'ASVS de l'OWASP. Il range plusieurs centaines d'exigences de vérification par thème, de l'authentification à la configuration, et les répartit en trois niveaux de rigueur.
Le bon usage tient en trois gestes. On choisit un niveau en fonction de ce que l'application manipule. On retire ce qui ne s'applique pas, en notant pourquoi. On ajoute ce que le catalogue ne peut pas connaître : les règles propres au métier, celles que seule l'analyse des biens et des menaces fait apparaître.
La figure 4 enchaîne ces trois gestes.
en fonction de ce que l'application manipule"] class N nouveau
en fonction de ce que l'application manipule"] --> R["Retirer ce qui ne s'applique pas
en notant pourquoi"] class N neutre class R nouveau
en fonction de ce que l'application manipule"] --> R["Retirer ce qui ne s'applique pas
en notant pourquoi"] R --> A["Ajouter ce que le catalogue ne peut pas connaître
les règles propres au métier"] class N,R neutre class A nouveau
- Ajouté à cette étape
Un catalogue donne le socle commun. Il ne dira jamais qu'une commande validée ne doit plus bouger, ni que tel champ est plus sensible que les autres. Ces exigences-là viennent de la première source, et ce sont souvent les plus importantes.
La conformité : traduire un texte en exigences
La troisième source a ses propres règles. Une obligation de conformité ne se discute pas, mais elle ne se code pas non plus telle quelle. Entre l'article d'un règlement et une ligne de backlog, il y a un travail de traduction.
On distingue quatre familles d'obligations.
| Famille | D'où elle vient | Qui contrôle | Exemple |
|---|---|---|---|
| Réglementaire | Une loi ou un règlement | Une autorité publique | La protection des données personnelles |
| Contractuelle | Un contrat avec un client ou un partenaire | L'autre partie | Un délai de notification d'incident promis au client |
| Sectorielle | Un standard imposé par une profession | Un organisme du secteur | Le standard de sécurité des données de l'industrie des cartes de paiement |
| Interne | Une politique de l'organisation | L'audit interne | Le standard de chiffrement de la maison |
La première question à poser est toujours la même : quels textes s'appliquent à ce logiciel, et quelle autorité en contrôle l'application ? La réponse dépend de ce qu'il traite, pour qui, et dans quels pays. Elle ne vient pas de l'équipe technique. Elle vient du juridique et de la conformité, et il faut aller la chercher tôt.
Vient ensuite la traduction, en quatre colonnes : l'obligation telle que le texte la formule, le contrôle qu'elle implique, l'exigence qu'on écrit pour le logiciel, et la preuve qu'on gardera.
| Obligation | Contrôle | Exigence pour le logiciel | Preuve |
|---|---|---|---|
| Le règlement européen sur la protection des données demande une sécurité adaptée au risque, et cite le chiffrement | Chiffrement des données personnelles sensibles | Les champs classés « restreint » sont chiffrés au repos avec une clé gérée hors de l'application | Configuration versionnée, test automatisé |
| Le même règlement impose la protection des données dès la conception et par défaut | Minimisation | Le formulaire de réservation ne collecte que les champs listés dans le registre des traitements | Revue du modèle de données à chaque évolution |
| Il impose de notifier une violation à l'autorité dans les 72 heures | Détection et qualification rapides | Tout accès anormal à des données personnelles déclenche une alerte traitée en moins de quatre heures | Journal des alertes et des délais |
| Le standard des cartes de paiement interdit de conserver le cryptogramme après l'autorisation | Non-conservation | Aucun composant, journal compris, n'écrit le cryptogramme sur un support persistant | Analyse automatique des journaux, test dédié |
La dernière ligne est une exigence négative, et elle descend jusqu'aux journaux. C'est le genre de précision qu'un texte ne donne pas et que la traduction doit ajouter.
La figure 5 suit cette dernière ligne, de l'obligation à la preuve.
- Le standard des cartes de paiement interdit de conserver le cryptogramme après l'autorisation
- Le contrôle que cette obligation implique : la non-conservation
- Aucun composant, journal compris, n'écrit le cryptogramme sur un support persistant
- La preuve qu'on gardera : une analyse automatique des journaux et un test dédié
Deux mises en garde ferment ce chapitre.
Et, comme le disait le billet P6, un texte fixe un plancher. Il ne remplace pas l'analyse de ses propres risques.
Pour le détail du règlement européen, le blog a une série dédiée, citée en fin de page.
Quand deux exigences se contredisent
Une liste d'exigences sérieuse contient des conflits. Les ignorer revient à laisser le développeur trancher seul, un vendredi soir.
| Conflit | D'un côté | De l'autre | Une façon de trancher |
|---|---|---|---|
| Tracer ou minimiser | Journaliser chaque accès avec le détail | Ne pas multiplier les copies de données personnelles | Journaliser l'identifiant de la ressource, jamais son contenu |
| Protéger ou servir | Verrouiller un compte après des échecs | Ne pas permettre à un tiers de bloquer un utilisateur | Ralentir progressivement plutôt que verrouiller |
| Conserver ou effacer | Garder les preuves pour un litige | Effacer à la demande de la personne | Durées par catégorie, écrites, avec les cas de gel |
| Chiffrer ou chercher | Chiffrer un champ sensible | Permettre la recherche sur ce champ | Index dérivé, ou recherche limitée à des rôles |
Chaque arbitrage se note, avec sa raison et le nom de celui qui l'a pris. C'est une décision de conception au sens plein, et elle sera contestée un jour par quelqu'un qui n'était pas là.
Reste à ordonner. Toutes les exigences ne se valent pas, et une liste où tout est obligatoire ne guide personne. Trois rangs suffisent : ce que la loi ou un contrat impose, ce que l'analyse de risque rend nécessaire, ce qui est souhaitable. Les deux premiers ne se négocient pas sprint par sprint. Le troisième, si.
La figure 6 empile ces trois rangs.
se négocie sprint par sprint"] class R1,R2 fort
- Ne se négocie pas sprint par sprint
Scénario : British Airways, ou le journal que personne n'avait demandé
Entre le 22 juin et le 5 septembre 2018, un attaquant accède aux systèmes de British Airways. L'autorité britannique de protection des données, l'ICO, clôt son enquête le 16 octobre 2020 par une sanction de 20 millions de livres. Elle avait d'abord annoncé son intention d'infliger plus de 183 millions.
La décision décrit le chemin suivi. L'attaquant se connecte avec les identifiants compromis d'un employé d'un prestataire, qui disposait d'un accès distant aux applications de la compagnie. Il s'échappe de l'environnement restreint où cet accès devait le contenir. Il trouve ensuite des identifiants à privilèges conservés en clair.
Deux sources de données s'offrent alors à lui. La première est un ensemble de fichiers journaux où des numéros de carte et leurs cryptogrammes étaient écrits en clair, pour certaines transactions, depuis 2015. La seconde est le site lui-même : l'attaquant modifie un script de la page de paiement pour détourner les données saisies vers un site qu'il contrôle.
Les données d'environ 429 612 clients et employés sont potentiellement concernées. La compagnie ne détecte rien pendant plus de deux mois. Elle est prévenue par un tiers. Elle ferme alors la faille en quatre-vingt-dix minutes.
La figure 7 reprend ce chemin, de la première connexion à la fermeture de la faille.
- L'attaquant se connecte avec les identifiants compromis d'un employé d'un prestataire
- Il s'échappe de l'environnement restreint où cet accès devait le contenir
- Il trouve ensuite des identifiants à privilèges conservés en clair
- Des journaux contiennent en clair des numéros de carte et leurs cryptogrammes, depuis 2015
- Il modifie un script de la page de paiement
- Les données saisies sont détournées vers un site qu'il contrôle
- La compagnie ne détecte rien pendant plus de deux mois : elle est prévenue par un tiers
- Elle ferme alors la faille en quatre-vingt-dix minutes
Relisons la décision comme une liste d'exigences absentes.
| Ce que la décision établit | L'exigence qui manquait | Sa source |
|---|---|---|
| Des cryptogrammes écrits en clair dans des journaux depuis 2015 | Aucun composant, journal compris, n'écrit le cryptogramme sur un support persistant | Sectorielle : standard des cartes de paiement |
| Un accès distant ouvert avec un simple mot de passe | Tout accès distant d'un tiers exige un second facteur | Organisation et menaces |
| Une sortie possible de l'environnement restreint | Un compte distant n'accède qu'aux applications prévues pour son rôle | Menaces : moindre privilège |
| Des identifiants à privilèges en clair | Aucun secret n'est stocké en clair, fichiers de scripts compris | Organisation |
| Un script de paiement modifié sans alerte | Toute modification d'un script servi sur la page de paiement est détectée | Menaces, et exploitation |
La première ligne est la plus instructive. Ces journaux n'étaient pas une fonction voulue. Ils venaient d'un mécanisme de diagnostic resté actif. Personne n'avait décidé de conserver des cryptogrammes. Personne, non plus, n'avait écrit qu'il ne fallait pas le faire.
Une exigence positive oubliée se remarque : il manque un écran, un client se plaint. Une exigence négative oubliée ne se remarque pas, parce que le logiciel fonctionne très bien avec un journal de trop. Elle ne se découvre qu'en la cherchant, et on ne la cherche que si elle est écrite.
Un dernier détail. L'ICO relève que la compagnie a corrigé la faille en une heure et demie une fois prévenue. La capacité à réparer existait. Ce qui manquait se situait bien plus tôt, dans une liste.
Testez-vous
Pourquoi les exigences non fonctionnelles s'oublient-elles plus que les fonctionnelles ?
Les exigences fonctionnelles se voient : il y a un écran, un bouton, un message d'erreur. Les qualités ne se voient que le jour où elles manquent, souvent en production.
Que répondre à celui qui demande la commande d'un autre : « interdit » ou « introuvable » ?
« Introuvable ». Répondre « interdit » confirme que la commande existe. Répondre « introuvable » ne dit rien.
D'où venaient les journaux de British Airways où des cryptogrammes étaient écrits en clair ?
D'un mécanisme de diagnostic resté actif. Personne n'avait décidé de conserver des cryptogrammes, et personne n'avait écrit qu'il ne fallait pas le faire.
Points clés
- Une exigence de sécurité vient de l'une de cinq sources : métier, menaces, conformité, organisation, exploitation. On doit pouvoir citer laquelle.
- Les exigences fonctionnelles décrivent un comportement, les non fonctionnelles une qualité. Les secondes pèsent le plus sur l'architecture et s'oublient le plus.
- Une exigence utile est précise, testable, atomique, traçable, réaliste et indépendante de la solution.
- Les exigences négatives disent ce que le système ne doit pas faire. Personne ne les réclame ; il faut les écrire quand même.
- Une obligation de conformité se traduit en quatre temps : obligation, contrôle, exigence, preuve.
- Les conflits entre exigences se tranchent explicitement, et la décision se note.
Dans la série
Palier 1 : Écrire la carte. Domaine : Exigences.
- Précédent : Gestion du risque logiciel : identifier, analyser, évaluer, traiter
- Suivant : Classification des données : cycle de vie, vie privée, destruction
- Vue d'ensemble : Sécurité du cycle de vie logiciel : par où commencer dans La Brigade
Pour aller plus loin
- CSSLP Certification Exam Outline, ISC2 : objectifs 3.1 et 3.2.
- Penalty notice, British Airways plc, Information Commissioner's Office, 16 octobre 2020.
- Information Commissioner fines British Airways plc £20 million in relation to its 2018 data breach, analyse de la décision par Bird & Bird.
- RGPD : les six bases légales et les sept principes et Violation de données : qualifier, notifier en 72 heures, sur ce blog.