Authentification du connecteur source Marketo Engage
Avant de pouvoir créer un connecteur source Marketo Engage (ci-après dénommé « Marketo »), vous devez d’abord configurer un service personnalisé via l’interface Marketo, ainsi que récupérer les valeurs de votre identifiant Munchkin, de votre identifiant client et de votre secret client.
La documentation ci-dessous décrit la procédure à 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 des actions que dans les espaces de travail pour lesquels ils disposent d’autorisations.
Une fois que vous avez sélectionné les autorisations que vous souhaitez accorder, cliquez sur Create.
Vous pouvez gérer des 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
Configurer un nouvel utilisateur
De la même manière que 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 de boîte de dialogue contextuelle s’affiche. Indiquez les informations appropriées pour votre e-mail, votre prénom, votre nom et votre raison. Au cours de cette étape, vous pouvez également établir 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 de Permissions, puis cochez la case API Only pour fournir un rôle d’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 des services existants. Pour créer un service personnalisé, sélectionnez New puis New Service.
Attribuez un nom d’affichage explicite à votre nouveau service, puis sélectionnez Custom dans le menu déroulant Service. Fournissez une description appropriée, puis sélectionnez l’utilisateur auquel vous souhaitez affecter des privilèges d’accès dans le menu déroulant API Only User. Une fois les détails nécessaires renseignés, sélectionnez Create pour créer votre nouveau service personnalisé.
Obtention de votre identifiant client et de votre secret client
Avec un nouveau service personnalisé créé, vous pouvez désormais récupérer des valeurs pour votre identifiant client et 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 identifiant client et votre secret client.
Obtention de votre Munchkin ID
La dernière étape à effectuer pour authentifier votre connecteur source Marketo consiste à 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 Munchkin ID unique répertorié en haut du panneau.
Associé à votre identifiant client et à votre secret client, vous pouvez utiliser votre Munchkin ID pour configurer un nouveau compte et créer une nouvelle connexion Marketo source sur Experience Platform.