Jira-Verbindung
Der Scanner liest Jira-Data-Center-Inhalte ausschliesslich über die Jira REST API. Er greift nie auf die Jira-Datenbank zu und verändert nie Jira-Inhalte.
Konfiguration über die Admin-Oberfläche
Öffnen Sie Administration -> Jira-Verbindung und hinterlegen Sie:
- Jira-Basis-URL - z. B.
https://jira.example.com - Benutzername des Service-Accounts - das Jira-Konto für die API-Aufrufe
- Zugangsdaten des Service-Accounts - API-Token oder Passwort dieses Kontos
Führen Sie dann Verbindung testen aus. Der Test prüft, ob die API erreichbar ist, ob die Jira-Version ausgelesen werden kann und ob der Service-Account die nötigen Berechtigungen hat. Fehlgeschlagene Tests zeigen einen bereinigten Fehler; Zugangsdaten erscheinen nie in Fehlermeldungen oder Logs.
Konfiguration über Umgebungsvariablen
| Variable | Beschreibung |
|---|---|
JIRA_BASE_URL | Basis-URL der Ziel-Jira-Data-Center-Instanz |
JIRA_SERVICE_ACCOUNT_USERNAME | Benutzername des Jira-Service-Accounts |
JIRA_SERVICE_ACCOUNT_TOKEN | API-Token / Passwort des Service-Accounts |
JIRA_CREDENTIAL_ENCRYPTION_KEY | Symmetrischer Schlüssel zur Verschlüsselung gespeicherter Zugangsdaten (erforderlich) |
Anforderungen an den Service-Account
Der Service-Account benötigt mindestens die Jira-Berechtigung Projekte durchsuchen in jedem zu scannenden Projekt. Jira-Administratorrechte sind nicht erforderlich - die Administration der Anwendung wird über die OIDC-Rollen der Anwendung gesteuert, nicht über Jira-Berechtigungen.
Speicherung der Zugangsdaten
Zugangsdaten werden mit JIRA_CREDENTIAL_ENCRYPTION_KEY verschlüsselt
gespeichert und nie in Logs geschrieben. Halten Sie den Schlüssel über Neustarts
hinweg stabil; ein Wechsel erfordert die erneute Eingabe der Jira-Zugangsdaten.