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

# Semgrep

> Verbinden Sie die Semgrep AppSec Platform mit einem Bearer-API-Token mit Web-API-Scope mit Iru Compliance, um Nachweise zu Findings, Deployments und Richtlinien zu erfassen.

### Über Semgrep

Iru ruft die **Web API** von Semgrep für **Findings**, **Projekte** und **Richtlinien** auf. Token müssen den Scope **Web API** enthalten – Token, die nur für **Agent/CI** gelten, liefern an Web-Endpunkten **404**-Fehler. Für den API-Zugriff ist in der Regel der Tarif **Team** oder **Enterprise** erforderlich.

### Funktionsweise

```http theme={null}
Authorization: Bearer YOUR_API_TOKEN
```

| Detail | Wert |
| - | - |
| **Kategorie** | Sicherheit |
| **Authentifizierung** | Bearer (Web-API-Scope) |

Offizielle Referenzen: [Token](https://semgrep.dev/docs/deployment/tokens), [Web-API-Scope](https://semgrep.dev/docs/kb/semgrep-appsec-platform/api-404-token-scope), [API-Referenz](https://semgrep.dev/api/v1/docs/).

### Voraussetzungen

* **Administrator** oder **Besitzer** der Semgrep-Organisation.

### Semgrep mit Iru verbinden

<Tabs>
  <Tab title="Semgrep">
    <Note>
      Schließen Sie diesen Tab ab, bevor Sie die Quelle in Compliance verbinden.
    </Note>

    <Steps>
      <Step title="Bei Semgrep anmelden">
        Öffnen Sie die **Semgrep AppSec Platform** und melden Sie sich als **Administrator** oder **Besitzer** der Organisation an, die Iru lesen soll.
      </Step>

      <Step title="Einstellungen öffnen">
        Wählen Sie **Einstellungen** (je nach Semgrep-Oberfläche über das Zahnradsymbol oder das Profilmenü).
      </Step>

      <Step title="Tokens öffnen">
        Navigieren Sie zu **Tokens** und dann zu **API-Token** (die Bezeichnung kann auch **API Tokens** oder **Personal access tokens** lauten).
      </Step>

      <Step title="Token erstellen">
        Wählen Sie **Erstellen** (oder **New token**). Geben Sie einen Namen wie **Iru Compliance** ein.
      </Step>

      <Step title="Web-API-Scope aktivieren">
        Aktivieren Sie den Scope **Web API** (für diesen Connector erforderlich). Entfernen Sie alle Schreib-Scopes, die Ihr Sicherheitsteam für die reine Nachweiserfassung nicht wünscht.
      </Step>

      <Step title="Speichern und Secret kopieren">
        **Speichern** Sie das Token und kopieren Sie dann das **Secret** einmalig. Semgrep zeigt es nur bei der Erstellung an.
      </Step>
    </Steps>

    <Note>
      Fahren Sie im Tab [**Iru Compliance**](#iru-compliance) fort.
    </Note>
  </Tab>

  <Tab title="Iru Compliance">
    <Note>
      Schließen Sie zuerst den Tab [**Semgrep**](#semgrep) ab.
    </Note>

    <Steps>
      <Step title="Quellen öffnen">
        Erweitern Sie in Iru Compliance in der linken Navigationsleiste **Compliance** und wählen Sie **Quellen**.

        <Frame>
          <img src="https://mintcdn.com/iru/tI0HDLDwHj8r9Ile/assets/media/images/iru-navigation-compliance-sources.png?fit=max&auto=format&n=tI0HDLDwHj8r9Ile&q=85&s=87dcef15fc17d2fb9a6e53f454e41710" alt="Linke Navigation: Compliance erweitert, Sources ausgewählt" width="410" height="1024" data-path="assets/media/images/iru-navigation-compliance-sources.png" />
        </Frame>
      </Step>

      <Step title="Semgrep aktivieren">
        Suchen Sie **Semgrep** (verwenden Sie **Kategorie** oder **Nach Name oder Beschreibung suchen**). Aktivieren Sie auf dieser Karte den **Schalter**. Für den Connector-Assistenten kann sich ein Browser-Tab oder -Fenster öffnen.
      </Step>

      <Step title="API-Token einfügen">
        Fügen Sie das **Bearer**-Token ein, wenn Sie dazu aufgefordert werden.
      </Step>

      <Step title="Verbindung abschließen">
        Wählen Sie **Bearer-Token senden**. Wenn die Verbindung erfolgreich ist, zeigt der Assistent **Verbindung konfiguriert** an.
      </Step>

      <Step title="Prüfen, ob die Quelle aktiv ist">
        Schließen Sie den Browser-Tab **Iru fordert Zugriff auf externe Dienste an**, kehren Sie dann zu **Compliance** → **Quellen** zurück und vergewissern Sie sich, dass die Karte **Semgrep** den Status **Aktiv** hat.
      </Step>
    </Steps>
  </Tab>
</Tabs>

### Fehlerbehebung

<AccordionGroup>
  <Accordion title="Beim Aktivieren der Quelle öffnet sich nichts">
    Überprüfen Sie die Einstellungen des **Pop-up-Blockers** für die Iru-Website und versuchen Sie es erneut.
  </Accordion>

  <Accordion title="404 bei der API">
    Erstellen Sie das Token mit dem Scope **Web API** neu.
  </Accordion>

  <Accordion title="Keine API-Funktionen">
    Wechseln Sie zu einem Tarif, der API-Zugriff umfasst.
  </Accordion>
</AccordionGroup>

### Verwandte Artikel

<CardGroup cols={2}>
  <Card title="Verwaltung von Quellen" icon="plug" href="/de/compliance/sources-management">
    Alle Compliance-Quellen durchsuchen und verwalten.
  </Card>

  <Card title="Erste Schritte mit Compliance" icon="rocket" href="/de/compliance/getting-started-with-compliance">
    Frameworks, Aktionen und **Artefakte**.
  </Card>

  <Card title="Iru-Überblick" icon="layer-group" href="/de/iru/platform-overview/iru-overview">
    Wie Endpoint, Compliance und Identity zusammenwirken.
  </Card>

  <Card title="Verwaltung von Artifacts" icon="folder-open" href="/de/compliance/artifacts-management">
    Nachweise aus Quellen und Aktionen hochladen, prüfen und organisieren.
  </Card>
</CardGroup>