Verbindungen
Die externen Systeme, mit denen jeder Bereich verbunden ist, wer sie verbinden darf und wie sie in diesem Build simuliert werden.
In diesem Build alles simuliert
Portline ruft keinen externen Dienst auf. Jeder der folgenden Konnektoren ist simuliert, und für jeden ist vor dem Launch eine Anbieterentscheidung und eine Prüfung nötig.
Wo die Konnektoren zu finden sind
- Jeder Bereich hat eine Seite „Integrationen“, die die Konnektoren dieses Bereichs auflistet, mit den Daten, die jeder davon liefert, und seinem Status. Manche Konnektoren erscheinen in mehr als einem Bereich; Samsara zum Beispiel liefert Daten an Flotte, Übersicht und Rampen.
- Einstellungen → Verbindungen listet alle Konnektoren an einer Stelle auf.
- Nur Inhaber und Admins verbinden oder trennen Konnektoren. Disponenten und Betrachter sehen dieselben Seiten schreibgeschützt.
- Ihr Tarif entscheidet, welche Konnektoren verfügbar sind. Ein Konnektor ist verfügbar, wenn der Tarif mindestens einen Bereich freischaltet, der ihn nutzt. Einige benötigen zusätzlich eine weitere Funktion: Sensorwerte von Kühlcontainern benötigen Reefer-Telemetrie (ab Growth). Konnektoren außerhalb Ihres Tarifs werden aufgelistet, können aber nicht verbunden werden.
Status und Synchronisierung
Im Demo-Modus wird jeder Status (verbunden, eingeschränkt, Fehler, wartet auf erste Synchronisierung) zusammen mit den übrigen Demodaten generiert. Tatsächlich wird nichts synchronisiert.
Im Modus mit lokaler Datenbank legt ein Klick auf Verbinden eine ausstehende Anfrage an. Die Zustandsfelder (Status, letzte Synchronisierung, letzter Fehler und Ereignisse der letzten 24 Stunden) werden ausschließlich vom Sync-Worker geschrieben, der mit der Service-Rolle läuft. Ein angemeldeter Nutzer kann eine Verbindung anfordern oder eine trennen, sonst nichts. Postgres setzt das mit dem Guard-Trigger pl_connections durch: Er lehnt jede andere Statusänderung durch einen Client ab und vermerkt, wer die Anfrage wann gestellt hat. Beim Trennen bleibt die Zeile erhalten, sodass Sie weiterhin sehen, wer die Verbindung hergestellt hat.
Alle Konnektoren
Die Logos stammen von simple-icons (CC0). Marken, die nicht in simple-icons enthalten sind, erhalten ein schlichtes Monogramm. Markennamen und Logos gehören ihren jeweiligen Inhabern und werden nur zur Kennzeichnung des Konnektors gezeigt.
| Konnektor | Kategorie | Genutzt von | Authentifizierung | Ab Tarif | In dieser Fassung |
|---|---|---|---|---|---|
| p44project44 | Sichtbarkeit auf See | Sendungen,Container,Übersicht | API-Schlüssel | Starter | Attrappe in dieser Fassung · vor dem Start prüfen |
| VZVizion | Sichtbarkeit auf See | Container,Sendungen | API-Schlüssel | Starter | Attrappe in dieser Fassung · vor dem Start prüfen |
| MTMarineTraffic | Schiffspositionen | Übersicht,Flotte | API-Schlüssel | Starter | Attrappe in dieser Fassung · vor dem Start prüfen |
| DHL Express | Paketfrachtführer | Sendungen | API-Schlüssel | Starter | Attrappe in dieser Fassung · vor dem Start prüfen |
| FedEx | Paketfrachtführer | Sendungen | OAuth | Starter | Attrappe in dieser Fassung · vor dem Start prüfen |
| UPS | Paketfrachtführer | Sendungen | OAuth | Starter | Attrappe in dieser Fassung · vor dem Start prüfen |
| SSamsara | Lkw-Telematik | Flotte,Übersicht,Rampen | OAuth | Starter | Attrappe in dieser Fassung · vor dem Start prüfen |
| GGeotab | Lkw-Telematik | Flotte | OAuth | Hafenumfuhr und Lkw-Transport | Attrappe in dieser Fassung · vor dem Start prüfen |
| TomTom Traffic | Verkehr und ETA-Angaben | Rampen,Flotte | API-Schlüssel | Hafenumfuhr und Lkw-Transport | Attrappe in dieser Fassung · vor dem Start prüfen |
| OCORBCOMM | Sensoren des Kühlcontainers | Container,Sendungen | Signierter Web-Rückruf | Kühlkette | Attrappe in dieser Fassung · vor dem Start prüfen |
| OpenStreetMap | Karten | Übersicht | Keine Zugangsdaten | Starter | Attrappe in dieser Fassung · vor dem Start prüfen |
| SAP S/4HANA | ERP und Aufträge | Lager,Sendungen | OAuth | Starter | Attrappe in dieser Fassung · vor dem Start prüfen |
| NSNetSuite | ERP und Aufträge | Lager | OAuth | Kühlkette | Attrappe in dieser Fassung · vor dem Start prüfen |
| Shopify | ERP und Aufträge | Lager | OAuth | Kühlkette | Attrappe in dieser Fassung · vor dem Start prüfen |
| Zebra scanners | Erfassung | Lager,Rampen | Signierter Web-Rückruf | Hafenumfuhr und Lkw-Transport | Attrappe in dieser Fassung · vor dem Start prüfen |
| Google Calendar | Kalender | Rampen | OAuth | Hafenumfuhr und Lkw-Transport | Attrappe in dieser Fassung · vor dem Start prüfen |
| TwTwilio | Nachrichtenübermittlung | Nachrichten,Rampen | API-Schlüssel | Starter | Attrappe in dieser Fassung · vor dem Start prüfen |
| WhatsApp Business | Nachrichtenübermittlung | Nachrichten | API-Schlüssel | Starter | Attrappe in dieser Fassung · vor dem Start prüfen |
| Resend | Nachrichtenübermittlung | Nachrichten | API-Schlüssel | Starter | Attrappe in dieser Fassung · vor dem Start prüfen |
| SlSlack | Alarme | Übersicht,Nachrichten | OAuth | Starter | Attrappe in dieser Fassung · vor dem Start prüfen |
| Okta | Anmeldung | Team | SAML / OIDC | Starter | Attrappe in dieser Fassung · vor dem Start prüfen |
| Google Workspace | Anmeldung | Team | OAuth | Starter | Attrappe in dieser Fassung · vor dem Start prüfen |
| MEMicrosoft Entra ID | Anmeldung | Team | SAML / OIDC | Starter | Attrappe in dieser Fassung · vor dem Start prüfen |
Webhook-URLs
Überall dort, wo ein Nutzer eine ausgehende URL eingeben könnte (ein Webhook-Ziel, einen Endpunkt eines Frachtführers), durchläuft sie zuerst einen Guard. Der Guard akzeptiert nur https auf dem Standardport und lehnt Zugangsdaten in der URL, IP-Literale, numerische Hosts und interne Namen wie localhost oder *.internal ab. Ein echter HTTP-Client müsste außerdem zum Zeitpunkt der Anfrage das DNS prüfen und Weiterleitungen ablehnen; das kommt mit der ersten echten Verbindung.