Über Drupal
Iru nutzt Drupal Core JSON:API (/jsonapi) für Inhaltstypen, Nodes, Benutzer, Rollen und zugehörige Metadaten. Drupal 8.7+ enthält JSON:API im Core – aktivieren Sie es unter Extend. Die Authentifizierung erfolgt über HTTP Basic (Benutzername + Passwort). Stellen Sie die Website über HTTPS bereit, damit Anmeldeinformationen nicht im Klartext gesendet werden.
So funktioniert es
Offizielle Referenzen: JSON:API-Modul, Berechtigungsmodell.
Voraussetzungen
- JSON:API ist aktiviert;
https://YOUR_HOST/jsonapigibt JSON zur Ressourcenerkennung zurück. - Ein Drupal-Benutzer, dessen Rolle die für Sie relevanten Bundles per GET abrufen darf.
Drupal mit Iru verbinden
- Drupal
- Iru Compliance
Schließen Sie diese Registerkarte ab, bevor Sie die Quelle in Compliance verbinden.
1
Als Administrator anmelden
Melden Sie sich bei Ihrer Drupal-Website mit einem Benutzer an, der Module installieren und die Konfiguration ändern kann (Administrator oder gleichwertig).
2
Extend (Module) öffnen
Gehen Sie zu Verwalten → Extend (oder Administration → Extend, je nach Admin-Theme).
3
JSON:API aktivieren
Suchen Sie das Modul JSON:API. Aktivieren Sie es und führen Sie einen ggf. von Drupal angeforderten Konfigurationsimport oder Cache-Neuaufbau durch.
4
Berechtigungen bestätigen
Stellen Sie sicher, dass der Integrationsbenutzer bzw. die Rolle, die Iru verwendet, die von Ihren Kontrollen benötigten JSON:API-Ressourcen per GET abrufen kann (Anonymous ist oft zu weit gefasst; bevorzugen Sie ein dediziertes Dienstkonto mit minimalem Lesezugriff).
5
JSON:API-Endpunkt überprüfen
Rufen Sie im Browser oder mit
curl das Discovery-Dokument Ihrer Website ab (zum Beispiel https://YOUR_HOST/jsonapi) und bestätigen Sie, dass Drupal JSON zurückgibt (nicht 403 oder 404).Fahren Sie auf der Registerkarte Iru Compliance fort.
Fehlerbehebung
Beim Aktivieren der Quelle öffnet sich nichts
Beim Aktivieren der Quelle öffnet sich nichts
Prüfen Sie die Einstellungen des Pop-up-Blockers für die Iru-Website und versuchen Sie es erneut.
404 bei /jsonapi
404 bei /jsonapi
Aktivieren Sie das JSON:API-Modul.
403 bei Ressourcen
403 bei Ressourcen
Erteilen Sie view-Berechtigungen für die relevanten Entitätstypen.
401
401
Korrigieren Sie das Passwort; Drupal unterscheidet zwischen Groß- und Kleinschreibung.
Hinweise
Bevorzugen Sie ein schreibgeschütztes Dienstkonto, beschränkt auf…
Bevorzugen Sie ein schreibgeschütztes Dienstkonto, das auf die erforderlichen Inhaltstypen beschränkt ist.
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.