Zugriffstokens

Um Ihre OpenProject-Zugriffstokens anzuzeigen und zu verwalten, navigieren Sie zu Kontoeinstellungen und wählen Sie im Menü Zugriffstokens. Zugriffstokens erlauben es externen Applikationen Zugriff auf OpenProject zu erhalten.

Die Zugriffstoken sind in zwei Registerkarten unterteilt: Provider-Tokens und Client-Tokens. Provider-Tokens werden von OpenProject generiert und ermöglichen es anderen Anwendungen, sich mit dem Projekt zu verbinden. Client-Tokens werden von externen Anwendungen generiert und ermöglichen OpenProject die Verbindung mit ihnen.

Provider-Tokens

Provider-Tokens werden in OpenProject erstellt und ermöglichen externen Anwendungen den Zugriff auf OpenProject. Dazu gehören API, iCalendar, iCalendar für Meetings, OAuth und RSS-Tokens.

API

API-Token erlauben es Drittanbieter-Anwendungen, mit dieser OpenProject-Instanz über REST-APIs zu kommunizieren. Wenn noch keine API-Tokens erstellt wurden, ist diese Liste leer. Sie können API REST Web Service und CORS unter Administration → API und Webhooks aktivieren.

Um ein neues API-Token zu erstellen, klicken Sie auf + API Token, benennen das Token in dem sich öffnenden Formular und klicken auf die Schaltfläche Anlegen.

Es wird ein neues API-Token generiert und angezeigt. Bitte denken Sie daran, dass jeder Token nur einmal angezeigt wird, wenn er erstellt wird. Es ist also wichtig, ihn zu kopieren und sicher zu speichern. Sollten Sie diese Informationen verlieren, KÖNNEN Sie alte Token löschen und neue generieren.

Tipp

Wir empfehlen, jedes Token nur für einen Zweck zu verwenden (z.B. für eine einzige Anwendung), damit Sie genau wissen, was ersetzt werden muss, falls Sie es löschen müssen.

iCalendar

Mit iCalendar-Tokens können Benutzer OpenProject-Kalender abonnieren und aktuelle Arbeitspaketinformationen von externen Clients einsehen. Diese Liste wird leer sein, wenn Sie noch keine Kalenderabonnements haben.

Sobald Sie einen Kalender abonniert haben, erscheint hier eine Liste aller Kalender, die Sie abonniert haben. Der Name des Kalenders ist klickbar und führt Sie direkt zum jeweiligen Kalender in OpenProject.

Sie können einen Eintrag in der iCalendar-Liste löschen, indem Sie auf das Löschen Symbol klicken. Dies löst eine Warnmeldung aus, in der Sie aufgefordert werden, die Löschentscheidung zu bestätigen. Wenn Sie dieses Token löschen, haben Sie keinen Zugriff mehr auf OpenProject Informationen in allen verlinkten Clients, die dieses Token verwenden.

Sie werden dann eine Nachricht sehen, die Sie darüber informiert, dass der Token und die iCal URL nun ungültig sind.

iCalendar für Besprechungen

iCalendar Besprechungs-Token ermöglichen es Benutzern, ihre Besprechungen zu abonnieren und aktuelle Informationen in externen Kalendern anzuzeigen.

Diese Liste wird leer sein, wenn Sie noch keine Kalenderabonnements haben. Sobald Sie einen Besprechungs-Kalender abonniert haben, erscheint hier eine Liste aller iCalendar Besprechungs-Token.

Klicken Sie zum Abonnieren auf die Schaltfläche Im Kalender abonnieren direkt in Ihren Kontoeinstellungen oder im Besprechungsmodul.

Sie können das Abonnement dann Besprechungs-Token nennen und auf Abonnement erstellen klicken.

Sie sehen dann den neu generierten Token.

Wichtig

Dies ist das einzige Mal, dass es angezeigt wird. Stellen Sie sicher, dass Sie es kopieren und sicher speichern.

Um ein iCal-Besprechungs-Token unter Kontoeinstellungen zu löschen, klicken Sie auf das Symbol Löschen neben dem entsprechenden Token-Namen.

OAuth

OAuth Token erlauben es Drittanbieter-Anwendungen, sich mit dieser OpenProject Instanz zu verbinden, zum Beispiel Nextcloud (sehen Sie hier wie Sie Nextcloud einrichten). OAuth Anwendungen können unter Administration → Authentifizierung erstellt werden.

OAuth-Tokens werden nicht direkt in OpenProject erstellt. Stattdessen wird der Autorisierungsprozess von der externen Anwendung aus gestartet. Während der Einrichtung werden Sie zu OpenProject weitergeleitet, um den Zugriff zu bestätigen und dann zur externen Anwendung zurückzukehren, um die Verbindung abzuschließen.

Wenn noch keine Integration von Drittanbietern aktiviert wurde, ist diese Liste leer. Bitte wenden Sie sich an Ihren Administrator, um Ihnen bei der Einrichtung zu helfen.

Sobald es Integrationen gibt, werden ihre Token hier angezeigt. Sie können den Zugriff jederzeit widerrufen, indem Sie auf das Symbol Löschen klicken. Durch das Entfernen eines Tokens wird der externen Anwendung sofort die Erlaubnis entzogen, in Ihrem Namen zu handeln, d.h. sie kann keine API-Aufrufe mehr in Ihrem Namen tätigen. Wenn Sie die Integration erneut verwenden möchten, müssen Sie sie erneut autorisieren.

RSS

RSS-Token erlauben es Benutzern über einen externen RSS-Reader auf dem Laufenden zu bleiben. Sie können nur ein aktives RSS-Token haben.

Erstellen Sie ein neues Token, indem Sie auf den +RSS Token Button klicken.

Dadurch wird Ihr Token erstellt und Sie erhalten eine Nachricht, in der das Zugriffstoken angezeigt wird.

Wichtig

Sie können das RSS-Zugriffstoken nur einmal sehen, und zwar direkt nachdem Sie es erstellt haben. Vergewissern Sie sich, dass Sie es kopieren.

Sobald ein RSS-Token erstellt wurde, sehen Sie hier die Details und können ihn löschen, indem Sie auf das Symbol Löschen klicken.

Client-Tokens

Client-Tokens werden von externen Anwendungen generiert und ermöglichen OpenProject die Verbindung mit ihnen.

OAuth

OAuth-Client-Tokens ermöglichen es dieser OpenProject-Instanz, sich mit externen Anwendungen zu verbinden.

Wenn Sie Ihr Konto noch nicht mit einer der für Ihre Instanz aktivierten Integrationen verknüpft haben, ist diese Liste leer. Sie können Token löschen, indem Sie auf das Symbol Löschen klicken.