Créer une app OAuth Notion pour OpenConnector

Utilisez une connexion publique Notion lorsqu’OpenConnector doit permettre aux utilisateurs d’autoriser des pages ou des bases de données d’un espace de travail via OAuth. Notion prend aussi en charge les secrets d’intégration interne, mais OAuth convient à un flux d’autorisation utilisateur.

Service OpenConnector

ID du service	Fournisseur	Type d’authentification
`notion`	Notion	OAuth2

Le fournisseur OAuth Notion d’OpenConnector demande des capacités comme read_content, insert_content et update_content.

Prérequis

Un runtime OpenConnector en cours d’exécution.
Un accès au portail développeur des intégrations Notion.
La permission de créer une connexion publique.
L’origine OpenConnector ouverte par les utilisateurs dans le navigateur, par exemple http://localhost:3000 ou https://connect.example.com.

Étape 1 : définir l’URL de callback OpenConnector

Ajoutez /oauth/callback à l’origine OpenConnector pour construire l’URL de callback. Pour un test local, utilisez http://localhost:3000/oauth/callback. Pour un déploiement public, définissez OOMOL_CONNECT_ORIGIN, redémarrez OpenConnector et utilisez l’URL de callback publique, par exemple https://connect.example.com/oauth/callback.

Étape 2 : créer une connexion publique Notion

Dans le portail développeur des intégrations Notion :

Créez une nouvelle connexion publique.
Renseignez le nom de la connexion et les détails de l’espace de travail.
Ajoutez l’URL de callback OpenConnector exacte dans la configuration de l’URI de redirection OAuth.
Choisissez le scope d’installation adapté à votre cas d’usage.
Configurez les capacités de contenu nécessaires aux opérations OpenConnector.
Enregistrez la connexion.

Consultez le guide officiel Notion Authorization. Notion précise que le scope d’installation est sélectionné lors de la création d’une connexion publique ; choisissez-le avec soin.

Étape 3 : copier les identifiants du client

Dans les paramètres de la connexion publique Notion, copiez :

Valeur Notion	Champ OpenConnector
Identifiant client OAuth	`clientId`
Secret client OAuth	`clientSecret`

Étape 4 : enregistrer le client Notion dans OpenConnector

Utilisez la console web d’OpenConnector :

Ouvrez la console web d’OpenConnector, par exemple http://localhost:3000.
Ouvrez Providers et sélectionnez Notion.
Choisissez Configure OAuth Client ou Edit OAuth Client.
Collez l’ID et le secret du client Notion.
Choisissez Save OAuth Client.

Étape 5 : connecter et tester

Après avoir enregistré le client OAuth, choisissez Connect sur la page du fournisseur Notion. Sélectionnez le contenu de l’espace de travail Notion à partager, approuvez l’accès, revenez dans OpenConnector et vérifiez que la page du fournisseur indique que l’espace de travail est connecté.

Utilisez notion.search ou notion.list_users comme opération de test à faible risque depuis la liste des opérations de la console.

Résolution des problèmes

Symptôme	Vérification
Notion refuse l’URI de redirection	L’URI de redirection OAuth dans Notion doit correspondre exactement à `<openconnector-origin>/oauth/callback`.
Du contenu partagé est absent	Pendant l’autorisation, sélectionnez les pages ou bases de données accessibles à la connexion. L’accès Notion est limité au contenu partagé.
Les opérations d’écriture échouent	Vérifiez que la connexion Notion possède les capacités d’insertion ou de mise à jour du contenu et que la page ou base partagée autorise l’opération.
Le mauvais espace de travail est connecté	Lancez l’autorisation dans un profil de navigateur connecté à l’espace de travail Notion voulu.
Confusion entre jeton d’intégration interne et OAuth	Utilisez l’ID et le secret du client OAuth pour ce guide. Les secrets d’intégration interne suivent un autre parcours.