Atlassian Cloud Integration¶

Diese Anleitung führt Sie durch die Einrichtung der Atlassian Cloud Integration in TCM365. Nach Abschluss kann TCM365 Konfigurationen aus Jira, Confluence und Atlassian Org Security erfassen, Drift erkennen und kontrollierte Rollbacks durchführen.

Übersicht¶

TCM365 verbindet sich mit Atlassian Cloud über OAuth 2LO (Two-Legged OAuth), auch bekannt als OAuth 2.0 mit Client Credentials. Diese Methode ermöglicht server-zu-server Zugriff ohne Benutzerinteraktion nach der initialen Autorisierung.

Unterstützte Produkte und Resource Types¶

Schritt 1: OAuth App in der Atlassian Developer Console erstellen¶

1. Öffnen Sie die Atlassian Developer Console
2. Klicken Sie auf Create > OAuth 2.0 integration
3. Geben Sie einen Namen ein (z.B. "TCM365 Configuration Manager")
4. Klicken Sie auf Create

App-Berechtigungen (Scopes) konfigurieren¶

Navigieren Sie zu Permissions in Ihrer neuen App und fügen Sie folgende Scopes hinzu:

Jira API Scopes¶

Confluence API Scopes¶

Admin API Scopes¶

Schritt 2: Authorization konfigurieren¶

1. Navigieren Sie zu Authorization in Ihrer App
2. Klicken Sie auf Add neben "OAuth 2.0 (3LO)"
3. Geben Sie die Callback URL ein:

https://ihre-tcm365-instanz.de/api/v1/setup/atlassian/callback

Für lokale Entwicklung:

http://localhost:8000/api/v1/setup/atlassian/callback

1. Klicken Sie auf Save changes

Client Credentials notieren¶

Navigieren Sie zu Settings und notieren Sie:

• Client ID -- Wird in TCM365 als OAuth Client ID benötigt
• Client Secret -- Wird in TCM365 als OAuth Client Secret benötigt (klicken Sie auf "Show" zum Anzeigen)

Schritt 3: Atlassian Tenant in TCM365 verbinden¶

Über den Setup Wizard (empfohlen)¶

1. Navigieren Sie im TCM365 Frontend zu Tenants
2. Klicken Sie auf Tenant hinzufügen
3. Wählen Sie Atlassian als Vendor
4. Der Atlassian Setup Wizard oeffnet sich (AtlassianSetupWizardView)
5. Geben Sie ein:
6. Anzeigename für den Tenant
7. OAuth Client ID aus Schritt 2
8. OAuth Client Secret aus Schritt 2
9. Klicken Sie auf Verbinden
10. Sie werden zur Atlassian-Autorisierungsseite weitergeleitet
11. Wählen Sie die zu verbindende Atlassian Site aus
12. Klicken Sie auf Accept
13. Sie werden zurück zu TCM365 geleitet (AtlassianCallbackView)

Über die API¶

POST /api/v1/tenants

{
  "name": "Meine Atlassian Cloud",
  "vendor": "atlassian",
  "oauthClientId": "ihr-client-id",
  "oauthClientSecret": "ihr-client-secret"
}

Danach den OAuth-Flow starten:

POST /api/v1/setup/atlassian/authorize

Schritt 4: Site Discovery und Guard Tier¶

Nach erfolgreicher OAuth-Autorisierung führt TCM365 automatisch folgende Schritte durch:

Automatische Site Discovery¶

TCM365 ermittelt automatisch:

• Site ID -- Eindeutige Kennung der Atlassian Cloud Site
• Site URL -- URL der Site (z.B. https://contoso.atlassian.net)
• Site Name -- Anzeigename der Site

Guard Tier Erkennung¶

TCM365 erkennt den Atlassian Guard Tier der Organisation:

Der Guard Tier bestimmt, welche Org Security Resource Types erfasst werden können.

Schritt 5: Ersten Snapshot erstellen¶

Nach der Verbindung können Sie sofort Snapshots erstellen:

1. Navigieren Sie zu Snapshots
2. Klicken Sie auf Neuer Snapshot
3. Wählen Sie Ihren Atlassian Tenant
4. Wählen Sie die gewünschten Resource Types (z.B. alle Jira + Confluence + Org Security)
5. Klicken Sie auf Capture starten

Der Capture-Prozess nutzt direkte REST API-Aufrufe an die Atlassian Cloud APIs mit dem AtlassianAdapter.

Authentifizierung und Rate Limiting¶

OAuth 2LO Token-Verwaltung¶

Die AtlassianAuthFactory verwaltet OAuth Tokens automatisch:

• Access Token -- Kurzlebiges Token für API-Aufrufe
• Refresh Token -- Langlebiges Token zur Erneuerung des Access Tokens
• Automatische Erneuerung -- Tokens werden vor Ablauf automatisch erneuert
• Verschluesselte Speicherung -- Alle Tokens werden mit Per-Tenant-Verschlüsselung gespeichert

Rate Limiting¶

Der AtlassianRateLimiter implementiert ein points-basiertes Rate Limiting System, das die Atlassian API Rate Limits respektiert:

• Automatische Drosselung bei Annaeherung an Limits
• Retry-Logik mit exponentialem Backoff
• Separate Rate Limit-Tracking pro Tenant

Feature Flags¶

Die Atlassian-Integration wird über Feature Flags gesteuert:

Feature Flags können pro Organisation über die Feature Registry konfiguriert werden.

Security Baselines für Atlassian¶

TCM365 enthält 3 Atlassian-spezifische Baseline Templates:

Bewerten Sie Ihre Atlassian-Konfiguration unter Baselines mit diesen Templates.

Troubleshooting¶

OAuth-Autorisierung schlägt fehl¶

• Prüfen Sie, ob die Callback URL in der Atlassian Developer Console korrekt konfiguriert ist
• Stellen Sie sicher, dass die erforderlichen Scopes in der App konfiguriert sind
• Überprüfen Sie, ob Ihre Atlassian-Organisation externe App-Zugriffe erlaubt

Fehlende Resource Types im Snapshot¶

• Einige Org Security Resource Types erfordern einen höheren Guard Tier (Standard oder Premium)
• Prüfen Sie die erteilten OAuth Scopes -- fehlende Scopes führen zu Graceful Degradation
• Der TCM365 Diagnostik-Endpoint (/api/v1/diagnostics) zeigt den Verbindungsstatus

Rate Limit-Fehler¶

• Der AtlassianRateLimiter handhabt Rate Limits automatisch
• Bei persistenten Fehlern prüfen Sie, ob andere Anwendungen dasselbe OAuth Token verwenden
• Erhoehen Sie ggf. die Wartezeiten zwischen Snapshot-Erfassungen

Nächste Schritte¶

Nach erfolgreicher Einrichtung der Atlassian-Integration:

• Drift Detection einrichten -- Configuration Monitor für kritische Atlassian-Einstellungen erstellen
• Baseline-Bewertung durchführen -- Atlassian Security Baselines gegen Ihren Snapshot evaluieren
• Benachrichtigungen konfigurieren -- Alerts für Atlassian Configuration Drift aktivieren
• Vergleiche nutzen -- Regelmäßige Snapshots für Konfigurationsvergleiche erstellen