Configurer une Connected App

À quoi sert la fiche

Connected App permet à l’instance Frappe d’accéder à d’autres services web pour le compte des utilisateurs. L’exemple vise Google Mail. Tout service OAuth 2.0 convient. L’usage depuis une intégration est dans Client OAuth générique.

Mise en place

1. Créez une Connected App et nommez-la.
2. Beaucoup de fournisseurs publient leurs points d’entrée sur /.well-known/openid-configuration. Saisissez cette URL et cliquez sur Get OpenID Configuration. Sinon, dans Endpoints, saisissez à la main Authorization URI (page de consentement) et Token URI (échange du code contre un jeton d’accès ou de rafraîchissement).
3. Enregistrez. Un champ en lecture seule Redirect URI apparaît. Sa dernière partie est propre à cette Connected App. Enregistrez-la chez le fournisseur.
4. Créez des identifiants client OAuth 2.0. Indiquez les origines JavaScript autorisées et l’URI copiée. En production, l’origine peut être https://erp.mycompany.com. En local, http://localhost:8000.
5. Copiez l’identifiant et le secret dans la Connected App.
6. Déclarez les périmètres. Pour une boîte Gmail, la source utilise https://mail.google.com/.
7. Paramètres supplémentaires. La documentation Google citée demande access_type=offline pour que le serveur lise la boîte en arrière-plan et rafraîchisse le jeton sans l’utilisateur. Sans ce paramètre, l’accès temporaire expire vite.

Connexion

Le bouton « Connect to ... » en haut à droite ouvre l’écran de consentement, puis ramène vers Frappe. Le serveur échange le code obtenu à la redirection contre un jeton d’accès temporaire et, si le fournisseur le donne, un jeton de rafraîchissement.