Exploitation

Fonctionnement local

Si vous ne souhaitez pas garder l’appliance en ligne, vous pouvez toujours utiliser un navigateur sur le même réseau local et accéder à l’adresse IP ou au nom d’hôte de l’appliance :


http://<appliance-host>

Connectez-vous en tant qu’utilisateur admin :

Nom d’utilisateur : admin
Mot de passe : le mot de passe admin initial généré pour votre appliance

L’installateur affiche ce mot de passe à la fin de l’installation. Il est également enregistré sous APPLIANCE_ADMIN_PASSWORD dans /opt/ironflock/.env sur l’hôte de l’appliance, un fichier lisible uniquement par root :


sudo grep '^APPLIANCE_ADMIN_PASSWORD=' /opt/ironflock/.env

Modifiez le mot de passe après votre première connexion.

Mot de passe admin oublié ? Exécutez ceci sur l’hôte de l’appliance pour en définir un nouveau ; la commande affiche le nouveau mot de passe :


curl -fsSL https://instance-registry.ironflock.com/dl/appliance/install_ironflock.sh \
  | sudo bash -s -- --reset-admin-password

Appliances plus anciennes : une appliance installée avant que l’installateur ne génère le mot de passe admin démarre avec le mot de passe ironflock. La première connexion avec celui-ci vous demande de définir un nouveau mot de passe.

UI web des apps

Lorsqu’une app sur un appareil connecté expose une interface web, l’appliance la rend accessible à travers son tunnel intégré. D’emblée, cela n’exige rien de l’IT de l’entreprise — chaque UI d’app est publiée en HTTP simple sur un port attribué automatiquement de l’adresse de l’appliance (http://<appliance-host>:<port>), et l’IronFlock UI affiche le lien. L’accès reste protégé par la connexion à l’appliance.

Pour des URL https:// de confiance sur un réseau d’entreprise partagé — avec un certificat générique de votre CA ou un reverse proxy terminant le TLS — consultez UI des apps et HTTPS.

Liaison des comptes

Créez des comptes utilisateurs locaux pour votre équipe en les invitant par e-mail depuis les paramètres de votre projet sur l’appliance. L’e-mail d’invitation contient tout ce dont l’invité a besoin :

Un lien de connexion personnel — l’ouvrir sur ironflock.com connecte le compte ironflock.com de l’invité à l’appliance. S’il ne possède pas encore de compte ironflock.com, il en crée d’abord un avec l’adresse e-mail invitée (la connexion n’est accordée que si les deux adresses e-mail correspondent). Une fois la connexion établie, l’appliance apparaît dans son sélecteur de projets ironflock.com et il peut y travailler à distance immédiatement — aucune clé manuelle, aucune inscription locale requise.
Un lien d’inscription locale — optionnel : finaliser l’inscription locale lui permet en plus de se connecter directement sur l’interface de l’appliance (http://<appliance-host>).

Quelques points à connaître :

Les utilisateurs locaux existants n’ont pas besoin d’une nouvelle invitation du propriétaire du projet. Sur l’interface de l’appliance, ils ouvrent leur Profil et cliquent sur M’envoyer le lien de connexion par e-mail dans la section Se connecter à ironflock.com.
Renvoyer le lien : inviter à nouveau la même adresse e-mail (ou cliquer à nouveau sur le bouton du profil) génère un nouveau lien de connexion. Seul le lien du dernier e-mail envoyé est valide.
Si l’appliance ne peut pas envoyer d’e-mails — par exemple sur un réseau d’entreprise restreint qui bloque le relais de messagerie — le lien de connexion est affiché directement dans l’interface : l’invitant le copie et le transmet par le canal de son choix. Le lien doit être ouvert dans un navigateur disposant d’un accès internet.
Déconnexion : un utilisateur peut supprimer la connexion à tout moment sur ironflock.com sous Profil → Instances → Instances connectées. Rouvrir le dernier lien de connexion la rétablit.

Le propriétaire de l’instance — l’utilisateur qui a créé l’Instance Key sur ironflock.com — est automatiquement connecté au compte admin local de l’instance ; aucune invitation n’est nécessaire pour le propriétaire.

Synchroniser les apps depuis la boutique en ligne

L’Appliance inclut un local App Store — un catalogue d’apps privé et un registre de conteneurs qui diffuse les apps aux appareils du réseau local. Vous pouvez alimenter cette boutique locale en synchronisant des apps depuis l’IronFlock Store public en ligne, à condition que l’Appliance dispose d’une connexion internet au moment de la synchronisation. Aucune connexion internet permanente n’est nécessaire ; une connexion temporaire suffit pour récupérer les apps dont vous avez besoin.

Prérequis

Un compte sur la plateforme publique ironflock.com.
Votre compte appliance est connecté à votre compte ironflock.com (voir Liaison des comptes). Le compte admin du propriétaire de l’instance est connecté automatiquement.

Fonctionnement de la synchronisation des apps


┌────────────────────┐                       ┌────────────────────┐
│  Online IronFlock  │  ◄──── account ─────► │  Appliance         │
│  Store (cloud)     │      connection       │  local Store       │
└────────────────────┘                       └────────────────────┘
         │                                            │
   apps available to                          sync button shown
   the connected account                      instead of install

Ouvrez le local App Store — Lorsque l’Appliance dispose d’une connexion internet active, l’App Store affiche toutes les apps disponibles pour votre compte ironflock.com connecté sur la plateforme en ligne.
Synchronisez les apps dont vous avez besoin — Au lieu d’un bouton Install, chaque app affiche un bouton Sync. Cliquer dessus télécharge l’app — y compris ses images de conteneurs et ses métadonnées — depuis la boutique en ligne vers la boutique locale.
Ajoutez des appareils — Une fois synchronisée, l’app est entièrement disponible dans votre boutique locale et vous pouvez y ajouter des appareils normalement, sans connexion internet.

Flux de mise à jour

Lorsqu’une nouvelle version d’une app synchronisée est publiée sur la boutique en ligne, un bouton Sync réapparaît pour cette app. Connectez brièvement l’Appliance à internet, synchronisez la nouvelle version, puis déployez-la sur vos appareils via le flux de mise à jour d’app standard.

Cette conception vous donne un contrôle total sur ce qui entre dans votre réseau — rien n’est téléchargé automatiquement, et la connexion internet n’est nécessaire que pendant l’étape de synchronisation.

Expéditeur d’e-mails personnalisé (SMTP)

Par défaut, tous les e-mails de la plateforme — vérification de compte, récupération de mot de passe, invitations et notifications d’alarme — sont relayés via le proxy SMTP cloud d’IronFlock et apparaissent comme [email protected]. Pour que les e-mails semblent envoyés par votre propre entreprise, faites pointer l’appliance vers votre propre serveur SMTP.

Sur l’hôte de l’appliance, modifiez le fichier d’environnement généré par l’installateur dans /opt/ironflock/.env et définissez les variables suivantes :


SMTP_CONNECTION_URI=smtps://USERNAME:[email protected]:465/
SMTP_FROM_ADDRESS=[email protected]
SMTP_FROM_NAME=Your Company

Utilisez smtps:// pour TLS implicite (généralement port 465), ou smtp:// avec STARTTLS (port 587).
Encodez en URL les caractères spéciaux du nom d’utilisateur ou du mot de passe (par exemple @ → %40).
SMTP_FROM_ADDRESS et SMTP_FROM_NAME correspondent à ce que les destinataires voient dans l’en-tête De de chaque e-mail de la plateforme.

Appliquez les changements en redémarrant la pile :


sudo systemctl restart ironflock.service

Après le redémarrage, tous les e-mails d’authentification, les notifications de la plateforme et les e-mails d’alarme sont envoyés via votre serveur SMTP avec l’adresse et le nom d’expéditeur de votre entreprise.

Si SMTP_CONNECTION_URI n’est pas défini, l’appliance continue d’acheminer les e-mails via le proxy SMTP cloud d’IronFlock authentifié avec votre clé de licence — aucune configuration supplémentaire n’est nécessaire, mais les e-mails porteront la marque IronFlock.

Maintenance

Pour mettre à jour le système IronFlock sur votre appliance, l’administrateur peut utiliser le bouton de mise à jour dans la section licence de son profil dès qu’une nouvelle version est disponible. L’appliance a besoin d’une connexion internet pour télécharger la mise à jour. IronFlock redémarre automatiquement une fois la mise à jour terminée.

Les mises à jour du système d’exploitation Linux sont à votre charge.

Cycle de vie de la licence

Votre licence est liée à une seule Appliance physique. La même licence ne peut pas faire fonctionner une seconde instance IronFlock sur un matériel différent en même temps. Pour le fonctionnement quotidien, l’Appliance fonctionne hors ligne — les données de production, les tableaux de bord, la gestion des apps et le contrôle des appareils edge restent tous localement sur le boîtier.

Quand l’Appliance a besoin d’internet

Une connexion internet n’est requise qu’à ces moments-là :

Installation initiale et mises à jour de l’Appliance — nécessaire de toute façon pour télécharger le logiciel depuis les serveurs de distribution IronFlock ; la licence est activée dans la même étape.
Revérification périodique de la licence — dépend de votre plan :
- Licence mensuelle : une fois tous les 30 jours.
- Licence annuelle : une fois tous les 365 jours.
- Licence perpétuelle : pas de revérification périodique — internet n’est nécessaire qu’à l’installation et lors des mises à jour.
Transfert de licence vers un nouveau matériel (voir ci-dessous).
Service AI Multi Agent — uniquement pendant qu’il est activement utilisé.

Période de grâce et verrouillage

Si une revérification périodique ne peut pas atteindre le cloud (panne réseau, erreur cloud transitoire), l’Appliance entre dans une période de grâce de 7 jours. Pendant cette période, l’Appliance continue de fonctionner normalement et réessaie automatiquement.

Si sept jours complets s’écoulent sans revérification réussie, l’Appliance se verrouille : la plupart des opérations sont refusées et l’interface affiche la licence comme invalide. Pour récupérer, rétablissez la connexion internet de l’Appliance et cliquez sur Revalider maintenant dans le panneau de licence de votre profil sur l’interface de l’Appliance (la vue locale http://<appliance-host>, ou votre instance accédée via ironflock.com).

Déplacer votre licence vers un nouveau matériel (transfert)

Une licence est liée à l’empreinte matérielle d’une machine. Pour la déplacer vers une autre machine, vous initiez un transfert depuis votre profil cloud IronFlock :

Ouvrez Profil → Instances sur ironflock.com.
Cliquez sur Réinitialiser l’empreinte matérielle sur l’instance que vous souhaitez déplacer.

Le transfert nécessite que l’Appliance actuellement liée soit en ligne. Le cloud se reconnecte à elle, lui demande de se révoquer localement, et seulement ensuite efface l’empreinte côté cloud. Cette poignée de main garantit que l’ancienne Appliance ne peut pas continuer à fonctionner pendant qu’une nouvelle se lie — évitant l’usage double accidentel de la même licence.

Une fois le déblocage réussi :

Configurez le nouveau matériel en suivant les étapes du Installation, en utilisant la même instance key.
La nouvelle Appliance se valide, lie son empreinte, et devient l’appareil actif.

Lorsque l’ancien matériel est en panne ou inaccessible

Si l’Appliance précédemment liée est hors d’usage ou autrement injoignable, la poignée de main expirera et l’interface cloud affichera appliance_unreachable_contact_support. Dans ce cas, contactez l’équipe IronFlock — nous pouvons effacer la liaison manuellement après vérification de la propriété.

Astuce : déclenchez le transfert avant de mettre l’ancien matériel hors service, tant qu’il est encore en ligne. Le processus est beaucoup plus rapide — pour vous et pour notre équipe de support — lorsque l’ancienne Appliance peut encore être atteinte.