Connecter Figma à Lutril
Lutril se connecte à Figma en SCIM 2.0, avec un jeton généré depuis vos paramètres d’administration Figma. L’API REST de Figma n’expose aucun endpoint pour lire ou gérer les membres d’une organisation : un jeton d’accès personnel, un jeton de plan comme une application OAuth 2 s’arrêtent aux API fichiers et journaux d’activité. SCIM porte toute la gestion des membres : créer un compte, le désactiver à l’échéance d’un accès just-in-time, et lister les personnes qu’il a provisionnées. Cette liste n’est pas l’annuaire de l’organisation, et Figma n’offre rien qui le soit. Cela fonctionne aussi bien sur le plan Organization que sur le plan Enterprise ; SCIM n’existe ni sur Starter ni sur Professional. Une seule fonction diffère entre les deux : attribuer un type de siège via SCIM est réservé à Enterprise, et sur Organization c’est Figma qui applique son siège par défaut.
Accès demandés
- Un jeton d’API SCIM depuis Admin settings, Login and provisioning, SCIM provisioning. Figma ne l’affiche qu’une fois, à la création. Il couvre toute la surface SCIM : il n’y a pas de scope à sélectionner endpoint par endpoint.
- Lecture : GET /Users renvoie les utilisateurs que Figma a provisionnés par SCIM, ce que sa propre référence dit noir sur blanc : « a list of currently SCIM provisioned users in the organization ». Ce n'est pas l'annuaire de l'organisation. Sur une org qui vient d'activer SCIM, la liste est vide, et elle se remplit au fur et à mesure que Lutril provisionne. Figma n'expose aucun endpoint listant tous les membres, quels que soient le plan et le type de jeton.
- Création : POST /Users crée le compte. Aucun mot de passe n’est défini ni généré à aucun moment : un compte SCIM sur Figma se connecte via le SSO de votre organisation. Organization et Enterprise.
- Retrait : PATCH /Users/:id avec op replace, path active, value false. La personne quitte l’organisation et l’enregistrement SCIM subsiste, donc la demande suivante réactive le même compte. Organization et Enterprise. Lutril n’appelle jamais DELETE /Users/:id, qui efface l’utilisateur et son journal de provisioning : la suppression définitive reste une action humaine dans la console d’administration Figma.
- Type de siège, Enterprise uniquement : roles de la forme { type: seatType, value: Full, Dev, Collab ou View }. Sur un plan Organization, laissez le siège vide dans Lutril ; Figma crée le compte sur son siège par défaut et toute montée en gamme est une action manuelle dans la console d’administration Figma.
Étapes de configuration
- 1
Dans Figma, ouvrez Admin settings, puis Access, Authentication, SAML SSO, et copiez votre Tenant ID. Prenez-le sur cet écran et nulle part ailleurs : c'est l'identifiant d'org SAML, pas l'identifiant d'organisation visible dans une URL figma.com. Les deux sont de longs nombres, donc on les confond facilement, et Figma répond au mauvais par un 404 sec qui ne nomme ni l'un ni l'autre.
Open Figma admin settings - 2
Construisez votre URL de base SCIM à partir de cet identifiant de tenant. Figma for Government utilise figma-gov.com à la place de figma.com.
Texthttps://www.figma.com/scim/v2/YOUR_TENANT_IDThis is what Lutril's SCIM Base URL field expects: no trailing slash, and no /Users suffix. - 3
Ouvrez Admin settings, Login and provisioning, SCIM provisioning, et générez un jeton d’API. Copiez-le immédiatement : Figma ne l’affiche qu’une fois.
- 4
Dans Lutril, connectez Figma et collez l’URL de base SCIM ainsi que le jeton dans le champ SCIM Bearer Token. Le jeton est chiffré au repos et n’est jamais écrit en configuration ni en journaux.
- 5
Optionnel, sur le plan Enterprise, pour l’accès just-in-time : dans le catalogue Lutril, définissez le type de siège qu’applique une attribution automatique, et proposez les quatre mêmes sièges comme options de demande. Le siège envoyé par Lutril est toujours celui qu’un owner a configuré, jamais celui choisi par le demandeur. Sur un plan Organization, laissez le siège vide : l’accès just-in-time fonctionne de la même façon, et c’est Figma qui décide du siège.
Où le créer
Documentation officielle
Connectez-vous à Lutril pour brancher Figma, ou réservez une démo et nous le mettons en place avec vous. Sans slides.