This package consumes the following services:
Hydrogen Auth Plugin
A brute-force approach to remote gateway authentication.
This package for Atom, is a plugin for Hydrogen.
It allows connecting to password-protected notebook servers and gateways. However, the approach taken to achieve this involves some heavy monkey-patching. There is no guarantee that it won't break other atom packages.
Please note that notebook servers with self-signed certificates are not supported, due to the default security policy in nodejs/Atom.
How to use
- Make sure the gateway or notebook server you are connected to is part of your hydrogen
gateways
config. - Activate the
hydrogen
package (by running any command in that package). - Run the Hydrogen Auth: Login to Gateway command and select your gateway.
- Double-check that the login URL specified is correct, and then input your password.
- Now run Hydrogen: Connect to Remote Kernel. If the password you entered was correct, you will be prompted to create or select a session. If your login did not succeed, you will instead be given an error message.
Troubleshooting
- "Hydrogen v1.0.0+ has to be running": this may signal that you don't have the right version of
hydrogen
installed. It may also mean that you have not yet activated thehydrogen
package (to activate it, run any command belonging to the package) - Connecting to the gateway fails, even after entering a login: Please make sure that the notebook server is running, and that the login URL and password are correct.
- Self-signed certificates are not supported. Consider using Let's Encrypt for public servers, and alternative authentication (e.g. SSH tunneling or http basic auth via nginx proxy) for private servers.
TODO
The following features are currently unsupported. (Though patches are welcome!)
- Support for multi-user notebook servers
- Figure out a user-configurable method of adding trusted certificates (or wait for node.js to support using the system certificate store)
- Integrate code from this package into
@jupyterlab/services
andhydrogen
, such that a separate package is not necessary.