FAQ

Wie kann ich meine OAuth Credentials für Jira Cloud erstellen?

Um OAuth für die Authentifizierung in ESM nutzen zu können, musst du einige Schritte durchführen. Zuerst musst du eine App in der Atlassian Developer Konsole registrieren.

Rufe die Atlassian Developer Konsole auf und erstelle eine neue OAuth 2.0 Integration

Navigiere zu Permissions und füge Jira API hinzu. Setze folgende Berechtigungs-Scopes:

Jira platform REST API

Scope Name	Code
View Jira issue data	`read:jira-work`
Manage project settings	`manage:jira-project`
View user profiles	`read:jira-user`
Create and manage issues	`write:jira-work`

Jira platform Management API

Scope Name	Code
View Jira Service Management request data	`read:servicedesk-request`
Manage Jira Service Management customers and organizations	`manage:servicedesk-customer`
Create and manage Jira Service Management requests	`write:servicedesk-request`

Wechsle zu Authorization und konfiguriere OAuth 2.0 (3LO)
Setze https://your-matrix-url.com/wm/externalAuth/redirect.html als Callback-URL. Ersetze your-matrix-url.com durch die URL deines Matrix-Systems.

Info

Es ist nicht notwendig, dass die URL aus dem Internet erreichbar ist.
Navigiere zu Settings. Hier findest du die benötigten Informationen Client ID und Secret

Wo finde ich die ID meines Issue-Typs?

Öffne in Jira eine Issue mit dem Issue-Typ, dessen ID du haben möchtest (z.B. Bug)
Exportiere diese Issue als XML

Suche nach der Zeile, wo der Typ definiert ist

Beispiel XML Export

<rss version="0.92">
    <channel>
        ...
        <item>
            ...
            <type id="10012" iconUrl="...">Bug</type>
            ...
        </item>
    </channel>
</rss>

Kopiere den Wert von id

Wo finde ich die ID einer Priorität?

Öffne in Jira eine Issue mit der Priorität dessen ID du wissen möchtest.
Exportiere diese Issue als XML

Suche nach der Zeile, wo die Priorität definiert ist

Beispiel XML Export

<rss version="0.92">
    <channel>
        ...
        <item>
            ...
            <priority id="3" iconUrl="...">Medium</priority>
            ...
        </item>
    </channel>
</rss>

Kopiere den Wert von id

Wo finde ich meinen Projektschlüssel?

Jira Cloud

Öffne eine Ansicht (z.B. ein Board) in Jira

Deine URL sollte etwa so aussehen:

https://company.atlassian.net/jira/software/projects/{PROJEKTSCHLÜSSEL}/boards/1

Jira Server

Öffne eine Ansicht (z.B. ein Board) in deiner Jira Server-Instanz

Deine URL sollte etwa so aussehen:

https://YOUR_SERVER.com/projects/{PROJEKTSCHLÜSSEL}/boards/1

Wie kann ich meine E-Mail auch für nicht-Administratoren sichtbar machen?

Navigiere zum Jira ID Portal
Im Abschnitt Kontakt kann nun die Sichtbarkeit der E-Mail auf Jeder gesetzt werden.

Wo kann ich die ID einer Projekt Rolle bekommen?

Rufe in deinem Browser einfach die URL https://[COMPANY].atlassian.net/rest/api/3/project/[PROJECT_ID_OR_KEY]/roledetails?excludeConnectAddons=true auf.

[
  {
    "self": "https://[COMPANY].atlassian.net/rest/api/3/project/10017/role/10022",
    "name": "Administrator",
    "id": 10022,
    "description": "Admins can do most things, like update settings and add other admins.",
    "admin": true,
    "default": false,
    "scope": {
      "type": "PROJECT",
      "project": {
        "id": "10017"
      }
    },
    "roleConfigurable": true,
    "translatedName": "Administrator"
  },
  ...
]

Wie kann ich einen Service Account erstellen?

Warning

Nachdem du den Service Account erstellt hast, hat dieser noch keine Berechtigungen in Jira. Du musst dem Account in Jira explizit die notwendigen Rechte zuweisen, damit er auf Projekte und Daten zugreifen kann.

Navigiere zur Atlassian Admin Seite.
Navigiere auf der Linken Seite zu Directory > Service Accounts
Vergebe Name und Beschreibung. Der Name wird später als Benutzer Name des Account Users in Jira angezeigt.
Wähle als App Role bei Jira die Benutzer-Rolle
Nach dem erfolgreichen Erstellen des Service Accounts erstelle unter Credentials neue OAuth 2.0 Credentials.
Zum einfachen Finden der benötigten Berechtigungs-Scopes stelle folgende Filter ein
Suche und aktiviere folgende Scopes:
- read:jira-work
- read:jira-user
- write:jira-work
- manage:jira-project
- manage:jira-configuration