Sécurité
L’appliance fonctionne sur du matériel et dans un réseau que vous exploitez. IronFlock fournit le logiciel et ses réglages par défaut ; le niveau de protection de l’appliance dépend aussi du mode que vous choisissez, du réseau qui l’entoure et de l’hôte sur lequel elle tourne. Cette page est la liste de contrôle pour cette partie.
Ce que protège chaque mode
L’appliance fonctionne dans l’un des trois modes décrits dans HTTPS et certificats. Ils diffèrent par ce qui est chiffré et vérifié :
| HTTP en clair (par défaut) | HTTPS avec une CA auto-émise | HTTPS avec votre certificat d’entreprise | |
|---|---|---|---|
| Navigateur vers l’appliance | Non chiffré | HTTPS | HTTPS |
| Cookies de connexion | Non marqués comme sécurisés | Sécurisés | Sécurisés |
Liaison des appareils (port 18080) | Non chiffrée | Non chiffrée | HTTPS sur 443 |
| Images d’apps et mises à jour de l’agent pour les appareils | Non chiffrées | Non chiffrées | HTTPS sur 443 |
| Tunnel d’accès distant des appareils | Chiffré, serveur non vérifié | Chiffré, serveur non vérifié | Chiffré et vérifié |
| Passkeys et clés de sécurité | Uniquement depuis l’appliance elle-même | Oui | Oui |
Utilisez HTTPS avec votre certificat d’entreprise partout où l’appliance partage un réseau avec d’autres systèmes. C’est le seul mode dans lequel les appareils connectés vérifient à qui ils s’adressent. Les deux autres modes conviennent à un segment réseau que seuls l’appliance, ses appareils et ses opérateurs peuvent atteindre.
Ce qui reste non chiffré
Même avec HTTPS, une partie du trafic n’est pas chiffrée. Concevez votre réseau en conséquence :
- La liaison des appareils sur le port
18080est publiée sur toutes les interfaces réseau, dans tous les modes. L’agent d’appareil de l’appliance elle-même et les apps qui tournent sur l’appliance s’y connectent, et, en mode HTTP en clair et avec une CA auto-émise, tous les appareils connectés également. - Les tunnels d’accès distant vers l’appliance (port
7000) sont chiffrés en mode HTTP en clair et avec une CA auto-émise, mais les appareils ne peuvent pas vérifier le certificat de l’appliance. Une personne ayant accès au chemin réseau pourrait se faire passer pour le serveur de tunnel de l’appliance. Les agents d’appareil consignent un avertissement lorsqu’ils se connectent de cette manière. - Les connexions entre les services à l’intérieur de l’appliance, par exemple vers ses bases de données, ne sont pas chiffrées. Elles ne quittent pas l’hôte.
- Les données au repos ne sont pas chiffrées par l’appliance. Utilisez le chiffrement du système d’exploitation ou du disque de l’hôte si l’appliance stocke des données sensibles ou est susceptible de quitter vos locaux.
Liste de contrôle de durcissement
- Choisissez le mode adapté à votre réseau (voir Ce que protège chaque mode).
- Limitez qui peut atteindre les ports de l’appliance. L’installation n’ouvre rien dans votre pare-feu, et Docker publie les ports de l’appliance en contournant les règles d’entrée habituelles du pare-feu de l’hôte (
ufw,firewalld). Filtrez dans la chaîneDOCKER-USERou au niveau de votre pare-feu réseau : l’installation dépose un modèle dans/opt/ironflock/docker-user-firewall.sh.example. N’autorisez les ports des appareils (18080,15001,15002,7000,30000–30049) que depuis vos réseaux d’appareils — voir Appareils se connectant à l’appliance. - Maintenez à jour le système d’exploitation de l’hôte et limitez qui y possède un compte. Toute personne disposant d’un accès root sur l’hôte peut lire tous les secrets de l’appliance.
- Utilisez des clés SSH plutôt que des mots de passe pour l’accès administratif à l’hôte.
- Configurez la synchronisation horaire — voir Synchronisation horaire (NTP).
- Changez le mot de passe admin après la première connexion et configurez un second facteur pour le compte admin.
- Exigez un second facteur pour tous dès que tous les comptes en ont un (voir Comptes et accès).
- Protégez le compte ironflock.com propriétaire de l’instance avec un second facteur : il dispose d’un accès admin à l’appliance depuis le cloud.
- Désactivez la connexion cloud si personne n’a besoin de travailler sur l’appliance depuis ironflock.com (voir Connexion cloud).
- N’installez que des apps de confiance. Les apps s’exécutent sur l’appliance et sur vos appareils avec un large accès à l’hôte, y compris aux fichiers de configuration de l’appliance.
- Maintenez l’appliance à jour (voir Mises à jour).
- Vérifiez
ironflockavant la première installation (voir Vérifierironflockavant la première installation).
Comptes et accès
- Compte admin : chaque appliance reçoit son propre mot de passe admin lors de l’installation ;
ironflock appliance installl’affiche une seule fois. S’il est perdu, définissez-en un nouveau comme décrit dans Fonctionnement local — cela déconnecte aussi toutes les sessions admin. - Les nouveaux utilisateurs ne peuvent s’inscrire qu’avec une invitation d’un projet de l’appliance. Sans invitation, l’inscription est refusée, y compris via une connexion sociale.
- Second facteur : les utilisateurs peuvent configurer une application d’authentification (TOTP), des passkeys ou des clés de sécurité, ainsi que des codes de récupération. Les passkeys et les clés de sécurité nécessitent HTTPS. L’option
--2fadeironflock appliance installou deironflock appliance configuredéfinit la politique, qui est conservée lors des mises à jour :available— les utilisateurs peuvent configurer un second facteur, mais il ne leur est jamais demandé.effective(par défaut) — les utilisateurs qui ont un second facteur doivent l’utiliser.required— chaque utilisateur doit utiliser un second facteur. Assurez-vous d’abord que chaque compte en possède un : un utilisateur qui n’en a pas ne peut plus se connecter.
- Les sessions durent 24 heures.
- Accès depuis ironflock.com : le compte ironflock.com qui a créé la clé d’instance est relié au compte admin de l’appliance. Les utilisateurs que vous invitez relient leurs propres comptes ironflock.com — voir Liaison des comptes. Un utilisateur peut supprimer cette liaison à tout moment. Pour bloquer tout accès depuis ironflock.com, l’administrateur désactive la connexion cloud.
Secrets sur l’hôte
ironflock appliance install génère les secrets de l’appliance une seule fois, lors de l’installation, et les conserve lors des mises à jour. Ils se trouvent sous /opt/ironflock/ :
| Fichier | Contenu | Accès |
|---|---|---|
.env | Mots de passe et clés de tous les services, le mot de passe admin initial, les identifiants du proxy et du SMTP | root uniquement (0600) |
license.env | La clé d’instance, et ce que la validation de la licence enregistre avec elle | root et les services IronFlock (0640) |
certs/ | Le certificat HTTPS et sa clé ; avec une CA auto-émise, également la clé de la CA | Clés privées root uniquement (0600) |
registry-token-certs/ | La clé qui signe les jetons de téléchargement des images d’apps | Le service de registre uniquement (0600) |
.env.prev, rotation.log | Le .env d’avant la dernière rotation ; quel secret a fait l’objet d’une rotation et quand, sans les valeurs | root uniquement (0600) |
L’installation connecte également Docker au registre IronFlock avec votre clé d’instance ; la configuration Docker de root la contient donc aussi.
Incluez ces fichiers dans vos sauvegardes et protégez les sauvegardes comme l’appliance elle-même. Ne supprimez jamais .env et ne laissez jamais une installation le générer à nouveau : les bases de données et les données chiffrées dépendent de ses valeurs. Pour remplacer un secret, effectuez sa rotation.
Ce que vous pouvez remplacer vous-même :
- Mot de passe admin : dans le profil, ou avec
sudo ironflock appliance reset-admin-password(voir Fonctionnement local). - Certificat HTTPS : votre propre certificat avec
sudo ironflock appliance configure --tls-cert <file> --tls-key <file>(voir HTTPS et certificats). Un certificat émis par la CA propre à l’appliance se renouvelle de lui-même : une vérification hebdomadaire en signe un nouveau lorsqu’il reste moins de 30 jours. - Clé d’instance : dans la section licence du profil admin, ou avec
sudo ironflock appliance configure --license-file <file>, où le fichier contient la nouvelle clé. La nouvelle clé doit ouvrir l’accès au registre IronFlock avant d’être écrite. - Identifiants SMTP : dans
.env, puis redémarrez avecsudo ironflock appliance restart. - Proxy : avec
sudo ironflock appliance configure(voir Derrière un proxy d’entreprise). - Secrets internes des services :
sudo ironflock appliance rotate <NAME>, voir ci-dessous.
Rotation d’un secret interne
sudo ironflock appliance rotate <NAME> donne une nouvelle valeur à un secret du .env pendant que l’appliance fonctionne. La nouvelle valeur va d’abord là où l’ancienne est conservée (un rôle de base de données, le fichier d’appareil de l’agent, la paire de clés des jetons du registre), puis dans .env. Seuls les services qui lisent le secret sont recréés, et la commande vérifie qu’ils sont en bonne santé. Le .env d’avant la modification est conservé sous le nom .env.prev, et rotation.log liste chaque rotation, jamais une valeur. ironflock appliance rotate --help liste les noms dont elle peut effectuer la rotation. Voir ironflock appliance rotate.
Effectuez les rotations via SSH ou sur la console de l’appliance, et non dans le terminal de l’appareil de l’appliance elle-même dans IronFlock : une rotation qui redémarre les services dont dépend ce terminal le coupe.
| Secrets | Effet d’une rotation |
|---|---|
WAMP_SECRET_SVC_*, WAMP_SYSTEM_SECRET et les autres secrets des services | Les services qui l’utilisent redémarrent ; leurs connexions se rétablissent en quelques secondes. |
KRATOS_SECRETS_COOKIE | Les nouvelles connexions d’utilisateurs utilisent la nouvelle clé ; les sessions ouvertes auparavant restent valides, car la clé précédente est conservée jusqu’à la rotation suivante. |
POSTGRES_PASSWORD, PGPASSWORD_*, DATASERVICE_PASSWORD | Le rôle de base de données reçoit le nouveau mot de passe, puis ses services redémarrent. Pose d’abord la question ; --yes répond. |
REGISTRY_TOKEN_KEY | Les jetons de téléchargement des images d’apps sont signés avec une nouvelle clé ; les jetons signés auparavant restent valides jusqu’à la rotation suivante. Pose d’abord la question ; --yes répond. |
APPLIANCE_DEVICE_SECRET | L’appareil de l’appliance elle-même reçoit de nouveaux identifiants ; son agent redémarre et est de nouveau en ligne en moins d’une minute. Pose d’abord la question ; --yes répond. |
FILE_CRED_KEY | Les applications conservent leurs fichiers ; leur accès au stockage passe à la nouvelle clé. Pour les identifiants S3 directs des applications, choisissez --keep-direct-access ou --revoke-direct-access. Les identifiants conservés continuent de fonctionner, pour une rotation planifiée : quiconque connaît la clé précédente peut encore les dériver, c’est pourquoi les paramètres de stockage de chaque application les signalent à remplacer, et sudo ironflock appliance revoke-direct-access supprime plus tard ceux qui restent. Les identifiants révoqués cessent de fonctionner et sont supprimés immédiatement, par exemple après une fuite présumée. Pose d’abord la question (--yes répond) et nécessite la version 1.6.23 ou ultérieure de l’appliance. |
APPLIANCE_ADMIN_PASSWORD | Un nouveau mot de passe admin initial, comme avec ironflock appliance reset-admin-password. |
N’effectuez la rotation de FLEETDB_SECRET_KEYS, KRATOS_SECRETS_CIPHER et des deux clés OBJECTSTORE_ADMIN_* qu’avec l’équipe IronFlock : les données stockées avec elles en dépendent. La clé d’instance se change dans le profil admin ou avec ironflock appliance configure, et non avec rotate.
Connexions sortantes et télémétrie
Les destinations auxquelles l’appliance se connecte sont listées dans Configuration du pare-feu ; toutes ces connexions sont chiffrées.
- La validation de la licence envoie la clé de licence, une empreinte du matériel et les jetons d’accès des connexions de l’appliance à l’App Store en ligne.
- L’assistant IA envoie les prompts via la passerelle LLM d’IronFlock, sauf si vous configurez votre propre passerelle.
- Aucune télémétrie. L’appliance n’envoie aucune donnée d’analyse d’utilisation : ni l’interface de l’appliance ni ses services ne transmettent de données d’utilisation à IronFlock ou à des tiers.
- Depuis le navigateur de l’utilisateur : les tuiles de carte sont chargées depuis Mapbox, et la saisie vocale utilise le service de reconnaissance vocale Deepgram. Ces connexions sont établies par le navigateur, pas par l’appliance.
Mises à jour
- Les mises à jour de l’appliance sont lancées par l’admin (voir Maintenance) et signées par IronFlock.
ironflockvérifie la liste des versions disponibles et le manifeste de publication de la nouvelle version avec la clé de publication de l’appliance qu’il contient, puis chaque fichier de la nouvelle version et chaque image de conteneur par rapport à ce manifeste. Un fichier modifié ou non signé, ou toute image autre que celle publiée, arrête la mise à jour avant que quoi que ce soit ne change sur l’appliance. Une mise à jour ne ramène jamais d’elle-même l’appliance à une version plus ancienne, et si une mise à jour échoue, l’appliance revient à la version qu’elle exécutait auparavant. - Les mises à jour de l’agent d’appareil sont signées. Chaque agent vérifie la signature avant d’appliquer une mise à jour et revient à la version précédente si la nouvelle version ne démarre pas — voir Mises à jour de l’agent d’appareil.
- Le système d’exploitation de l’hôte relève de votre responsabilité, y compris Docker.
Vérifier ironflock avant la première installation
L’appliance vérifie elle-même chaque mise à jour : ironflock vérifie chaque version de l’appliance avec la clé de publication de l’appliance IronFlock qu’il contient, avant de l’installer. Ce à quoi vous faites confiance, c’est le script d’installation d’ironflock, qui s’exécute en tant que root. Vérifiez-le avant son exécution, comme décrit dans Vérifier d’abord le script d’installation : gpg doit signaler une signature valide de la clé IronFlock Bootstrap avec l’empreinte F6C9 4D96 CE31 5377 ACA7 C8EA 4990 5433 7321 2788. Le script vérifie à son tour ironflock avec cette clé avant de l’installer. Les deux clés sont listées sur la page Clés de signature.
Sauvegarde et restauration
Pour sauvegarder toute l’appliance, arrêtez-la avec sudo ironflock appliance stop et copiez :
- le dossier
/opt/ironflock/, y compris.env,license.env,certs/etregistry-token-certs/; - les volumes Docker de l’appliance (
docker volume ls), qui contiennent les bases de données, les fichiers, le local App Store et les fichiers des utilisateurs.
Redémarrez-la ensuite avec sudo ironflock appliance start. Conservez .env avec les volumes du même instant : les données chiffrées des volumes ne peuvent être lues qu’avec les clés de ce .env.
Les secrets seuls peuvent être sauvegardés pendant que l’appliance fonctionne :
sudo ironflock appliance backup -o /root/appliance-secrets.tar.gzL’archive contient .env, license.env, la CA, les clés des jetons du registre, le registre des secrets et rotation.log ; seul root peut lire le fichier. Un FLEETDB_SECRET_KEYS ou un FILE_CRED_KEY perdu ne peut être récupéré d’aucune autre manière : chiffrez l’archive et conservez-la avec les sauvegardes des volumes.
Pour remettre les secrets en place sur une appliance installée, restaurez-les avec --force pendant qu’elle tourne, puis redémarrez-la afin que chaque service lise les fichiers restaurés :
sudo ironflock appliance restore appliance-secrets.tar.gz --force
sudo ironflock appliance restartLe .env de l’appliance d’avant la restauration est conservé sous le nom .env.prev. Sur une nouvelle machine, installez ironflock, exécutez sudo ironflock appliance restore appliance-secrets.tar.gz, puis installez l’appliance comme d’habitude, avec la clé d’instance et les options utilisées auparavant, par exemple --tls. Voir ironflock appliance backup et ironflock appliance restore.
Mise hors service
-
Déplacez ou libérez la licence tant que l’appliance est encore en ligne — voir Déplacer votre licence vers un nouveau matériel.
-
Supprimez le logiciel :
sudo ironflock appliance remove --purge sudo ironflock agent removeironflock appliance remove --purgesupprime les services, les conteneurs et le réseau de l’appliance, la connexion de Docker au registre IronFlock, les modifications que son installation a apportées à l’hôte et, avec--purge, aussi ses données : le répertoire d’installation/opt/ironflockavec.envetlicense.env, les volumes Docker et les images.ironflock agent removesupprime ensuite l’agent d’appareil propre à l’appliance. Chaque commande liste ce qu’elle supprime et pose d’abord la question ;--yesrépond. Docker lui-même reste installé, de même qu’ironflockdans/usr/local/bin. Voirironflock appliance removeetironflock agent remove. -
Si le matériel quitte vos locaux, effacez son disque de manière sûre — les commandes ci-dessus suppriment les fichiers, mais ne les écrasent pas.
Paramètres qui affaiblissent la sécurité
Certains paramètres n’existent que pour le dépannage. Ne les définissez pas en production :
AGENT_UPDATE_ALLOW_UNSIGNED— permet à un agent d’appareil d’appliquer des mises à jour non signées. Il ne fonctionne qu’avecuntil=<time>, au plus 24 heures à l’avance, puis expire de lui-même.TUNNEL_AUTHZ_ENFORCE=false— permet aux appareils d’ouvrir des tunnels sans prouver leur identité.?tls.rejectUnauthorized=falsedansSMTP_CONNECTION_URI— accepte n’importe quel certificat de votre serveur de messagerie.--2fa available— les seconds facteurs ne sont jamais demandés.