Hackspace Access Control System

An Android app for our "keyholder" to view and manage the door states.

It uses an mqtt service to get the current status and sends door commands per ssh.

Create keystore with cert for the mqtt connection

We need a Android compatible keystore with the endpoint's ssl certificate in it. Download the bcprov-ext-jdk14-1.53.jar, e.g. from here and run:

echo -n | openssl s_client -connect mainframe.io:8883 | sed -ne '/-BEGIN CERTIFICATE-/,/-END CERTIFICATE-/p' > mqtt_mainframe.io.crt
keytool -import -trustcacerts -keystore hacs_keystore.bks -storepass keystorepw -noprompt -alias mqtt_mainframe -file mqtt_mainframe.io.crt -storetype BKS -providerClass org.bouncycastle.jce.provider.BouncyCastleProvider -providerpath bcprov-ext-jdk14-1.53.jar

Copy the resulting hacs_keystore.bks to the src/main/assets/keystore/ folder.

ssh keys

Must start with mf-door. and end with .key and must have a password.

Download

TODO

• Save passwords more secure, e.g. https://developer.android.com/samples/BasicAndroidKeyStore/index.html

Libs

• https://www.eclipse.org/paho/clients/android/
  • mqtt fix for Android 12: eclipse/paho.mqtt.android#485 (comment)
• https://github.com/googlesamples/easypermissions
• https://github.com/ACRA/acra.git
• http://www.jcraft.com/jsch/

Helpful!

• http://www.hivemq.com/blog/mqtt-client-library-enyclopedia-paho-android-service
• https://developer.android.com/training/scheduling/alarms#java

Acknowledgements

• The 3 led buttons come from https://openclipart.org/user-cliparts/bnielsen