Doc: enable SSL verification inside Grid'5000

README.org

@@ -62,8 +62,11 @@ conform with the Grid5000 API models (with an 's'!)
   easily test and adapt them.
 
 - The configuration is read from a configuration file located in the home
-  directory (should be compatible with the restfully one). 
-  It can be created with the following:
+  directory (should be compatible with the restfully one). It can be created
+  with the following:
+
+- When accessing the API from outside of Grid'5000 (e.g your local workstation),
+  you need to specify the following configuration file:
 
 #+BEGIN_EXAMPLE
 echo '
@@ -72,10 +75,15 @@ password: MYPASSWORD
 ' > ~/.python-grid5000.yaml
 #+END_EXAMPLE
 
-#+BEGIN_hint
-From a Grid'5000 frontend this file is optionnal. In all other cases the
-configuration file is mandatory.
-#+END_hint
+- When accessing the API from a Grid'5000 frontend, providing the username and
+  password is optionnal. Nevertheless you'll need to deal with SSL verification
+  by specifying the path to the certificate to use:
+
+#+BEGIN_EXAMPLE
+echo '
+verify_ssl: /etc/ssl/certs/ca-certificates.crt
+' > ~/.python-grid5000.yaml
+#+END_EXAMPLE
 
 - Using a virtualenv is recommended (python 3.5+ is required)
 

README.rst

@@ -64,8 +64,11 @@ conform with the Grid5000 API models (with an ’s’!)
   easily test and adapt them.
 
 - The configuration is read from a configuration file located in the home
-  directory (should be compatible with the restfully one). 
-  It can be created with the following:
+  directory (should be compatible with the restfully one). It can be created
+  with the following:
+
+- When accessing the API from outside of Grid’5000 (e.g your local workstation),
+  you need to specify the following configuration file:
 
 ::
 
@@ -74,10 +77,15 @@ conform with the Grid5000 API models (with an ’s’!)
     password: MYPASSWORD
     ' > ~/.python-grid5000.yaml
 
-.. hint::
+- When accessing the API from a Grid’5000 frontend, providing the username and
+  password is optionnal. Nevertheless you’ll need to deal with SSL verification
+  by specifying the path to the certificate to use:
+
+::
 
-    From a Grid’5000 frontend this file is optionnal. In all other cases the
-    configuration file is mandatory.
+    echo '
+    verify_ssl: /etc/ssl/certs/ca-certificates.crt
+    ' > ~/.python-grid5000.yaml
 
 - Using a virtualenv is recommended (python 3.5+ is required)