¶ Requirements to receive an xDoor-Key
¶ Membership
There are two requirements to getting an xDoor-key.
- You must be a member of x-hain.
- You must have at least 3 members with keys who know you to vouch for you.
You can request a key, for now, on our weekly meetings on Wednesdays. You can read more about them here: https://wiki.x-hain.de/en/Governance
¶ Your vaccination status
- You must be fully vaccinated, i.e. 2x vaccinated OR recovered+vaccinated, with the last vaccination at least 15 days ago.
¶ You are responsible for all persons present without their own xDoor-Key.
You basically have two options:
- Either: You always lock the entrance door after yourself as soon as you have entered or left the space.
- Or: You keep an eye on the door and check the vaccination status of all persons entering the Space. Only fully vaccinated persons (2x vaccinated or recovered+vaccinated) over the age of 12 are allowed to enter xHain while wearing an FFP2 mask. More details in our hygiene concept.
- In addition, you are responsible for the actions of these persons. This means: Do not leave people unattended (e.g. in another room) if you do not know or trust them.
- When you leave xHain everyone has to leave xHain with you, except for members who have their own xDoor key. (If you are unsure, ask them to show you how they lock/unlock the door with their mobile phone).
¶ Always leave xHain tidy and clean.
- Always leave xHain cleaner than you found it. Always clear all workspace areas and tables before you leave.
- Take out the rubbish when bins are full.
¶ Summary
You will only get a key if we trust you to follow our hygiene rules and if you are confident enough to check other people and also ask them to leave if necessary. If you are not comfortable with the latter, please always lock the door behind you.
¶ about xDoor
We have an electronically controlled front door at xHain. With xDoor you can lock and unlock the front door. Once you have been granted key access by our "Schlüsselkinder" (latch-key members), you can then connect your smartphone with xDoor as follows.
xDoor is an electronically controlled mechanism, which turns the key with a motor. You can manually unlock (upper button) or lock (lower button) the door by pressing the buttons. When leaving the space you can lock the door behind you by pulling the door almost shut, reach inside to press the "lock" button and quickly pull the door fully shut.
- Wait a few moments for the motor to finish its movement. Then check if the door is actually locked.
Caution! DO NOT pull the door handle or keep it pulled down while the door mechanism is in motion. This will put the door into a deadlock position which can only be resolved by using a regular hardware key. (Contact @felix if this happens.)
¶ Hardware
Hardware documentation can be found on github.
¶ App Setup for xDoor
¶ Android
-
install the app "ConnectBot" (fdroid, google play store)
-
start the app. Click on menu > Manage Pubkeys
- Name: xDoor, Type: select "ed25519"
- click on "generate" (at very bottom)
- draw random wild pattern on the field
-
long press on key (xDoor) > "copy public key"
- Login to https://login.x-hain.de/if/user/#/settings and paste the key from the clipboard into the ssh-key field and hit save. The approval can take a bit and the keys will update over night.
-
on app homescreen: tap on plus-symbol to create new host
- Username ("username@hostname:port"): open@xdoor
- nickname: open
- "use pubkey authentification": select xDoor key
- activate: "close on disconnect"
- save (symbol at top right, "save host")
In case you get a connection error with the port "xDoor", try xdoor.lan.xhain.space instead
- repeat steps to create another host
- username: close@xdoor
- nickname: close
- activate: "close on disconnect"
- save (symbol at top right, "save host")
- save (top right)
- Once you have received the confirmation that your public key has been entered into our system (it may take a few days), you can now lock and unlock the door as follows:
- Connect your phone with the xHain Wifi (not the guest wifi!) (you may have to disable mobile data connections to force the app to use the wifi. If you have a firewall you may also revoke acces to the mobile data connection for the app).
- Tap on "open" or "close" on the home screen of the app to unlock or lock the xDoor
In case you get a connection error with the port "xDoor", try xdoor.lan.xhain.space instead
¶ iOS
¶ Shortcuts (iOS native)
- download the Shortcut
- select the 'Run script over SSH' action (small blue arrow)
[
] - click on the 'key' property
[
] - press 'Share Public Key' and copy your key
- Login to https://login.x-hain.de/if/user/#/settings and paste the key from the clipboard into the ssh-key field and hit save. The approval can take a bit and the keys will update over night.
- the first time you run the script you'll be asked to allow scripts to be run through the shortcuts app
- bonus: in the main shortcuts menu press and hold the shortcut, select 'Share' and 'Add to Homescreen'. You can choose a custom name and Icon, to be displayed on your home screen
¶ Termius
Connecting to the xDoor with an iPhone can be done with the terminus app. No iOS user has documented it yet.
¶ Changing your key (new phone who this?)
Login to https://login.x-hain.de/if/user/#/settings and paste the key from the clipboard into the ssh-key field and hit save. The keys will update over night.