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

# Drupal

> Verbinden Sie Drupal über JSON:API mit HTTP Basic Auth und einem schreibgeschützten Dienstkonto mit Iru Compliance, um Nachweise zur Website-, Benutzer- und Rollenkonfiguration zu erfassen.

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

```http theme={null}
Authorization: Basic base64(username:password)
```

| Detail | Wert |
| - | - |
| **Kategorie** | Entwicklertools |
| **Authentifizierung** | Basic (Drupal-Benutzer) |

Offizielle Referenzen: [JSON:API-Modul](https://www.drupal.org/docs/core-modules-and-themes/core-modules/jsonapi-module), [Berechtigungsmodell](https://www.drupal.org/docs/administering-a-drupal-site/managing-users).

### Voraussetzungen

* **JSON:API** ist aktiviert; **`https://YOUR_HOST/jsonapi`** gibt JSON zur Ressourcenerkennung zurück.
* Ein Drupal-Benutzer, dessen Rolle die für Sie relevanten Bundles per **GET** abrufen darf.

### Drupal mit Iru verbinden

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

    <Steps>
      <Step title="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).
      </Step>

      <Step title="Extend (Module) öffnen">
        Gehen Sie zu **Verwalten** → **Extend** (oder **Administration** → **Extend**, je nach Admin-Theme).
      </Step>

      <Step title="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.
      </Step>

      <Step title="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).
      </Step>

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

      <Step title="Hostnamen eingeben">
        Geben Sie nur den **Hostnamen** ein (zum Beispiel **`cms.example.com`**). Bestätigen Sie die Variablen, falls der Assistent eine Vorschau anzeigt.
      </Step>

      <Step title="Drupal-Anmeldeinformationen eingeben">
        Geben Sie **Benutzername** und **Passwort** für das Integrationskonto ein.
      </Step>

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

      <Step title="Bestätigen, dass 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 bestätigen Sie, dass die Karte **Drupal** den Status **Aktiv** hat.
      </Step>
    </Steps>
  </Tab>
</Tabs>

### Fehlerbehebung

<AccordionGroup>
  <Accordion title="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.
  </Accordion>

  <Accordion title="404 bei /jsonapi">
    Aktivieren Sie das JSON:API-Modul.
  </Accordion>

  <Accordion title="403 bei Ressourcen">
    Erteilen Sie **view**-Berechtigungen für die relevanten Entitätstypen.
  </Accordion>

  <Accordion title="401">
    Korrigieren Sie das Passwort; Drupal unterscheidet zwischen Groß- und Kleinschreibung.
  </Accordion>
</AccordionGroup>

### Hinweise

<CardGroup cols={2}>
  <Card title="Bevorzugen Sie ein schreibgeschütztes Dienstkonto, beschränkt auf…" icon="circle-info">
    Bevorzugen Sie ein **schreibgeschütztes** Dienstkonto, das auf die erforderlichen Inhaltstypen beschränkt ist.
  </Card>
</CardGroup>

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