Droits et périmètre
Qui peut appeler les endpoints d'états, et quelles données chaque compte voit.
Rôles acceptés
Tous les endpoints /provider/reports/* exigent l'un des rôles suivants :
| Rôle | Profil |
|---|---|
COMPANY_ADMIN, SUPERVISEUR, ACCOUNTANT | Compte d'une compagnie d'assurance |
| Comptes du Pool | Gestion et contrôle, toutes compagnies |
Un compte courtier (BROKER_ADMIN, BROKER_USER, SOUSCRIPTEUR) reçoit 403 : les états sont
réservés aux compagnies et au Pool. En complément du rôle, les opérations de calcul (aperçu,
génération, téléchargement) vérifient que le compte est bien un utilisateur de compagnie ou du
Pool ; un compte rattaché à un courtier est refusé même s'il portait un rôle compagnie.
Périmètre des données
| Compte | Ce que contiennent les états | companyId dans la requête | scopeMode: PER_COMPANY |
|---|---|---|---|
| Compagnie | Uniquement les contrats, avenants, quittances, répartitions et encaissements de sa compagnie | ignoré | ignoré (toujours un seul fichier) |
| Pool / exploitant | Toutes les compagnies | restreint à cette compagnie | un fichier par compagnie |
Le périmètre est appliqué au niveau de la requête de données : il n'est pas possible de le contourner par un filtre.
Visibilité des objets
| Objet | Visible par |
|---|---|
| Catalogue, sources, champs | tous les comptes autorisés |
| Favoris | le compte qui les a posés |
| Modèles | les comptes du même périmètre (compagnie / courtier) ; les modèles SHARED sans compagnie (créés par le Pool) par tous |
| Exécutions et fichiers | les comptes du même périmètre que l'exécution |
| Planifications | les comptes du même périmètre que le modèle |
Données personnelles
Par défaut (options.hideSensitiveData = true), les champs marqués sensibles (téléphone, e-mail,
adresse, pièce d'identité, permis) sont remplacés par •••••• dans l'aperçu comme dans les fichiers.
Ne désactivez ce masquage que pour un besoin légitime et des destinataires habilités ; l'état
SOUSCRIPTEURS y est particulièrement exposé.
Traçabilité
Chaque génération manuelle est journalisée (action GENERATE_REPORT) avec l'utilisateur, la compagnie
et l'identifiant de l'exécution. Les fichiers portent une empreinte SHA-256 (checksumSha256,
en-tête X-Checksum-Sha256) pour vérifier leur intégrité.