L'Agent BrynQ a besoin d'une clé pour fonctionner : un jeton d'API BrynQ qui appartient à votre environnement BrynQ. Vous le collez une seule fois lors de l'installation de l'Agent. L'Agent le conserve sur le serveur et s'en sert pour prouver à BrynQ à quel client il appartient.
Sans jeton valide, l'Agent ne peut pas établir sa connexion sécurisée avec BrynQ ni se mettre à jour.
| Quand | Ce que fait le jeton |
| Pendant l'installation | BrynQ vérifie le jeton et identifie le client auquel il appartient. BrynQ crée ensuite la connexion sécurisée et l'adresse propre à votre Agent : https://<votre-client>.brynq-agent.com. |
| Mises à jour automatiques | L'Agent utilise le jeton pour rechercher les nouvelles versions et les télécharger depuis BrynQ. |
| Test de connexion | La page Connexion BrynQ du tableau de bord d'administration local utilise le jeton pour vérifier que BrynQ accepte cet Agent. |
| Requêtes entrantes | L'Agent n'accepte que les requêtes pour votre client. Les requêtes pour un autre client sont refusées, même avec un jeton valide. |
L'Agent n'accepte qu'un jeton lié à un seul client : le client pour lequel l'Agent est installé.
Demandez le jeton d'Agent de votre environnement à votre consultant BrynQ ou au support BrynQ. BrynQ le crée pour vous et vous le transmet de façon sécurisée.
À convenir avant la création du jeton :
N'utilisez pas de jeton de la page Admin Portal › Accès API : ce sont des jetons administrateur pour tous les clients, et l'Agent les refuse.
Lors d'une réinstallation ou d'une mise à niveau, le programme d'installation détecte qu'un jeton est déjà enregistré. Laissez Garder le jeton d'API existant (recommandé) sélectionné, ou choisissez Le remplacer par un nouveau jeton d'API et collez le nouveau.
Il n'est pas nécessaire de réinstaller l'Agent pour remplacer le jeton.
BrynQ vérifie d'abord le nouveau jeton. Il n'est enregistré que si BrynQ l'accepte pour votre client : un mauvais jeton ne remplace donc jamais un jeton qui fonctionne.
Le programme d'installation et la page Connexion BrynQ indiquent pourquoi BrynQ n'accepte pas un jeton. Pour les autres problèmes, voir Dépannage de l'Agent BrynQ.
| Message | Signification | Que faire |
BrynQ ne connaît pas ce jeton d'API (TOKEN_NOT_FOUND) | Le jeton n'existe pas, a été révoqué ou n'a pas été copié en entier. | Copiez à nouveau le jeton en entier. Toujours refusé ? Demandez un nouveau jeton à BrynQ. |
Le jeton d'API a expiré (TOKEN_EXPIRED) | La période de validité du jeton est dépassée. | Demandez un nouveau jeton à BrynQ et remplacez-le sur la page Connexion BrynQ. |
L'utilisateur BrynQ auquel appartient ce jeton d'API n'existe plus (RELATED_USER_NOT_FOUND) | Le jeton a été créé par un utilisateur BrynQ qui a depuis été supprimé. | Demandez un nouveau jeton à BrynQ. |
BrynQ n'accepte ce jeton d'API que depuis d'autres adresses IP (IP_NOT_ALLOWED) | Le jeton a une liste blanche d'adresses IP qui ne contient pas l'adresse IP publique de votre serveur. | Demandez à BrynQ d'ajouter l'adresse affichée sous Adresse IP publique à la liste blanche du jeton, ou de supprimer la liste. Cliquez ensuite sur Vérifier à nouveau. |
BrynQ connaît le jeton, mais ce n'est pas un jeton d'agent (AGENT_TOKEN_MUST_TARGET_EXACTLY_ONE_CUSTOMER) | Le jeton est lié à plusieurs clients ou à aucun, par exemple un jeton administrateur. | Utilisez un jeton créé dans votre propre environnement BrynQ (voir Quel jeton utiliser). |
| BrynQ lie le jeton à un autre client | Le jeton appartient à un autre environnement BrynQ que cet Agent. | Utilisez le jeton d'Agent de votre propre environnement. |
| La plateforme BrynQ ne répond pas | BrynQ est temporairement occupé ou indisponible. | Attendez quelques minutes et cliquez sur Vérifier à nouveau. |
| BrynQ est injoignable | Le serveur ne peut pas établir de connexion HTTPS sortante vers BrynQ. | Demandez à votre administrateur informatique d'autoriser le trafic HTTPS sortant vers BrynQ (voir ci-dessous), y compris via un éventuel proxy. |
La vérification du jeton, le test de connexion et les mises à jour partent tous en sortie de votre serveur vers BrynQ. Aucun port entrant n'est nécessaire. Si votre pare-feu ou votre proxy n'autorise le trafic sortant que vers des destinations approuvées, autorisez :
| Destination | Adresse IP | Port |
| app.brynq.com | 20.54.225.251 | TCP 443 (HTTPS) |
Autorisez le nom d'hôte app.brynq.com si votre pare-feu le permet, et l'adresse IP s'il n'accepte que des adresses IP. La vérification Connexions sortantes sur la page Dépannage du tableau de bord d'administration indique si le serveur peut joindre BrynQ. Le Cloudflare Tunnel a besoin de son propre port sortant : voir Paramètres réseau de l'Agent BrynQ.
Ne confondez pas les deux adresses : 20.54.225.251 est l'adresse de BrynQ, que votre pare-feu autorise. L'Adresse IP publique de votre serveur est celle que BrynQ ajoute à la liste blanche du jeton.