Authentification de votre connecteur source Marketo Engage
Avant de pouvoir créer un connecteur source Marketo Engage (ci-après appelé "Marketo"), vous devez d’abord configurer un service personnalisé via l’interface Marketo, ainsi que récupérer les valeurs de votre ID Munchkin, de votre ID client et de votre secret client.
La documentation ci-dessous décrit les étapes à suivre pour acquérir des informations d’authentification afin de créer un connecteur source Marketo.
Configurer un nouveau rôle
La première étape de l’acquisition de vos informations d’authentification consiste à configurer un nouveau rôle via l’interface Marketo.
Connectez-vous à Marketo et sélectionnez Admin dans la barre de navigation supérieure.
La page Users & Roles contient des informations sur les utilisateurs, les rôles et les historiques de connexion. Pour créer un nouveau rôle, sélectionnez Roles dans l’en-tête supérieur, puis sélectionnez New Role.
La boîte de dialogue Create New Role s’affiche. Attribuez un nom et une description, puis sélectionnez les autorisations que vous souhaitez accorder pour ce rôle. Les autorisations sont limitées à des espaces de travail spécifiques et les utilisateurs ne peuvent effectuer que des actions dans les espaces de travail dans lesquels ils disposent d’autorisations.
Une fois que vous avez sélectionné les autorisations que vous souhaitez accorder, sélectionnez Create.
Vous pouvez gérer les autorisations restreintes sur l’API lors de la création de rôles avec Marketo. Au lieu de sélectionner "API d’accès", vous pouvez fournir un rôle avec le niveau d’accès minimal en sélectionnant les autorisations suivantes :
- Read-Only Activity
- Read-Only Assets
- Read-Only Campaign
- Read-Only Company
- Read-Only Custom Object
- Read-Only Custom Object Type
- Read-Only Named Account
- Read-Only Named Account List
- Read-Only Opportunity
- Read-Only Person
- Read-Only Sales Person
Configuration d’un nouvel utilisateur
Comme pour les rôles, vous pouvez configurer un nouvel utilisateur à partir de la page Users & Roles. La page Users fournit une liste des utilisateurs actifs actuellement configurés dans Marketo. Sélectionnez Invite New User pour configurer un nouvel utilisateur.
Un menu contextuel s’affiche. Indiquez les informations appropriées pour votre email, votre prénom, votre nom et votre raison. Au cours de cette étape, vous pouvez également définir une date d’expiration pour l’accès au nouveau compte utilisateur que vous invitez. Lorsque vous avez terminé, sélectionnez Next.
Sélectionnez les champs appropriés à l’étape Permissions, puis cochez la case API Only pour fournir un rôle API au nouvel utilisateur. Sélectionnez Next pour continuer.
Pour terminer le processus, sélectionnez Send.
Configuration d’un service personnalisé
Une fois que vous avez établi un nouvel utilisateur, vous pouvez configurer un service personnalisé pour récupérer vos nouvelles informations d’identification. Sur la page d'administration, sélectionnez LaunchPoint.
La page Installed services contient une liste de services existants. Pour créer un service personnalisé, sélectionnez New, puis New Service.
Fournissez un nom d’affichage descriptif à votre nouveau service, puis sélectionnez Custom dans le menu déroulant Service. Fournissez une description appropriée, puis sélectionnez l’utilisateur que vous souhaitez configurer dans le menu déroulant API Only User. Une fois que vous avez renseigné les détails nécessaires, sélectionnez Create pour créer votre service personnalisé.
Obtention de l’ID client et du secret client
Une fois un nouveau service personnalisé créé, vous pouvez désormais récupérer les valeurs de votre ID client et de votre secret client. Dans le menu Installed Services, recherchez le service personnalisé auquel vous souhaitez accéder, puis sélectionnez View Details.
Une boîte de dialogue s’affiche, contenant votre ID client et votre secret client.
Obtention de votre Munchkin ID
La dernière étape que vous devez effectuer pour authentifier votre connecteur source Marketo est de récupérer votre Munchkin ID. Sur la page d’administration, sélectionnez Munchkin sous le panneau Integration.
La page Munchkin s’affiche, avec votre identifiant Munchkin unique répertorié en haut du panneau.
Combiné avec votre ID client et votre secret client, vous pouvez utiliser votre Munchkin ID pour configurer un nouveau compte et créer une Marketo connexion source sur Experience Platform.