diff --git a/doc/services/identity/v3/application-credentials.rst b/doc/services/identity/v3/application-credentials.rst index 917c03b6..433414dd 100644 --- a/doc/services/identity/v3/application-credentials.rst +++ b/doc/services/identity/v3/application-credentials.rst @@ -1,6 +1,16 @@ Application Credentials ======================= +Application credentials provide a way to delegate a user’s authorization to an application without sharing the user’s +password authentication. This is a useful security measure, especially for situations where the user’s identification +is provided by an external source, such as LDAP or a single-sign-on service. Instead of storing user passwords in +config files, a user creates an application credential for a specific project, with all or a subset of the role assignments +they have on that project, and then stores the application credential identifier and secret in the config file. + +See the `Official documentation `_ + +You must :doc:`create the service ` first to use this resource. + Create ------ diff --git a/doc/services/identity/v3/create.rst b/doc/services/identity/v3/create.rst index 1101f36f..5cbc18eb 100644 --- a/doc/services/identity/v3/create.rst +++ b/doc/services/identity/v3/create.rst @@ -1,14 +1,14 @@ Create Service ============== -Service can be created via ``identityV3()`` method of ``OpenStack`` object: +Service can be created via ``identityV3()`` method of the ``OpenStack`` object: .. code-block:: php - $service = $openstack->identityV3(); + $identity = $openstack->identityV3(); A list of additional options can be passed to the method. For example, to change the region: .. code-block:: php - $service = $openstack->identityV3(['region' => '{region}']); + $identity = $openstack->identityV3(['region' => '{region}']);