Skip to main content

Ü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

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. Offizielle Referenzen: Arnica-Dokumentation, API-Referenz (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

Schließen Sie diese Registerkarte ab, bevor Sie die Quelle in Compliance verbinden.
1

Bei Arnica anmelden

Melden Sie sich unter https://app.arnica.io mit einem Konto an, das die Rolle admin hat.
2

Admin API öffnen

Gehen Sie zu Administrator → API.
3

Neuen API-Schlüssel erstellen

Wählen Sie Create a New API Key aus.
4

Schlüssel benennen

Geben Sie einen Namen wie Iru Compliance ein, damit Sie diesen Schlüssel später identifizieren können.
5

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

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.
Fahren Sie auf der Registerkarte Iru Compliance fort.

Fehlerbehebung

Überprüfen Sie die Einstellungen des Pop-up-Blockers für die Iru-Website und versuchen Sie es erneut.
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.
Entweder fehlt dem Schlüssel risks:read oder inventory:read, oder diese Repositorys sind in Arnica ausgeschlossen. Ausgeschlossene Repositorys sind für Iru unsichtbar.
Arnica wird nach einem Zeitplan abgefragt, nicht bei Bedarf. Warten Sie einen vollständigen Erfassungszyklus ab, bevor Sie der Sache nachgehen.

Verwandte Artikel

Quellenverwaltung

Alle Compliance-Quellen durchsuchen und verwalten.

Erste Schritte mit Compliance

Frameworks, Aktionen und Artefakte.

Iru-Übersicht

Wie Endpoint, Compliance und Identity zusammenwirken.

Artifacts-Verwaltung

Nachweise aus Quellen und Aktionen hochladen, prüfen und organisieren.