Merge pull request #1084 from dhermes/add-simple-auth-doc

Basic beginning of authentication module.
googleapis · Aug 25, 2015 · ac13419 · ac13419
2 parents 5609a84 + 264b722
commit ac13419
Show file tree

Hide file tree

Showing 2 changed files with 27 additions and 0 deletions.
diff --git a/docs/gcloud-auth.rst b/docs/gcloud-auth.rst
@@ -0,0 +1,26 @@
+Authentication
+--------------
+
+Quick overview
+==============
+
+*   **If you're running in Compute Engine or App Engine**,
+    authentication should "just work".
+
+*   **If you're developing locally**,
+    the easiest way to authenticate is using the `Google Cloud SDK`_:
+
+    .. code-block:: bash
+
+        $ gcloud auth login
+
+.. _Google Cloud SDK: http://cloud.google.com/sdk
+
+
+*   **If you're running your application elsewhere**,
+    you should download a service account JSON keyfile
+    and point to it using an environment variable:
+
+    .. code-block:: bash
+
+        $ export GOOGLE_APPLICATION_CREDENTIALS="/path/to/keyfile.json"
diff --git a/docs/index.rst b/docs/index.rst
@@ -4,6 +4,7 @@
   :caption: gcloud
 
   gcloud-api
+  gcloud-auth
 
 .. toctree::
   :maxdepth: 0