Network Ports and Device Identification for BioStar Air

Feature Overview

For BioStar Air to function correctly, certain network ports must be accessible. These ports enable secure communication between compatible readers, cloud services, and user applications. Additionally, administrators may sometimes need to determine the MAC address of a BioStar Air compatible reader from its serial number for network configuration tasks.

Required Network Ports

Ensure the following ports are open in your network firewall:

• 6379, 6381: Redis Ports
  Used as a message broker to sync user information, handle fast event logging, manage sessions, and process device-to-cloud signaling.
• 5671: AMQP over TLS (RabbitMQ)
  Provides a secure messaging protocol for real-time communication between services.
• 443: HTTPS (TLS)
  Standard secure web traffic, required for:
  • Admin Portal web app (browser access)
  • BioStar Air mobile apps (iOS/Android)
  • API calls
  • Device firmware updates pulled from the cloud
  • Device login and authentication services
• If using BioStar Air's built-in Video Management:

  • WebSocket Domain : eu-wss-api.airfob.com

  • WebSocket Port : 3500

  • TURN/STUN Port : 80, 443, 3478, 5349

Important: Ensure access to the following endpoints for device login and authentication:

• https://e-afs-api.airfob.com/v1/device/login (Europe)
• https://afs-api.airfob.com/v1/device/login (Rest of world)

Determining the MAC Address from the Serial Number

In some cases, you may need to determine the MAC address of a BioStar Air compatible reader using only its serial number. This is helpful for tasks such as whitelisting devices before adding them to your network.

Steps

1. Locate the Serial Number:
   Find the 9-digit serial number on the back of the device.
2. Convert the Serial Number to Hexadecimal:
   Use a calculator or an online tool to convert the serial number from decimal to hexadecimal format.
3. Extract the Last 3 Bytes:
   From the hexadecimal value, take the last 6 characters. These represent the final 3 bytes.
4. Formulate the MAC Address:
   The MAC address always starts with 00:17:FC:. Append the last 3 bytes (6 characters) from the hexadecimal value, separating each pair with a colon.

Example

1. Serial Number: 546089489
2. Conversion to Hex: 208CAA11
3. Extract the Last 3 Bytes: 8CAA11
4. Formulate the MAC Address: 00:17:FC:8C:AA:11

Following these steps ensures you can accurately identify a BioStar Air compatible reader on your network using its serial number.