Benutzerdefinierte Services

Ein benutzerdefinierter Service stellt Anmeldeinformationen zur Authentifizierung bei Marketo bereit. Anmeldeinformationen werden benötigt, um ein Zugriffstoken vom Marketo () ​. Jeder benutzerdefinierte Dienst wird auf einen einzelnen Benutzer (nur API) beschränkt, von dem er seine Berechtigungen ableitet.

Rollen

Der erste Schritt beim Erstellen eines benutzerdefinierten Service besteht darin, eine Rolle zu erstellen, die Sie auf den relevanten Benutzer „Nur API“ anwenden können. Dies erfolgt über das Menü Admin > Benutzer & Rollen > Rollen.

Rollen sind Container für einzelne Berechtigungen, die den Zugriff auf bestimmte Funktionen ermöglichen oder einschränken. In Abonnements mit aktivierten Arbeitsbereichen und Partitionen werden die Berechtigungen pro Arbeitsbereich erteilt. Wenn ein(e) Benutzende® in einem Arbeitsbereich über eine Berechtigung verfügt, in einem anderen jedoch nicht, kann er/sie nur zulässige Aktionen in diesem Arbeitsbereich ausführen. Um eine Rolle zu erstellen, klicken Sie auf die Schaltfläche Neue Rolle .

Geben Sie Ihrer Rolle unbedingt einen beschreibenden Namen. Benutzer, die nur über eine API verfügen, verfügen über einen bestimmten Berechtigungssatz, der von den normalen Benutzerberechtigungen getrennt ist. API-Berechtigungen sind in ihrer eigenen Hierarchie unter der Struktur „Zugriff auf API“ vorhanden.

Rollenberechtigungen

Nur Berechtigungen in der Gruppe „Zugriff auf API“ werden auf API-Benutzer angewendet, d. h., bei Vergabe aller Administratorberechtigungen werden einem Benutzer keine API-Berechtigungen gewährt.

Überlegen Sie beim Erstellen einer Rolle sorgfältig, welche Aktionen Sie der Anwendung, die sie verwendet, gestatten sollten. Gewähren Sie nur den minimalen Berechtigungssatz, der für die Durchführung dieser Aktionen erforderlich ist. Durch das Zulassen eines unnötig toleranten Berechtigungssatzes können Integrationen unerwünschte Aktionen in Ihrem Abonnement durchführen. Sie können das Berechtigungs-Tool verwenden, um Ihren minimalen Berechtigungssatz zu bestimmen. Siehe die vollständige Liste von Berechtigungen.

Benutzer

Nachdem Sie eine Rolle erstellt haben, müssen Sie einen „Nur-API“-Benutzer erstellen. Benutzende, die nur über eine API verfügen, sind in Marketo ein spezieller Benutzertyp, da sie von anderen Benutzenden verwaltet werden und nicht zur Anmeldung bei Marketo verwendet werden können. Benutzer, die nur über eine API verfügen, können:

Geben Sie Ihrem Benutzer einen beschreibenden Namen und eine E-Mail-Adresse (sie muss nicht gültig sein), basierend auf dem Service und der Anwendung, für die sie verwendet werden soll. Füllen Sie die erforderlichen Felder im Dialogfeldmenü aus, klicken Sie auf das Kontrollkästchen „Nur API“ und weisen Sie dem Benutzer eine Ihrer API-Rollen zu. Dadurch werden die für diese Rolle festgelegten Berechtigungen dem Benutzer zugewiesen.

Klicken Sie abschließend auf „Senden“, um den Benutzer „Nur API“ zu erstellen.

Erwägen Sie bei der Bereitstellung einer neuen Anwendung mit Anmeldeinformationen dringend, einen neuen Benutzer für den Service zu ernennen, selbst wenn er denselben Berechtigungssatz wie eine andere vorhandene Integration hat. Statistiken und Fehler zur Nutzung von API-Aufrufen werden benutzerspezifisch verfolgt, sodass die Bereitstellung eines Benutzers für jede Anwendung dabei hilft, Nutzungsszenarien und Probleme auf bestimmte Anwendungen zu isolieren. Dies ist praktisch, wenn Probleme beim Erzielen der täglichen API-Aufrufbeschränkungen auftreten oder Fehler aufgrund von API-Aufrufen auftreten, die von Integrationen vorgenommen werden.

Benutzerdefinierte Services

Benutzerdefinierte Services stellen die tatsächlichen Anmeldeinformationen, die Client-ID und das Client-Geheimnis, bereit, die erforderlich sind, um eine Authentifizierung mit einer Marketo-Instanz durchzuführen. Um einen Service bereitzustellen, gehen Sie zum Menü Admin > Integrationen > LaunchPoint und wählen Sie Neuer Service.

Geben Sie Ihrem Dienst einen beschreibenden Namen und wählen Sie in der Liste „Dienst“ die Option „Benutzerdefiniert“ aus. Geben Sie Ihrem Service eine ausführliche Beschreibung, wählen Sie einen geeigneten Benutzer aus der Liste Nur API-Benutzer aus und klicken Sie auf Erstellen.

Dadurch wird Ihrer Liste der LaunchPoint-Services ein neuer Service hinzugefügt und die Option „Details anzeigen“. Klicken Sie auf „Details anzeigen“ und Sie erhalten die Client-ID und das Client-Geheimnis, die für die Authentifizierung erforderlich sind, den Eigentümer der Benutzerin bzw. des Benutzers und eine Option zum Abrufen des Tokens für kurzfristige Testzwecke. Das Token, das Sie aus diesem Dialogfeld erhalten, hat dieselbe Lebensdauer wie Token, die normalerweise vom Identity Service abgerufen werden, und ist nach der Erstellung 3.600 Sekunden lang gültig.

Arbeitsbereiche und Partitionen

Bei Abonnements mit Arbeitsbereichen und Partitionen wird die Möglichkeit zum Zugriff auf einen bestimmten Datensatz oder ein bestimmtes Asset auf Grundlage der Berechtigungen gewährt, die die Rolle eines Benutzers in einem bestimmten Arbeitsbereich hat. Jeder Arbeitsbereich erhält im Menü Arbeitsbereiche und Partitionen Zugriff auf eine oder mehrere Partitionen und ein Lead gehört zu einer einzelnen Partition. Wenn der Benutzer „Nur API“ Zugriff auf das Lesen oder Schreiben von Lead-Datensätzen in einem Arbeitsbereich hat, kann er auf alle Datensätze in Partitionen zugreifen, auf die dieser Arbeitsbereich Zugriff hat.

Assets gehören zu Arbeitsbereichen. Daher hängt die Fähigkeit zum Lesen oder Schreiben eines Assets davon ab, ob der/die Benutzende im entsprechenden Arbeitsbereich über eine Rolle verfügt, die zum Lesen oder Schreiben dieses Asset-Datensatztyps im Arbeitsbereich berechtigt ist.

Berechtigungsliste

Im Folgenden finden Sie eine Liste aller Berechtigungen, die nur für Benutzer mit einer -API verfügbar sind, und der Berechtigungen, die sie einem Benutzer mit dieser Berechtigung erteilen.