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.
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 terminaison | Méthode | Auth | Description | |||
|---|---|---|---|---|---|---|
/api/v1/customer/:customerId/security-settings | GET / PUT / POST / DELETE | Bearer | Lit, met à jour (request payload), réinitialise ou supprime les contrôles de sécurité de l'espace. | |||
/api/v1/auth/saml/admin/:customerId/idp | GET / PUT / DELETE | Bearer | Configure 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/login | GET | Public | Déclenche la redirection SP-SSO (avec GET .../metadata, POST .../acs et GET /api/v1/auth/saml/resolve). | |||
/api/v1/organizations/current/workspaces/switch | POST | Bearer | Bascule vers l'espace locataire actif et fait tourner les jetons de session pour éviter toute réutilisation inter-locataires. | |||
/api/v1/api-keys | GET / POST | Bearer | Liste 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/regenerate | POST | Bearer | Fait 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/deactivate | POST | Bearer | Suspend immédiatement une clé API sans supprimer l'historique de télémétrie d'utilisation. | |||
/api/v1/audit-log | GET | Bearer | Interroge les événements d'audit immuables d'administration et de sécurité (niveaux SecurityLevel : `LOW \ | MEDIUM \ | HIGH \ | CRITICAL`). |
/api/v1/audit-log/export.csv | GET | Bearer (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 :
{
"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 siscopesest omis).
{
"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éspi_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.
