De BrynQ Agent installeren

De BrynQ Agent installeren

Wat je bereikt

Aan het eind van deze handleiding draait de BrynQ Agent als Windows-service op een server in je eigen netwerk. BrynQ kan dan de systemen bereiken die je kiest (een SQL-database, bestanden, een interne REST- of SOAP-API, of Active Directory), zonder dat je zelf inkomende firewallpoorten opent, DNS-records registreert of SSL-certificaten installeert.

ℹ Installeer je voor Sage 100 France? Deze handleiding behandelt het installatieprogramma van begin tot eind. De Sage-pagina's van het installatieprogramma worden hier alleen kort genoemd (stap 4). Volg voor de Sage-stappen Sage 100 France-module.

Voordat je begint

Loop eerst deze checklist af. Elk punt voorkomt een veelvoorkomende reden om vast te lopen.

  • ☐ Een Windows-server met Windows Server 2016 of nieuwer (64-bits), die de systemen kan bereiken waarmee BrynQ verbinding moet maken.
    Het installatieprogramma weigert oudere Windows-versies.
  • ☐ Lokale beheerdersrechten op die server.
    Waarom: het installatieprogramma maakt Windows-services aan en schrijft naar Program Files en ProgramData. Zonder deze rechten kunnen delen van de installatie mislukken.
  • ☐ Edge, Chrome of Firefox op de server, om later de lokale beheerpagina te openen. Internet Explorer kan die niet tonen.
  • ☐ Uitgaande verbindingen vanaf de server (inkomende poorten zijn niet nodig):
    • https://app.brynq.com, TCP-poort 443 (de BrynQ-API en updates);
    • region1.v2.argotunnel.com en region2.v2.argotunnel.com, poort 7844 (UDP, met TCP als terugvaloptie). Dit is de beveiligde verbinding met BrynQ. Die kan niet via een proxy lopen, dus poort 7844 moet rechtstreeks open staan.
    Achter een proxy die om een aanmelding vraagt (NTLM of Kerberos)? Sta het computeraccount van de server (DOMAIN\SERVER$) toe op de proxy. Zie Netwerkinstellingen van de BrynQ Agent.
  • ☐ Een BrynQ API-token op klantniveau. Het moet gekoppeld zijn aan precies één klant: de klant waar deze Agent bij hoort. Vraag het aan BrynQ. Zie De API-token voor de BrynQ Agent.
    Waarom: BrynQ gebruikt dit token om de beveiligde verbinding op te zetten en updates te leveren. Een token voor meerdere klanten wordt geweigerd. Beperk je het token tot bepaalde IP-adressen, voeg dan het openbare IP-adres van deze server toe.
  • ☐ Weet welke modules je nodig hebt (zie stap 3). Twijfel je? Vraag het BrynQ-support.
  • ☐ Alleen voor de module SQL Server: de naam van de SQL Server, en een account (Windows- of SQL Server-login) met toegang tot de databases die BrynQ nodig heeft.

Stap 1: Download het installatieprogramma

📍 Waar: BrynQ, in een browser op de Windows-server.

  1. Meld je aan bij BrynQ en ga naar Organization > Agent. De pagina heet BrynQ Agent.
    Zie je hem niet? Vraag een beheerder om het recht Access to download the BrynQ Agent aan je rol toe te voegen.
  2. Bekijk de kaart met de nieuwste Version. Kies Click here to read the full release notes als je eerst de wijzigingen wilt lezen.
  3. Klik op Download en sla het installatieprogramma (brynq-agent-installer-<version>.exe) op de server op.

Heb je een oudere versie nodig? Gebruik Older versions op dezelfde pagina. Bij elke versie staan de releasedatum, de release notes en een Checksum (SHA-256) voor de integriteitscontroles van je IT-afdeling. Gebruik de nieuwste versie, tenzij BrynQ-support iets anders zegt.

ℹ Een beveiligingswaarschuwing? Het installatieprogramma is ondertekend door Salure ICT BV (de juridische entiteit van BrynQ). Windows of je browser kan toch waarschuwen voor een nieuw bestand. Zie Beveiliging voor hoe je de handtekening controleert.

Stap 2: Voer het installatieprogramma uit

📍 Waar: de Windows-server.

Geblokkeerd door Windows of je beveiligingssoftware? Zie Beveiliging om de handtekening te controleren en de Agent toe te staan, en Problemen met de BrynQ Agent oplossen voor problemen met rechten.
  1. Klik met de rechtermuisknop op het installatieprogramma en kies Als administrator uitvoeren.
  2. Selecteer taal voor installatie: kies Engels, Frans, Duits of Nederlands. De weergavetaal van Windows is vooraf geselecteerd. Alle BrynQ-pagina's volgen deze taal. De licentieovereenkomst is altijd in het Engels, en Sage-schermnamen blijven in het Frans.
    00-taal
  3. Licentieovereenkomst: lees deze zorgvuldig. Artikel 7 (Support and Diagnostics) beschrijft wat BrynQ-support op de server kan lezen. Ga je ermee akkoord en wil je de BrynQ Agent gebruiken, accepteer de overeenkomst dan om verder te gaan.
  4. Bij een eerste installatie: houd de standaard installatiemap aan (C:\Program Files\BrynQ\Agent), tenzij je organisatie een andere locatie vereist.
  5. Cloudverbinding: plak het BrynQ API-token. BrynQ controleert het token terwijl je typt. Volgende werkt pas als je BrynQ accepteert dit token. ziet.
    03-cloudverbinding
    Andere meldingen die je kunt zien:
    • BrynQ accepteert dit token niet (bijvoorbeeld TOKEN_NOT_FOUND of TOKEN_EXPIRED): controleer of je het hele token hebt gekopieerd, of vraag BrynQ om een nieuw token.
    • BrynQ accepteert dit token alleen vanaf andere IP-adressen. Voeg het openbare IP-adres van deze server toe aan het token in BrynQ.
    • Het token is geen agent-token: een agent-token is aan precies één klant gekoppeld. Gebruik het agent-token van deze klant.
    • BrynQ kon niet worden bereikt of gaf geen antwoord: controleer de uitgaande verbinding naar app.brynq.com en klik daarna op Opnieuw controleren.
    Voer je het installatieprogramma opnieuw uit op een server die al verbonden is? Kies Het bestaande API-token behouden (aanbevolen) of Vervangen door een nieuw API-token.

Stap 3: Kies de modules

Kernidee: een module is één soort verbinding die de Agent aan BrynQ aanbiedt. Alleen de modules die je selecteert, zijn beschikbaar; alle andere blijven dicht. Bij een nieuwe installatie is niets geselecteerd.

De pagina Modules groepeert de modules onder Gegevensbronnen, API-proxy's en Salarisintegraties. Selecteer een module om rechts de beschrijving te lezen.

ModuleSelecteer deze als BrynQ moet...
SQL Serverquery's uitvoeren op een SQL Server-database in je netwerk.
Bestandsbeheerbestanden en mappen op de server of in het netwerk uploaden, weergeven of downloaden.
Active DirectoryActive Directory (LDAP) lezen of bijwerken.
REST-proxyeen interne REST API aanroepen.
SOAP-proxyeen interne SOAP-webservice aanroepen.
Sage 100 Francegegevens importeren in Sage 100 Paie & RH. Dit schakelt ook SQL Server en Bestandsbeheer in (grijs weergegeven). Zie Sage 100 France-module.

04-modules

Selecteer alleen wat je nodig hebt. Wil je de modules later wijzigen, voer het installatieprogramma dan opnieuw uit. Bij een herinstallatie tonen de modules die al aan staan het label Ingeschakeld.

Stap 4: Sage-pagina's (alleen voor Sage 100 France)

Als je Sage 100 France aanvinkt, doorzoekt het installatieprogramma eerst de server en toont het daarna deze pagina's. De Sage-schermnamen blijven in elke taal in het Frans.

  • Sage-bedrijven: vink de bedrijven aan waarin BrynQ importeert.
  • SQL Server-verbinding en Databases (stap 5). De SQL Server komt uit de Sage-bestanden. De verbindingspagina wordt overgeslagen als die verbinding al werkt.
  • Sage-serviceaccount: plak de Code en het Token van het serviceaccount dat je in Sage aanmaakt.
  • Sage-installatie: wordt alleen getoond als er meer dan één Sage-installatie is om uit te kiezen.
  • Sage-importmodellen: maak de drie importmodellen van BrynQ aan in Sage. Volgende werkt zodra alle drie gevonden zijn en Sage gesloten is.
  • ConnectImport-scenario: laat BrynQ het scenario laten maken (aanbevolen) staan.

Volg Sage 100 France-module voor elk van deze pagina's stap voor stap.

Stap 5: Stel de SQL-verbinding in (alleen voor SQL Server)

🔍 Het installatieprogramma vindt de meeste waarden zelf. Het vindt de lokale SQL Server-instanties en de geïnstalleerde SQL Server ODBC-stuurprogramma's, en biedt ze aan in de keuzelijsten. Meestal kun je de voorgestelde waarde kiezen. Zoek alleen zelf iets op als er iets ontbreekt of als je het niet herkent.

Op de pagina SQL Server-verbinding:

  1. Server: kies de voorgestelde SQL Server, of typ de naam (bijvoorbeeld SERVERNAME of SERVERNAME\INSTANCE). Bij Sage 100 France wordt de server uit de Sage-bestanden gehaald.
  2. Aanmeldmethode: kies Windows-authenticatie of SQL Server-authenticatie. Alleen SQL Server-authenticatie vraagt om een Gebruikersnaam en Wachtwoord. Het account moet toegang hebben tot de databases die BrynQ gebruikt.
  3. Laat Geavanceerd... zoals het is, tenzij je databasebeheerder iets anders zegt. Daar staan het ODBC-Stuurprogramma en de Extra verbindingsopties (standaard Encrypt=no;TrustServerCertificate=yes).
  4. Klik op Verbinding testen. Je ziet Verbinding geslaagd, of de reden waarom de verbinding mislukte.

08-sql-verbinding

Voer je het installatieprogramma opnieuw uit? Kies Huidige instellingen behouden (aanbevolen) of Instellingen wijzigen.

Kies op de pagina Databases welke databases de BrynQ-interfaces gebruiken:

  • Alleen de databases die ik selecteer (aanbevolen): vink ze aan in de lijst. Ontbreekt er een? Klik op Database staat niet in de lijst? om de naam toe te voegen.
  • Alle databases op deze server: inclusief databases die later worden toegevoegd.

09-sql-databases

⚠ Deze keuze beperkt de toegang niet. Ze legt alleen vast welke databases de interfaces gebruiken. Wil je de toegang beperken, geef de SQL-login dan alleen rechten op die databases.

De SQL-instellingen worden alleen op je server opgeslagen. Je kunt ze later wijzigen in het lokale beheerdashboard.

Stap 6: Rond af en controleer

  1. Extra opties:
    • Snelkoppelingen: met Maak een snelkoppeling op het bureaublad (aanbevolen) en Maak een snelkoppeling in het menu Start open je later het beheerdashboard.
    • BrynQ-support: laat Uitgebreide diagnose delen (aanbevolen) aangevinkt, zodat BrynQ-support problemen sneller kan oplossen. Wat ziet BrynQ-support? legt uit wat er wordt gedeeld. Je kunt dit later wijzigen op het beheerdashboard onder Probleemoplossing.
    • Netwerk: vink Aangepaste lokale netwerkinstellingen gebruiken alleen aan als een ander programma op de server poort 7070 of 7071 al gebruikt.
      Standaard: luister-IP 127.0.0.1, agentpoort 7070, lokale beheerpoort 7071.
    14-extra-opties
  2. Controleer de samenvatting op Het voorbereiden van de installatie is gereed en klik op Installeren. Het installatieprogramma toont de voortgang per stap. Mislukt de laatste stap, dan kun je het in een venster met Opnieuw nog eens proberen, met behoud van al je keuzes.
  3. Als de installatie klaar is, laat je Het BrynQ Agent-dashboard openen aangevinkt en klik je op Voltooien.
    18-voltooid
✅ Controlepunt:
  1. Open Taakbeheer > Services. BrynQAgent en BrynQCloudflared hebben de status Wordt uitgevoerd. (Bij Sage 100 France is er een derde service: BrynQSageImport.)
  2. Open http://127.0.0.1:7071/admin in een browser op de server. De pagina Start toont je Agent-adres en BrynQ-verbinding: Verbonden.
  3. Open C:\ProgramData\BrynQ\Agent\config\public_url.txt. Het bestand bevat je Agent-adres: https://<your-customer>.brynq-agent.com.
✖ Klopt er iets niet? Zie Problemen met de BrynQ Agent oplossen. Het installatieprogramma bewaart een kopie van zijn log in C:\ProgramData\BrynQ\Agent\logs\installer\setup-<date>-<time>.log. Is de installatie gestopt omdat een BrynQ-map door een andere gebruiker is aangemaakt? De melding noemt het takeown-commando dat dit oplost.

Stap 7: Gebruik de Agent in BrynQ

Als je een interface instelt die de Agent gebruikt, vul je het Agent-adres uit public_url.txt (https://<your-customer>.brynq-agent.com) in bij de autorisatie van die app in BrynQ. De templatehandleiding van je interface vertelt je precies waar.

Wat er wordt geïnstalleerd

WatWaar
ProgrammabestandenC:\Program Files\BrynQ\Agent (of de map die je hebt gekozen)
InstellingenC:\ProgramData\BrynQ\Agent\config (alleen beheerders en Windows zelf kunnen dit lezen)
LogbestandenC:\ProgramData\BrynQ\Agent\logs (installatielogs in de submap installer)
Windows-servicesBrynQAgent (de Agent), BrynQCloudflared (de beveiligde verbinding met BrynQ), BrynQSageImport (alleen bij Sage 100 France). Alle services starten automatisch (vertraagd) als Windows start.

Volgende stappen