De BrynQ Agent heeft één sleutel nodig om te werken: een BrynQ API-token die bij je BrynQ-omgeving hoort. Je plakt hem één keer tijdens de installatie van de Agent. De Agent bewaart hem op de server en gebruikt hem om aan BrynQ te laten zien bij welke klant hij hoort.
Zonder geldige token kan de Agent geen beveiligde verbinding met BrynQ opzetten en zichzelf niet bijwerken.
| Wanneer | Wat de token doet |
| Tijdens de installatie | BrynQ controleert de token en zoekt op bij welke klant hij hoort. Daarna maakt BrynQ de beveiligde verbinding en het eigen adres van je Agent aan: https://<jouw-klant>.brynq-agent.com. |
| Automatische updates | De Agent gebruikt de token om nieuwe versies te zoeken en bij BrynQ te downloaden. |
| Verbindingstest | De pagina BrynQ-verbinding van het lokale beheerdashboard gebruikt de token om te testen of BrynQ deze Agent accepteert. |
| Inkomende verzoeken | De Agent accepteert alleen verzoeken voor jouw klant. Verzoeken voor een andere klant worden geweigerd, ook met een geldige token. |
De Agent accepteert alleen een token die aan precies één klant is gekoppeld: de klant waarvoor de Agent wordt geïnstalleerd.
Vraag je BrynQ-consultant of BrynQ support om de Agent-token van je omgeving. BrynQ maakt hem voor je aan en stuurt hem veilig op.
Spreek dit af voordat de token wordt aangemaakt:
Gebruik geen token van de pagina Admin Portal › API toegang: dat zijn beheerderstokens voor alle klanten, en die weigert de Agent.
Installeer je opnieuw of voer je een upgrade uit, dan ziet de installer dat er al een token is opgeslagen. Laat Het bestaande API-token behouden (aanbevolen) geselecteerd, of kies Vervangen door een nieuw API-token en plak de nieuwe.
Je hoeft de Agent niet opnieuw te installeren om de token te vervangen.
BrynQ controleert de nieuwe token eerst. Hij wordt alleen opgeslagen als BrynQ hem voor jouw klant accepteert, dus een verkeerde token vervangt nooit een werkende.
De installer en de pagina BrynQ-verbinding vertellen je waarom BrynQ een token niet accepteert. Voor andere problemen, zie Problemen met de BrynQ Agent oplossen.
| Melding | Wat het betekent | Wat te doen |
BrynQ kent deze API-token niet (TOKEN_NOT_FOUND) | De token bestaat niet, is ingetrokken of is niet helemaal gekopieerd. | Kopieer de hele token opnieuw. Nog steeds geweigerd? Vraag BrynQ om een nieuwe token. |
De API-token is verlopen (TOKEN_EXPIRED) | De geldigheidsperiode van de token is voorbij. | Vraag BrynQ om een nieuwe token en vervang hem op de pagina BrynQ-verbinding. |
De BrynQ-gebruiker van deze API-token bestaat niet meer (RELATED_USER_NOT_FOUND) | De token is aangemaakt door een BrynQ-gebruiker die inmiddels is verwijderd. | Vraag BrynQ om een nieuwe token. |
BrynQ accepteert deze API-token alleen vanaf andere IP-adressen (IP_NOT_ALLOWED) | De token heeft een IP-whitelist waar het openbare IP-adres van je server niet in staat. | Vraag BrynQ het adres onder Openbaar IP-adres aan de whitelist van de token toe te voegen, of de whitelist te verwijderen. Klik daarna op Opnieuw controleren. |
BrynQ kent de token, maar het is geen agent-token (AGENT_TOKEN_MUST_TARGET_EXACTLY_ONE_CUSTOMER) | De token is gekoppeld aan meerdere klanten of aan geen enkele, bijvoorbeeld een beheerderstoken. | Gebruik een token die in je eigen BrynQ-omgeving is aangemaakt (zie Welke token je nodig hebt). |
| BrynQ koppelt de token aan een andere klant | De token hoort bij een andere BrynQ-omgeving dan deze Agent. | Gebruik de Agent-token van je eigen omgeving. |
| Het BrynQ-platform reageert niet | BrynQ is tijdelijk druk of niet beschikbaar. | Wacht een paar minuten en klik op Opnieuw controleren. |
| BrynQ is niet bereikbaar | De server kan geen uitgaande HTTPS-verbinding met BrynQ maken. | Vraag je IT-beheerder uitgaand HTTPS-verkeer naar BrynQ toe te staan (zie hieronder), ook via een eventuele proxy. |
De tokencontrole, de verbindingstest en de updates gaan allemaal uitgaand van je server naar BrynQ. Er is geen inkomende poort nodig. Laat je firewall of proxy alleen uitgaand verkeer naar goedgekeurde bestemmingen toe, sta dan toe:
| Bestemming | IP-adres | Poort |
| app.brynq.com | 20.54.225.251 | TCP 443 (HTTPS) |
Sta de hostnaam app.brynq.com toe als je firewall dat ondersteunt, en het IP-adres als hij alleen IP-adressen accepteert. De controle Uitgaande verbindingen op de pagina Probleemoplossing van het beheerdashboard laat zien of de server BrynQ kan bereiken. De Cloudflare Tunnel heeft een eigen uitgaande poort nodig: zie Netwerkinstellingen van de BrynQ Agent.
Haal de twee adressen niet door elkaar: 20.54.225.251 is het adres van BrynQ, dat jouw firewall toestaat. Het Openbaar IP-adres van je server is wat BrynQ aan de IP-whitelist van de token toevoegt.