openstack-manuals/doc/user-guide/section_sdk_authenticate.xml
Christian Berendt 6be4f5775f Unified the syntax of the XML root element (user-guide)
The XML root element of Docbook XML files should match the following
format:

<ELEMENT 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="THE_XML_ID_OF_THE_ELEMENT">

Change-Id: Ic59684221ba99632c71e3f9b5f97ec74f56793a4
2014-07-09 19:51:07 +02:00

27 lines
1.3 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>Authenticate</title>
<para>When using the SDK, you must authenticate against an OpenStack
endpoint before you can use OpenStack services. Each project uses
a slightly different syntax for authentication.</para>
<para>You must typically authenticate against a specific version of
a service. For example, a client might need to authenticate
against Identity 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><replaceable>PROJECT</replaceable>-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>