Skip to content

Aporta is an open source physical access controller. The main purpose of the software is to secure doors from unauthorized access. This is accomplished by determining if a person is authorized to enter a door. The door is unlocked momentarily by the software when authorized credential are presented.

License

Notifications You must be signed in to change notification settings

bytedreamer/Aporta

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Aporta

Build Status

Aporta is an open source physical access controller. The main purpose of the software is to secure doors from unauthorized access. This is accomplished by determining if a person is authorized to enter a door. The door is unlocked momentarily by the software when authorized credential are presented.

Aporta doesn't intend to recreate what is already available by existing physical access controllers. The goal is to provide a level of flexibility that is not possible with existing closed physical access control systems. Below are the design considerations that are going to make Aporta truly versatile.

  • The software is written to be platform independent. This gives Aporta the ability to run on wide range of hardware. The same code runs on Windows, Mac, or Linux, even lower power devices such as Raspberry Pi.
  • Modularity is built into the architecture of the software. There will be the ability to add custom plugins for enhanced capabilities.
  • Open standards are embraced and built into the software.
  • Features are not to be restricted by licensing. All the software's capabilities are available without being overburden with expensive and confusing license terms.

Release Plan

The project is early in its development. After working on access control products for many years, my inclination is that there are a large number of features required for a viable access controller. The list below is an attempt to limit the feature targeted in the first release.

  • Easy installation (Done)
    • Windows installer (Done)
    • Debian packages (Done)
  • Self hosted web management
    • SSL required by default (Done)
    • A master password to gain access
  • OSDP Driver
    • Install new devices with security channel encryption (Done)
    • Process standard Wiegand card reads (Done)
    • Detect if device is online (Done)
    • Control output (Done)
    • Notify when input is tripped
  • Access Control
    • Enroll new cardholder (Done)
    • Basic access level assignment
    • Read entire card data for card number (Done)
    • Card number is a non-reversible hash (Done)
    • Log access events (Done)

Installation

Aporta has installers for both Windows and Linux Debian distributions.

Windows

64-bit Windows MSI Installer

Linux

DEB packages have been created both x64 and Arm processors.

  • amd64 for Intel and AMD 64-bit processors
  • armhf for older 32-bit Raspberry PIs
  • arm64 for Raspberry PIs 3+ and newer with 64-bit OS

Steps to install and run from Linux DEB packages

  • Run commands from a shell terminal
  • Install files by running the following command using the correct version of the package file
 sudo dpkg -i Aporta.linux-XXX.deb
  • Change directory to /opt/Aporta
  • The following command will run the Aporta server
sudo ./Aporta

Quick Start

After installing Aporta, browse to the local web url https://localhost:8443 to get started. A Quick Start Guide can be found in the Wiki section.

Configuration

appsettings.Production.json - Location for Aporta settings

{
    "EventLog": {
        "LogLevel": {
            "Default": "Information", -> configure default logging level
            "Microsoft": "Warning",
            "Microsoft.Hosting.Lifetime": "Information"
            }
    },
    "AllowedHosts": "*",
    "Kestrel": {
        "EndPoints": {
            "Https": {
              "Url": "https://*:8443" -> web site port number (check machine firewall settings if connecting remotely)
            }
        }
    }
}

Aporta Housekeeping

General information about configuring and setting up the Aporta project for development and running locally.

Aporta HouseKeeping

Aporta Core Abstractions and Concepts

A summary of all of the Core Abstractions and Concepts used in the Aporta code.

Documentation

About

Aporta is an open source physical access controller. The main purpose of the software is to secure doors from unauthorized access. This is accomplished by determining if a person is authorized to enter a door. The door is unlocked momentarily by the software when authorized credential are presented.

Topics

Resources

License

Stars

Watchers

Forks

Languages