Agent de redirection de port

La redirection de port vous permet d'accéder depuis votre poste de travail à un port TCP d'un appareil déployé, tel que SSH ou une interface web locale. Cette page vous explique comment activer l'agent sur l'appareil et ouvrir une session de redirection avec la CLI fun.

Fonctionnement

L'agent présent sur l'appareil continue d'utiliser la connexion MQTTS existante de l'appareil. Lorsque vous ouvrez une session, le trafic entre votre port local et le port de l'appareil transite par cette connexion. Vous n'ouvrez aucun port entrant sur l'appareil ni sur son réseau.

Vous pouvez exécuter l'agent de deux façons :

Option	À utiliser lorsque
Intégré au daemon Linux	L'appareil exécute déjà le daemon. Depuis la version 1.8 du daemon, cette option prend également en charge le terminal distant.
`fundamentum-edge-pfwd` autonome	Vous n'avez besoin que de la redirection de port, sans le daemon.

Avant de commencer

L'appareil est provisionné. Consultez Provisionnement.
Le service que vous souhaitez atteindre écoute sur l'appareil, par exemple SSH sur le port 22.
La CLI fun est installée et connectée sur votre poste de travail, avec un accès au projet de l'appareil.

1. Activer l'agent sur l'appareil

Option A : dans le daemon Linux

La redirection de port est désactivée par défaut. Activez-la dans config.toml :

[pfwd]
enabled = true

Ou démarrez le daemon avec --pfwd :

fundamentum-edge --pfwd

Option B : agent autonome

Installez l'agent autonome depuis crates.io :

cargo install fundamentum-edge-pfwd

Exécutez-le avec l'identité de l'appareil et sa clé privée :

fundamentum-edge-pfwd \
  --private-key ./rsa_private.pem \
  --project-id <project-id> \
  --region-id 1 \
  --registry-id <registry-id> \
  --serial <serial-number> \
  --endpoint mqtts.fundamentum-iot.com

Option	Valeur par défaut	Description
`--private-key`	`./rsa_private.pem`	Clé privée de l'appareil
`--project-id`, `--region-id`, `--registry-id`, `--serial`	Aucune	Identité de l'appareil
`--endpoint`	`localhost`	Hôte du broker MQTT ; définissez-le sur `mqtts.fundamentum-iot.com`

Si vous avez besoin d'une paire de clés, générez-la comme indiqué dans Auto-provisionnement.

2. Ouvrir une session depuis votre poste de travail

Redirigez un port de l'appareil vers un port local :

fun devices port-forward --project <project-id> --registry <registry-id> --serial <serial-number> \
  --remote-port 22 --local-port 2222

Option	Description
`-p`, `--project`	ID du projet
`-r`, `--registry`	ID du registre
`-s`, `--serial`	Numéro de série de l'appareil
`-d`, `--remote-port`	Port sur l'appareil ; il doit être en écoute
`-l`, `--local-port`	Port sur votre poste de travail

L'alias court est fun devices pf. Utilisez --context <name> pour choisir un autre contexte de la CLI (par défaut : default).

3. Utiliser le port redirigé

Tant que la session est ouverte, connectez-vous au port local comme si vous vous connectiez à l'appareil :

ssh -p 2222 <device-user>@localhost

Appuyez sur n'importe quelle touche dans le terminal fun pour fermer la session.

Étapes suivantes

Terminal distant et redirection de port pour le point de vue de l'opérateur.
La CLI fun.