Skip to content

Credentials

URL : /organizations/{orgId}/credentialsMenu : Suivi des activités ▸ CredentialsPermission requise : credential_read (+ credential_create, credential_update, credential_rotate, credential_delete pour agir)

Liste des jetons d'authentification utilisés pour les échanges entre votre organisation et la plateforme (REST ou SFTP).

Credentials configurés

Layout

Les credentials sont affichés sous forme de cartes (pas de tableau). Trois filtres rapides en haut : Tous, REST, SFTP.

Chaque carte affiche :

  • Libellé (label)
  • Type d'authentification (tag coloré)
  • Mode de provisionnement
  • Statut (Actif, PROVISIONED, etc.)
  • Trois actions :
IcôneAction
🖊️ bleuModifier les champs non sensibles (libellé, URL du token endpoint…).
🔄 rougeRotation — régénère la valeur secrète.
🗑️ rougeRévoquer — supprime le credential (irréversible).

Types d'authentification

REST

TypeDescription
API_KEYClé API dans un en-tête HTTP.
HTTP_SIGNATURESignature cryptographique de la requête (Cavage draft).
OAUTH2_CLIENT_CREDENTIALSOAuth2 via client_id/client_secret.
OAUTH2_PLUS_HTTP_SIGNATUREOAuth2 + signature combinés.

SFTP

TypeDescription
SSH_KEYAuthentification par clé SSH publique.

Modes de provisionnement

ModeQui fournit la valeur ?Usage typique
SELF_PROVIDEDVous fournissez la clé.Flux sortant ASACI (la plateforme appelle votre système avec votre clé).
SYSTEM_PROVIDEDLa plateforme génère la clé.Flux entrant ASACI (votre système appelle la plateforme avec une clé fournie).

Statut de provisionnement

ValeurSignification
PENDINGCréation en cours.
PROVISIONEDProvisionné — opérationnel.
FAILEDÉchec — intervention requise.

Champs selon le type

API_KEY

  • apiKey
  • headerName (ex. X-API-Key)

HTTP_SIGNATURE

  • httpSignatureKeyId
  • httpSignaturePublicKey (PEM)
  • httpSignatureAlgorithm (rsa-sha256…)

OAUTH2_CLIENT_CREDENTIALS

  • clientId
  • clientSecret
  • tokenUrl

OAUTH2_PLUS_HTTP_SIGNATURE

Combine les champs OAuth2 + HTTP_SIGNATURE.

SSH_KEY (SFTP)

  • sftpUsername
  • sftpPublicKey (OpenSSH)
  • diskQuotaMb, maxFileSizeMb, maxConnections, bandwidthLimitMbps

Créer un credential

Bouton orange « Ajouter » en haut à droite. Volet « Configurer credential REST » ou SFTP :

  1. Saisissez un libellé clair.
  2. Choisissez le mode (SELF_PROVIDED / SYSTEM_PROVIDED).
  3. Choisissez le type d'authentification.
  4. Remplissez les champs spécifiques au type.
  5. Cliquez sur « Configurer ».

Mode SYSTEM_PROVIDED

La valeur générée est affichée une seule fois dans le volet — copiez-la ou téléchargez-la immédiatement. Une fois fermée, elle n'est plus récupérable (il faudrait refaire une rotation).

Rotation et révocation

  • 🔄 Rotation : régénère la valeur sans supprimer le credential. Voir Renouveler un credential.
  • 🗑️ Révoquer : suppression définitive — casse immédiatement tous les services qui dépendent du credential. À utiliser avec précaution.

Sécurité

  • Les valeurs sensibles (clientSecret, apiKey, clé privée) sont chiffrées en base et jamais réaffichées après création.
  • Toutes les opérations sont tracées dans la piste d'audit (partner.credentials_updated).

Voir aussi

Documentation ASACI Santé Connect