Dernière révision : 23 septembre 2026 · Nouveautés de la plateforme
Deux populations appellent les API, et ne s'authentifient pas de la même façon. La convention d'autorisation tient dans cette distinction.
| Canal | Identité | Ce qu'il porte | Appelant |
|---|---|---|---|
| Utilisateur | un compte dans une organisation | un rôle préfixé par l'organisation | l'espace de travail, un jeton personnel |
| Application | une clé d'API | une portée, sans préfixe | un flux, un partenaire, une intégration |
Le rôle porte la frontière multi-tenant — dans quelle organisation ; la portée dit quelle action. Une API métier exige les deux, ce qui empêche une clé valide d'agir dans une organisation qui n'est pas la sienne.
Un utilisateur crée des jetons pour ses outils. Les droits d'un jeton sont l'intersection de ce qu'il demande et de ce que son porteur détient : un jeton n'élève pas son détenteur.
Une clé n'appartient à aucun utilisateur. Elle porte des portées et n'agit que dans l'organisation qui l'a émise.
L'espace documentaire est fermé par défaut : un document déposé n'est pas public tant que son accès n'a pas été ouvert. Les téléversements passent au contrôle antivirus, et un fichier refusé n'est pas écrit.
Last revised 23 September 2026 · Platform changelog
Two populations call the APIs, and they do not authenticate the same way. The authorisation convention rests on that distinction.
| Channel | Identity | What it carries | Caller |
|---|---|---|---|
| User | an account within an organisation | a role prefixed with the organisation | the workspace, a personal token |
| Application | an API key | a scope, with no prefix | a flow, a partner, an integration |
The role carries the multi-tenant boundary — which organisation; the scope says which action. A business API requires both, which prevents a valid key from acting in an organisation that is not its own.
A user creates tokens for their tools. A token's rights are the intersection of what it asks for and what its holder owns: a token does not elevate its holder.
A key belongs to no user. It carries scopes and acts only within the organisation that issued it.
The document store is closed by default: a deposited document is not public until its access has been opened. Uploads are scanned for viruses, and a rejected file is not written.