Jira Cloud Dokumentation

OAuth Zugriff zulassen





Über OAuth-Zugriffstoken

OAuth-Zugriffstoken ermöglichen es dir:


  • Ein Jira Gadget auf einer externen, OAuth-kompatiblen Webanwendung oder Website zu verwenden (auch bekannt als "Consumer")
  • Diesem Gadget Zugriff auf Jira-Daten gewähren, die deinem Jira-Benutzerkonto vorbehalten sind.


Bevor du beginnst

Dein Jira Administrator muss eine OAuth-Verbindung mit dieser externen Webanwendung oder Instanz herstellen, indem er sie als OAuth-Consumer freigibt. Wenn du zum Beispiel ein Jira-Gadget zu deiner Bamboo-Homepage hinzufügen und diesem Gadget den Zugriff auf deine eingeschränkten Jira-Daten erlauben möchtest, muss dein Jira Administrator Bamboo zunächst als OAuth-Consumer genehmigen.


Das Jira-Gadget auf dem "Consumer" erhält über ein "OAuth-Zugriffstoken", das als eine Art "Schlüssel" fungiert, Zugriff auf deine Jira-Daten. Solange der Consumer im Besitz dieses Zugriffstokens ist, kann das Jira-Gadget auf Jira-Daten zugreifen, die sowohl öffentlich zugänglich als auch in deinem Jira-Benutzerkonto enthalten sind. Du kannst dieses Zugriffstoken jederzeit in deinem Jira-Benutzerkonto widerrufen, ansonsten laufen alle Zugriffstoken nach sieben Tagen ab. Sobald das Zugriffstoken widerrufen wurde oder abgelaufen ist, hat das Jira-Gadget nur noch Zugriff auf öffentlich zugängliche Daten in deiner Jira-Instanz.


Ein OAuth-Zugriffstoken erscheint nur dann in deinem Benutzerprofil, wenn die folgenden Bedingungen erfüllt sind:


  1. Dein Jira Administrator hat mit OAuth einen Anwendungslink zwischen deiner Jira-Instanz und dem Consumer eingerichtet. Jira Administratoren sollten sich mit der Verwendung von AppLinks zur Verknüpfung mit anderen Anwendungen (Englisch) befassen.
  2. Du hast einem Jira Gadget bei einem Consumer den Zugriff auf deine Jira Daten erlaubt. Weitere Informationen zu diesem Vorgang findest du weiter unten unter Ausstellen von OAuth-Zugriffstoken.


Ausstellen von OAuth-Zugriffstoken

Ein OAuth-Zugriffstoken wird von Jira ausgegeben, um einem seiner Gadgets auf einem Consumer Zugriff auf deine Jira-Daten zu gewähren (d.h. Daten, die auf dein Jira-Benutzerkonto beschränkt sind).


  • Wenn du ein Jira-Gadget auf einem Consumer (z. B. Bamboo) verwendest und dieses Gadget Zugriff auf deine Jira-Daten benötigt, wirst du zunächst aufgefordert, dich bei Jira anzumelden (falls du das noch nicht getan hast).
  • Wenn du dich bei Jira angemeldet hast, bekommst du eine Nachricht mit der Aufforderung, den Zugriff zu beantragen. 
    Zu diesem Zeitpunkt bereitet Jira den Vorgang vor, dem Jira Gadget (auf dem Consumer) ein OAuth-Zugriffstoken zu geben.
  • Um dem Gadget Zugriff auf deine Jira-Daten zu gewähren, klicke auf die Schaltfläche Zugriff genehmigen. Die Consumeranwendung erhält das OAuth-Zugriffstoken von deiner Jira-Instanz. Dieses Zugriffstoken ist spezifisch für dieses Gadget. Solange das Token im Gadget gespeichert ist, hat dein Gadget Zugriff auf deine Jira-Daten.


OAuth-Zugriffstoken widerrufen

Du kannst ein OAuth-Zugriffstoken widerrufen, um einem Jira-Gadget auf einem Consumer den Zugriff auf Jira-Daten zu verweigern, die auf dein Jira-Benutzerkonto beschränkt sind. Du kannst nur OAuth-Zugriffstoken widerrufen, deren Vorgang du Jira zuvor erlaubt hast.


  1. Klicke auf Dein Profil () > Persönliche Einstellungen.
  2. Klicke unten auf der Seite im Bereich Verbundene Apps auf Apps verwalten.
  3. Deine Liste der OAuth-Zugriffstoken wird in einem Tabellenformat dargestellt, wobei jedes Zugriffstoken in einer eigenen Zeile und jede Eigenschaft dieser Token in einer eigenen Spalte aufgeführt wird. Weitere Informationen zu dieser Tabelle findest du weiter unten.
  4. Finde das Jira-Gadget und die zugehörige Consumeranwendung, deren OAuth-Zugriffstoken du widerrufen möchtest, und klicke auf den Link OAuth-Zugriffstoken widerrufen in der Spalte Aktionen.
  5. Möglicherweise wirst du aufgefordert, diese Aktion zu bestätigen. Wenn ja, klicke auf OK.


Das Zugriffstoken des Gadgets wird widerrufen und das Jira-Gadget auf dem Consumer hat nur noch Zugriff auf öffentlich verfügbare Jira-Daten.


Details zur OAuth-Zugriffstoken-Tabelle


Spaltenname

Beschreibung

Consumer

Der Name des Jira-Gadgets, das dem Consumer hinzugefügt wurde.

Beschreibung des Consumers

Eine Beschreibung dieser Consumeranwendung. Diese Informationen wurden aus den OAuth-Einstellungen des Consumers entnommen, als eine OAuth-Verbindung zwischen Jira und diesem Consumer hergestellt wurde.
(info) Handelt es sich bei dem Consumer um eine andere Atlassian-Anwendung, werden diese Informationen aus dem Feld "Beschreibung" des Tabs Consumer-Info (Englisch) in den OAuth-Administrationseinstellungen übernommen. Der Administrator der Anwendung kann dieses Detail der Consumerinformationen anpassen.

Ausgegeben am

Das Datum, an dem der OAuth-Zugriffstoken von Jira an den Consumer ausgegeben wurde. Dies geschieht unmittelbar, nachdem du dem Gadget den Zugriff auf deine Jira-Daten erlaubt hast (in deinem Jira-Benutzerkonto).

Läuft aus am

Das Datum, an dem das OAuth-Zugriffstoken abläuft. Das ist sieben Tage nach dem Datum "Ausgegeben am". Wenn dieses Datum erreicht ist, wird das Zugriffstoken automatisch aus dieser Liste entfernt.

Aktionen

Die Funktion zum Widerruf des Zugangstokens.





Zurück zum Hauptmenü   Nächstes Thema  







Confluence

Diese Seite wurde zuletzt am 18.09.2023 geändert.