Access Keys

Depending on the access control system, proximity serial numbers is interpreted differently. For example, some systems may use the whole raw serial number, while others uses only a part of it, or forms a vendor specific serial number based on an algorithm. As IntServ Access are an access control system independent integration platform, IntServ Access takes care of all this behind the scenes for you. In order to be able to do that, the raw access key serial number is always used.

Supported Access Key Types

The following types of access keys is currently supported:

Type	Description
proximity	A contactless card or tag, using RFID-based technology as EM or Mifare.
code	A code used to authorize a specific user instead of a card or tag. Should not to be mixed up with PIN (Personal Identification Number), that is often used in combination with a proximity access key for increased security.

Proximity Access Keys

Proximity identification numbers are typically expressed as fixed size decimal or hexdecimal (prefixed with 0x) values. The identification number must always be the raw CSN and always in fixed size format, regardless if expressed in decimal or hexdecimal.

Reading out the raw serial number from a proximity access key may require a RFID-desktop reader that supports output in a fixed size format.

Proximity Format Specifiers

To support integrators transitioning FTP-based integrations to use IntServ Access API, there is also a set of format specifiers available to specify the key type. Using a format specifier does not require a fixed size serial number. Serial numbers can be expressed in either decimal or hexdecimal when a format specifier is used.

Format specifier	Example	Description
EM:	EM:12345	EM identification number. 1-13 digits / 40-bit CSN.
MC:	MC:12345	Mifare (Classic) identification number. 1-10 digits / 32-bit CSN.
MD:	MD:1234567	Mifare (DesFire) identification number. 1-17 digits / 56-bit CSN.

Composite Keys

Proximity access keys with multiple RFID technologies (typically EM and Mifare combined) is supported. These access keys if referred to as composite access keys. Identification numbers for a composite key is separated with | (pipe).

Codes

Codes are always specified as a decimal value. It is recommended to allow IntServ Access to generate a code automatically, to ensure that it will be a unique code. If the code size is not supported by the targeted access control system, the code is truncated from the left in order to fit the targeted access control system.

Examples

Specifying an EM proximity acccess key in fixed size decimal format (raw csn):

.
"key": 
{
    "identification": "0001234567890",
    "type": "proximity"
}
.

Specifying an EM proximity acccess key in fixed size hexdecimal format (raw csn):

.
"key": 
{
    "identification": "0x00499602d2",
    "type": "proximity"
}
.

Specifying a Mifare proximity acccess key in fixed size hexdecimal format (raw 32-bit csn):

.
"key": 
{
    "identification": "0x2ac7ee00",
    "type": "proximity"
}
.

Specifying a 6-digit code:

.
"key": 
{
    "identification": "334455",
    "type": "code"
}
.

Specifying a EM proximity access key with format specifiers in decimal format:

.
"key": 
{
    "identification": "EM:123456",
    "type": "proximity"
}
.

Specifying a composite access key (EM and Mifare combined) in fixed size hexdecimal format:

.
"key": 
{
    "identification": "0x00499602d2|0x2ac7ee00",
    "type": "proximity"
}
.