Authentification et droits

L’accès à l’API CCFN repose sur HTTP Basic, une souscription active de l’organisation et un rôle CCFN explicite. Les identifiants sont ceux du compte autorisé. HTTP Basic encode les identifiants ; la confidentialité du transport repose sur HTTPS.

Séparer les comptes

Un administrateur d’espace ne peut pas accéder aux objets, même si un rôle d’usage lui a aussi été attribué. Un administrateur de plateforme est également exclu des fonctions sur les objets. Préparez donc au moins un compte d’administration et un compte d’usage.

Compte ou rôle	Espaces	Objets
`CCFN_ADMIN`	Gestion des espaces de l’organisation	Refusé
`CCFN_USER`	Refusé	Ensemble des fonctions d’usage exposées
Rôles d’usage spécialisés	Refusé	Fonctions explicitement attribuées
Administrateur de plateforme	Ne remplace pas l’attribution d’un rôle CCFN	Refusé

Les rôles ne donnent pas d’accès transversal aux autres organisations. Un objet d’une autre organisation ne devient pas accessible parce que son UUID est connu.

Attribuer les fonctions nécessaires

Rôle spécialisé	Fonction autorisée
`CCFN_USER_DEPOSIT`	Déposer et consulter l’état d’un dépôt idempotent
`CCFN_USER_READ`	Lire le fichier, sa représentation Base64, le certificat et le ZIP
`CCFN_USER_METADATA_READ`	Lire les métadonnées d’un objet
`CCFN_USER_CONTROL`	Contrôler l’intégrité à la demande
`CCFN_USER_LIST`	Lister et rechercher les objets
`CCFN_USER_COUNT`	Compter les objets correspondant aux filtres
`CCFN_USER_RETENTION_EXTEND`	Prolonger la rétention
`CCFN_USER_DESTROY`	Demander une destruction après échéance

Le rôle CCFN_USER_JOURNAL_READ est réservé dans le modèle de droits. Aucun endpoint de lecture du journal n’est exposé dans la version documentée. L’existence de ce rôle ne signifie donc pas que cette fonction est disponible.

Envoyer l’authentification

curl --user "$CCFN_USER" \
  -H 'Accept: application/json' \
  "$CCFN_BASE_URL/api/ccfn/v1/health"

Une intégration serveur doit obtenir ses secrets depuis son gestionnaire de secrets. Ne placez pas les identifiants dans une URL, un dépôt Git ou du JavaScript exécuté dans un navigateur utilisateur.

Comprendre les refus

401 signale une authentification absente ou incorrecte. 403 signale notamment une souscription absente/inactive ou un rôle insuffisant. 404 peut désigner une ressource inexistante ou hors du périmètre de l’organisation.

La souscription et les rôles se préparent lors de l’activation du service. Ces guides ne décrivent pas d’API CCFN de création des utilisateurs ou d’attribution des rôles.

Portée des espaces

Les espaces regroupent les objets et portent des paramètres de conservation. La version documentée ne fournit pas de liste de permissions par espace pour chaque utilisateur : les rôles d’usage portent sur les fonctions au sein de l’organisation. Pour isoler plusieurs populations, faites définir le modèle d’organisation et d’accès avant l’intégration.

À lire ensuite : Créer et gérer les espaces.