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

# Arnica

> Verbinden Sie Arnica über einen eingeschränkten, schreibgeschützten API-Schlüssel mit Iru Compliance, um Ergebnisse der Secret-Erkennung, Repository-Inventar, Entwicklerrisiken und den Status von Sicherheitsrichtlinien zu erfassen.

### Über Arnica

Iru liest **Ergebnisse**, **Repository-Inventar**, **Sicherheitsrichtlinien** und Daten zu **Entwicklerrisiken** über die REST API von Arnica mit einem **Bearer**-API-Schlüssel, der in der Arnica-Webplattform unter **Administrator** → **API** erstellt wird. Schlüssel werden bei der Erstellung an **Scopes gebunden**. Gewähren Sie nur die **Lese**-Scopes, die Ihre Kontrollen erfordern, und vermeiden Sie Schreib-Scopes vollständig.

### So funktioniert es

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

Die API von Arnica wird unter `https://api.app.arnica.io` in Version **v1** bereitgestellt. Schlüssel werden im Arnica-Dashboard pro Scope erstellt, sodass ein Schlüssel ohne einen bestimmten Scope einen Fehler statt eines Teilergebnisses zurückgibt. Arnica gibt bei jedem Authentifizierungs- und Autorisierungsfehler **`403`** zurück, nicht `401`. Ein ungültiger Schlüssel, ein widerrufener Schlüssel und ein Schlüssel ohne erforderlichen Scope sehen alle gleich aus. Iru speichert nur den API-Schlüssel; es muss kein Host und keine Subdomain konfiguriert werden.

| Detail | Wert |
| - | - |
| **Kategorie** | Sicherheit |
| **Authentifizierung** | Bearer (API-Schlüssel mit Scopes) |

Offizielle Referenzen: [Arnica-Dokumentation](https://docs.arnica.io/), [API-Referenz (Swagger)](https://api.app.arnica.io/swagger).

### Voraussetzungen

* **Arnica-Admin**-Zugriff. Nur Admins können **Administrator** → **API** öffnen, um einen Schlüssel zu erstellen.
* Legen Sie fest, welche Repositorys einbezogen werden. In Arnica können Sie Repositorys ausschließen, und ausgeschlossene Repositorys liefern keine Nachweise. Iru kann nicht unterscheiden, ob ein Repository keine Ergebnisse hat oder nie gescannt wurde.

### Arnica mit Iru verbinden

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

    <Steps>
      <Step title="Bei Arnica anmelden">
        Melden Sie sich unter [https://app.arnica.io](https://app.arnica.io) mit einem Konto an, das die Rolle **admin** hat.
      </Step>

      <Step title="Admin API öffnen">
        Gehen Sie zu **Administrator** → **API**.
      </Step>

      <Step title="Neuen API-Schlüssel erstellen">
        Wählen Sie **Create a New API Key** aus.
      </Step>

      <Step title="Schlüssel benennen">
        Geben Sie einen Namen wie **Iru Compliance** ein, damit Sie diesen Schlüssel später identifizieren können.
      </Step>

      <Step title="Schreibgeschützte Scopes auswählen">
        Wählen Sie **schreibgeschützte** Scopes aus, die Ihr Compliance-Programm abdecken: `risks:read`, `products:read`, `inventory:read`, `policies:read` und `status-checks:read`. Fügen Sie `groups:read` hinzu, wenn Ihre Kontrollen die Mitgliedschaft in Entwicklergruppen abdecken. Gewähren Sie **nicht** `risks:write` oder andere Schreib-Scopes.
      </Step>

      <Step title="Token erstellen und kopieren">
        Wählen Sie **Erstellen** aus und kopieren Sie den Tokenwert, solange Arnica ihn **einmalig** anzeigt. Bewahren Sie ihn sicher auf, bis Sie ihn als **Bearer**-Token in Iru einfügen.
      </Step>
    </Steps>

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

  <Tab title="Iru Compliance">
    <Note>
      Schließen Sie zuerst die Registerkarte [**Arnica**](#arnica) ab.
    </Note>

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

        <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="Arnica aktivieren">
        Suchen Sie **Arnica** (verwenden Sie **Kategorie** oder **Nach Name oder Beschreibung suchen**). Aktivieren Sie auf dieser Karte den **Schalter**. Möglicherweise öffnet sich eine Browser-Registerkarte oder ein Fenster für den Connector-Assistenten.
      </Step>

      <Step title="Bearer-Token einfügen">
        Fügen Sie das Token in das Feld **Bearer** ein.
      </Step>

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

      <Step title="Prüfen, ob die Quelle aktiv ist">
        Schließen Sie die Browser-Registerkarte **Iru fordert Zugriff auf externe Dienste an**, kehren Sie dann zu **Compliance** → **Quellen** zurück und vergewissern Sie sich, dass die Karte **Arnica** 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="Verbindung schlägt mit 403 fehl">
    Arnica gibt bei Authentifizierungsfehlern `403` statt `401` zurück. Dies umfasst daher sowohl einen ungültigen, abgelaufenen oder widerrufenen Schlüssel als auch einen fehlenden Scope. Generieren Sie den Schlüssel neu, vergewissern Sie sich, dass Sie die vollständige Zeichenfolge eingefügt haben, und prüfen Sie die Scope-Liste erneut.
  </Accordion>

  <Accordion title="Für einige Repositorys fehlen Ergebnisse">
    Entweder fehlt dem Schlüssel `risks:read` oder `inventory:read`, oder diese Repositorys sind in Arnica **ausgeschlossen**. Ausgeschlossene Repositorys sind für Iru unsichtbar.
  </Accordion>

  <Accordion title="Die Karte ist aktiv, aber es sind keine Artefakte erschienen">
    Arnica wird nach einem Zeitplan abgefragt, nicht bei Bedarf. Warten Sie einen vollständigen Erfassungszyklus ab, bevor Sie der Sache nachgehen.
  </Accordion>
</AccordionGroup>

### Verwandte Artikel

<CardGroup cols={2}>
  <Card title="Quellenverwaltung" 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-Übersicht" icon="layer-group" href="/de/iru/platform-overview/iru-overview">
    Wie Endpoint, Compliance und Identity zusammenwirken.
  </Card>

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