Requirements en installatie

Requirements en installatie

Om de agent correct te laten werken, is de volgende configuratie vereist.

Hardware- en softwarevereisten

  1. Windows Server 2012 64 bit of 2016 64 bit met 8 GB RAM, minimaal 2 CPU-kernen met 2,40 GHz, 150 GB harde schijf;
  2. Verbinding met internet (eventueel via een proxy);
  3. Een internet- en intranetgeregistreerde DNS A. Het DNS A-record verwijst naar de server waarop de agent is geïnstalleerd;
  4. Een openbaar bruikbaar SSL-certificaat
  5. Een webserver. Bijvoorbeeld IIS, NginX, enz. die ten minste de in 1.2 beschreven configuratie bevat.

Autorisatievereisten

Er zijn rechten nodig om gegevens uit het betreffende systeem op te halen.

De agent installeren

De volgende stappen moeten worden uitgevoerd om de agent correct te laten werken.
  1. Registreer een DNS-record dat verwijst naar de server van de klant waarop het verkeer binnenkomt;
  2. Installeer een browser-SSL-certificaat voor het geregistreerde DNS-record;
  3. Stel in een webserver de configuratie in waarin de volgende zaken zijn ingesteld. Een voorbeeldconfiguratie voor NginX wordt getoond in bijlage 1:
    1. HTTP-omleiding naar HTTPS;
    2. SSL-certificaat voor al het verkeer;
    3. Leid alle inkomende verzoeken om naar de agent (poort 7070);
  4. Maak een aparte map aan waarin brynq_agent.exe wordt geplaatst;
  5. Download de BrynQ Agent via https://app.brynq.com/interface-agent/ en plaats deze in deze map.
  6. Maak een gebruiker aan die de benodigde rechten heeft voor de map waarin de agent zich bevindt en die de rechten heeft zoals vermeld in de vereisten.

De agent uitvoeren

U kunt de BrynQ Agent testen en uitvoeren door een PowerShell-venster te openen in de map waar brynq-agent.exe zich bevindt.
Start het met: .\brynq-agent-<versie>.exe
Als u het zonder parameters uitvoert, start de agent met de volgende standaardinstellingen:

  1. Luister IP: 127.0.0.1
  2. Poort: 7070
  3. SSL: false
  4. Certificaatmap: huidige map
  5. Certificaatbestand: brynq_agent_cert.pem
  6. Sleutelbestand: brynq_agent_key.pem
U kunt deze instellingen overschrijven met opdrachtregelopties.

Beschikbare parameters 

  1. –listen / -l
    Stelt het IP-adres in waaraan de agent zich bindt, zodat inkomende verbindingen deze kunnen bereiken. Voorbeeld: brynq-agent.exe --listen 0.0.0.0
  2. –port / -p
    Wijzigt de poort waarop de agent luistert naar inkomende verzoeken. Voorbeeld: brynq-agent.exe --port 5005
  3. –ssl / -s
    Schakelt SSL-versleuteling voor de webserver van de agent in of uit. Opmerking: als deze optie is ingesteld op true, moet u ook --certdirectory opgeven.
  4. –certdirectory / -cd
    Definieert de map waarin de SSL-certificaat- en sleutelbestanden zijn opgeslagen. Voorbeeld: brynq-agent.exe --ssl true --certdirectory C:\agentcerts
  5. –certfile / -cf
    Overschrijft de standaardcertificaatbestandsnaam die de agent gebruikt voor SSL. Handig wanneer uw certificaatbestand niet de standaardnaam gebruikt.
  6. –keyfile / -kf
    Overschrijft de standaardsleutelbestandsnaam die de agent gebruikt voor SSL. Handig wanneer uw sleutelbestand niet de standaardnaam gebruikt.
  7. –http_proxy / -hp
    Stelt een uitgaande HTTP-proxy in voor de externe verzoeken van de agent. Wordt gebruikt in beperkte omgevingen waar direct uitgaand verkeer wordt geblokkeerd.
  8. –https_proxy / -hsp
    Stelt een uitgaande HTTPS-proxy in voor beveiligde externe verzoeken. Wordt gebruikt wanneer HTTPS-verkeer via een bedrijfsproxy moet verlopen.
  9. –verify_ssl / -vssl
    Schakelt SSL-certificaatverificatie voor uitgaande HTTPS-verzoeken in of uit. Gebruik false alleen wanneer u werkt met interne of zelfondertekende eindpunten.
Voorbeeld Volledige SSL-start: brynq-agent.exe –listen 0.0.0.0 –port 443 –ssl true –certdirectory C:\agentcerts

Warning
Houd er rekening mee dat als u de parameter ssl gebruikt, de parameter certfolder verplicht is. 

Taak maken

Maak een taak in Windows Taakplanner met de volgende instellingen:
  1. Algemeen
    1. Uitvoeren met nieuw aangemaakte gebruiker;
    2. Vink ‘Uitvoeren ongeacht of gebruiker is aangemeld’ aan;
    3. Vink ‘Uitvoeren met hoogste rechten’ niet aan
  2. Triggers:
    1. Taak starten: Bij opstarten
    2. Taak uitstellen voor: 15 minuten
  3. Acties:
    1. Actie: Een programma starten
  4. Programma/script: Het volledige pad naar brynq-agent.exe. Voeg indien gewenst de parameters toe (zie stap 6).
  5. Starten in: De map waarin brynq-agent.exe is geplaatst
  6. Instellingen
    1. Schakel ‘De taak stoppen als deze langer dan:’ uit;
Sla de Windows-taak op en voer deze uit.


    • Related Articles

    • Integration Between AFAS and Entra ID (Azure AD)

      Integration Between AFAS and Entra ID (Azure AD) Our interface between AFAS Profit and Microsoft Entra ID keeps your employee data consistent and secure — automatically. When someone joins, leaves, or changes roles in AFAS, the interface ensures that ...
    • Integration Between AFAS and Entra ID (Azure AD)

      Integration Between AFAS and Entra ID (Azure AD) Our interface between AFAS Profit and Microsoft Entra ID keeps your employee data consistent and secure — automatically. When someone joins, leaves, or changes roles in AFAS, the interface ensures that ...
    • Apps activeren

      Om data uit andere systemen te halen is het nodig om deze systemen aan BrynQ te koppelen. Dat koppelen is mogelijk in de sectie “Apps”. Dit artikel legt uit hoe je apps activeert. Wanneer je een app activeert, wordt deze opgenomen in je maandelijkse ...
    • Voorbeeld configuration IIS

      Installeer Application Request Routing (ARR) De eerste stap is het installeren van de add-on module voor Application Request Routing voor IIS. Met Windows Server 2012 R2 of latere versies zoals Windows Server 2016 en 2018 kunt u de Microsoft Web ...
    • Foleta-connector

      De Foleta-connector maakt het mogelijk om data vanuit Foleta in dashboards in te laden. Tevens bevat deze connector de mogelijkheid om data toe te voegen in SalureConnect met als doel Foleta en Profit met elkaar te vergelijken. Algemene configuratie ...