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.

En bref. Une exigence de sécurité a une source qu'on peut citer et un test qui peut la faire échouer. Le cas réel est la sanction de British Airways par l'ICO, relue comme une liste d'exigences absentes. La première d'entre elles est négative : ne pas écrire le cryptogramme d'une carte dans un journal.

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.

  • La liste à laquelle la conception et les tests se réfèrent
Figure 1 : cinq sources alimentent la liste. La conception et les tests s'y 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.

À retenir. Une exigence dont personne ne peut dire d'où elle vient sera la première supprimée quand le calendrier se tendra.

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.

  • Exigence non fonctionnelle
Figure 2 : deux exigences non fonctionnelles et ce qu'elles décident dans l'architecture

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.

Client Aauthentifié Système Journal commande de B 1 « introuvable » 2 refus d'accès 3 1 2 3 1. Le client A, authentifié, demande une commande appartenant au client B 2. La réponse est « introuvable », la même que pour une commande inexistante 3. Un refus d'accès est journalisé avec l'identité de A
  1. Le client A, authentifié, demande une commande appartenant au client B
  2. La réponse est « introuvable », la même que pour une commande inexistante
  3. Un refus d'accès est journalisé avec l'identité de A
Figure 3 : le client A demande la commande du client B

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.

À retenir. Si personne ne sait écrire le test, ce n'est pas encore une exigence.

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.

  • Ajouté à cette étape
Figure 4 : les trois gestes pour se servir d'un catalogue d'exigences

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.

Obligationstandard descartes Contrôle Exigencepour le logiciel Preuve interdiction 1 non-conservation 2 3 test dédié 4 1 2 3 4 1. Le standard des cartes de paiement interdit de conserver le cryptogramme aprèsl'autorisation 2. Le contrôle que cette obligation implique : la non-conservation 3. Aucun composant, journal compris, n'écrit le cryptogramme sur un supportpersistant 4. La preuve qu'on gardera : une analyse automatique des journaux et un test dédié
  1. Le standard des cartes de paiement interdit de conserver le cryptogramme après l'autorisation
  2. Le contrôle que cette obligation implique : la non-conservation
  3. Aucun composant, journal compris, n'écrit le cryptogramme sur un support persistant
  4. La preuve qu'on gardera : une analyse automatique des journaux et un test dédié
Figure 5 : une obligation traduite en contrôle, en exigence, puis en preuve

Deux mises en garde ferment ce chapitre.

La conformité de façade. Une obligation mal traduite donne une conformité de façade : la case est cochée, le contrôle n'existe pas dans le code.

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.

  • Ne se négocie pas sprint par sprint
Figure 6 : trois rangs pour ordonner les exigences

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.

Accès distantd'un prestataire Identifiants àprivilègesen clair Fichiersjournaux Attaquant Page depaiement Site del'attaquant British Airways Tiers identifiants compromis 1 2 3 4 script modifié 5 données saisies 6 alerte 7 8 1 2 3 4 5 6 7 8 1. L'attaquant se connecte avec les identifiants compromis d'un employé d'unprestataire 2. Il s'échappe de l'environnement restreint où cet accès devait le contenir 3. Il trouve ensuite des identifiants à privilèges conservés en clair 4. Des journaux contiennent en clair des numéros de carte et leurs cryptogrammes,depuis 2015 5. Il modifie un script de la page de paiement 6. Les données saisies sont détournées vers un site qu'il contrôle 7. La compagnie ne détecte rien pendant plus de deux mois : elle est prévenue par untiers 8. Elle ferme alors la faille en quatre-vingt-dix minutes
  1. L'attaquant se connecte avec les identifiants compromis d'un employé d'un prestataire
  2. Il s'échappe de l'environnement restreint où cet accès devait le contenir
  3. Il trouve ensuite des identifiants à privilèges conservés en clair
  4. Des journaux contiennent en clair des numéros de carte et leurs cryptogrammes, depuis 2015
  5. Il modifie un script de la page de paiement
  6. Les données saisies sont détournées vers un site qu'il contrôle
  7. La compagnie ne détecte rien pendant plus de deux mois : elle est prévenue par un tiers
  8. Elle ferme alors la faille en quatre-vingt-dix minutes
Figure 7 : British Airways, de l'accès distant à la page de paiement

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.

À retenir. Ce qu'un logiciel ne doit pas faire s'écrit aussi. Sinon, il finit par le faire.

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.


Pour aller plus loin