This Camio User Guide covers:

1. Overview of Camio with ABC Fitness
2. Enabling the ABC Fitness API
3. Mapping Cameras to ABC Fitness Stations
4. Camio Setup for ABC Fitness Gateway
5. Enabling Tailgating Notifications
6. Removing Camera to Station Mappings

Overview of Camio with ABC Fitness

Fast visual verification and access event detection

Camio enables fast search and alerts on events like access granted, invalid access, and door forced open. 

Works with existing cameras

Setup takes less than 15 minutes. Each camera is mapped to a ABC Fitness station so that events from those stations annotate the video from that camera. You configure the Camio Gateway with the credentials required to subscribe to ABC Fitness access control events.

Enabling the ABC Fitness API

Setting Up an ABC Fitness API Account for the First Time

1. Sign up for a 3scale account at https://abcfinancial.3scale.net/signup
2. You will be contacted by ABC Fitness in order to fill out and sign a API Access Agreement via E-Sign
   • The agreement mentions API fees but these are for 3rd party vendors only.  You are requesting access to your club account data only, so ABC does not charge Club Owners for their own data
   • Page 15/16 of Document
     • Vendor - Fill in your Club Name 
     • Effective Date - Today's date
     • Vendor address - Club Address
     • Your Products - Copy and Paste the following
       • "Gym Name" is requesting API access to our ABC data to facilitate our Open Source tailgating software that will be running on-premise and maintained by our internal team.  We require access to our ABC Club #XXXXX.  Please give access to these twoAPI endpoints: get /{clubNumber}/clubs/checkins/details and get /{clubNumber}/members
     • Release Date - Today's date
     • Representative - Club's Owner Name
     • Territory - ABC Club Number  (If a franchise that needs multiple club access, enter "All Clubs"

Once Your ABC Fitness API Account is Setup

1. Login to https://abcfinancial.3scale.net/
2. Click on "API KEYS" at the top
3. Copy your Application Key (if not present, click "Create new key") and Application ID. Save for this step.

Note: If you previously setup your ABC Fitness API account, ensure you have access to the following API endpoints:

• GET /{clubNumber}/clubs/checkins/details
• GET /{clubNumber}/members

Mapping Cameras to ABC Fitness Stations

Once you have access to the ABC Fitness API, you will need to generate a token in order to call the Camio API, as well as map your cameras in Camio to your ABC Fitness stations.

1. Generate your Camio Authorization token to be used by the Camio Gateway to annotate video with incoming access control events.
   1. Sign-in as the Camio account manager and press the Generate button at https://camio.com/settings/integrations/pacs
      • Either the account owner or a guest with Can Manage permission can generate the token
   2. Copy the token immediately after you generate it, since you will not be able to retrieve it again later.
   3. Paste the token into your Camio Gateway configuration as the "camio_api_token" value
2. Enter a station name next to each camera that has a view of people entering the station and press Save.  

Note: If you see a message "No integration settings found..." that means integration settings have never been saved for this account. Configure the settings and hit save. When you reload the page, the message should be gone.

Camio Setup for ABC Fitness

The Camio Gateway subscribes to ABC Fitness access control events in order to annotate the video associated with each event.

Camio Gateway Installation

The Camio Gateway runs as a Kubernetes deployment installable with Helm, which can run on any host machine (e.g. Linux, Windows) that can access the ABC Fitness server. If your firewall restricts the sites contacted, then please see firewall rules.

Quick Install via Helm

Detailed instructions for installing any of our PACS Gateway deployments through Helm can be found at our Camio User Guide for setup and deployment of Camio PACS Gateways. The following instructions will a brief overview of setting up with Helm, specific to the Camio ABC Fitness Gateway.

1. Create your values.yaml file. The most basic values.yaml for the ABC Fitness gateway should look like:

credentials:
  app_key: "INSERT ABC FITNESS APP KEY"
  app_id: "INSERT ABC FITNESS APP ID"
  club_id: "INSERT ABC FITNESS CLUB NUMBER"
  camio_api_token: "INSERT CAMIO DEV TOKEN"

That current version of the Camio ABC Fitness Gateway does not support self signed certificates. Please contact support@camio.com for more details if your deployment will need to use self signed certificates.

Note: By default the driver will assume your ABC Fitness API will be returning checkins in the UTC/GMT timezone. If this is not the case, a timezone can be set using the advanced config options below.

2. Create your K8s cluster if does not exist

3. Run:

helm install camio-abc-fitness oci://us-central1-docker.pkg.dev/camiologger/helm/camio-abc-fitness --version 1.0.1 -f /PATH/TO/values.yaml [-n camio] [--create-namespace]

The namespace ( -n ) argument is optional and will deploy the gateway in the specified namespace. If not included, the gateway will be set up in the default namespace. Use --create-namespace if the namespace you want to use does not currently exist.

4. Confirm that your helm installation was successful by running:

kubectl get pods [-n camio]

The output should look something like:

NAME                   READY STATUS  RESTARTS AGE
driver-XXXXXXXXX-XXXXX 1/1   Running 0        9s

If the driver pod shows as 1/1 READY and 0 RESTARTS, it is probably running correctly. If you would like more details, you can retrieve the logs for your pod by running:

kubectl logs driver-XXXXXXXXX-XXXXX [-n camio]

Docker Installation

Optionally, you can use the docker image instead. Run:

docker pull \ us-central1-docker.pkg.dev/camiologger/public-containers/camio-integration-driver-abc-fitness:latest-linux-amd64

to pull the image. An arm64 version of the image is also available and can be pulled using:

docker pull \ us-central1-docker.pkg.dev/camiologger/public-containers/camio-integration-driver-abc-fitness:latest-linux-arm64

Camio Gateway Configuration (values.yaml file)

The configuration is divided into the following sections to organize the gateway's settings:

credentials

app_key: "INSERT ABC FITNESS APP KEY"
app_id: "INSERT ABC FITNESS APP ID"
club_id: "INSERT ABC FITNESS CLUB ID"
camio_api_token: "INSERT CAMIO DEV TOKEN"

requests

# Uncomment any settings where default values shown need to be modified
# (default values should work for most deployments

# Config for re-trying requests to the Camio PACs server
# pacs:
#   backoff_multiplier: 2.0 
#   backoff_start: 2.0
#   backoff_limit: 3 

# events:
#   streaming: false # ABC Fitness API does not support streaming
#   polling_interval: 43200 # In seconds, how frequently to request checkin information via the ABC Fitness API. Defaults to every 12 hours
#   count_reset_interval: 86400 # Reset the stored events count every 24 hours
#   timezone_offset: # Timezone offset for the timestamps of the check-in events, as returned by the ABC Fitness API. Format is +/-HHMM. Examples: -0700, +0100. Does not account for daylight savings time, since the number is always added/subtracted from the UTC time. Default is None.
#   timezone_name: "UTC" # Name of the timezone that the check-in timestamps are in, as returned by the ABC Fitness API. Uses pytz timezones. If timezone_offset is also passed, will use the offset over the timezone name. Should account for daylight savings. Examples: US/Central, US/Eastern, US/Pacific, Europe/Paris. Default is UTC.
#   get_member_info: true  # If true, fetches the information for the members found in the check in events. Required for tailgating notifications, in order to get the members email.
#   page_size: 100  # How many check in events to request in one call to the ABC Fitness API

# members:
#   page_size: 100  # How many members to request in one call to the ABC Fitness API

container

image: us-central1-docker.pkg.dev/camiologger/public-containers/camio-integration-driver-abc-fitness:latest-linux-amd64

log_level

# 10  # DEBUG level and higher logs, use this value if debugging the gateway
20  # Default, INFO level and higher logs
# 30  # WARNING level and higher logs, use this value if you only want logs of potential problems in the gateway
# 40  # ERROR level and higher logs, use this value if you only want logs of definite errors in the gateway

Supported Timezone Names

Camio Gateway Host Hardware Requirements

The CPU and RAM required of the host machine that runs the Camio Gateway varies with the maximum throughput of access control events. This guide covers common volumes:

If you are also setting up MicroK8s on your machine, MicroK8s recommends 20G disk space and 4G of memory.

Firewall Rules

During the initial setup and any updates to the deployment, you will need access to these domains:

• us-central1-docker.pkg.dev

During operation the gateway will need access to the specified camio endpoints:

• https://incoming.integrations.camio.com/pacs/webhooks
• https://incoming.integrations.camio.com/pacs/devices

As well as the following ABC Fitness API endpoints:

• https://api.abcfinancial.com/rest/{clubNumber}/clubs/checkins/details 
• https://api.abcfinancial.com/rest/{clubNumber}/members 

Note: These rules only cover the Camio Gateway. If you are setting up K8s for the first time you may need to set up additional firewall rules.

Enabling Tailgating Notifications

Optionally, enable Camio to send notifications via email when a tailgating incident occurs. To enable this feature, toggle tailgating notifications on and configure an email body.

1. Toggle tailgating notifications on
2. Configure the email settings including options for CC, BCC, reply-to, and the email body itself. 
   • Detail on the email body template variables can be found here.
   • You can customize the email body or select Use Default Tailgaters Email to use the default template. Optionally, you can use the Default Reviewer Email and the emails will be sent only to the account owner and any configured CC/BCCs, and not to the tailgaters themselves.

Removing Camera to Station Mappings

You can update which cameras you have mapped to your ABC Fitness stations on the settings page at https://camio.com/settings/integrations/pacs. To remove the currently mapped station, click on the station in the dropdown list or click the x next to the station name:

Alternatively, select a new station.

If your camera was mapped to an old station that is no longer in your list of ABC Fitness stations, the station dropdown may appear blank:

To remove the old station, select and then deselect a new station from the dropdown. This will clear the old station. The dropdown should then look like this:

Make sure you click save to confirm the changes.