diff --git a/Documentation/teachinghub-authenticator.png b/Documentation/teachinghub-authenticator.png new file mode 100644 index 0000000000000000000000000000000000000000..6aae3394e097459fb0038b7168b1d654e2ddcf7f Binary files /dev/null and b/Documentation/teachinghub-authenticator.png differ diff --git a/Documentation/teachinghublogin.png b/Documentation/teachinghublogin.png new file mode 100644 index 0000000000000000000000000000000000000000..99e0f0d83b1e7d07616970ab53ff0fd2162d1328 Binary files /dev/null and b/Documentation/teachinghublogin.png differ diff --git a/Documentation/teachinghubnotebooks.png b/Documentation/teachinghubnotebooks.png new file mode 100644 index 0000000000000000000000000000000000000000..16d9fe6f0aa6db9a9b336f8eb810bbf3ccee6991 Binary files /dev/null and b/Documentation/teachinghubnotebooks.png differ diff --git a/Documentation/teachinghubnotebooks_kernels.png b/Documentation/teachinghubnotebooks_kernels.png new file mode 100644 index 0000000000000000000000000000000000000000..16346d8ae88819470a1e8b71f239af694f72298e Binary files /dev/null and b/Documentation/teachinghubnotebooks_kernels.png differ diff --git a/Documentation/techinghub-qrcode.png b/Documentation/techinghub-qrcode.png new file mode 100644 index 0000000000000000000000000000000000000000..3e51ad7d5729e2eabd6105c9026b49af33dbcd4b Binary files /dev/null and b/Documentation/techinghub-qrcode.png differ diff --git a/README.md b/README.md index e46cb3960a69a6fe744ec3c75b7bb2ba29a81edc..8445bcf51af4b4d50f45721c67b3dc8629fef7e8 100644 --- a/README.md +++ b/README.md @@ -105,8 +105,9 @@ git/2.29.0-gcc-5.3.0 netcdf-fortran/4.5.3-gcc-5.3.0 ``` ### JupyterHub -[Goto SRVX1-Jupyterhub](https://srvx1.img.univie.ac.at) -[Instructions SRVX1-Teaching Hub](TeachingHub.md) +Direct Access: [Goto SRVX1-Jupyterhub](https://srvx1.img.univie.ac.at) + +Follow the instructions to get access: [Instructions SRVX1-Teaching Hub](TeachingHub.md) ## Information on SRVX2 - Compute Computing Node @UZA2 diff --git a/TeachingHub.md b/TeachingHub.md index dc1291c16cd25496d74e1576afaddac69997e8ff..bf92a9bb7822d20912d397d10ae71a5f499c5fdf 100644 --- a/TeachingHub.md +++ b/TeachingHub.md @@ -1,17 +1,20 @@ # Teaching Hub @ IMGW -Address: [Teaching Hub](https://srvx1.img.univie.ac.at) -Access to the Teaching Hub can be done only via a browser. -Access to SRVX1 via a terminal (Putty,...) +<img src="https://jupyter.org/assets/hublogo.svg" width="300px"> + +- Address: [Teaching Hub](https://srvx1.img.univie.ac.at) +- Access to the Teaching Hub can be done only via a browser. +- Access to SRVX1 via a terminal (Putty,...) + [[_TOC_]] ## How to get access? -Usually your teacher is going to sign you up and you will recieve one or two emails containing information on how to login. +Usually **your teacher** is going to **sign you up** and you will recieve one or two emails containing information on how to login. You will recieve access to the Teaching Hub usually for 6 month. Can be extended for good reasons or until a teacher signs you up again. -### You recieved two Emails -This means you are new to the servers and the teaching hub. +## You recieved two Emails +This means you are new to the SERVERS and the Teaching Hub. The first email contains your login details for SRVX1, you get a username (Matrikelnumber) and a password. It looks like this: ``` @@ -34,8 +37,74 @@ Account expires: 2021-08-30 ``` Use these to login to the server and change the password to something better and still something that is safe: ``` -ssh [user]@srvx1.img.univie.ac.at +$ ssh [user]@srvx1.img.univie.ac.at +---------------------------------------------- + _ + (` ). + ( ). +) _( SRVX1 '`. + .=(`( . ) .-- + (( (..__.:'-' .+( ) +`. `( ) ) ( . ) + ) ` __.:' ) ( ( )) +) ) ( ) --' `- __.' +.-' (_.' .') + (_ ) + 131.130.157.5 +--..,___.--,--'`,---..-.--+--.,,-,,.-..-._.-.- +---------------------------------------------- +Teaching Server @IMGW +Environmental Modules: module av +Jupyterhub: https://srvx1.img.univie.ac.at +Usage Profile: Students +---------------------------------------------- + +$ passwd +Changing password for user [user]. +Changing password for [user]. +(current) UNIX password: +``` +After you completed these steps you are free to login anytime and use the server. +The second email contains your Teaching Hub credentials. See below. + +## You recieved one Email +the email you recieved contains credentials for the Teaching Hub. This email contains your username (the same as on SRVX1 for login), a new password (only for the Teaching Hub) and a secret (16 digit code). They look like this: +``` +Dear TeachingHub User Monkey +Some of your user information has been updated. + +TeachingHub Account Specification: +servers: https://srvx1.img.univie.ac.at +username: monkey +password: ABCDEFGHIJK (signed in, click on user name, upper right corner) +Email: a000000@univie.ac.at +Secret: 1A2B3C4D5E6F7G8H + +Please note that the TeachingHub is open from the web. +Two-factor Authentication is required. Download one of these apps and use your secret to generate TOTP (Time based One Time Passwords). +Authy (https://authy.com/download/) +FreeOTP (https://freeotp.github.io/) +Google Auth (https://play.google.com/store/apps/details?id=com.google.android.apps.authenticator2) +... ``` +You need to download one of these apps: +- [Authy](https://authy.com/download/) +- [FreeOTP](https://freeotp.github.io/) +- [Google Auth](https://play.google.com/store/apps/details?id=com.google.android.apps.authenticator2) +- or any other (search `2fa apps` and you will find plenty) + +I recommend using your phone and an app there, as this is the most secure way. And with you phone you can scan the qr code, which looks like this: +<img src="Documentation/teachinghub-qrcode.png" width="300px"> + +When you scan to your Authenticator App, it will automatically get the details (username, Secret) required to generate every 30 seconds a Time-based One Time Password (TOTP). Like this: + + +The combination of username, password and TOTP needs to be used to sign in: + + +This sounds all really complicated, but I promise this will be easier from time to time. Don't forget that this for our all security and your contribution is appreciated! Thanks. + +