Skip to content
Guide du centre d'aide · Sécurité & conformité
4 min de lectureVérifié 2026-11-16

Sécurité du compte & accès

Protégez votre console grâce au 2FA par rôle, rotation de clés API, révocation de session et contrôle des liens.

Dans ce guide

Architecture d'identité et de contrôle d'accès en profondeur

Passinstance applique une authentification multicouche, un cloisonnement strict des sessions et une restriction cryptographique des clés pour les opérateurs du tableau de bord (/settings/workspace/security), l'authentification unique SAML 2.0 (SSO), les intégrations API serveur à serveur et les terminaux scanner en point de vente.

FLUX ARCHITECTURE SYSTÈME
ARCHITECTURE INTERACTIVE
PIPELINE D'AUTHENTIFICATION & DE CONTRÔLE D'ACCÈS
ÉTAPE 01
1
VÉRIFICATION D'IDENTITÉ
Opérateurs console : E-mail/Mot de passe + 2FA TOTP OU SAML 2.0 Entreprise (/api/v1/auth/saml/:customerId/*)
Intégrations serveur : x-api-key (pi_live_... / pi_test_...) ou JWT OAuth2
Scanners mobiles : x-scanner-key + PIN opérateur (/scanner-keys/unlock-pin)
ÉTAPE 02
2
FRONTIÈRE D'AUTORISATION LOCATAIRE & RBAC
Politique de sécurité (GET/PUT /customer/:customerId/security-settings)
Rotation de session au changement d'espace (/organizations/current/workspaces/switch)
Rôles granulaires & accès par modèle (/api/v1/rbac/roles)
ÉTAPE 03
3
JOURNALISATION D'AUDIT IMMUABLE
Requêtes & export CSV (GET/api/v1/audit-log & /api/v1/audit-log/export.csv)

Points de terminaison de posture de sécurité et de gestion des accès

Les propriétaires d'espace et administrateurs sécurité configurent les règles d'authentification (/settings/workspace/security), gèrent les clés API (/settings/workspace/developer/api-credentials) et exportent les journaux d'audit (/settings/workspace/developer/audit-logs) via ces points de terminaison :

Chemin du point de terminaisonMéthodeAuthDescription
/api/v1/customer/:customerId/security-settingsGET / PUT / POST / DELETEBearerLit, met à jour (request payload), réinitialise ou supprime les contrôles de sécurité de l'espace.
/api/v1/auth/saml/admin/:customerId/idpGET / PUT / DELETEBearerConfigure les métadonnées SAML Identity Provider, l'Entity ID et les certificats X.509 de l'IdP (GET .../setup pour le guide SP).
/api/v1/auth/saml/:customerId/loginGETPublicDéclenche la redirection SP-SSO (avec GET .../metadata, POST .../acs et GET /api/v1/auth/saml/resolve).
/api/v1/organizations/current/workspaces/switchPOSTBearerBascule vers l'espace locataire actif et fait tourner les jetons de session pour éviter toute réutilisation inter-locataires.
/api/v1/api-keysGET / POSTBearerListe ou génère des clés API liées à l'environnement (pi_live_ en production, pi_test_ en sandbox).
/api/v1/api-keys/:id/regeneratePOSTBearerFait tourner de manière atomique le secret d'une clé API tout en conservant son UUID et ses périmètres.
/api/v1/api-keys/:id/deactivatePOSTBearerSuspend immédiatement une clé API sans supprimer l'historique de télémétrie d'utilisation.
/api/v1/audit-logGETBearerInterroge les événements d'audit immuables d'administration et de sécurité (niveaux SecurityLevel : `LOW \MEDIUM \HIGH \CRITICAL`).
/api/v1/audit-log/export.csvGETBearer (audit:read-all)Exporte jusqu'à 1000 lignes d'audit filtrées au format text/csv pour les revues SOC 2 et conformité.

Configurer les paramètres de sécurité de l'espace (request payload)

Les administrateurs peuvent rendre l'authentification à deux facteurs obligatoire pour toute l'organisation, définir les délais d'expiration des sessions inactives, bloquer les tentatives par force brute, exiger une complexité minimale des mots de passe, interdire les certificats de démonstration et encadrer la durée de vie des clés API via PUT /api/v1/customer/:customerId/security-settings :

JSON
{
  "requireTwoFactor": true,
  "enforceTwoFactorAuth": true,
  "sessionTimeoutMinutes": 60,
  "maxLoginAttempts": 5,
  "lockoutDurationMinutes": 15,
  "passwordMinLength": 12,
  "passwordRequireUppercase": true,
  "passwordRequireNumbers": true,
  "passwordHistoryLength": 5,
  "preventDemoCertificates": true,
  "apiRateLimitPerMinute": 120,
  "apiKeyExpirationDays": 180
}

Authentification unique SAML 2.0 Entreprise (SAML Identity Provider)

Les espaces Entreprise peuvent fédérer les connexions opérateurs avec Okta, Microsoft Entra ID (Azure AD), Google Workspace ou Ping Identity via SAML SSO API (/api/v1/auth/saml/:customerId/*) et SAML Admin API (/api/v1/auth/saml/admin/:customerId/*). Chaque enregistrement SAML Identity Provider associe un Entity ID du fournisseur d'identité, une URL de connexion SSO et un certificat de signature X.509 directement au domaine du locataire.

Cycle de vie des clés API à périmètre restreint (API_KEY_SCOPE_VALUES et API_KEY_ENVIRONMENT_VALUES)

Passinstance impose le cloisonnement des environnements (API_KEY_ENVIRONMENT_VALUES : 'live' | 'test') en séparant les identifiants de production (pi_live_...) des clés sandbox (pi_test_...). Lors de la création d'une clé via POST /api/v1/api-keys, attribuez des périmètres à moindre privilège issus de API_KEY_SCOPE_VALUES :

  • 'passes' — Émettre, mettre à jour, annuler et consulter des instances de passes.
  • 'templates' — Lire les schémas, attributs et mécaniques des modèles.
  • 'scans' — Exécuter les validations et rachats de mécaniques.
  • 'webhooks' — Gérer les abonnements webhooks push et pull.
  • 'analytics' — Interroger les indicateurs et rapports de l'espace.
  • '*' — Accès complet API développeur administrateur (valeur par défaut si scopes est omis).
JSON
{
  "name": "POS Checkout Integration — Production",
  "environment": "live",
  "scopes": ["passes", "scans"],
  "expiresAt": "2027-05-15T00:00:00.000Z"
}

Important : Les secrets bruts de clés API (data.key) et les jetons d'appairage scanner (key) ne sont affichés qu'une seule fois lors de leur création ou de leur rotation (POST /api/v1/api-keys/:id/regenerate). Conservez-les dans un coffre de secrets dédié et n'intégrez jamais de clés pi_live_ dans des bundles JavaScript côté navigateur ou dans des applications mobiles.

Consultez le chiffrement d'infrastructure et nos contrôles de conformité dans le Centre de sécurité et de confiance.

Documentation produit et développeur associée

Prêt à lancer votre premier programme de cartes Wallet ?

Créez votre espace de travail, configurez votre modèle et testez une vraie carte dans Apple Wallet et Google Wallet avant de déployer à grande échelle.