Skip to main content

​
Über Freshsales

Iru liest Benutzer mit ihren Rollen, Rollen mit Berechtigungen, Gebiete und Berechtigungen auf Feldebene für sensible Daten aus der Freshsales-API (Freshworks CRM). Die Authentifizierung erfolgt mit einem API-Schlüssel zusammen mit Ihrem Bundle-Alias; beide finden Sie unter Profile Settings → API Settings. Anfragen richten sich an https://YOUR_BUNDLE_ALIAS.myfreshworks.com/crm/sales/api. Der Connector-Assistent fragt zuerst den API-Schlüssel und dann den Bundle-Alias ab. Freshsales und Freshservice sind unterschiedliche Produkte mit unterschiedlichen Authentifizierungsverfahren. Wenn Sie Daten aus dem IT-Service-Management verbinden, verwenden Sie stattdessen den Artikel Freshservice.

​
So funktioniert es

Freshsales verwendet weder Basic Auth noch ein Bearer-Präfix. Der Schlüssel wird im Authorization-Header in der wörtlichen Form Token token=YOUR_API_KEY übergeben. Die API ist nicht versioniert. Es gibt keinen Versions-Header und keine datierte Revision. Der Bundle-Alias legt fest, welches CRM-Konto gelesen wird, wenn Ihre Freshworks-Organisation mehr als eines besitzt. Deshalb ist das Feld erforderlich. Ein API-Schlüssel gilt pro Benutzer und übernimmt genau die Rolle dieses Benutzers, ohne Scopes pro Endpunkt. Offizielle Referenzen: Freshworks CRM API.

​
Voraussetzungen

  • Ihr Bundle-Alias und Ihr API-Schlüssel, beide auf derselben Seite API Settings.
  • Ein dedizierter CRM-Benutzer mit Administratorrechten, mit dem der Schlüssel generiert wird. Der Schlüssel übernimmt die Rolle dieses Benutzers und hat keine Scopes; ein Schlüssel eines Vertriebsbenutzers mit Gebietseinschränkungen liefert daher ein unvollständiges Bild der Berechtigungen.

​
Freshsales mit Iru verbinden

Schließen Sie diese Registerkarte ab, bevor Sie die Quelle in Compliance verbinden.
1

Bei Freshsales anmelden

Melden Sie sich bei Ihrem Freshsales-Konto als der Benutzer mit Administratorrechten an, dessen Zugriff die Integration übernehmen soll.
2

Profile Settings öffnen

Wählen Sie Ihr Profilbild in der oberen rechten Ecke und dann Profile Settings.
3

API Settings öffnen

Wählen Sie die Registerkarte API Settings.
4

API-Schlüssel und Bundle-Alias kopieren

Kopieren Sie den unter Your API key angezeigten Wert. Kopieren Sie den Bundle alias, der auf derselben Registerkarte direkt unter dem API-Schlüssel angezeigt wird. Auch wenn Ihre Organisation nur ein CRM-Konto hat, ist dieser Wert erforderlich.
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.
Bestätigen Sie, dass der API-Schlüssel vollständig ist und dass der Bundle-Alias zu dem CRM-Konto passt, zu dem der Schlüssel gehört. Ein gültiger Schlüssel für den falschen Bundle-Host schlägt genauso fehl wie ein ungültiger Schlüssel.
Die beiden Produkte stellen unterschiedliche Anmeldeinformationen aus und authentifizieren sich unterschiedlich. Ein Freshservice-Schlüssel funktioniert hier nicht.
Der Schlüssel gehört zu einem Benutzer, dessen eigene Rolle diese nicht sehen kann. Generieren Sie den Schlüssel mit einem Benutzer mit Administratorrechten neu.
Der Bundle-Alias ist nur die Subdomain. Geben Sie weder https:// noch .myfreshworks.com an.

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