Added api samples and added support to deploy to App Engine

Author: ryanmats

auth/README.md

@@ -25,6 +25,8 @@ methods will work on any Google Cloud API.
 ```
   auth-cloud-implicit                      Authenticate to a cloud client library using a service account implicitly.
   auth-cloud-explicit                      Authenticate to a cloud client library using a service account explicitly.
+  auth-api-implicit                        Authenticate to a cloud API using a service account implicitly.
+  auth-api-explicit                        Authenticate to a cloud API using a service account explicitly.
 ```
 6. The following commands are available but will throw a ServiceException when
 run from command-line. The Compute Engine method only works on Compute Engine,
@@ -33,8 +35,17 @@ method only works on App Engine Standard.
 ```
   auth-cloud-explicit-compute-engine       Authenticate to a cloud client library using Compute Engine credentials explicitly.
   auth-cloud-explicit-app-engine           Authenticate to a cloud client library using App Engine Standard credentials explicitly.
+  auth-api-explicit-compute-engine         Authenticate to a cloud API using Compute Engine credentials explicitly.
+  auth-api-explicit-app-engine             Authenticate to a cloud API using App Engine Standard credentials explicitly.
 ```
-7. Run `php auth.php COMMAND --help` to print information about the usage of each command.
+7. You can test the samples that use Compute Engine / App Engine credentials by
+deploying to either App Engine Flexible (which allows usage of Compute Engine
+credentials since App Engine Flexible apps run on Compute Engine instances) or
+App Engine Standard. If you are deploying to App Engine Standard, first open
+`app-standard.yaml` and set the value of `GCLOUD_PROJECT` to your project ID.
+Run either `gcloud app deploy app-standard.yaml` or `gcloud app deploy app-flex.yaml`.
+
+8. Run `php auth.php COMMAND --help` to print information about the usage of each command.
 
 ## Contributing changes
 

auth/app-flex.yaml

@@ -0,0 +1,5 @@
+runtime: php
+env: flex
+
+runtime_config:
+  document_root: .

auth/app-standard.yaml

@@ -0,0 +1,10 @@
+runtime: php55
+api_version: 1
+threadsafe: true
+
+handlers:
+- url: /.*
+  script: index.php
+
+env_variables:
+  GCLOUD_PROJECT: your-project-id

auth/auth.php

@@ -93,6 +93,79 @@
     })
 );
 
+// Create auth-api-implicit Command.
+$application->add((new Command('auth-api-implicit'))
+    ->addArgument('projectId', InputArgument::REQUIRED, 'Your project ID')
+    ->setDescription('Authenticate to a cloud API using a service account implicitly.')
+    ->setHelp(<<<EOF
+The <info>%command.name%</info> command authenticates to a cloud API using a
+service account implicitly.
+
+    <info>php %command.full_name%</info>
+
+EOF
+    )
+    ->setCode(function ($input, $output) {
+        auth_api_implicit($input->getArgument('projectId'));
+    })
+);
+
+// Create auth-api-explicit Command.
+$application->add((new Command('auth-api-explicit'))
+    ->addArgument('projectId', InputArgument::REQUIRED, 'Your project ID')
+    ->addArgument('serviceAccountPath', InputArgument::REQUIRED, 'Path to your service account.')
+    ->setDescription('Authenticate to a cloud API using a service account explicitly.')
+    ->setHelp(<<<EOF
+The <info>%command.name%</info> command authenticates to a cloud API using a
+service account implicitly.
+
+    <info>php %command.full_name%</info>
+
+EOF
+    )
+    ->setCode(function ($input, $output) {
+        $projectId = $input->getArgument('projectId');
+        $serviceAccountPath = $input->getArgument('serviceAccountPath');
+        auth_api_explicit($projectId, $serviceAccountPath);
+    })
+);
+
+// Create auth-api-explicit-compute-engine Command.
+$application->add((new Command('auth-api-explicit-compute-engine'))
+    ->addArgument('projectId', InputArgument::REQUIRED, 'Your project ID')
+    ->setDescription('Authenticate to a cloud API using Compute Engine credentials explicitly.')
+    ->setHelp(<<<EOF
+The <info>%command.name%</info> command authenticates to a cloud API using
+Compute Engine credentials explicitly.
+
+    <info>php %command.full_name%</info>
+
+EOF
+    )
+    ->setCode(function ($input, $output) {
+        $projectId = $input->getArgument('projectId');
+        auth_api_explicit_compute_engine($projectId);
+    })
+);
+
+// Create auth-api-explicit-app-engine Command.
+$application->add((new Command('auth-api-explicit-app-engine'))
+    ->addArgument('projectId', InputArgument::REQUIRED, 'Your project ID')
+    ->setDescription('Authenticate to a cloud API using App Engine Standard credentials explicitly.')
+    ->setHelp(<<<EOF
+The <info>%command.name%</info> command authenticates to a cloud API using
+Compute Engine credentials explicitly.
+
+    <info>php %command.full_name%</info>
+
+EOF
+    )
+    ->setCode(function ($input, $output) {
+        $projectId = $input->getArgument('projectId');
+        auth_api_explicit_compute_engine($projectId);
+    })
+);
+
 if (getenv('PHPUNIT_TESTS') === '1') {
     return $application;
 }

auth/composer.json

@@ -1,6 +1,6 @@
 {
     "require": {
-        "silex/silex": "^1.3",
+        "google/apiclient": "^2.1",
         "google/cloud-storage": "^1.0",
         "paragonie/random_compat": "^2.0",
         "symfony/console": " ^3.0",
@@ -14,7 +14,11 @@
             "src/auth_cloud_implicit.php",
             "src/auth_cloud_explicit.php",
             "src/auth_cloud_explicit_compute_engine.php",
-            "src/auth_cloud_explicit_app_engine.php"
+            "src/auth_cloud_explicit_app_engine.php",
+            "src/auth_api_implicit.php",
+            "src/auth_api_explicit.php",
+            "src/auth_api_explicit_compute_engine.php",
+            "src/auth_api_explicit_app_engine.php"
         ]
     },
     "require-dev": {