Connecter votre fournisseur d'identité

Référence technique pour enregistrer Microsoft Entra ID, Salesforce Marketing Cloud ou un autre fournisseur OAuth 2.0 pour la connexion à Studio.

4 min de lecture

Cette page s'adresse à votre équipe informatique ou à votre administrateur d'identité : ce qu'il faut enregistrer dans votre fournisseur, et les informations à transmettre en retour. La vue administrateur se trouve dans Connexion d'entreprise (SSO).

Votre Customer Success Manager active le SSO

Vous ne configurez pas le SSO vous-même. Votre Customer Success Manager vous communique l'URL de callback exacte à enregistrer dans votre fournisseur. Une fois que vous lui avez transmis les informations ci-dessous, il active le fournisseur pour votre environnement.

Comment fonctionne la connexion

La connexion utilise le flux Authorization Code d'OAuth 2.0. Microsoft Entra ID y ajoute OpenID Connect. Salesforce Marketing Cloud et les autres fournisseurs utilisent OAuth 2.0 seul, avec un endpoint user info.

  1. L'utilisateur sélectionne le bouton du fournisseur sur la page de connexion.
  2. OmniLab le redirige vers l'endpoint d'autorisation du fournisseur.
  3. Le fournisseur authentifie l'utilisateur et le redirige vers l'URL de callback d'OmniLab.
  4. OmniLab échange le code d'autorisation contre des tokens auprès de l'endpoint de token.
  5. OmniLab lit l'identité de l'utilisateur auprès de l'endpoint user info.
  6. Si un compte Studio correspond à cet email et est rattaché à une organisation, la connexion aboutit.

Microsoft Entra ID

Enregistrer l'application

  1. Dans le portail Azure, enregistrez une nouvelle application sous App registrations.
  2. Sous Supported account types, choisissez Accounts in this organizational directory only.
  3. Sous Authentication, ajoutez une Redirect URI (plateforme : Web) avec l'URL de callback qui vous a été communiquée.
  4. Sous Certificates & secrets, créez un Client secret.
  5. Copiez la valeur du secret. Elle ne s'affiche qu'une fois.
  6. Notez la date d'expiration du secret.
  7. Dans l'onglet Overview, notez l'Application (client) ID et le Directory (tenant) ID.

Un secret client est valable 24 mois au maximum. Envoyez-en un nouveau à votre Customer Success Manager avant son expiration : une fois qu'il a expiré, plus personne ne peut se connecter avec Entra ID.

Informations à transmettre à OmniLab

ChampOù le trouverRemarques
Application (client) IDPortail Azure > App registrations > OverviewIdentifie votre application Entra
Directory (tenant) IDPortail Azure > App registrations > OverviewLimite la connexion à votre tenant Microsoft
Valeur du secret clientPortail Azure > Certificates & secrets (affichée une seule fois)Permet à OmniLab de terminer l'échange de code
Nom d'affichage du boutonÀ votre choixCe que voient les utilisateurs sur la page de connexion
URL de callback enregistréeConfirmation uniquementL'URL d'OmniLab doit figurer dans la liste des Redirect URIs

Scopes : openid, email, profile (OIDC standard). La connexion ne demande aucune autre permission.

OmniLab retrouve le compte Studio grâce à l'email que renvoie Entra ID : l'adresse email de l'utilisateur, qui n'est pas toujours son identifiant de connexion. Un utilisateur sans adresse email est refusé avec le message Email requis. Connectez-vous avec un utilisateur de test pour vérifier que l'adresse est bien transmise.

Salesforce Marketing Cloud

Créer le package

  1. Dans Marketing Cloud, ouvrez Setup > Apps > Installed Packages.
  2. Sélectionnez New.
  3. Nommez le package.
  4. Sélectionnez Add Component.
  5. Choisissez API Integration.
  6. Choisissez Web App.
  7. Ajoutez l'URL de callback qui vous a été communiquée comme Redirect URI.
  8. Enregistrez le composant.
  9. Notez le Client ID et le Client Secret.
  10. Notez l'Authentication Base URI du package, par exemple https://<subdomain>.auth.marketingcloudapis.com/.

Informations à transmettre à OmniLab

Les trois URL se composent de votre URI de base d'authentification suivie d'un chemin.

ChampRemarques
Client IDIdentifie votre package
Client secretPermet à OmniLab de terminer l'échange de code ; envoyé dans le corps de la requête
URL d'autorisationhttps://<subdomain>.auth.marketingcloudapis.com/v2/authorize
URL de tokenhttps://<subdomain>.auth.marketingcloudapis.com/v2/token
URL user infohttps://<subdomain>.auth.marketingcloudapis.com/v2/userinfo. Doit renvoyer l'email de l'utilisateur : c'est ainsi qu'OmniLab retrouve son compte Studio
URL de callback enregistréeConfirmation uniquement

Marketing Cloud ne demande aucun scope OAuth : l'accès dépend des permissions propres au package.

Un autre fournisseur OAuth 2.0

Consultez votre Customer Success Manager avant de planifier cette option : un seul fournisseur personnalisé peut être ajouté par environnement. Rassemblez :

ChampRemarques
Nom d'affichage du boutonCe que voient les utilisateurs sur la page de connexion
Client IDIdentifie l'application dans votre fournisseur
Client secretEnvoyé dans le corps de la requête de token (client_secret_post)
URL d'autorisationL'endpoint d'autorisation de votre fournisseur
URL de tokenL'endpoint de token de votre fournisseur
URL user infoDoit renvoyer l'email de l'utilisateur
Chaîne de scopesLes scopes dont votre fournisseur a besoin pour renvoyer l'email
URL de callback enregistréeL'URL de callback d'OmniLab doit figurer dans la liste des redirections autorisées du fournisseur

Avant le lancement

  • L'application est enregistrée chez le fournisseur, avec l'URL de callback d'OmniLab dans sa liste de redirections autorisées.
  • Les secrets ont été transmis de façon sécurisée à votre Customer Success Manager, jamais dans un email en clair.
  • Au moins un utilisateur de test existe dans OmniLab et est rattaché à une organisation.
  • L'email de l'utilisateur de test dans OmniLab correspond exactement à celui que renvoie le fournisseur.
  • Vous avez confirmé pour quel environnement le fournisseur est activé : Staging ou Production.

Étapes suivantes

Sur cette page