Parcourir la documentation

Vue d’ensemble de l’intégration SaaS

Utilisez Connector for SaaS lorsque chaque utilisateur de votre produit doit autoriser son propre compte Gmail, Slack, Notion ou celui d’un autre fournisseur. Votre produit gère l’expérience utilisateur et la mise en correspondance des utilisateurs ; OOMOL Connector stocke le compte connecté et exécute les opérations demandées par votre backend.

Ce parcours utilise une clé API de projet au format oo_proj_…. La clé représente un projet Connector et reste sur votre backend.

Modèle de ressources

RessourceRôle
ProjetIsole les configurations de fournisseurs, les clés, les comptes connectés, les journaux et l’utilisation
Configuration du fournisseurDéfinit comment un fournisseur est autorisé dans le projet
ID d’utilisateur externeAssocie les comptes connectés à un utilisateur de votre produit
ID ou alias du compte connectéSélectionne le compte utilisé pour une opération
Clé API du projetAuthentifie les requêtes de votre backend

Flux d’intégration

  1. Créez un projet et une configuration de fournisseur dans OOMOL Console.
  2. Créez une clé API de projet et stockez-la dans le gestionnaire de secrets de votre backend.
  3. Demandez à votre backend de créer un lien d’autorisation pour un utilisateur externe.
  4. Faites passer l’utilisateur par le flux d’autorisation du fournisseur.
  5. Enregistrez l’ID ou l’alias du compte connecté avec l’utilisateur de votre produit.
  6. Exécutez les opérations depuis le backend pour cet utilisateur et ce compte.

Responsabilités

Votre produit authentifie ses utilisateurs, détermine les fournisseurs qu’ils peuvent connecter, stocke l’association entre l’utilisateur et le compte, et contrôle les opérations demandées par son backend. Ne placez pas la clé API du projet dans les navigateurs ou les clients mobiles.

OOMOL Console fournit la configuration du projet, les enregistrements de comptes connectés, les journaux d’exécution et les vues d’utilisation pour ce parcours d’intégration.

Commencer le développement

Consultez le guide Connector for SaaS pour configurer Console et le flux REST. Utilisez Connecter les comptes des utilisateurs finaux avec ProjectConnector si votre backend est écrit en TypeScript.