add collapsible auth code

doc/_exts/samples.py

@@ -35,7 +35,7 @@ def run(self):
         return [
             CollapseNode(
                 '',
-                'show full code',
+                'auth code example',
                 nodes.paragraph(
                     '',
                     '',

doc/services/identity/v3/create.rst

@@ -1,7 +1,7 @@
 Create Service
 ==============
 
-Service can be created via ``identityV3`` method of ``OpenStack`` object:
+Service can be created via ``identityV3()`` method of ``OpenStack`` object:
 
 .. code-block:: php
 

doc/services/identity/v3/tokens.rst

@@ -1,12 +1,6 @@
 Tokens
 ======
 
-Authenticate (generate) token
------------------------------
-
-.. refdoc:: OpenStack/Identity/v3/Service.html#method_createService
-
-
 Generate token with user ID
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~
 

doc/setup.rst

@@ -17,6 +17,37 @@ There are different ways to provide the authentication credentials. See the :doc
 section for the full list of options. You should provide credentials to the ``OpenStack`` constructor as an array
 the same way you provide options to ``generateToken`` method of the ``Identity`` service.
 
+Authenticate with user ID
+~~~~~~~~~~~~~~~~~~~~~~~~~
+
+.. sample:: Setup/user_id.php
+
+Authenticate with username
+~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+.. sample:: Setup/username.php
+
+Authenticate application credential ID
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+.. sample:: Setup/application_credential_id.php
+
+Generate token from ID
+~~~~~~~~~~~~~~~~~~~~~~
+
+.. sample:: Setup/from_id.php
+
+Generate token scoped to project ID
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+.. sample:: Identity/v3/tokens/generate_token_scoped_to_project_id.php
+
+Generate token scoped to project name
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+.. sample:: Identity/v3/tokens/generate_token_scoped_to_project_name.php
+
+
 Here is an example of how to create a client with a user id and password:
 
 .. code-block:: php

samples/Setup/application_credential_id.php

@@ -0,0 +1,12 @@
+<?php
+
+require 'vendor/autoload.php';
+
+$openstack = new OpenStack\OpenStack([
+    'authUrl'                => '{authUrl}',
+    'region'                 => '{region}',
+    'application_credential' => [
+        'id'     => '{applicationCredentialId}',
+        'secret' => '{secret}',
+    ],
+]);

samples/Setup/from_id.php

@@ -0,0 +1,9 @@
+<?php
+
+require 'vendor/autoload.php';
+
+$openstack = new OpenStack\OpenStack([
+    'authUrl' => '{authUrl}',
+    'region'  => '{region}',
+    'tokenId' => '{tokenId}',
+]);

samples/Setup/scoped_to_project_id.php

@@ -0,0 +1,15 @@
+<?php
+
+require 'vendor/autoload.php';
+
+$openstack = new OpenStack\OpenStack([
+    'authUrl' => '{authUrl}',
+    'region'  => '{region}',
+    'user'    => [
+        'id'       => '{userId}',
+        'password' => '{password}',
+    ],
+    'scope'   => [
+        'project' => ['id' => '{projectId}'],
+    ],
+]);

samples/Setup/scoped_to_project_name.php

@@ -0,0 +1,20 @@
+<?php
+
+require 'vendor/autoload.php';
+
+$openstack = new OpenStack\OpenStack([
+    'authUrl' => '{authUrl}',
+    'region'  => '{region}',
+    'user' => [
+        'id'       => '{userId}',
+        'password' => '{password}'
+    ],
+    'scope' => [
+        'project' => [
+            'name' => '{projectName}',
+            'domain' => [
+                'id' => '{domainId}'
+            ]
+        ]
+    ]
+]);

samples/Setup/user_id.php

@@ -0,0 +1,21 @@
+<?php
+
+require 'vendor/autoload.php';
+
+$openstack = new OpenStack\OpenStack([
+    'authUrl' => '{authUrl}',
+    'region'  => '{region}',
+    'user' => [
+        'id'       => '{userId}',
+        'password' => '{password}'
+    ]
+]);
+
+$identity = $openstack->identityV3();
+
+$token = $identity->generateToken([
+    'user' => [
+        'id'       => '{userId}',
+        'password' => '{password}'
+    ]
+]);

samples/Setup/username.php

@@ -0,0 +1,15 @@
+<?php
+
+require 'vendor/autoload.php';
+
+$openstack = new OpenStack\OpenStack([
+    'authUrl' => '{authUrl}',
+    'region'  => '{region}',
+    'user' => [
+        'name'     => '{username}',
+        'password' => '{password}',
+        'domain'   => [
+            'id' => '{domainId}'
+        ]
+    ]
+]);