LexOpti est un serveur d’autorisation OAuth 2.1. Votre application agit pour un membre dans une organisation : le membre choisit l’organisation pendant l’autorisation, et chaque jeton y est lié. Pour connecter un membre pas à pas, suivez construire une intégration complète.
GET https://app.lexopti.com/api/auth/oauth2/authorize
Jeton
POST https://app.lexopti.com/api/auth/oauth2/token
Révocation (RFC 7009)
POST https://app.lexopti.com/api/auth/oauth2/revoke, avec token et token_type_hint
Ressource de l’API
https://app.lexopti.com/v1
Le client d’une application web est confidentiel : il s’authentifie aux points de jeton et de révocation en HTTP Basic (client_secret_basic, identifiant et secret encodés en formulaire). Une application mobile ou de bureau est enregistrée comme application native, un client public sans secret qui envoie son client_id dans le formulaire (applications mobiles et natives).
Code d’autorisation avec PKCE (S256, toujours exigé). Demandez la ressource https://app.lexopti.com/v1 au point d’autorisation et au point de jeton. Les URI de redirection d’une application web sont des URL HTTPS exactes, sans joker ; celles d’une application native sont une adresse IP de boucle locale sur tout port, un schéma à usage privé en domaine inversé ou une URI HTTPS revendiquée (enregistrer une application native).
La page de connexion de LexOpti propose Pas encore de compte ? Créer un compte sous son formulaire, et une adresse e-mail que LexOpti ne connaît pas y mène aussi. Le membre suit l’inscription normale de LexOpti : profession, structure, offre ou essai gratuit, paiement s’il y a lieu, puis le code reçu par e-mail. La page lui indique que si sa structure utilise déjà LexOpti, il doit demander une invitation à son responsable plutôt que créer une seconde structure.
Votre demande d’autorisation est conservée 45 minutes, dans ce navigateur seulement. Une fois l’inscription terminée, ou l’invitation acceptée, le membre la poursuit (le choix de l’organisation s’il en a plusieurs, puis le consentement) et revient sur votre redirect_uri avec le code et votre state, comme après une connexion. Rien ne change de votre côté : la même demande, le même rappel, la même vérification du state. Au-delà de 45 minutes, ou dans un autre navigateur, le compte est tout de même créé mais le membre reste dans LexOpti : il relance la connexion depuis votre logiciel.
Une application encore limitée aux bacs à sable le reste : la structure d’un nouveau membre est une organisation réelle, pour laquelle elle ne peut pas être autorisée.
Une fois votre application installée par une structure pour tous ses membres, celle-ci peut laisser votre logiciel agir pour les membres qu’elle a enrôlés sans qu’ils se connectent : le mode délégué, actif par défaut pour une application installée, que la structure demande à LexOpti de couper ou de rétablir. Votre logiciel garde alors une seule connexion, celle d’un propriétaire ou d’un administrateur, et nomme le membre qui agit sur chaque requête avec l’en-tête X-LexOpti-Acting-User: <member_id>. LexOpti exécute la requête avec le rôle de ce membre et note, sur chaque trace, que l’identité a été affirmée par votre application. L’enrôlement, les deux modes et leurs refus : enrôler vos membres.
Les jetons d’accès durent 15 minutes. Rafraîchissez-les automatiquement, avant expiration ou à la réception d’un 401 : avec le SDK, accessToken est une fonction appelée une fois par opération, qui rend un jeton valide et le rafraîchit au besoin.
Les jetons de rafraîchissement durent 30 jours et tournent à chaque usage : chaque rafraîchissement rend un nouveau jeton de rafraîchissement, valable 30 jours à partir de là. Des rafraîchissements concurrents à moins de 10 secondes sont tolérés (la même réponse est rendue) ; rejouer plus tard un ancien jeton est traité comme un vol et révoque toute la famille : enregistrez le nouveau jeton de façon atomique.
Une application restée inutilisée 30 jours, son dernier jeton de rafraîchissement expiré, doit obtenir une nouvelle autorisation du membre : faites-le repasser par le parcours d’autorisation.
Un jeton de rafraîchissement est aussi révoqué, quelle que soit son échéance, quand l’accès prend fin (ci-dessous) : le membre quitte l’organisation ou est banni, l’organisation bloque votre application, LexOpti la désactive, le membre retire son consentement, ou un jeton rejoué a révoqué sa famille.
Votre secret client n’est affiché qu’une fois et il est stocké haché. Demandez sa rotation à LexOpti : le nouveau secret n’est affiché qu’une fois, et l’ancien reste valable 24 heures, le temps de déployer le nouveau sans interruption.
Un rafraîchissement au point de jeton, en HTTP Basic : enregistrez le nouveau jeton de rafraîchissement avant d’utiliser le jeton d’accès.
A Headers object, an object literal, or an array of two-item arrays to set request's headers.
headers: {
authorization: string
authorization: `Basic ${
const basic:string
basic}` },
RequestInit.method?: string |undefined
A string to set request's method.
method: "POST",
}
);
if (!
const response:Response
response.
Response.ok: boolean
The ok read-only property of the Response interface contains a Boolean stating whether the response was successful (status in the range 200-299) or not.
D’après les exemples PHP exécutables : un jeton valide, rafraîchi sous un verrou pour que deux processus n’utilisent jamais le même jeton de rafraîchissement.
oauth.php
/**
* A valid access token, refreshed when it expires within a minute (or now,
* with $force). A valid token is read without any lock. Refresh tokens
* rotate: every refresh answers a new one and the old one stops working, so
* a refresh runs under an exclusive lock, reads the tokens again (another
* worker may have refreshed meanwhile), and stores the new refresh token
* before anything uses it.
*
* A refresh that times out may have been answered: LexOpti then rotated the
* token and the new one is lost. It is sent again at once, with the same
* refresh token: within 10 seconds LexOpti answers the same tokens again.
* Later, the old token is treated as stolen and the member must authorize
Quand le membre déconnecte LexOpti dans votre logiciel, révoquez ses jetons au point de révocation en HTTP Basic : d’abord le jeton de rafraîchissement, qui met fin à l’autorisation, puis le jeton d’accès. Abandonnez les jetons même si une révocation échoue.
Chaque requête revérifie que le membre appartient toujours à l’organisation, n’est pas banni, que l’organisation n’a pas bloqué votre application, que LexOpti ne l’a pas désactivée et que le consentement du membre existe encore. Si l’un d’eux manque, la requête suivante répond 401 invalid_token, quelle que soit l’expiration du jeton. Un jeton n’agit jamais au-delà du consentement actuel du membre : un consentement restreint à moins de portées restreint les jetons déjà émis.
Test Request dans la référence de l’API et l’aperçu en direct de l’atelier vous connectent avec l’application propre au portail, pour l’un de vos bacs à sable seulement, et gardent le jeton dans la mémoire de la page, jamais dans le stockage du navigateur. L’atelier ouvre l’autorisation dans une fenêtre ; quand le navigateur la bloque, quand elle est fermée sans réponse ou tarde trop, ou quand vous choisissez Ouvrir dans cet onglet, il continue dans le même onglet et vous ramène à l’atelier avec ses réglages. La référence de l’API ne peut utiliser qu’une fenêtre, sa visionneuse n’offrant pas d’autre moyen : si votre navigateur la bloque, autorisez les fenêtres surgissantes pour le portail, ou collez un jeton d’accès dans Authentication.