openstack/openstack-manuals
Code Issues Proposed changes
Files
ef43c464eef67fc3d4effb10a96514ab20f4b835
openstack-manuals/doc/user-guide/source/sdk_authenticate.rst
Akihiro Motoki 98f84a360f [user-guide] Reorganize SDK section 
The current structure of SDK section is not well listed in the
toc tree. This commit moves the overview in sdk.rst to a sub page
sdk_overview.rst so that all subsections in SDK section are displayed
in the toc.

Also moves 'Create a legacy client object' page to upper level.
Previously this page is listed as a bullet in the authenticate page
so it was small. This change makes the page more highlighed.

Change-Id: I6414b748a77a6375423da38e52113b36359e5f7d
2016-06-17 08:15:15 +00:00

885 B
Raw Blame History

Authenticate

When using the SDK, you must authenticate against an OpenStack endpoint before you can use OpenStack services. Because all projects use Keystone for authentication, the process is the same no matter which service or library you have decided to use. Each library also has more advanced and complicated ways to do things, should those be needed.

There are two basic ways to deal with your cloud config and credentials:

  • Environment variables via an openrc.sh file
  • clouds.yaml config file

The environment variables have been around the longest and are the form you are most likely to receive from your cloud provider. If you have one and only one cloud account, they are the most convenient way.

clouds.yaml is a bit newer and was designed to help folks who have more than one OpenStack cloud that they are using.