Readers

Every make ends in the same place: a punch with a time, a person and a direction. What differs is how it reaches CLOR.

Which option for which reader

Reader	Choose	How it connects
ZKTeco, eSSL, Biomax, Realtime, Identix, Mantra — anything with a “Cloud server / ADMS” menu	Push reader (ADMS)	The reader pushes to CLOR. Enter the serial number in CLOR, then on the reader set the cloud server address and port as shown under “How to connect a reader”.
Matrix COSEC Door V3 / PVR / Vega / FMX / ARC DC 200 / ARGO	Matrix COSEC door controller (push)	The controller logs in to a CLOR URL (shown once) and sends each event. Set it under Basic Settings → Communication → Server → Push API. CLOR also sets its clock and can restart it.
Hikvision face / card terminals behind your router	Hikvision terminal (push to CLOR)	Configuration → Network → Advanced → HTTP Listening: HTTPS, api.clor.in, port 443, the path CLOR gave. Event → Access Control must notify the listening host. No port forwarding needed.
Hikvision / Dahua / Suprema BioStar 2 reachable from the internet, or through the on-site connector	Hikvision (ISAPI) / Dahua / BioStar 2	CLOR (or the connector) signs in with the device's user name and password and pulls events every few minutes.
Anviz readers reporting to CrossChex Cloud	Anviz CrossChex Cloud	API key and secret from the portal (System → Cloud API), and the region your portal is on.
eSSL e-Time Office cloud	e-Time Office cloud	Your e-Time Office login.
Turnstiles, middleware, other software	Any reader or software that can send HTTP / any software with a JSON API	A URL to post to (or one for CLOR to call), then say which field is which.
Anything else	File import	A CSV exported from the reader's own software, whenever you have one.

Matrix, Hikvision push, Dahua, Suprema and Anviz drivers are built from the vendors' documentation and public integrations and have not yet been tried on hardware by CLOR. The reader's page shows the last thing it sent; if a field looks wrong, send it to [email protected] and we fix the driver.

Direction (in / out)

Readers with in/out keys send the key pressed. A reader at an entrance only can be set to “Entry only” so every punch is an entry. Where a reader says nothing, the first punch of the day is in and the last is out.

Clocks

CLOR measures each reader's drift from punches it sends as they happen. ADMS readers get a “Set the time” button on their page; Matrix controllers and readers behind the on-site connector are set automatically when a minute or more out. Reader health warns when a clock is out.

Health and alerts

Attendance → Readers → Reader health shows every reader, how long since it was heard, its clock, how full it is and what is queued. Name who gets e-mailed under Alerts; a reader that goes quiet, a day with no punches, a connector that stops checking in — each is one e-mail when it starts and one when it clears.