iitm-network-auth-app's Introduction

IIT Madras Network Auth

Cross platform desktop application for authenticating Windows/Linux/Mac devices with IIT Madras campus network firewall. Built with electron.

Note: app works only inside IIT Madras campus network.
Please file bugs and feature requests at issues.

Installation

Download the latest release for your platform from GitHub Releases page.

Note: Windows and Mac systems might show some security warnings. Please override/ignore these restrictions and install the app, as these warnings occur due to not signing the executable, which requires buying a code-signing certificate.

Usage

Type in the username, password and click login.
Check save option to keep username and password in the system.
This will create a new session with IIT Madras network firewall.
The connectivity indicator below the IITM logo shows current status, whether connected or not.
Keep the application open to maintain the login session.
Use the logout button to terminate the session.
Note: each login session is valid for 10 minutes. The application refresh the session every 9 minutes. Hence, even if you close the application, the session maybe valid for at-most 10 minutes, unless you logout.
The app will automatically download and install updates on Windows and Mac.
New updates will be shown at the bottom, click that to download.

Privacy and Security

This application does not collect any personal information regarding the user.
The username and password used for authentication are stored locally, in order to automatically connect at startup.
The application may collect anonymous data for statistical purposes.
The application will occasionally contact the update server for checking and downloading updates.

Contributing

Pull requests and issues are most welcome.

The app is made using electron, and built with electron-builder using Travis CI for Linux/Mac builds and Appveyor CI for Windows builds.

Todo

Re-authentication on waking up from sleep.
Implement netaccess authentication.

Credits

License

MIT

iitm-network-auth-app's People

Contributors

Watchers

iitm-network-auth-app's Issues

[Linux] desktop file is lacking a Categories= entry

The desktop file is lacking a Categories= entry in the *.desktop file.

According to the menu spec,

By including one of the Main Categories in an application's desktop entry file, the application will be ensured that it will show up in a section of the application menu dedicated to this category. If multiple Main Categories are included in a single desktop entry file, the entry may appear more than once in the menu.

Hence, please add at least one of the following in the Categories= key.

Main Category	Description	Notes
AudioVideo	Application for presenting, creating, or processing multimedia (audio/video)
Audio	An audio application	Desktop entry must include AudioVideo as well
Video	A video application	Desktop entry must include AudioVideo as well
Development	An application for development
Education	Educational software
Game	A game
Graphics	Application for viewing, creating, or processing graphics
Network	Network application such as a web browser
Office	An office type application
Science	Scientific software
Settings	Settings applications	Entries may appear in a separate menu or as part of a "Control Center"
System	System application, "System Tools" such as say a log viewer or network monitor
Utility	Small utility application, "Accessories"