Erstellen, rotieren, umstellen und löschen Sie die API-Keys Ihres Carriers in Orbit Connect, damit Ihr TMS oder Ihre Telematik Ihre Touren lesen und aktualisieren kann.
War dieser Artikel hilfreich?
Keine Antwort gefunden?
Fragen Sie Luna oder schreiben Sie unserem Support-Team.
Mit einem API-Key arbeiten Ihre eigenen Systeme mit Orbit, ohne dass sich eine Person anmeldet: Ihr TMS liest die Touren, die Ihre Auftraggeber Ihnen geben, Ihre Telematik meldet, wo sie gerade sind. Als Carrier-Administrator erstellen und verwalten Sie die Keys Ihres Carriers selbst in Orbit Connect unter API-Keys.
Das Wichtigste:
orb_car_live_…7Fq2.API-Keys erscheint in der Navigation von Orbit Connect unter Fahrzeuge, für Carrier-Administratoren. Andere Nutzer Ihres Carriers sehen den Punkt nicht. Ihr Auftraggeber, das Unternehmen, das Ihnen die Touren gibt, kann Ihre Keys ebenfalls verwalten, in Orbit MissionControl.
Jede Zeile zeigt den Name des Keys, seine Rolle, das Ende des Key, wann er Zuletzt benutzt wurde und wann er abläuft (Läuft ab). Eine Zeile kann diese Marker tragen:
| Marker | Bedeutung |
|---|---|
| In 5 Tagen | Der Key läuft in weniger als sieben Tagen ab. |
| Läuft ab am 20.10. | Der alte Key einer Rotation, der bis zu diesem Datum funktioniert. |
| Abgelaufen | Der Key funktioniert nicht mehr. Die Zeile ist ausgegraut. |
Zuletzt benutzt wird höchstens alle 15 Minuten aktualisiert. Ein Key, der ständig benutzt wird, kann deshalb eine Zeit von vor ein paar Minuten zeigen.
Öffnen Sie in Orbit Connect API-Keys in der Navigation.
Wählen Sie API-Key erstellen. Über der Liste öffnet sich die Karte Neuer API-Key.
Geben Sie einen Name ein, der sagt, wo der Key benutzt wird, zum Beispiel Telematik Nordlicht.
Wählen Sie die Rolle und wann der Key abläuft (Läuft ab): Nie, In 30 Tagen, In 90 Tagen oder In 365 Tagen.
Wählen Sie Erstellen. Ein Dialog zeigt den Key. Kopieren Sie ihn mit Kopieren und legen Sie ihn dort ab, wo Ihr System ihn lesen kann. Wählen Sie dann Ich habe den Key gespeichert.
Warning
Der Dialog ist der einzige Ort, an dem der Key angezeigt wird. Schließen Sie ihn, ohne den Key zu speichern, löschen Sie den Key und erstellen Sie einen neuen.
Die Rolle bestimmt, was ein Key darf. Rolle bietet an:
Um die Rolle eines Keys zu ändern, öffnen Sie das Menü … der Zeile und wählen Rolle ändern …. Die neue Rolle gilt spätestens nach einer Minute.
Rotieren ersetzt einen Key durch einen neuen mit demselben Namen und derselben Rolle. Nutzen Sie es, wenn jemand anderes einen Key gesehen haben könnte, oder regelmäßig als Vorsorge.
Öffnen Sie das Menü … der Zeile und wählen Sie Rotieren ….
Wählen Sie, wann der alte Key abläuft: Sofort, Nach 24 Stunden oder Nach 7 Tagen (empfohlen).
Wählen Sie Rotieren. Der neue Key wird einmal angezeigt, wie nach dem Erstellen. Tragen Sie ihn in Ihrem System ein, bevor der alte abläuft.
Ein Key lässt sich einmal rotieren; um ihn noch einmal zu ersetzen, rotieren Sie den neuen Key. Ein abgelaufener Key lässt sich nicht rotieren.
Öffnen Sie das Menü … der Zeile, wählen Sie Löschen … und bestätigen Sie mit Löschen. Systeme mit diesem Key verlieren spätestens nach einer Minute den Zugriff. Ein gelöschter Key lässt sich nicht wiederherstellen.
Wählen Sie Verlauf im Menü … einer Zeile, um zu sehen, was mit einem Key geschehen ist: wann er angelegt, rotiert, umgestellt oder gelöscht wurde, und von wem. Der Verlauf eines rotierten Keys zeigt auch die Keys, die er ersetzt hat.
Nordlicht Spedition in Hamburg fährt Touren für ein Logistikunternehmen. Die Administratorin Julia erstellt einen Key Telematik mit Carrier API Key Full Access für das Telematiksystem und einen zweiten Key mit Carrier API Key Read Only für eine Planungstabelle in Bremen. Als der Telematikanbieter wechselt, rotiert Julia den ersten Key mit einer Überlappung von 24 Stunden und trägt den neuen Key im neuen System ein.
Carrier-Keys funktionieren mit der Carrier-API. Die Seite verlinkt ihre Referenz unter Zur Carrier-API. Senden Sie den Key im Header x-api-key.
Nein. Orbit speichert von jedem Key nur einen Fingerabdruck, deshalb kann niemand ihn erneut anzeigen. Rotieren Sie den Key oder erstellen Sie einen neuen.
Nein. Sie sehen und ändern nur die Keys Ihres eigenen Carriers, und jeder Key, den Sie erstellen, gehört Ihrem Carrier.
Nichts. Ein Key gehört Ihrem Carrier, nicht einer Person, und funktioniert weiter.
Orbit merkt sich einen Key bis zu einer Minute. Danach gilt für jede Anfrage der neue Stand.