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 jij 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.

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.
• ☐ 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.
• ☐ Uitgaand HTTPS-verkeer (poort 443) toegestaan van de server naar https://app.brynq.com, https://api.cloudflare.com en de Cloudflare Tunnel-endpoints. Inkomende poorten zijn niet nodig.
• ☐ Een BrynQ API-token voor één klant. Maak het aan in BrynQ via Admin Portal > API Access > Add API token en selecteer precies één klant: de klant waar deze Agent bij hoort. Beheerderstoegang is niet nodig.
  Waarom: BrynQ gebruikt dit token om de beveiligde verbinding op te zetten en updates te leveren. Een token voor meerdere klanten wordt geweigerd.
• ☐ Weet welke modules je nodig hebt (zie stap 3). Twijfel je? Vraag het BrynQ support.
• ☐ Alleen voor de SQL-module: 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. Log in bij BrynQ en ga naar Organization > Agent. De pagina heet BrynQ Agent.
   Zie je hem niet? Vraag een beheerder om de rechten 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 op de server op.

Een oudere versie nodig? Gebruik Older versions op dezelfde pagina. Bij elke versie zie je 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 aangeeft.

Stap 2: Start het installatieprogramma

📍 Waar: de Windows-server.

1. Klik met rechts op het installatieprogramma en kies Als administrator uitvoeren.
2. Kies de installatietaal: Engels, Frans, Duits of Nederlands. Sommige BrynQ-pagina's en de licentieovereenkomst zijn altijd in het Engels.
   
3. Lees de licentieovereenkomst zorgvuldig. Ga je ermee akkoord en wil je de BrynQ Agent gebruiken, accepteer haar dan om verder te gaan.
4. Houd de standaard installatiemap (C:\Program Files\BrynQ\Agent), tenzij je organisatie een andere locatie vereist.
5. Voer de BrynQ API-token in. Het installatieprogramma zoekt je klant automatisch op.

Stap 3: Kies de modules

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

Selecteer alleen wat je nodig hebt. Wil je de modules later wijzigen? Start het installatieprogramma dan opnieuw.

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

1. ODBC-driver: kies de voorgestelde driver. Staan er meerdere in de lijst, kies dan die met het hoogste nummer (bijvoorbeeld ODBC Driver 18 for SQL Server).
2. Server: kies de voorgestelde SQL Server, of typ de naam (bijvoorbeeld SERVERNAAM of SERVERNAAM\INSTANTIE).
3. Authenticatie: kies Windows authentication of SQL username / password. Het account heeft toegang nodig tot de databases die BrynQ gebruikt.
4. Laat de vooraf ingevulde geavanceerde opties (Encrypt=no; TrustServerCertificate=yes) staan, tenzij je databasebeheerder iets anders zegt.
5. BrynQ test eerst de verbinding met de server. Kies daarna of BrynQ alle databases mag gebruiken of alleen een geselecteerde lijst.

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

Stap 5: Rond af en controleer

1. Select Start Menu Folder: laat de standaard staan en klik op Next.
2. Select Additional Tasks: OPTIONEEL (aanbevolen) vink Create a desktop shortcut aan om het beheerdashboard later te openen. Vink Use custom local network settings alleen aan als de standaardpoorten al in gebruik zijn op de server.
   Standaard: luister-IP 127.0.0.1, Agent-poort 7070, lokale beheerpoort 7071.
   
3. Klik op Install en, als de installatie klaar is, op Finish.

Stap 6: Gebruik de Agent in BrynQ

Stel je een interface in die de Agent gebruikt? Vul dan het Agent-adres uit public_url.txt (https://<jouw-klant>.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

Volgende stappen

• Het lokale beheerdashboard: moduleinstellingen bekijken of wijzigen.
• De BrynQ Agent bijwerken, verwijderen of terugzetten.
• Stille (onbeheerde) installatie: voor IT-teams die met scripts uitrollen.
• Beveiliging: hoe de Agent de verbinding beschermt.