Obsolens kennisbank Naar het portaal
Kennisbank › De collector plaatsen

Handmatig installeren, proxy en eigen CA-certificaat

Zo installeer je de collector stap voor stap zonder installatiescript, met een proxy of met het CA-certificaat van een firewall die SSL-inspectie doet.

Meestal is de regel of het installatiebestand uit het portaal genoeg. Handmatig installeren is handig als je zelf wilt zien wat er gebeurt, als de computer de scripts niet mag downloaden, of als je het CA-certificaat van een firewall met SSL-inspectie moet opgeven. Dat laatste kan alleen met deze stappen.

Downloaden en controleren

  1. Kies bij de locatie Collector toevoegen of Collector en daarna Handmatig installeren. Je ziet de downloads (Windows, Linux x86_64, Linux ARM64) en de controlegetallen (SHA256SUMS).

  2. Download het programma en SHA256SUMS naar de computer.

  3. Controleer de download. Op Linux:

    grep " obsolens-collector-linux-amd64$" SHA256SUMS | sha256sum -c -

    Op Windows vergelijk je de uitkomst van dit commando met de regel in SHA256SUMS:

    Get-FileHash -Algorithm SHA256 .\obsolens-collector-windows-amd64.exe

Installeren op Linux

Als root, in de map met het bestand. De koppelcode staat in het installatievenster van het portaal:

chmod +x obsolens-collector-linux-amd64
EOLSCAN_ENROLL_TOKEN=eole_... ./obsolens-collector-linux-amd64 enroll --config /etc/obsolens/collector.json --server https://portal.obsolens.com
./obsolens-collector-linux-amd64 install --config /etc/obsolens/collector.json

enroll koppelt de collector en bewaart zijn sleutel in de config. install kopieert het programma naar /usr/local/bin/obsolens-collector, schrijft de systemd-dienst obsolens-collector en start die. De koppelcode geef je bewust via EOLSCAN_ENROLL_TOKEN en niet als argument, zodat hij niet in de proceslijst staat. Laat je hem weg, dan vraagt enroll erom.

Wil je eerst zien welke systemd-dienst er komt, gebruik dan install --print.

Installeren op Windows

In PowerShell als administrator, in de map met het bestand:

$env:EOLSCAN_ENROLL_TOKEN = "eole_..."
.\obsolens-collector-windows-amd64.exe enroll --config "$env:TEMP\collector.json" --server https://portal.obsolens.com
Remove-Item Env:\EOLSCAN_ENROLL_TOKEN
.\obsolens-collector-windows-amd64.exe install --config "$env:TEMP\collector.json"
Remove-Item "$env:TEMP\collector.json"

install maakt C:\ProgramData\Obsolens aan, vergrendelt die map voor SYSTEM en Administrators, kopieert het programma en de config en maakt de geplande taak "Obsolens Collector". Verwijder daarna de tijdelijke config: daar staat de sleutel van de collector in.

Let op: bestaat C:\ProgramData\Obsolens al en is de map niet alleen van Administrators, dan weigert install. Verwijder de map en probeer het opnieuw.

Een proxy opgeven

Voeg --proxy toe aan enroll en install:

--proxy http://proxy.klant.local:3128

Vraagt de proxy om aanmelding, gebruik dan http://gebruiker:wachtwoord@proxy.klant.local:3128. Met --proxy none maakt de collector altijd direct verbinding. Op Windows neemt install een machinebrede WinHTTP-proxy vanzelf over als je geen --proxy opgeeft.

Het CA-certificaat van een firewall opgeven

Doet een firewall SSL-inspectie op het verkeer naar het portaal, dan is de beste oplossing een uitzondering voor het portaal in die inspectie. Kan dat niet, geef dan het CA-certificaat van de firewall op (PEM-formaat). Zie ook Uitgaande verbinding, proxy en SSL-inspectie.

Let op: met een eigen CA-certificaat vertrouwt de collector alleen dat certificaat, niet meer de gewone certificaatautoriteiten van het systeem. Gaat de inspectie later uit, dan moet je de instelling weer weghalen.

Op Linux zet je het certificaat in /etc/obsolens. De dienst kan niet in /home kijken.

install -d -m 0700 /etc/obsolens
cp firewall-ca.pem /etc/obsolens/
EOLSCAN_ENROLL_TOKEN=eole_... ./obsolens-collector-linux-amd64 enroll --config /etc/obsolens/collector.json --server https://portal.obsolens.com --ca-file /etc/obsolens/firewall-ca.pem
./obsolens-collector-linux-amd64 install --config /etc/obsolens/collector.json

Op Windows geef je bij enroll --ca-file op met het pad naar het certificaat. Kopieer het certificaat na install naar C:\ProgramData\Obsolens, zet dat pad bij "ca_file" in C:\ProgramData\Obsolens\collector.json en start de taak opnieuw.

De config later aanpassen

De config staat in /etc/obsolens/collector.json (Linux) of C:\ProgramData\Obsolens\collector.json (Windows). Je kunt daar onder meer "proxy" en "ca_file" wijzigen. Start de collector daarna opnieuw:

sudo systemctl restart obsolens-collector

schtasks /End /TN "Obsolens Collector"
schtasks /Run /TN "Obsolens Collector"

Controleer daarna de verbinding met diagnose. Zie De uitkomst van diagnose.

Zie ook