Skip to content
Guide du centre d'aide
4 min de lectureVérifié 2026-11-16

Badges employés & accès

Émettez des identifiants collaborateurs, prestataires ou visiteurs avec date d'expiration, contrôle 2D et révocation instantanée.

Dans ce guide

Vue d'ensemble

Les organisations utilisent Passinstance pour remplacer les cartes et badges d'accès en plastique par des identifiants numériques sécurisés à leur marque dans Apple Wallet et Google Wallet. Collaborateurs, prestataires, étudiants et visiteurs accèdent aux immeubles de bureaux, campus de coworking et laboratoires sécurisés via des portiques à code-barres optiques 2D ou des lecteurs NFC sans contact.

Architecture backend & schéma visuel

Les passes d'identité sont conçus avec des métadonnées collaborateur très lisibles et des protections visuelles anti-contrefaçon :

FLUX ARCHITECTURE SYSTÈME
ARCHITECTURE INTERACTIVE
FLUX D'ARCHITECTURE SYSTÈME : ACCÈS EMPLOYÉ & RÉVOCATION
ACTEURS SYSTÈME PARTICIPANTS
P1 Système RH / API REST
P2 API Centrale Passinstance
P3 Lecteur porte / Scanner
P4 Passe Wallet Mobile
ÉTAPE 1 REQUÊTE / ACTION POST/api/v1/passes
ÉTAPE 2 REQUÊTE / ACTION Provisionner passe & NFC
ÉTAPE 3 REQUÊTE / ACTION Ajout au Wallet
›
(Photo ID + Biométrie)
ÉTAPE 4 RÉPONSE Approcher lecteur
ÉTAPE 5 RÉPONSE POST/api/v1/scans
›
(NFC ISO 14443 / QR)
›
(Vérifier ACTIVE & créneau)
ÉTAPE 6 REQUÊTE / ACTION Accès autorisé (200)
ÉTAPE 7 REQUÊTE / ACTION POST/api/v1/passes/voiding/:id/void
ÉTAPE 8 REQUÊTE / ACTION Push APNs silencieux
›
(walletVoidStatus)
›
(Le portique rejette
›
les scans suivants)

Mise en page visuelle & emplacements d'images

  • Type de passe (pass type) : studentId, generic ou posterGeneric (Apple Wallet et Google Wallet affichent ces formats avec des proportions dédiées aux cartes d'identité).
  • Corrélation SIRH & annuaire (externalId) : enregistrez l'identifiant RH ou annuaire du collaborateur dans externalId (max. 255 caractères, unique parmi les passes actifs du locataire) afin que les webhooks de départ puissent annuler ou mettre à jour les badges via POST /api/v1/passes/upsert-by-external-id ou GET /api/v1/passes/by-external-id/:externalId.
  • Modèles de démonstration du catalogue : student-id-card, daily-access-pass et conference-badge.
  • Photo d'identification : importez les portraits des collaborateurs dans l'emplacement thumbnail (90×90 pt en @1x, 270×270 px en @3x). Google Wallet affiche cet emplacement sous forme d'avatar circulaire ou carré bien visible.
  • Identité de l'organisation : emplacements fixes logo et strip arborant les couleurs de l'entreprise ou du campus.
  • Métadonnées employé dynamiques :

- primaryFields : nom complet de l'employé ({fullName}). - secondaryFields : intitulé de poste ({title}) et service ({department}). - auxiliaryFields : matricule employé ({employeeId}) et niveau d'habilitation ({clearanceLevel}). - backFields : consignes d'urgence du bâtiment, numéros de sécurité et liens vers le support informatique.

  • Animation dynamique anti-capture d'écran (addSecurityAnimation: true) : génère un contour animé variant dans le temps autour du passe pour empêcher les captures d'écran statiques ou la présentation d'une photo partagée.

Mécaniques de contrôle d'accès & suivi de présence

Pour le contrôle de présence quotidien, le suivi des vacations ou la gestion des droits de cantine, les passes d'identité peuvent intégrer des mécaniques interactives :

  • Type de mécanique : VALID_ONCE_PER_DAY.
  • Résolution du fuseau horaire (resolveCustomerTimeZone) : Pass Mechanics Engine résout le fuseau horaire du site du porteur (ex. Europe/London). Une fois scanné à un portique d'accueil, les scans suivants au cours de la même journée calendaire renvoient un avertissement sans enregistrer de double présence.
  • Modes de scan (ScanMode) & résultats (scan status) :

- CHECK_IN : enregistre l'heure d'arrivée à l'entrée du bâtiment (CHECK_IN_SUCCESS, ou ALREADY_CHECKED_IN si déjà présent). - CHECK_OUT : enregistre le départ à la borne de sortie (CHECK_OUT_SUCCESS, ou ALREADY_CHECKED_OUT). - CHECK_IN_CHECK_OUT_TOGGLE : bascule automatiquement le statut entre présent sur site et absent à chaque passage devant le lecteur. - SAVE_ATTENDANCE : consigne des événements de présence répétables sans basculer d'état entrée/sortie.

Accès sans contact NFC aux portes (Apple VAS & Google Smart Tap)

Passinstance prend en charge la transmission matérielle d'identifiants sans contact sur la couche physique ISO/IEC 14443 Type A/B :

Dictionnaire de configuration NFC du passe

Lors de la configuration de l'accès sans contact aux portes, le schéma nfc est injecté dans la charge utile du passe :

JSON
{
  "nfc": {
    "message": "FACILITY_ACCESS_NODE_772",
    "encryptionPublicKey": "04a1b2c3d4e5f6...",
    "requiresAuthentication": true,
    "nfcFaceIdRequired": true,
    "nfcNoBarcode": false
  }
}
  • requiresAuthentication / nfcFaceIdRequired : demande à l'utilisateur une validation par Face ID, Touch ID ou code d'accès avant de transmettre la charge utile NFC au lecteur de porte.
  • nfcNoBarcode : masque l'affichage du code-barres optique sur la face du passe lors du déploiement de portiques sécurisés exclusivement NFC.
  • Lecteurs matériels compatibles : s'intègre avec les lecteurs certified NFC, Identiv et HID appairés à Passinstance via les configurations hardware reader / reader device.

Départ collaborateur & API de révocation instantanée

Lorsqu'un collaborateur quitte l'organisation ou qu'un badge prestataire temporaire arrive à échéance, son accès doit être révoqué immédiatement :

Endpoint de révocation

POST /api/v1/passes/voiding/:id/void
En-têtes
X-API-Key <API_KEY>
Content-Type application/json
JSON
{
  "voided": true,
  "options": {
    "reason": "CANCELLED",
    "customReason": "EMPLOYEE_OFFBOARDED",
    "sendPushNotification": false
  }
}

Résultat

  1. 1
    Le champ status du passe bascule vers VOIDED, lifecycleStatus (PassLifecycleStatus) passe à VOIDED, et l'endpoint retourne un code HTTP 204 No Content. Notez que options.reason accepte les valeurs VoidingReason (EXPIRED, CANCELLED, LOST, STOLEN, DUPLICATE, FRAUD, TECHNICAL_ISSUE, CUSTOMER_REQUEST, ADMIN_ACTION, SYSTEM_AUTO, OTHER).
  2. 2
    Tous les scans ultérieurs aux portiques d'accès ou sur les terminaux mobiles de contrôle sont rejetés avec la décision ALREADY_VOIDED.
  3. 3
    Passinstance actualise walletVoidStatus (WalletPropagationStatus : NONE -> PENDING -> QUEUED -> SUCCEEDED) à mesure que les workers en arrière-plan poussent la mise à jour via APNs HTTP/2 et l'API REST Google Wallet.

Important : L'accès sans contact aux portes via Apple Wallet exige un certificat marchand Apple VAS (Value Added Services) approuvé par Apple Developer Relations. Le scan optique par code QR/Aztec fonctionne immédiatement avec des caméras standard et des lecteurs de codes-barres 2D.

Découvrez nos Solutions d'accès & d'adhésion.

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.