Connecteur OAuth
En bref
Configurez un connecteur en 4 etapes avec OAuth. Quand le connecteur est demarrable, Ontologie ouvre une popup d'autorisation pour obtenir les permissions necessaires aupres du fournisseur.
Avant de commencer
- Acces a un workspace Ontologie
- Compte actif sur le service externe (Google, HubSpot, Shopify, etc.)
- Navigateur autorisant les popups pour la plateforme
Etapes
Step 1 — Choisir le connecteur et lancer l'autorisation
Depuis Live Data > Connecteurs, cliquez sur le connecteur OAuth souhaite.
Si le wizard affiche Se connecter, cliquez sur le bouton. Une popup s'ouvre pour vous connecter au service externe et accorder les permissions demandees.
Si le wizard affiche des champs OAuth manuels comme refresh_token, le connecteur n'a pas encore de flux popup gere par Ontologie. Dans ce cas, renseignez les champs demandes depuis votre console fournisseur ou demandez a votre administrateur d'activer une strategie provider.
Certains fournisseurs demandent des scopes specifiques (ex : Google → drive.readonly, HubSpot → contacts, deals). Ontologie configure les scopes requis automatiquement.
Step 2 — Tester la connexion
Apres autorisation, Ontologie teste automatiquement la connexion.
En cas d'echec, verifiez que vous avez accorde toutes les permissions demandees.
Erreurs courantes
| Erreur | Cause probable | Solution |
|---|---|---|
| Popup bloquee | Navigateur bloque les popups | Autorisez les popups pour la plateforme dans les parametres de votre navigateur. |
| Permissions refusees | Scopes non accordes | Relancez l'autorisation et acceptez toutes les permissions demandees. |
| Token expire | Session OAuth expiree | Relancez l'autorisation pour obtenir un nouveau token. |
Step 3 — Selectionner les flux de donnees (streams)
Apres un test reussi, Ontologie decouvre les flux disponibles de votre source. Cochez les flux que vous souhaitez synchroniser.
Commencez par un ou deux flux puis ajoutez-en si necessaire. Chaque flux genere un onglet dans le tableur source-linked.
Step 4 — Lier a une entite
Selectionnez l'entite cible dans votre ontologie pour recevoir les donnees synchronisees.
Vous pouvez aussi lier la source plus tard depuis l'onglet Sources de l'entite dans l'ontologie.
Credentials preconfigurees vs BYO
Certains connecteurs utilisent les credentials OAuth preconfigurees par Ontologie : vous cliquez sur Autoriser et le flux OAuth demarre sans configuration supplementaire. C'est le cas de la majorite des connecteurs populaires (Google Sheets, HubSpot, Shopify, etc.).
D'autres connecteurs necessitent des credentials BYO (Bring Your Own). Dans ce cas, vous devez fournir votre propre client_id et client_secret obtenus depuis la console developpeur du fournisseur. Ontologie vous guide dans la saisie de ces credentials avant de lancer l'autorisation.
Le wizard indique clairement si le connecteur est preconfigure ou s'il necessite vos propres credentials. Suivez les instructions affichees a l'ecran.
Redirect URI et refresh token
Quand une popup OAuth est disponible, la Redirect URI exacte est affichee dans le wizard et peut etre copiee. Configurez cette URL dans l'application OAuth du fournisseur avant de lancer l'autorisation.
Le champ refresh_token ne doit pas etre saisi manuellement quand le wizard propose une popup OAuth : il est recupere automatiquement apres autorisation. Il reste visible uniquement pour les connecteurs OAuth manuels, lorsqu'aucune strategie popup n'est disponible.
Microsoft Outlook
Pour Outlook, Ontologie utilise une strategie Microsoft Graph. Le wizard affiche le bouton de connexion, les scopes demandes, et la Redirect URI a configurer dans l'application Microsoft. Le refresh_token est genere par le flux OAuth et transmis automatiquement au connecteur sans etre demande comme champ utilisateur.
Resultat attendu
La synchronisation demarre et les donnees apparaissent dans le tableur source-linked de l'entite cible.
Voir aussi
- Connecteurs — Explorer le catalogue et ajouter un connecteur.
- Data Sources — Gerer toutes vos sources configurees.
- Liaison entites — Connecter vos sources a l'ontologie.
- Diagnostic — Identifier et corriger les erreurs de connexion.
Besoin d'aide ?
Ecrivez-nous : Support et contact.