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

# Smartsheet

> Verbinden Sie Smartsheet mit einem schreibgeschützten API-Zugriffstoken mit Iru Compliance, um Benutzer- und Lizenzinventar, Freigabeberechtigungen von Sheets und Workspace-Mitgliedschaften zu erfassen.

### Über Smartsheet

Iru liest über die Smartsheet-API **Benutzer mit ihren Lizenztypen**, **Sheets mit ihren Freigabeberechtigungen**, **Workspaces mit Mitgliederzugriff** und **Gruppen**. Die Authentifizierung erfolgt über ein **API-Zugriffstoken**, das unter **Konto** → **Personal Settings** → **API Access** generiert wird. Anfragen gehen an `https://api.smartsheet.com/2.0`; es muss keine Subdomain konfiguriert werden.

Iru liest die **Freigabe- und Zugriffskonfiguration**, nicht den Inhalt der Sheets. Erfasst wird, für wen jedes Sheet freigegeben ist, nicht die Zelldaten darin.

### Funktionsweise

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

Smartsheet authentifiziert mit einem **Bearer**-Token. Token werden pro Benutzer generiert und tragen den **effektiven Zugriff** dieses Benutzers, ohne separate Scopes pro Endpunkt. Sheets und Workspaces werden einzeln freigegeben, sodass ein Token eines Benutzers, der kein Mitglied eines Workspaces ist, für diesen nichts zurückgibt. Iru kann das nicht von einem Workspace unterscheiden, für den keine Freigaben vorliegen.

Generieren Sie das Token über ein **System Admin**-Konto, um das vollständigste Benutzer- und Lizenzinventar zu erhalten.

| Detail | Wert |
| - | - |
| **Kategorie** | Projektmanagement |
| **Authentifizierung** | Bearer (API-Zugriffstoken) |

Offizielle Referenzen: [API-Übersicht](https://smartsheet.redoc.ly/), [Authentifizierung und Zugriffstoken](https://smartsheet.redoc.ly/#section/Security/Authentication-and-Access-Tokens).

### Voraussetzungen

* Ein Konto, das ein API-Zugriffstoken generieren kann. Verwenden Sie vorzugsweise **System Admin**, damit das Benutzer- und Lizenzinventar vollständig ist.
* Zugriff auf jeden Workspace, aus dem Sie Nachweise erwarten. Der Zugriff in Smartsheet gilt pro Objekt.
* Legen Sie fest, welche Workspaces im Umfang liegen. Ausgeschlossene Workspaces liefern keine Nachweise.

### Smartsheet mit Iru verbinden

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

    <Steps>
      <Step title="Bei Smartsheet anmelden">
        Melden Sie sich bei Smartsheet mit dem Konto an, dessen Zugriff die Integration übernehmen soll, idealerweise ein **System Admin**.
      </Step>

      <Step title="Personal Settings öffnen">
        Wählen Sie **Konto** (Ihr Avatar unten links) und dann **Personal Settings**.
      </Step>

      <Step title="API Access öffnen">
        Wählen Sie **API Access**.
      </Step>

      <Step title="Neues Zugriffstoken generieren">
        Wählen Sie **Generate new access token**.
      </Step>

      <Step title="Token benennen und kopieren">
        Geben Sie einen Namen wie **Iru Compliance** ein, damit Sie dieses Token später identifizieren können. Kopieren Sie den Tokenwert **einmalig**, während Smartsheet ihn anzeigt. Er kann danach nicht mehr abgerufen werden. Wenn Sie ihn verlieren, generieren Sie einen Ersatz.
      </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 [**Smartsheet**](#smartsheet) 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="Smartsheet aktivieren">
        Suchen Sie **Smartsheet** (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="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**. 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 **Smartsheet** 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="Authentifizierung schlägt fehl">
    Generieren Sie das Token neu und fügen Sie die vollständige Zeichenfolge ein. Smartsheet erlaubt es nicht, ein vorhandenes Token anzuzeigen, daher lässt sich eine unvollständige Kopie nachträglich nicht überprüfen.
  </Accordion>

  <Accordion title="Ein Workspace oder Sheet fehlt">
    Der Inhaber des Tokens hat keine Freigabe dafür. Generieren Sie das Token über ein **System Admin**-Konto neu oder geben Sie die relevanten Workspaces für das verwendete Konto frei.
  </Accordion>

  <Accordion title="Die Benutzerliste wirkt unvollständig">
    Ein Token ohne Administratorrechte gibt nur die Benutzer zurück, die es sehen kann. Verwenden Sie ein System Admin-Token für ein vollständiges Benutzer- und Lizenzinventar.
  </Accordion>

  <Accordion title="Sheet-Inhalte werden nicht angezeigt">
    Das ist zu erwarten. Iru erfasst die Freigabe- und Zugriffskonfiguration, keine Zelldaten.
  </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>