openstack-manuals/doc/user-guide/section_sdk_authenticate.xml
Lorin Hochstein 689de3f4e8 Add initial Python SDK docs to user guide
Initial addition of Python SDK content to user's guide. Describes
how an end-user can employ the Python bindings to automate tasks.

This initial commit adds info on:
 - How to authenticate with Identity, Commpute, Image, and Network
   clients
 - How to manage images

Change-Id: Ie8c4120acc7739c0bc4bddd99ffdbfbfbe241e0f
2013-12-30 11:02:57 -06:00

23 lines
1.2 KiB
XML

<?xml version="1.0" encoding="utf-8"?>
<section xmlns="http://docbook.org/ns/docbook"
xmlns:xi="http://www.w3.org/2001/XInclude"
xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0" xml:id="sdk_auth">
<title>Authentication</title>
<para>You must authenticate against an OpenStack endpoint before you can
use OpenStack services. Each project uses a slightly different syntax for doing
authentication.</para>
<para>You must typically authenticate against a specific version of
a service. For example, a client might need to authenticate
against the Identity Service v2.0.</para>
<para>Python scripts that use the OpenStack SDK must have access to the
credentials contained in the
<link linkend="cli_openrc">OpenStack RC file</link>. Because credentials
are sensitive information, do not include them in your scripts. This guide
assumes that users source the <filename>openrc.sh</filename> file and access
the credentials by using the environment variables in the Python scripts.</para>
<xi:include href="section_sdk_auth_keystone.xml"/>
<xi:include href="section_sdk_auth_glance.xml"/>
<xi:include href="section_sdk_auth_nova.xml" />
<xi:include href="section_sdk_auth_neutron.xml" />
</section>