Der BrynQ Agent braucht einen Schlüssel, um zu funktionieren: ein BrynQ-API-Token, das zu Ihrer BrynQ-Umgebung gehört. Sie fügen es einmal bei der Installation des Agent ein. Der Agent speichert es auf dem Server und weist BrynQ damit nach, zu welchem Kunden er gehört.
Ohne gültiges Token kann der Agent keine sichere Verbindung zu BrynQ aufbauen und sich nicht aktualisieren.
| Wann | Was das Token tut |
| Bei der Installation | BrynQ prüft das Token und ermittelt den Kunden, zu dem es gehört. Danach richtet BrynQ die sichere Verbindung und die eigene Adresse Ihres Agent ein: https://<ihr-kunde>.brynq-agent.com. |
| Automatische Updates | Der Agent sucht mit dem Token nach neuen Versionen und lädt sie bei BrynQ herunter. |
| Verbindungstest | Die Seite BrynQ-Verbindung des lokalen Admin-Dashboards testet mit dem Token, ob BrynQ diesen Agent akzeptiert. |
| Eingehende Anfragen | Der Agent akzeptiert nur Anfragen für Ihren Kunden. Anfragen für einen anderen Kunden werden abgelehnt, auch mit einem gültigen Token. |
Der Agent akzeptiert nur ein Token, das mit genau einem Kunden verknüpft ist: dem Kunden, für den der Agent installiert wird.
Bitten Sie Ihren BrynQ-Berater oder den BrynQ-Support um das Agent-Token Ihrer Umgebung. BrynQ erstellt es für Sie und übermittelt es sicher.
Vereinbaren Sie vor dem Erstellen des Tokens:
Verwenden Sie kein Token von der Seite Admin Portal › API-Zugriff: Das sind Administrator-Token für alle Kunden, und der Agent lehnt sie ab.
Bei einer Neuinstallation oder einem Upgrade erkennt der Installer, dass bereits ein Token gespeichert ist. Lassen Sie Vorhandenes API-Token behalten (empfohlen) ausgewählt, oder wählen Sie Durch ein neues API-Token ersetzen und fügen Sie das neue ein.
Sie müssen den Agent nicht neu installieren, um das Token zu ersetzen.
BrynQ prüft das neue Token zuerst. Es wird nur gespeichert, wenn BrynQ es für Ihren Kunden akzeptiert. Ein falsches Token ersetzt also nie ein funktionierendes.
Der Installer und die Seite BrynQ-Verbindung zeigen, warum BrynQ ein Token nicht akzeptiert. Andere Probleme: siehe Fehlerbehebung für den BrynQ Agent.
| Meldung | Bedeutung | Was tun |
BrynQ kennt dieses API-Token nicht (TOKEN_NOT_FOUND) | Das Token existiert nicht, wurde widerrufen oder nicht vollständig kopiert. | Kopieren Sie das ganze Token erneut. Weiterhin abgelehnt? Bitten Sie BrynQ um ein neues Token. |
Das API-Token ist abgelaufen (TOKEN_EXPIRED) | Die Gültigkeitsdauer des Tokens ist vorbei. | Bitten Sie BrynQ um ein neues Token und ersetzen Sie es auf der Seite BrynQ-Verbindung. |
Der BrynQ-Benutzer, zu dem dieses API-Token gehört, existiert nicht mehr (RELATED_USER_NOT_FOUND) | Das Token wurde von einem BrynQ-Benutzer erstellt, der inzwischen entfernt wurde. | Bitten Sie BrynQ um ein neues Token. |
BrynQ akzeptiert dieses API-Token nur von anderen IP-Adressen (IP_NOT_ALLOWED) | Das Token hat eine IP-Whitelist, die die öffentliche IP-Adresse Ihres Servers nicht enthält. | Bitten Sie BrynQ, die unter Öffentliche IP-Adresse angezeigte Adresse zur Whitelist des Tokens hinzuzufügen oder die Whitelist zu entfernen. Klicken Sie dann auf Erneut prüfen. |
BrynQ kennt das Token, aber es ist kein Agent-Token (AGENT_TOKEN_MUST_TARGET_EXACTLY_ONE_CUSTOMER) | Das Token ist mit mehreren Kunden oder mit keinem verknüpft, zum Beispiel ein Administrator-Token. | Verwenden Sie ein Token, das in Ihrer eigenen BrynQ-Umgebung erstellt wurde (siehe Welches Token Sie brauchen). |
| BrynQ verknüpft das Token mit einem anderen Kunden | Das Token gehört zu einer anderen BrynQ-Umgebung als dieser Agent. | Verwenden Sie das Agent-Token Ihrer eigenen Umgebung. |
| Die BrynQ-Plattform antwortet nicht | BrynQ ist vorübergehend ausgelastet oder nicht verfügbar. | Warten Sie einige Minuten und klicken Sie auf Erneut prüfen. |
| BrynQ ist nicht erreichbar | Der Server kann keine ausgehende HTTPS-Verbindung zu BrynQ aufbauen. | Bitten Sie Ihren IT-Administrator, ausgehenden HTTPS-Verkehr zu BrynQ zu erlauben (siehe unten), auch über einen eventuellen Proxy. |
Die Tokenprüfung, der Verbindungstest und die Updates gehen alle ausgehend von Ihrem Server zu BrynQ. Ein eingehender Port ist nicht nötig. Erlaubt Ihre Firewall oder Ihr Proxy ausgehenden Verkehr nur zu freigegebenen Zielen, erlauben Sie:
| Ziel | IP-Adresse | Port |
| app.brynq.com | 20.54.225.251 | TCP 443 (HTTPS) |
Erlauben Sie den Hostnamen app.brynq.com, wenn Ihre Firewall das unterstützt, und die IP-Adresse, wenn sie nur IP-Adressen akzeptiert. Die Prüfung Ausgehende Verbindungen auf der Seite Fehlerbehebung des Admin-Dashboards zeigt, ob der Server BrynQ erreicht. Der Cloudflare Tunnel braucht einen eigenen ausgehenden Port: siehe Netzwerkeinstellungen des BrynQ Agent.
Verwechseln Sie die beiden Adressen nicht: 20.54.225.251 ist die Adresse von BrynQ, die Ihre Firewall erlaubt. Die Öffentliche IP-Adresse Ihres Servers ist die, die BrynQ zur IP-Whitelist des Tokens hinzufügt.