Internal-server (HP pc in het kantoor en hoe deze samewerkt met live.thefreighthero.nl en chrome extensie)

nikitaskliarov

Internal Server Documentation The Freight Hero

1. Algemene Informatie

De Internal-Server is een fysieke HP-server op de kantoorlocatie. Deze dient als de cruciale schakel (proxy) tussen de kantoor-PBX (VoIP-telefooncentrale) en het cloudplatform Realtime.

Hoofdfunctie: Het monitoren van de PBX via webhooks/events, het verwerken van deze data en het doorsturen van notificaties naar de cloud-API (live.thefreighthero.nl). Dit zorgt ervoor dat inkomende en uitgaande gesprekken zichtbaar worden in de browsers van medewerkers.

2. Toegang en Beheer

Fysieke Toegang: Indien SSH niet beschikbaar is, kan beheer plaatsvinden via een directe monitor- en toetsenbordverbinding.
Wachtwoordherstel: Kan worden uitgevoerd door de GRUB-bootloader te onderbreken tijdens het opstarten en de single user mode (of init=/bin/bash) te gebruiken.
SSH-verbinding: Toegang via het lokale netwerk: ssh root@192.168.1.25.

3. Services en Configuratie

Het systeem maakt gebruik van systemd om de applicatie te beheren.

Service-naam: internal.service
Configuratiebestand: /etc/systemd/system/internal.service
- Hierin staat de cruciale INTERNAL_API_KEY. Zonder de juiste key zal de cloudserver alle verzoeken weigeren met een 403 Forbidden error.
Applicatie-locatie: /home/internal/internal-server/bin/www (Node.js).

4. Veelvoorkomende Commando's

Logs inzien: journalctl -u internal -f (essentieel voor het debuggen van gesprekken).
Service herstarten: systemctl restart internal.
Configuratie herladen: systemctl daemon-reload (nodig na wijzigingen in het servicebestand).

Cruciaal: De INTERNAL_API_KEY moet exact overeenkomen met de sleutel die door de cloudserver wordt verwacht. Deze is te verifiëren in de omgeving van de draaiende Node-processen op de VPS server (root@thefreighthero.com) via cat /proc/[PID]/environ waar PID is van realtime service (gebruik ps aux hiervoor)

Kennisbank