{"id":6417,"date":"2020-06-08T21:46:58","date_gmt":"2020-06-08T18:46:58","guid":{"rendered":"https:\/\/xn--jyvskyl-7wae.hacklab.fi\/?page_id=6417"},"modified":"2025-09-08T22:04:47","modified_gmt":"2025-09-08T19:04:47","slug":"electronic-locking-system","status":"publish","type":"page","link":"https:\/\/xn--jyvskyl-7wae.hacklab.fi\/en\/our-space\/electronic-locking-system\/","title":{"rendered":"Electronic Locking System"},"content":{"rendered":"\r\n

The Hacklab\u2019s exterior doors are primarily unlocked via the mobile app following this guide. If you cannot or prefer not to use the app, you can also open the doors by phone using a PIN code. In those cases, the membership coordinator will provide separate instructions. See more on Key Member Guide<\/a> for details.<\/p>\r\n\r\n\r\n\r\n

Usage Instructions<\/h2>\r\n\r\n\r\n\r\n

The electronic locking system relies on SSH authentication. You may use any SSH client to unlock the doors. Below are detailed examples for two Android clients. In summary, setup works like this:<\/p>\r\n\r\n\r\n\r\n

    \r\n
  1. Generate an SSH key (or use an existing key).<\/li>\r\n\r\n\r\n\r\n
  2. Send your public key to the membership coordinator or server administrator.<\/li>\r\n\r\n\r\n\r\n
  3. Log in with your chosen SSH client to hackbus@lab.jkl.hacklab.fi using your SSH key.<\/li>\r\n\r\n\r\n\r\n
  4. The doors will unlock for 30 seconds after you successfully authenticate.<\/li>\r\n<\/ol>\r\n\r\n\r\n\r\n

    If that sounds too complex, don\u2019t worry\u2014you can get hands-on help at the club!<\/p>\r\n\r\n\r\n\r\n

    TL;DR for Geeks:
    ssh-keygen -t ed25519<\/code>
    cat ~\/.ssh\/id_ed25519.pub<\/code>
    ssh hackbus@lab.jkl.hacklab.fi<\/code><\/p>\r\n\r\n\r\n\r\n

    Access During an Internet Outage<\/h2>\r\n\r\n\r\n\r\n

    The club space has Internet service over two separate links\u2014Lounea (lab.jkl.hacklab.fi<\/code>) and Telia (varalab.jkl.hacklab.fi<\/code>). If both connections fail, you can try opening the doors directly over the local network. Replace lab.jkl.hacklab.fi<\/code> with its IP address 10.0.0.1<\/code> and retry while connected to the club\u2019s Wi-Fi. If that still doesn\u2019t work, there\u2019s likely a fault in the automation system or other infrastructure. In that case, reach out to us via our group chat channel for assistance.<\/p>\r\n\r\n

     <\/p>\r\n\r\n

    Example 1: ConnectBot<\/h2>\r\n\r\n\r\n\r\n

    ConnectBot is a free, open-source SSH client for Android. You can download it from F-Droid<\/a> or Google Play Store<\/a>.<\/p>\r\n\r\n\r\n\r\n

    \r\n
    \"\"<\/figure>\r\n
    \r\n

    Create a new SSH key Open Manage Pubkeys and tap the \u201c+\u201d in the top-right corner.<\/p>\r\n<\/div>\r\n<\/div>\r\n

     <\/p>\r\n\r\n\r\n\r\n

    \r\n
    \"\"<\/figure>\r\n
    \r\n

    Name and configure the key Give it any name you like. Change the type to Ed25519, as it\u2019s considered the most secure algorithm among the options.<\/p>\r\n\r\n\r\n\r\n

    Skip the passphrase We don\u2019t recommend adding a passphrase to the key\u2014your phone itself should be locked, not this single key.<\/p>\r\n\r\n\r\n\r\n

    Tap Generate, then follow the on-screen prompt to move your finger around the display to seed the key.<\/p>\r\n\r\n\r\n\r\n

    Protect your private key Never share the private half of your key with anyone!<\/strong> The public half is not sensitive.<\/p>\r\n<\/div>\r\n<\/div>\r\n\r\n\r\n\r\n

    \r\n
    \"\"<\/figure>\r\n
    \r\n

    Add a new host Go back to the Hosts view and tap the \u201c+\u201d in the bottom-left corner. Enter hackbus@lab.jkl.hacklab.fi<\/strong> and enable Use pubkey authentication, selecting the key you just created.<\/p>\r\n<\/div>\r\n<\/div>\r\n\r\n\r\n\r\n

    \r\n
    \"\"<\/figure>\r\n
    \r\n

    Send your public key In Pubkeys, long-press your newly created key, choose Copy public key, and send it via private message on Matrix or Telegram to the membership or server coordinator. As a last resort, email it to the board<\/a>.<\/p>\r\n<\/div>\r\n<\/div>\r\n\r\n\r\n\r\n

    \r\n
    \"\"<\/figure>\r\n
    \r\n

    Unlock the doors Once you receive confirmation that your key has been added, simply tap the connection in ConnectBot. No commands are needed; the session will close automatically after the doors open.<\/p>\r\n\r\n\r\n\r\n

    Verify the fingerprint On your first connection, you\u2019ll see a warning. Confirm that the server fingerprint matches the one shown in the screenshot\u2014this ensures you\u2019re indeed connecting to the Hacklab server.<\/p>\r\n<\/div>\r\n<\/div>\r\n\r\n\r\n\r\n

    Example 2: JuiceSSH<\/h2>\r\n\r\n\r\n\r\n

    JuiceSSH<\/a> is a free SSH client available on the Google Play Store for Android.<\/p>\r\n\r\n\r\n\r\n

    \r\n
    \"\"<\/figure>\r\n
    \r\n

    Aloita valitsemalla “Open Manage Connections and tap the \u201c+\u201d in the bottom-right corner.<\/p>\r\n<\/div>\r\n<\/div>\r\n\r\n\r\n\r\n

    \r\n
    \"\"<\/figure>\r\n
    \r\n

    Give the connection any name, set the address to “lab.jkl.hacklab.fi<\/strong>” then tap “Identity \u2192 New\u2026” to create a user identity.<\/p>\r\n<\/div>\r\n<\/div>\r\n\r\n\r\n\r\n

    \r\n
    \"\"<\/figure>\r\n
    \r\n

    Choose any name for your identity, but set the username to “hackbus”. Create a new SSH key under Private Key.<\/p>\r\n<\/div>\r\n<\/div>\r\n\r\n\r\n\r\n

    \r\n
    \"\"<\/figure>\r\n
    \r\n

    Generate your SSH key. SSH uses a public\/private key pair. Public key is given to the server (Hacklab) and private key is kept as a secret. This key replaces a password and is far more secure.<\/p>\r\n\r\n\r\n\r\n

    Skip the passphrase We don\u2019t recommend adding a passphrase \u2014 your phone should have the lock, not this key.<\/p>\r\n\r\n\r\n\r\n

    Protect your private key Never share your private key with anyone!<\/strong> The public key is fine to share.<\/p>\r\n<\/div>\r\n<\/div>\r\n\r\n\r\n\r\n

    \r\n
    \"\"<\/figure>\r\n
    \r\n

    Review connection settings. Your host entry should now show address, username, and the selected private key.<\/p>\r\n<\/div>\r\n<\/div>\r\n\r\n\r\n\r\n

    \r\n
    \"\"<\/figure>\r\n
    \r\n

    The final step is to send your public key to the Hacklab server. Copy the key by going to the \u201cIdentities\u201d tab, long-pressing \u201cHackbus,\u201d and selecting \u201cExport Public Key.\u201d .<\/p>\r\n\r\n\r\n\r\n

    Send it via private message on Matrix or Telegram to the membership or server coordinator, or email the board<\/a> as a last resort.<\/p>\r\n<\/div>\r\n<\/div>\r\n\r\n\r\n\r\n

    \r\n
    \r\n

    The electronic door opening is active once you\u2019ve received confirmation that your key has been added. Opening is as simple as tapping the connection. You don\u2019t need to type any commands into the terminal that appears, and the connection will close itself shortly after the doors have opened.<\/p>\r\n\r\n\r\n\r\n

    On your first connection, you\u2019ll receive a server authentication warning. The fingerprint should be SHA256:lq7yNwXYccQMPEqAoTKs\/zeWRJ8NYVm69nHouF4\/qvY. This fingerprint verifies that the server you\u2019re connecting to is indeed the Hacklab server.<\/p>\r\n\r\n\r\n\r\n

    Example 3: a-Shell (iOS)<\/h2>\r\n\r\n\r\n\r\n

    a-Shell<\/a> is an open-source terminal emulator for Apple mobile devices. There\u2019s also a \u201cmini\u201d version, which strips out extra features to save space\u2014this mini app includes everything we need, so you can install it if you don\u2019t need a full-blown terminal emulator for other tasks.<\/p>\r\n

    To create your SSH key, run the same nerdy command introduced earlier: ssh-keygen -t ed25519<\/code>.<\/p>\r\n

    Do not give your key a name, so that SSH tools will always find it. And do not assign a passphrase, because your device should be secure, not an individual key. You should skip both the name and passphrase prompts by pressing Enter three times.<\/p>\r\n

    This command created a private key, which is used when establishing the connection, and a public key, which you can share with others to say something like \u201cHey, with this you can identify me!\u201d<\/p>\r\n

    \"\"<\/p>\r\n

    Use the command cat .ssh\/id_ed25519<\/code> to print your public .pub key in the terminal for copying. Double-tap the text in the terminal to select it for easy copying. Make sure you copy your public key\u2014not your private one\u2014by verifying that the key begins with ssh-ed25519 rather than —–BEGIN OPENSSH PRIVATE KEY—–.<\/p>\r\n

    \"\"<\/p>\r\n

    Send your public key via private message on Matrix or Telegram to the membership coordinator or server administrator. As a last resort, you may email it to the board<\/a>.<\/p>\r\n

    Door unlocking via SSH is enabled once you\u2019ve received confirmation that your key has been added. To test the connection (while standing by the door or with someone already inside), run: ssh hackbus@lab.jkl.hacklab.fi<\/code>.<\/p>\r\n

    \"\"<\/p>\r\n

    On your first connection, you\u2019ll see a server verification warning. The fingerprint should match SHA256:lq7yNwXYccQMPEqAoTKs\/zeWRJ8NYVm69nHouF4\/qvY. This fingerprint confirms that the server you\u2019re connecting to is indeed the Hacklab server. The connection will close itself shortly after the doors have opened.<\/p>\r\n

    a-Shell also supports iOS Shortcuts. Using it, you can make door unlocking as easy as tapping an icon on your Home screen.<\/p>\r\n

    Open the Shortcuts app and tap the plus icon to create a new shortcut.<\/p>\r\n

    \"\"<\/p>\r\n

    Name your shortcut by tapping the dropdown menu in the center of the top bar and entering a new name\u2014 for example, \u201cOpen Door.\u201d<\/p>\r\n

    \"\"<\/p>\r\n

    Search for \u201ca-Shell\u201d by typing its name into the search bar at the bottom. From the list of available actions, select Execute Command<\/strong>.<\/p>\r\n

    \"\"<\/p>\r\n

    In the Execute Command field, enter the exact SSH command you used to test access: ssh hackbus@lab.jkl.hacklab.fi<\/code><\/p>\r\n

    \"\"<\/p>\r\n

    If you don\u2019t want to see the terminal, expand the Execute action via the arrow icon and uncheck Show While Running. Show while running<\/code>.<\/p>\r\n

    \"\"<\/p>\r\n

    If you want to see the terminal input and have the app close after the command runs, long-press the yellow Execute icon. Duplicate the action, and set the command to just\u00a0output<\/code>.<\/p>\r\n

    \"\"<\/p>\r\n

    \"\"<\/p>\r\n

    Tap Done in the top right. Now add the shortcut to your Home Screen by long-pressing an icon or empty area, tapping the plus icon in the top left, searching for Shortcuts, and selecting your shortcut from the carousel. Once the Shortcuts widget is on your Home Screen, you no longer need to launch the terminal or type any commands to open the doors.<\/p>\r\n

    \"\"<\/p>\r\n

    \"\"<\/p>\r\n<\/div><\/div>\r\n\r\n\r\n\r\n

     <\/p>\r\n<\/div>","protected":false},"excerpt":{"rendered":"

    The Hacklab\u2019s exterior doors are primarily unlocked via the mobile app following this guide. If you cannot or prefer not to use the app, you can also open the doors by phone using a PIN code. In those cases, the membership coordinator will provide separate instructions. See more on Key Member Guide for details. Usage […]<\/p>\n","protected":false},"author":31,"featured_media":0,"parent":4858,"menu_order":2,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_acf_changed":false,"_import_markdown_pro_load_document_selector":0,"_import_markdown_pro_submit_text_textarea":"","footnotes":""},"class_list":["post-6417","page","type-page","status-publish","hentry"],"acf":[],"_links":{"self":[{"href":"https:\/\/xn--jyvskyl-7wae.hacklab.fi\/en\/wp-json\/wp\/v2\/pages\/6417"}],"collection":[{"href":"https:\/\/xn--jyvskyl-7wae.hacklab.fi\/en\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/xn--jyvskyl-7wae.hacklab.fi\/en\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/xn--jyvskyl-7wae.hacklab.fi\/en\/wp-json\/wp\/v2\/users\/31"}],"replies":[{"embeddable":true,"href":"https:\/\/xn--jyvskyl-7wae.hacklab.fi\/en\/wp-json\/wp\/v2\/comments?post=6417"}],"version-history":[{"count":28,"href":"https:\/\/xn--jyvskyl-7wae.hacklab.fi\/en\/wp-json\/wp\/v2\/pages\/6417\/revisions"}],"predecessor-version":[{"id":6446,"href":"https:\/\/xn--jyvskyl-7wae.hacklab.fi\/en\/wp-json\/wp\/v2\/pages\/6417\/revisions\/6446"}],"up":[{"embeddable":true,"href":"https:\/\/xn--jyvskyl-7wae.hacklab.fi\/en\/wp-json\/wp\/v2\/pages\/4858"}],"wp:attachment":[{"href":"https:\/\/xn--jyvskyl-7wae.hacklab.fi\/en\/wp-json\/wp\/v2\/media?parent=6417"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}