> ## 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.

# Linear

> Einrichten der Linear-Integration in Corgea

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

## Voraussetzungen

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

* Einen Linear-Workspace, auf den Sie Zugriff haben
* Einen persönlichen Linear-API-Schlüssel, erstellt unter **Settings > API** ([Linear-API-Schlüssel erstellen](https://linear.app/docs/api-and-webhooks))
* Die Corgea-Berechtigung **Manage Integration** zum Hinzufügen, Bearbeiten oder Löschen einer Integration sowie **View Integration** zum Anzeigen vorhandener Integrationen (siehe [Berechtigungsgruppen](/de/permission_groups))

<Note>
  Ein persönlicher Linear-API-Schlüssel übernimmt Ihre Berechtigungen im Workspace. Erstellen Sie den Schlüssel mit einem Konto, dessen Zugriffsrechte den für Corgea vorgesehenen Aktionen entsprechen. Corgea speichert den Schlüssel verschlüsselt und zeigt ihn nach dem Speichern nicht erneut an.

  Nur persönliche API-Schlüssel werden unterstützt. OAuth ist derzeit nicht verfügbar.
</Note>

<Info>
  Die Linear-Integration ist ab dem Starter-Tarif verfügbar. Im Free-Tarif fordert Corgea Sie zu einem Upgrade auf, statt die Integrationsseite zu öffnen.
</Info>

## Einrichtung der Integration

<Steps>
  <Step title="Zugriff auf die Integrationsseite">
    Melden Sie sich bei Corgea an, öffnen Sie "Integrations" und suchen Sie unter **Ticketing Integrations** nach "Linear".

    <Frame>
      <img src="https://mintcdn.com/corgea/yUpPYRq94UTabZ2I/images/linear/ticketing_integrations.png?fit=max&auto=format&n=yUpPYRq94UTabZ2I&q=85&s=e8406565228b260e6adb7083922fea53" style={{ borderRadius: '0.5rem' }} alt="Linear wird zusammen mit JIRA unter Ticketing-Integrationen aufgelistet" width="2462" height="374" data-path="images/linear/ticketing_integrations.png" />
    </Frame>
  </Step>

  <Step title="Linear-Integrationen öffnen">
    Klicken Sie auf "Add", um die Seite für Linear-Integrationen zu öffnen. Sobald mindestens eine Integration konfiguriert ist, heißt die Schaltfläche "Edit" und zeigt die Anzahl der Integrationen an.

    <Frame>
      <img src="https://mintcdn.com/corgea/yUpPYRq94UTabZ2I/images/linear/no_linear_integrations.png?fit=max&auto=format&n=yUpPYRq94UTabZ2I&q=85&s=fc8927e7b15dd85a69c12e1950f95515" style={{ borderRadius: '0.5rem' }} alt="Die Seite der Linear-Integrationen, bevor eine Integration hinzugefügt wurde" width="2576" height="918" data-path="images/linear/no_linear_integrations.png" />
    </Frame>
  </Step>

  <Step title="Integration konfigurieren">
    Klicken Sie auf "Add Integration" und geben Sie Folgendes ein:

    * **Name**: Eine aussagekräftige Bezeichnung für die Integration (z. B. "My Linear Workspace")
    * **API Key**: Ihr persönlicher Linear-API-Schlüssel
    * **Team Default** (optional): ID des Linear-Teams, das beim Erstellen von Issues vorausgewählt wird
    * **Project Default** (optional): ID des Linear-Projekts, das beim Erstellen von Issues vorausgewählt wird

    Beide Standardwerte erfordern eine Linear-ID statt eines Namens. Lassen Sie die Felder leer, um Team und Projekt bei jedem Ticket auszuwählen.

    <Frame>
      <img src="https://mintcdn.com/corgea/kSEDD3ERVNp3rnFE/images/linear/add_linear_integration_modal.png?fit=max&auto=format&n=kSEDD3ERVNp3rnFE&q=85&s=8c462b1c7d9a1bcb0fc7d40efa115696" style={{ borderRadius: '0.5rem' }} alt="Das Dialogfeld 'Linear-Integration hinzufügen'" width="1014" height="1018" data-path="images/linear/add_linear_integration_modal.png" />
    </Frame>
  </Step>

  <Step title="Konfiguration speichern">
    Klicken Sie zum Abschließen der Integration auf "Save". Corgea prüft den API-Schlüssel vor dem Speichern bei Linear. Ein ungültiger Schlüssel wird sofort abgelehnt und nicht gespeichert.

    <Frame>
      <img src="https://mintcdn.com/corgea/yUpPYRq94UTabZ2I/images/linear/linear_integration_api_key_error.png?fit=max&auto=format&n=yUpPYRq94UTabZ2I&q=85&s=d4ad2803c35706aadaeaed72e81bb8c4" style={{ borderRadius: '0.5rem' }} alt="Das Dialogfeld 'Linear-Integration hinzufügen' zeigt einen Fehler wegen eines ungültigen API-Schlüssels" width="1022" height="1180" data-path="images/linear/linear_integration_api_key_error.png" />
    </Frame>
  </Step>
</Steps>

## Erstellen von Linear-Issues

<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 in der Issue-Seitenleiste auf das Wegweiser-Symbol (Tooltip: "Create Linear Ticket"). Wenn JIRA ebenfalls verbunden ist, befindet sich die zugehörige Schaltfläche daneben.

    <Frame>
      <img src="https://mintcdn.com/corgea/yUpPYRq94UTabZ2I/images/linear/create_linear_ticket_button.png?fit=max&auto=format&n=yUpPYRq94UTabZ2I&q=85&s=7267dee4eb043bab7860ca900917d4c1" style={{ borderRadius: '0.5rem' }} alt="Schaltfläche Create Linear Ticket in der Issue-Seitenleiste" width="616" height="602" data-path="images/linear/create_linear_ticket_button.png" />
    </Frame>
  </Step>

  <Step title="Ticket konfigurieren">
    Wählen Sie zunächst die Integration und anschließend das Team aus. Falls Sie bei der Einrichtung keine Standardwerte für Team und Projekt angegeben haben, legen Sie diese hier fest. Corgea ruft Ihre Teams automatisch ab; nach der Teamauswahl werden die zugehörigen Projekte geladen.

    Das Projekt ist optional. Wählen Sie "No project", um das Issue ohne Projekt für das Team anzulegen oder eine vorhandene Projektauswahl aufzuheben.

    <Frame>
      <img src="https://mintcdn.com/corgea/yUpPYRq94UTabZ2I/images/linear/create_linear_ticket_modal.png?fit=max&auto=format&n=yUpPYRq94UTabZ2I&q=85&s=836927e5d8afc281211518bc26896cda" style={{ borderRadius: '0.5rem' }} alt="Dialog Create Linear Ticket mit Auswahlfeldern für Integration, Team und Projekt" width="1016" height="824" data-path="images/linear/create_linear_ticket_modal.png" />
    </Frame>
  </Step>

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

  <Step title="Erstellung bestätigen">
    Das neue Linear-Issue wird in einem neuen Browser-Tab geöffnet und Corgea zeigt eine Bestätigung an. Auf der Issue-Detailseite erscheint anschließend ein Link "View Ticket" zum Linear-Issue.
  </Step>
</Steps>

Beim Erstellen eines Tickets werden Erläuterung, Dateipfad und vorgeschlagener Fix des Befunds an Linear gesendet. Deshalb gelten dieselben Zugriffsregeln wie für den Befund: Sie benötigen die Berechtigung zum Anzeigen des Befunds und Zugriff auf das zugehörige Projekt. Wenn Sie den Befund in Corgea nicht öffnen können, können Sie ihn auch nicht an Linear übertragen.

Wenn Corgea Linear nicht erreichen kann oder der API-Schlüssel keine Berechtigung hat, Tickets zu erstellen, wird der Fehler im Dialog angezeigt und kein Ticket wird aufgezeichnet.

<Note>
  Wenn Linear das Issue erstellt, Corgea es aber nicht mit dem Befund verknüpfen kann, zeigt der Dialog einen Link "Open in Linear" zum neuen Issue an und deaktiviert "Create Ticket". Dadurch erzeugt ein erneuter Versuch kein Duplikat. Notieren Sie das Linear-Issue und laden Sie anschließend die Issue-Detailseite neu.
</Note>

"Create Ticket" bleibt auch deaktiviert, während Corgea Teams und Projekte lädt. Dadurch wird kein Ticket erstellt, bevor das Standardprojekt angewendet wurde.

## Details des Linear-Issues anpassen

Corgea füllt das Linear-Issue standardmäßig mit folgenden Informationen:

* **Titel**:
  * Code-Issues: Issue-Klassifizierung und Dateiposition
  * Dependency-Issues: CVE, betroffenes Paket und betroffene Version
* **Beschreibung**:
  * Details zur Sicherheitslücke (Ort/Paket, Kategorie, Schweregrad)
  * Erklärung des Problems
  * Vorgeschlagener Fix einschließlich Code-Diff, sofern Corgea einen generiert hat. Lange Diffs werden gekürzt. Ist kein Fix verfügbar, steht im Abschnitt "Corgea couldn't generate an auto-fix".
  * Projektinformationen: Projektname, Scan-ID und Scandatum (Codeprobleme)
  * Referenzen: Links zum MITRE CWE-Eintrag, zur Corgea CWE-Datenbank und zur betroffenen Datei in GitHub oder GitLab, falls verfügbar (Codeprobleme)
  * Link zur Issue-Detailseite in Corgea

Die Beschreibung verwendet Markdown, sodass Linear Überschriften, Links und Diff-Blöcke nativ rendert.

Wenn Sie zusätzliche Felder hinzufügen oder die Details eines Issues anpassen müssen, können Sie das Linear-Issue ändern, nachdem es in Ihrem Linear-Arbeitsbereich erstellt wurde.

## Verwaltung mehrerer Linear-Integrationen

Wenn Sie mehrere Linear-Arbeitsbereiche haben, können Sie in Corgea mehrere Linear-Integrationen einrichten. Beim Erstellen eines Linear-Issues werden Sie aufgefordert, die entsprechende Integration auszuwählen.

### Bearbeiten einer Integration

Auf der Seite für Linear-Integrationen wählen Sie das Stiftsymbol der Integration aus, die Sie ändern möchten.

<Frame>
  <img src="https://mintcdn.com/corgea/yUpPYRq94UTabZ2I/images/linear/hovering_over_edit_button.png?fit=max&auto=format&n=yUpPYRq94UTabZ2I&q=85&s=bc6e0067cc9b1fa0d6fe892339870e45" style={{ borderRadius: '0.5rem' }} alt="Die Schaltfläche zum Bearbeiten einer Linear-Integration" width="2576" height="918" data-path="images/linear/hovering_over_edit_button.png" />
</Frame>

Lassen Sie das API-Schlüssel-Feld leer, um den vorhandenen Schlüssel beizubehalten, oder geben Sie einen neuen Schlüssel ein, um ihn zu ersetzen. Da Corgea niemals einen gespeicherten Schlüssel an den Browser zurückgibt, ist dieses Feld immer leer, anstatt den aktuellen Wert anzuzeigen.

<Frame>
  <img src="https://mintcdn.com/corgea/yUpPYRq94UTabZ2I/images/linear/edit_linear_integration_modal.png?fit=max&auto=format&n=yUpPYRq94UTabZ2I&q=85&s=f9cb2639fea7be6a42464871d8f91026" style={{ borderRadius: '0.5rem' }} alt="Dialog Edit Linear Integration" width="1014" height="1018" data-path="images/linear/edit_linear_integration_modal.png" />
</Frame>

### Löschen einer Integration

Wählen Sie das Mülltonnen-Symbol bei der Integration, die Sie entfernen möchten.

<Frame>
  <img src="https://mintcdn.com/corgea/yUpPYRq94UTabZ2I/images/linear/hovering_over_delete_button.png?fit=max&auto=format&n=yUpPYRq94UTabZ2I&q=85&s=0586ae8786924759219b42e9769274cb" style={{ borderRadius: '0.5rem' }} alt="Die Schaltfläche zum Löschen einer Linear-Integration" width="2576" height="918" data-path="images/linear/hovering_over_delete_button.png" />
</Frame>

Corgea öffnet eine Bestätigungsseite, die die Integration benennt, bevor sie entfernt wird. Das Löschen einer Integration trennt nur den Arbeitsbereich von Corgea. Die bereits erstellten Linear-Issues bleiben unberührt.

<Frame>
  <img src="https://mintcdn.com/corgea/yUpPYRq94UTabZ2I/images/linear/delete_linear_integration.png?fit=max&auto=format&n=yUpPYRq94UTabZ2I&q=85&s=9de22d656d06f908e38df0f8e69e061f" style={{ borderRadius: '0.5rem' }} alt="Die Bestätigungsseite, die vor dem Löschen einer Linear-Integration angezeigt wird" width="1216" height="580" data-path="images/linear/delete_linear_integration.png" />
</Frame>

Mit der Linear-Integration optimieren Sie Ihr Schwachstellenmanagement und stellen sicher, dass kritische Issues in Ihrem vorhandenen Workflow nachverfolgt und bearbeitet werden.