Suprema BioStar 2 (REST)
Suprema·AE_HSc_SupremaBioStar2_RestConnectorGuide
Overview
The Suprema BioStar 2 REST connector integrates AlertEnterprise with Suprema BioStar 2 — a biometric access-control platform supporting face, fingerprint, and card-based authentication. Common in fin-services data-center and high-security-zone deployments where biometric MFA is required.
Topology: AlertEnterprise application → Suprema BioStar 2 REST Connector → Suprema BioStar 2 RESTful APIs. Direct REST integration; no intermediate agent.
Architecture
Composed from this connector's actors + edges. Trust zones are color-coded; trust crossings render as thicker lines.
Authentication
1 method supported
BioStar 2's REST API uses a session-cookie authentication model — the connector POSTs login credentials and receives a session cookie used on subsequent calls. See the connector guide's Security chapter for the configured credential storage pattern.
Prerequisites
Everything that must be in place for this connector to work, with the owner who's responsible.
BioStar 2 server v8.4+
customerCustomer's BioStar 2 server must be on version 8.4 or above to expose the REST API surface the connector requires.
BioStar 2 API user with appropriate permissions
customerDedicated API user account on BioStar 2 with permissions to manage users + access groups.
Known limitations
Documented constraints to set customer expectations before deployment.
Biometric template handling is regulatory-sensitive
importantBiometric templates are sensitive personal data under GDPR Article 9, India DPDP 2023, US BIPA, and similar regimes. The connector moves template references but customer must establish lawful basis, consent, and retention policies separately.
Data fields
3 fields mapped between AE Guardian and the vendor system.
| AE field | Vendor field | Description | Direction | Required |
|---|---|---|---|---|
| User | BioStar 2 User | User records — name, ID, biometric template references (templates stored on device or server depending on deployment). | bidirectional | yes |
| Credential | BioStar 2 Card / Biometric Template | Cards and biometric templates assigned to users. Provisioning manages both. | bidirectional | yes |
| Access Level | BioStar 2 Access Group | Access group / access-level assignments per user. | bidirectional | no |
- src/connectors/suprema-bio-star2-rest/source.pdf — p6 — Chapter 1, Supported Version
- src/connectors/suprema-bio-star2-rest/source.pdf — p8 — Chapter 2, Connector Architecture