Descripción general
Las organizaciones utilizan Passinstance para sustituir las tarjetas plásticas físicas y acreditaciones tradicionales por credenciales digitales seguras con imagen de marca en Apple Wallet y Google Wallet. Empleados, contratistas, estudiantes y visitantes acceden a edificios de oficinas, campus compartidos y laboratorios restringidos mediante tornos ópticos con código 2D o lectores NFC sin contacto.
Arquitectura del backend y esquema visual
Los pases de identidad se diseñan con metadatos de empleado de alta visibilidad y protecciones visuales antifalsificación:
Diseño visual y ranuras de recursos
-
Tipo de pase (pass type):
studentId,genericoposterGeneric(Apple Wallet y Google Wallet los presentan con proporciones dedicadas de tarjeta de identidad). -
Correlación con RRHH y directorio (
externalId): Guarde el ID de empleado de su directorio o RRHH enexternalId(máx. 255 caracteres, único entre pases activos del inquilino) para que los webhooks automáticos de baja puedan anular o actualizar pases mediantePOST /api/v1/passes/upsert-by-external-idoGET /api/v1/passes/by-external-id/:externalId. -
Plantillas de demostración del catálogo:
student-id-card,daily-access-passyconference-badge. -
Identificación fotográfica: Suba retratos del personal en la ranura de recursos
thumbnail(90x90 pt a @1x, 270x270 px a @3x). Google Wallet la presenta como un avatar circular o cuadrado destacado. -
Identidad corporativa:
logofijo y bannerstripcon los colores de la empresa o del campus. -
Metadatos dinámicos del empleado:
- primaryFields: Nombre completo del empleado ({fullName}). - secondaryFields: Cargo ({title}) y departamento ({department}). - auxiliaryFields: ID de empleado ({employeeId}) y nivel de acceso ({clearanceLevel}). - backFields: Protocolos de emergencia del edificio, teléfonos de contacto de seguridad y enlaces al soporte de TI.
-
Animación dinámica anticaptura (
addSecurityAnimation: true): Genera un perímetro visual animado y variable en el tiempo sobre el pase para impedir capturas de pantalla estáticas o fotografías compartidas fraudulentamente.
Mecánicas de control de acceso y seguimiento de asistencia
Para el registro diario de asistencia en instalaciones, control de turnos o seguimiento de vales de comedor, los pases de identidad pueden vincular mecánicas interactivas:
-
Tipo de mecánica:
VALID_ONCE_PER_DAY. -
Resolución de zona horaria (
resolveCustomerTimeZone):Pass Mechanics Engineresuelve la zona horaria del edificio del titular (por ejemplo,Europe/London). Tras escanearse en un torno de recepción, los escaneos posteriores en el mismo día natural devuelven una advertencia sin duplicar el registro de asistencia. -
Modos de escaneo (
ScanMode) y resultados (scan status):
- CHECK_IN: Registra la hora de entrada en el acceso al edificio (CHECK_IN_SUCCESS, o ALREADY_CHECKED_IN si ya figura dentro). - CHECK_OUT: Registra la salida en la puerta de salida (CHECK_OUT_SUCCESS, o ALREADY_CHECKED_OUT). - CHECK_IN_CHECK_OUT_TOGGLE: Alterna automáticamente el estado entre presencia dentro y fuera de las instalaciones en cada lectura. - SAVE_ATTENDANCE: Registra eventos repetibles de asistencia sin conmutar el estado de entrada.
Acceso NFC sin contacto en puertas (Apple VAS y Google Smart Tap)
Passinstance admite transmisión de credenciales por hardware sin contacto sobre la capa física ISO/IEC 14443 Tipo A/B:
Diccionario de configuración NFC del pase
Al configurar el acceso a puertas sin contacto, se inyecta el esquema nfc dentro del payload del pase:
{
"nfc": {
"message": "FACILITY_ACCESS_NODE_772",
"encryptionPublicKey": "04a1b2c3d4e5f6...",
"requiresAuthentication": true,
"nfcFaceIdRequired": true,
"nfcNoBarcode": false
}
}
-
requiresAuthentication/nfcFaceIdRequired: Solicita al usuario verificación mediante Face ID, Touch ID o código de acceso antes de transmitir el payload NFC al lector de la puerta. -
nfcNoBarcode: Oculta el código de barras óptico en el anverso del pase al desplegar tornos seguros exclusivos por NFC. -
Lectores hardware compatibles: Se integra con lectores certified NFC, Identiv e HID emparejados con Passinstance mediante configuraciones
hardware reader/reader device.
API de baja instantánea y revocación
Cuando un empleado deja la organización o expira la acreditación temporal de un contratista, el acceso debe revocarse de inmediato:
Endpoint de revocación
/api/v1/passes/voiding/:id/void
{
"voided": true,
"options": {
"reason": "CANCELLED",
"customReason": "EMPLOYEE_OFFBOARDED",
"sendPushNotification": false
}
}
Resultado
-
1
El
statusdel pase cambia aVOIDED,lifecycleStatus(PassLifecycleStatus) pasa aVOIDEDy el endpoint devuelve HTTP204 No Content. Tenga en cuenta queoptions.reasonadmiteVoidingReason(EXPIRED,CANCELLED,LOST,STOLEN,DUPLICATE,FRAUD,TECHNICAL_ISSUE,CUSTOMER_REQUEST,ADMIN_ACTION,SYSTEM_AUTO,OTHER). -
2
Todos los escaneos posteriores en tornos de acceso o puntos de control móviles se rechazan con la decisión
ALREADY_VOIDED. -
3
Passinstance actualiza
walletVoidStatus(WalletPropagationStatus:NONE->PENDING->QUEUED->SUCCEEDED) a medida que los workers en segundo plano envían la actualización por APNs HTTP/2 y Google Wallet REST API.
Importante: El acceso a puertas sin contacto con Apple Wallet requiere un certificado comercial aprobado de Apple VAS (Value Added Services) emitido por Apple Developer Relations. El escaneo óptico QR/Aztec funciona de forma inmediata sin configuración previa en cámaras estándar y lectores de códigos 2D.
Más información sobre nuestras Soluciones de acceso e identidad.
