Updating secure notebook tut.

ellisonbg · ellisonbg · commit e6bb3b2147a4 · 2013-06-24T11:00:13.000-05:00
diff --git a/notebooks/Running a Secure Public Notebook.ipynb b/notebooks/Running a Secure Public Notebook.ipynb
@@ -19,8 +19,10 @@
      "cell_type": "markdown",
      "metadata": {},
      "source": [
-      "Sometimes you want to run a notebook on a publicly visible interface.\n",
-      "Since the notebook lets you run arbitrary code as you, an HTTP connection with no authentication isn't exactly wise."
+      "Sometimes you want to run a notebook on a publicly visible network interface.\n",
+      "Since the notebook lets you run arbitrary code as you, an HTTP connection with no authentication isn't exactly wise.\n",
+      "This Notebook shows you how to run the IPython Notebook server to allow **trusted users** to access the Notebook\n",
+      "on a remote, public server. **Untrusted users should never be given access to the Notebook.**"
      ]
     },
     {
@@ -35,9 +37,7 @@
      "cell_type": "markdown",
      "metadata": {},
      "source": [
-      "For this, the IPython Notebook can be secured with a simple password,\n",
-      "which you add to your config files.  You don't put the password itself into you config file,\n",
-      "rather the salted / hashed password generated by `IPython.lib.passwd`"
+      "First, the IPython Notebook should be secured with a password, which you add to your config files.  You don't put the password itself into you config file, rather the salted / hashed password generated by `IPython.lib.passwd`:"
      ]
     },
     {
@@ -53,13 +53,13 @@
      "outputs": [
       {
        "output_type": "pyout",
-       "prompt_number": 4,
+       "prompt_number": 1,
        "text": [
-        "'sha1:12600d61acf2:3870d364759e268bc7076fd8843cdff1e2f1b683'"
+        "'sha1:3d850b8981b3:73ccd5b832d131d9e30aa4cee84f7e619a154b15'"
        ]
       }
      ],
-     "prompt_number": 4
+     "prompt_number": 1
     },
     {
      "cell_type": "markdown",
@@ -76,8 +76,18 @@
      ],
      "language": "python",
      "metadata": {},
-     "outputs": [],
-     "prompt_number": 6
+     "outputs": [
+      {
+       "output_type": "stream",
+       "stream": "stdout",
+       "text": [
+        "[ProfileCreate] Generating default config file: u'/Users/bgranger/.ipython/profile_nbssl/ipython_config.py'\r\n",
+        "[ProfileCreate] Generating default config file: u'/Users/bgranger/.ipython/profile_nbssl/ipython_qtconsole_config.py'\r\n",
+        "[ProfileCreate] Generating default config file: u'/Users/bgranger/.ipython/profile_nbssl/ipython_notebook_config.py'\r\n"
+       ]
+      }
+     ],
+     "prompt_number": 2
     },
     {
      "cell_type": "markdown",
@@ -106,9 +116,9 @@
      "cell_type": "markdown",
      "metadata": {},
      "source": [
-      "Now that we have secured our notebook with a password,\n",
-      "we probably want to encrypt traffic with HTTPS.\n",
-      "To run the notebook over https, we need to generate a key and self-signed certificate:\n",
+      "Now that we have secured our notebook with a password, we need to encrypt traffic with HTTPS.\n",
+      "To run the notebook over HTTPS, we need to generate a key and self-signed certificate. Run the following in the \n",
+      "`nbssl` profile directory:\n",
       "    \n",
       "    \n",
       "    openssl req -x509 -nodes -days 365 -newkey rsa:1024 -keyout mycert.key -out mycert.crt"
@@ -130,7 +140,7 @@
     },
     {
      "cell_type": "heading",
-     "level": 1,
+     "level": 2,
      "metadata": {},
      "source": [
       "A public notebook"
@@ -156,7 +166,7 @@
     },
     {
      "cell_type": "heading",
-     "level": 1,
+     "level": 2,
      "metadata": {},
      "source": [
       "--no-browser"
@@ -167,15 +177,32 @@
      "metadata": {},
      "source": [
       "When you are starting the notebook on a remote server (or just in general),\n",
-      "you may not want to launch the browser as well.  For this, you can add at the command-line:\n",
+      "you may not want to launch the browser automatically.  For this, you can add at the command-line:\n",
       "\n",
-      "    $> ipython notebook --no-browser\n",
+      "    $ ipython notebook --no-browser\n",
       "\n",
       "Or, to set this as your permanent default, add to you `ipython_notebook_config.py`:\n",
       "\n",
       "    c.NotebookApp.open_browser = False"
      ]
     },
+    {
+     "cell_type": "heading",
+     "level": 2,
+     "metadata": {},
+     "source": [
+      "Running the Notebook"
+     ]
+    },
+    {
+     "cell_type": "markdown",
+     "metadata": {},
+     "source": [
+      "To start the Notebook server using this profile, run the following:\n",
+      "\n",
+      "    $ ipython notebook --profile=nbssl"
+     ]
+    },
     {
      "cell_type": "code",
      "collapsed": false,
