This repository contains the code for a smart shared lock IoT application. The application is designed for multiple users to access a shared space (such as a house, Airbnb, hotel, or bank) using a smart lock with a 4-step authorization process. Users can also register new authorized users to the system. In addition, the application provides a joint lock service, which requires multiple users to authenticate together to open the lock.
- 4-step authorization process:
- PIN entry (SHA-256 hashed on the backend)
- Face authorization (only authorized users can access the smart lock)
- Voice authentication (users must speak their password; converted to text, hashed, and matched against passwords in the config database)
- Biometric authorization (fingerprint matching)
- New user registration
- Activity reporting: If anyone tries to open the system and fails, a report of the activity is generated along with their photo and biometric fingerprint. This information is shared with all authenticated users via email.
- Joint lock service: Requires multiple users (n=2 or more) to authenticate together to open the lock.
- Clone the repository to your local machine: git clone https://github.com/vatsalchheda/CS437-Final-Project.git
- Install the required dependencies: pip install -r requirements.txt
- Integrate the sensors (web-camera, microphone, LED, biometric fingerprint) with raspberry pi 4
- Configure the application by updating the
config.pyfile with your own settings (e.g., emails, password hashes, SMTP server, API keys, etc.). - Run the main script: python driver.py
- Users can enter their PIN on the device or through a connected interface to initiate the authorization process.
- The device will prompt users for face authorization. Users should position their face in front of the camera to proceed.
- Users will be prompted for voice authentication. They should speak their password, and the application will convert their speech to text, hash it, and match it against the stored passwords in the config database.
- Lastly, users must provide biometric authorization by placing their finger on the fingerprint sensor.
- If all 4 steps are successfully completed, the user gains access to the shared space.
- To register a new user, follow the on-screen instructions after successfully completing the authorization process.
- For joint lock access, authorized users should follow the same 4-step authorization process one after the other within the allowed time window.
- Adding a new user
- Intruder
- Total lines of code: 912
- Total files: 11 (excluding directories)
- Main languages used: Python
Pull requests are welcome. Please ensure that your changes do not break the existing functionality of the application.