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.
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.
- L'utilisateur sélectionne le bouton du fournisseur sur la page de connexion.
- OmniLab le redirige vers l'endpoint d'autorisation du fournisseur.
- Le fournisseur authentifie l'utilisateur et le redirige vers l'URL de callback d'OmniLab.
- OmniLab échange le code d'autorisation contre des tokens auprès de l'endpoint de token.
- OmniLab lit l'identité de l'utilisateur auprès de l'endpoint user info.
- Si un compte Studio correspond à cet email et est rattaché à une organisation, la connexion aboutit.
Microsoft Entra ID
Enregistrer l'application
- Dans le portail Azure, enregistrez une nouvelle application sous App registrations.
- Sous Supported account types, choisissez Accounts in this organizational directory only.
- Sous Authentication, ajoutez une Redirect URI (plateforme : Web) avec l'URL de callback qui vous a été communiquée.
- Sous Certificates & secrets, créez un Client secret.
- Copiez la valeur du secret. Elle ne s'affiche qu'une fois.
- Notez la date d'expiration du secret.
- 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
| Champ | Où le trouver | Remarques |
|---|---|---|
| Application (client) ID | Portail Azure > App registrations > Overview | Identifie votre application Entra |
| Directory (tenant) ID | Portail Azure > App registrations > Overview | Limite la connexion à votre tenant Microsoft |
| Valeur du secret client | Portail Azure > Certificates & secrets (affichée une seule fois) | Permet à OmniLab de terminer l'échange de code |
| Nom d'affichage du bouton | À votre choix | Ce que voient les utilisateurs sur la page de connexion |
| URL de callback enregistrée | Confirmation uniquement | L'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
- Dans Marketing Cloud, ouvrez Setup > Apps > Installed Packages.
- Sélectionnez New.
- Nommez le package.
- Sélectionnez Add Component.
- Choisissez API Integration.
- Choisissez Web App.
- Ajoutez l'URL de callback qui vous a été communiquée comme Redirect URI.
- Enregistrez le composant.
- Notez le Client ID et le Client Secret.
- 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.
| Champ | Remarques |
|---|---|
| Client ID | Identifie votre package |
| Client secret | Permet à OmniLab de terminer l'échange de code ; envoyé dans le corps de la requête |
| URL d'autorisation | https://<subdomain>.auth.marketingcloudapis.com/v2/authorize |
| URL de token | https://<subdomain>.auth.marketingcloudapis.com/v2/token |
| URL user info | https://<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ée | Confirmation 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 :
| Champ | Remarques |
|---|---|
| Nom d'affichage du bouton | Ce que voient les utilisateurs sur la page de connexion |
| Client ID | Identifie l'application dans votre fournisseur |
| Client secret | Envoyé dans le corps de la requête de token (client_secret_post) |
| URL d'autorisation | L'endpoint d'autorisation de votre fournisseur |
| URL de token | L'endpoint de token de votre fournisseur |
| URL user info | Doit renvoyer l'email de l'utilisateur |
| Chaîne de scopes | Les scopes dont votre fournisseur a besoin pour renvoyer l'email |
| URL de callback enregistrée | L'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
- Checklist de lancement SSO
- À propos du SSO pour votre équipe
- Authentification : l'accès API de serveur à serveur, une configuration distincte
Ce que fournit votre équipe identité
Rassemblez les informations dont OmniLab a besoin pour faire confiance à votre système d'identité, avant que quiconque ne commence la configuration.
Checklist de lancement SSO
Vérifiez que la connexion d'entreprise et le retrait d'accès fonctionnent avant de faire basculer votre équipe.