API Token

Mit Vertec Version 6.6 wurden API Tokens für die Erhöhung der Anmeldesicherheit von Web API Zugriffen eingeführt. Die API Tokens erhöhen die Anmeldesicherheit der Vertec XML Schnittstelle und der BI API Schnittstelle.

Hinweis:
Aus Gründen der Rückwärtskompatibilität wird das alte System (die Authentisierung via Username und Passwort) weiterhin unterstützt. Ab Vertec Version 6.7 jedoch nicht mehr. Die Umstellung sollte also dennoch bald erfolgen.

API Token generieren

API Tokens können auf der Seite Weitere Info eines Bearbeiters generiert werden:

Mit einem Klick auf den Button Generieren… wird das API Token generiert und im entsprechenden Feld angezeigt:

Dieses muss sogleich kopiert werden, da es beim nächsten Aufruf der Seite nicht mehr angezeigt wird. Anstelle des Tokens wird folgender Text angezeigt und das Token kann nur noch gelöscht werden:

Wird das Token gelöscht, kann es danach nicht mehr verwendet werden, und anstelle des Löschen… Buttons steht wieder der Button Generieren… zur Verfügung.

Alle API Tokens löschen

Benutzer mit Administratorrecht können die generierten API Tokens aller Bearbeiter im Menü Einstellungen mithilfe der Option Alle API Tokens löschen... auf einmal löschen:

Es erscheint zunächst eine Warnabfrage, die nochmals nachfragt, ob wirklich alle API Tokens gelöscht werden sollen.

Berechtigungen

Der Abschnitt API Token auf der Seite Weitere Info des Bearbeiters wird nur angezeigt, wenn der eingeloggte Benutzer das Administratorrecht hat oder ihm das Schreibrecht auf Projektbarbeiter.ApiToken gewährt wird.