Skip to main content

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

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. Offizielle Referenzen: API-v2-Referenz, Wo Sie Ihren API-Schlüssel finden.

​
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.
1

Bei Freshservice anmelden

Melden Sie sich bei https://YOUR_DOMAIN.freshservice.com als der Agent mit Administratorrechten an, dessen Berechtigungen die Integration übernehmen soll.
2

Profile Settings öffnen

Wählen Sie Ihren Profil-Avatar oben rechts und dann Profile Settings.
3

API-Schlüssel kopieren

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

Passwortkonvention beachten

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

​
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

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.