> ## 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.
# Freshservice
> Verbinden Sie Freshservice über HTTP Basic Auth mit Ihrem API-Schlüssel als Benutzernamen mit Iru Compliance, um Änderungsgenehmigungen, Lösungszeiten von Incidents, Ticketdatensätze und das CMDB-Asset-Inventar zu erfassen.
### Über Freshservice
Iru liest **Tickets**, **Changes** (mit Genehmigungsstatus und Implementierungsdaten), **Incidents**, **Problems**, **Assets aus der CMDB** und **Agents mit ihren Rollen** aus der Freshservice API v2. Die Authentifizierung erfolgt mit Ihrem **API-Schlüssel**, den Sie unter **Profile Settings** finden. Anfragen richten sich an Ihre Kontodomain unter `https://YOUR_DOMAIN.freshservice.com/api/v2`. Der Connector-Assistent fragt zuerst die **Basic-Anmeldeinformationen** und dann die **Domain** ab.
### So funktioniert es
```http theme={null}
Authorization: Basic BASE64("YOUR_API_KEY:X")
```
Freshservice verwendet **HTTP Basic** über HTTPS: Der **Benutzername** ist Ihr **API-Schlüssel**, und das **Passwort** ist eine beliebige nicht leere Zeichenfolge, üblicherweise das Literal `X`. Iru übernimmt die Codierung. Basic Auth mit Benutzername und Passwort wurde **am 31. Mai 2023 eingestellt** und schlägt nun fehl, daher ist der API-Schlüssel die einzige unterstützte Methode.
Ein API-Schlüssel verfügt über **genau die Berechtigungen des Agents, der ihn generiert hat**, und es gibt keine Scopes pro Endpunkt. Ein Schlüssel eines Agents mit eingeschränkten Berechtigungen liefert nur eine Teilansicht von Tickets und Changes. Verwenden Sie ein dediziertes Dienstkonto mit Administratorrechten, damit die Nachweise vollständig bleiben.
| Detail | Wert |
| - | - |
| **Kategorie** | Support |
| **Authentifizierung** | Basic (API-Schlüssel + `X`) |
Offizielle Referenzen: [API-v2-Referenz](https://api.freshservice.com/v2/), [Wo Sie Ihren API-Schlüssel finden](https://support.freshservice.com/support/solutions/articles/50000000306-where-do-i-find-my-api-key-).
### Voraussetzungen
* Ihre **Domain** (`acme` aus `https://acme.freshservice.com`).
* Ein **Agent-Konto mit Administratorrechten**, mit dem der Schlüssel generiert wird. Ein persönliches Agent-Konto bindet die Nachweiserfassung an die Berechtigungen einer einzelnen Person und funktioniert nicht mehr, wenn diese Person das Unternehmen verlässt.
* Legen Sie fest, was im Umfang enthalten ist. In Freshservice können Sie Tickettypen ausschließen, das Asset-Inventar überspringen oder nach Abteilung filtern. Wenn zugrunde liegende Daten ausgeschlossen sind, markiert Iru die betroffenen Kontrollen als nicht überprüfbar.
### Freshservice mit Iru verbinden
Schließen Sie diese Registerkarte ab, bevor Sie die Quelle in Compliance verbinden.
Melden Sie sich bei `https://YOUR_DOMAIN.freshservice.com` als der **Agent mit Administratorrechten** an, dessen Berechtigungen die Integration übernehmen soll.
Wählen Sie Ihren **Profil-Avatar** oben rechts und dann **Profile Settings**.
Suchen Sie auf dieser Seite **Your API Key** und kopieren Sie den Schlüssel. Freshservice zeigt den Schlüssel auf der Profilseite an, anstatt jedes Mal einen neuen zu generieren, sodass Sie ihn später erneut abrufen können.
Das **Passwort** für Basic Auth ist das Literal `X`. Geben Sie es in Iru ein, nicht in Freshservice.
Fahren Sie auf der Registerkarte [**Iru Compliance**](#iru-compliance) fort.
Schließen Sie zuerst die Registerkarte [**Freshservice**](#freshservice) ab.
Erweitern Sie in Iru Compliance in der linken Navigationsleiste **Compliance** und wählen Sie **Quellen**.
Suchen Sie **Freshservice** (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.
Der erste Schritt des Assistenten ist **Enter Basic Authentication**. Geben Sie unter **Benutzername** Ihren **API-Schlüssel** und unter **Kennwort** `X` (wörtlich) ein. Freshservice validiert das Passwortfeld nicht. Jeder nicht leere Platzhalterwert funktioniert.
Wählen Sie **Anmeldedaten senden**.
Geben Sie nur die **Domain** ein (zum Beispiel `acme`, nicht die vollständige URL). Bestätigen Sie die Vorschau-URL, falls der Assistent eine anzeigt. Wenn die Verbindung erfolgreich ist, zeigt der Assistent **Verbindung konfiguriert** an.
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 **Freshservice** den Status **Aktiv** hat.
### Fehlerbehebung
Prüfen Sie die Einstellungen des **Pop-up-Blockers** für die Iru-Website und versuchen Sie es erneut.
Es wurden eine E-Mail-Adresse und ein Passwort anstelle des API-Schlüssels verwendet. Diese Methode wurde am 31. Mai 2023 entfernt. Verwenden Sie den Schlüssel als **Benutzernamen**.
Fügen Sie den vollständigen API-Schlüssel ein und bestätigen Sie, dass das Feld **Passwort** einen nicht leeren Wert wie `X` enthält. Ein leeres Passwort schlägt fehl.
Dem Agent, der den Schlüssel generiert hat, fehlt die Berechtigung für Changes, Assets oder Problems. Generieren Sie den Schlüssel mit einem Agent mit Administratorrechten neu.
Entweder liegt die CMDB außerhalb des Umfangs dieser Verbindung oder der Agent kann keine Assets lesen. Iru kann diese Fälle nicht unterscheiden.
Korrigieren Sie die **Domain** und stellen Sie die Verbindung erneut her. Die Domain ist nur die Subdomain, nicht die vollständige URL.
### Verwandte Artikel
Alle Compliance-Quellen durchsuchen und verwalten.
Frameworks, Aktionen und **Artefakte**.
Wie Endpoint, Compliance und Identity zusammenwirken.
Nachweise aus Quellen und Aktionen hochladen, prüfen und organisieren.