> ## Documentation Index
> Fetch the complete documentation index at: https://docs.corgea.app/llms.txt
> Use this file to discover all available pages before exploring further.

# JIRA

> Einrichten der JIRA-Integration in Corgea

Mit Corgeas JIRA-Integration erstellen Sie automatisch JIRA-Tickets für Security-Issues in Ihrer Codebasis und Ihren Abhängigkeiten. So können Sie Schwachstellen direkt in Ihrem vorhandenen JIRA-Workflow nachverfolgen und verwalten.

## Voraussetzungen

Für die JIRA-Integration benötigen Sie:

* Ein JIRA-Konto mit administrativen Rechten
* Die URL Ihrer JIRA-Instanz (z.B., `https://mycompany.atlassian.net`)
* Ein JIRA-API-Token ([So erstellen Sie ein JIRA-API-Token](https://support.atlassian.com/atlassian-account/docs/manage-api-tokens-for-your-atlassian-account/))

## Einrichtung der Integration

<Steps>
  <Step title="Zugriff auf die Integrationsseite">
    Melden Sie sich bei Corgea an und öffnen Sie die Seite "Integrations".
  </Step>

  <Step title="JIRA-Integrationen öffnen">
    Suchen Sie die Integration "JIRA" und klicken Sie auf "Add" oder "Edit", um die JIRA-Integrationsseite zu öffnen.
  </Step>

  <Step title="Integration konfigurieren">
    <img src="https://mintcdn.com/corgea/uxLuQR4653lM43Tj/images/create-jira-integration.png?fit=max&auto=format&n=uxLuQR4653lM43Tj&q=85&s=9b9ee22cc1005576c9723ff40294e23d" alt="JIRA-Integration erstellen" width="1009" height="616" data-path="images/create-jira-integration.png" />

    Klicken Sie auf "Add Integration" und geben Sie Folgendes ein:

    * **Name**: Eine aussagekräftige Bezeichnung für die Integration (z. B. "My JIRA Instance")
    * **Base URL**: URL Ihrer JIRA-Instanz (z. B. `https://mycompany.atlassian.net`)
    * **Username**: Ihr JIRA-Benutzername
    * **API Token**: Ihr JIRA-API-Token
    * **Project Key** (optional): Standardmäßiger JIRA-Projektschlüssel beim Erstellen von Issues
    * **Issue Type** (optional): Standardmäßiger JIRA-Issue-Typ beim Erstellen von Issues
  </Step>

  <Step title="Konfiguration speichern">
    Klicken Sie auf "Save", um die Einrichtung abzuschließen.
  </Step>
</Steps>

## JIRA-Vorgänge erstellen

<Steps>
  <Step title="Zu Issues navigieren">
    Navigieren Sie entweder zu einem Code-Issue oder zu einem Dependency-Issue in Corgea und öffnen Sie die Detailseite des Issues.
  </Step>

  <Step title="Auf Issue-Details zugreifen">
    Klicken Sie auf der Issue-Detailseite auf das Ticket-Symbol (Tooltip: "Create Ticket").

    <img src="https://mintcdn.com/corgea/iadAV76rx_-M1qX0/images/pull_request.png?fit=max&auto=format&n=iadAV76rx_-M1qX0&q=85&s=c8286da5954cff2b319a709b40c635ca" alt="Ticket erstellen Schaltfläche" width="492" height="436" data-path="images/pull_request.png" />
  </Step>

  <Step title="Ticket konfigurieren">
    Wenn Sie bei der Einrichtung keine Standardwerte für Project Key und Issue Type festgelegt haben, geben Sie diese hier an. Corgea ruft die verfügbaren Projekte und Issue-Typen automatisch ab.

    <img src="https://mintcdn.com/corgea/uxLuQR4653lM43Tj/images/create-ticket.png?fit=max&auto=format&n=uxLuQR4653lM43Tj&q=85&s=9225ca9d574a1fbf4abe654aa545669d" alt="Ticket erstellen" width="611" height="499" data-path="images/create-ticket.png" />
  </Step>

  <Step title="Ticket erstellen">
    Klicken Sie auf "Create JIRA Ticket". Corgea erstellt ein neues JIRA-Issue mit den relevanten Details.
  </Step>

  <Step title="Erstellung bestätigen">
    Sie erhalten eine Bestätigungsnachricht mit einem Link zum neu erstellten JIRA-Ticket.
  </Step>
</Steps>

## Anpassen der JIRA-Ticket-Details

Standardmäßig füllt Corgea das JIRA-Ticket mit den folgenden Informationen aus:

* **Zusammenfassung**:
  * Code-Issues: Issue-Klassifizierung und Dateiposition
  * Dependency-Issues: CVE, betroffenes Paket und betroffene Version
  * Zusammenfassungen, die die Längenbegrenzung von JIRA überschreiten, werden automatisch verkürzt
* **Beschreibung**:
  * Details zur Sicherheitslücke (Ort/Paket, Kategorie, Schweregrad)
  * Erläuterung des Issues
  * Vorgeschlagener Fix (falls verfügbar)
  * Link zur Issue-Detailseite in Corgea

Wenn Sie zusätzliche Felder einfügen oder die Ticketdetails anpassen müssen, können Sie das JIRA-Ticket nach seiner Erstellung in Ihrer JIRA-Instanz ändern.

## Verwaltung mehrerer JIRA-Integrationen

Wenn Sie mehrere JIRA-Instanzen oder -Projekte haben, können Sie mehrere JIRA-Integrationen in Corgea einrichten. Beim Erstellen eines JIRA-Tickets werden Sie aufgefordert, die entsprechende Integration auszuwählen.

Auf der JIRA-Integrationsseite können Sie eine bestehende Integration bearbeiten oder eine Integration löschen, die Sie nicht mehr benötigen. Beim Bearbeiten einer Integration lassen Sie das API-Token leer, um das vorhandene Token beizubehalten, oder geben Sie ein neues Token ein, um es zu ersetzen.

Durch die Integration von Corgea mit JIRA können Sie Ihren Prozess zur Verwaltung von Sicherheitslücken optimieren und sicherstellen, dass kritische Probleme innerhalb Ihres bestehenden Workflows verfolgt und bearbeitet werden.