diff --git a/api-quick-start/src/docbkx/api-quick-start-intro.xml b/api-quick-start/src/docbkx/api-quick-start-intro.xml index cf692084c..14b16276a 100644 --- a/api-quick-start/src/docbkx/api-quick-start-intro.xml +++ b/api-quick-start/src/docbkx/api-quick-start-intro.xml @@ -4,22 +4,24 @@ xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="Compute_API_Quick_Start" version="5.0"> OpenStack APIs - To authenticate access to OpenStack services, you issue an - authentication request to the OpenStack Identity Service. You - must supply a payload of credentials in the authentication - request. + To authenticate access to OpenStack services, you must first + issue an authentication request to the OpenStack Identity + Service to acquire an authentication token. To request an + authentication token, you must supply a payload of credentials + in the authentication request. Credentials are usually a combination of your user name and password, and optionally, the name or ID of the tenant in which your cloud runs. Ask your cloud administrator for your user name, password, and tenant so that you can generate authentication tokens. Alternatively, you can supply a token rather than a user name and password. - A token is typically valid for 24 hours. When you send API - requests, you include the token in the - X-Auth-Token header. You must generate - another token if you interact with your cloud through API - endpoints rather than through a client. - + When you send API requests, you include the token in the + X-Auth-Token header. If you access + multiple OpenStack services, you must get a token for each + service. A token is valid for a limited time before it + expires. A token can also become invalid for other reasons. + For example, if the roles for a user change, existing tokens + for that user are invalid. Authentication and API request workflow @@ -92,7 +94,8 @@ X-Auth-Token header. Continue to send API requests with that token until the job completes or a 401 - Unauthorized error occurs. + Unauthorized error + occurs. If the 401 diff --git a/api-ref/src/docbkx/ch_identity-admin-v2.xml b/api-ref/src/docbkx/ch_identity-admin-v2.xml index 25d406d9d..51bdee062 100644 --- a/api-ref/src/docbkx/ch_identity-admin-v2.xml +++ b/api-ref/src/docbkx/ch_identity-admin-v2.xml @@ -9,7 +9,7 @@ xlink:href="#identity-admin-v2"> Identity Service admin API v2.0 Gets an authentication token that permits access to the - Compute API for 24 hours. + Compute API. diff --git a/api-ref/src/docbkx/ch_identity-v2.xml b/api-ref/src/docbkx/ch_identity-v2.xml index 3adf992d3..a0f4ed8de 100644 --- a/api-ref/src/docbkx/ch_identity-v2.xml +++ b/api-ref/src/docbkx/ch_identity-v2.xml @@ -22,7 +22,7 @@ xlink:href="#identity-v2"> Identity Service API v2.0 Gets an authentication token that permits access to the - Compute API for 24 hours. + Compute API. diff --git a/api-ref/src/docbkx/ch_identity-v3.xml b/api-ref/src/docbkx/ch_identity-v3.xml index 52d7a063b..f25617aec 100644 --- a/api-ref/src/docbkx/ch_identity-v3.xml +++ b/api-ref/src/docbkx/ch_identity-v3.xml @@ -22,7 +22,7 @@ xlink:href="#identity-v3"> Identity Service API v3 Gets an authentication token that permits access to the - Compute API for 24 hours. + Compute API.
Versions