Jump to content

Card Access System

From /dev/hack

If you are on this page and have not completed /dev/hack Member Onboarding, do not continue!

Please do not try to tap in until you have been trained about (dis)arming and closing up the space.

In the cardkey system, you should ask another existing member to visit https://cardkey.devhack.net/vouching/ to confirm that you have completed the member onboarding reading. You will then be allowed to add cardkeys yourself.

Card Access Systems

We currently have two separate card access systems:

Home Assistant - gatekeeper

  • janky automations (duh)
  • mostly deprecated for /dev/hack members; only some SCN & guest cards remain.
  • just a list of card UIDs mapped to (unvalidated) usernames
  • door control and door card reader can go down if our infra or internet fails
  • door taps announced to the chat are from HA

Cardkey + Hikvision

  • https://cardkey.devhack.net
  • newer system that we're migrating to
  • integrated w/ hikvision
  • network or infra outages at the space do not affect the door reader and the accepted cards

How to register a card at https://cardkey.devhack.net/

Picture of the Hikvision reader that is hanging in the focus foundry

First, if you haven't yet, get door training. Get another existing member to enter your username at https://cardkey.devhack.net/vouching/.

warning: it's not recommended to use your credit/debit card with cardkey. we've had some reports of using a debit card on the front door regularly causing it to stop working with other tap-to-pay terminals.

If you want to use your iPhone as your access card, check out the Apple Wallet Cardkey page.

If you're at the space:

Right now the web app allows you to tap your proposed card at the gate and then claim it immediately within 5 minutes.

If you're not at the space:

You then need a card UID read from a Flipper Zero or phone based NFC reader:

  • Get the card ID from your card reader (it will look something like 1A:2B:3C:4D:5E:6F:70).
  • If there are more than 4 bytes, take the first 4 (such as 1A:2B:3C:4D).
  • Reverse the order of those bytes (making it 4D:3C:2B:1A).
  • Convert the resulting bytes to decimal (like 0x4d3c2b1a → 1295788826).

Then:

  1. go to https://cardkey.devhack.net
  2. login
  3. select 'Cards' at the top
  4. enter your UID into the field
  5. press Register Card
  6. under the door controller sync section, hit "Blorp!" so that the card is transferred to the door controller
  7. done! your card is registered