123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288 |
- <?php
- /*
- * Copyright 2015 Google Inc.
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- * http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
- namespace Google\Auth;
- use Google\Auth\Credentials\ExternalAccountCredentials;
- use Google\Auth\Credentials\ImpersonatedServiceAccountCredentials;
- use Google\Auth\Credentials\InsecureCredentials;
- use Google\Auth\Credentials\ServiceAccountCredentials;
- use Google\Auth\Credentials\UserRefreshCredentials;
- use RuntimeException;
- use UnexpectedValueException;
- /**
- * CredentialsLoader contains the behaviour used to locate and find default
- * credentials files on the file system.
- */
- abstract class CredentialsLoader implements
- GetUniverseDomainInterface,
- FetchAuthTokenInterface,
- UpdateMetadataInterface
- {
- use UpdateMetadataTrait;
- const TOKEN_CREDENTIAL_URI = 'https://oauth2.googleapis.com/token';
- const ENV_VAR = 'GOOGLE_APPLICATION_CREDENTIALS';
- const QUOTA_PROJECT_ENV_VAR = 'GOOGLE_CLOUD_QUOTA_PROJECT';
- const WELL_KNOWN_PATH = 'gcloud/application_default_credentials.json';
- const NON_WINDOWS_WELL_KNOWN_PATH_BASE = '.config';
- const MTLS_WELL_KNOWN_PATH = '.secureConnect/context_aware_metadata.json';
- const MTLS_CERT_ENV_VAR = 'GOOGLE_API_USE_CLIENT_CERTIFICATE';
- /**
- * @param string $cause
- * @return string
- */
- private static function unableToReadEnv($cause)
- {
- $msg = 'Unable to read the credential file specified by ';
- $msg .= ' GOOGLE_APPLICATION_CREDENTIALS: ';
- $msg .= $cause;
- return $msg;
- }
- /**
- * @return bool
- */
- private static function isOnWindows()
- {
- return strtoupper(substr(PHP_OS, 0, 3)) === 'WIN';
- }
- /**
- * Load a JSON key from the path specified in the environment.
- *
- * Load a JSON key from the path specified in the environment
- * variable GOOGLE_APPLICATION_CREDENTIALS. Return null if
- * GOOGLE_APPLICATION_CREDENTIALS is not specified.
- *
- * @return array<mixed>|null JSON key | null
- */
- public static function fromEnv()
- {
- $path = getenv(self::ENV_VAR);
- if (empty($path)) {
- return null;
- }
- if (!file_exists($path)) {
- $cause = 'file ' . $path . ' does not exist';
- throw new \DomainException(self::unableToReadEnv($cause));
- }
- $jsonKey = file_get_contents($path);
- return json_decode((string) $jsonKey, true);
- }
- /**
- * Load a JSON key from a well known path.
- *
- * The well known path is OS dependent:
- *
- * * windows: %APPDATA%/gcloud/application_default_credentials.json
- * * others: $HOME/.config/gcloud/application_default_credentials.json
- *
- * If the file does not exist, this returns null.
- *
- * @return array<mixed>|null JSON key | null
- */
- public static function fromWellKnownFile()
- {
- $rootEnv = self::isOnWindows() ? 'APPDATA' : 'HOME';
- $path = [getenv($rootEnv)];
- if (!self::isOnWindows()) {
- $path[] = self::NON_WINDOWS_WELL_KNOWN_PATH_BASE;
- }
- $path[] = self::WELL_KNOWN_PATH;
- $path = implode(DIRECTORY_SEPARATOR, $path);
- if (!file_exists($path)) {
- return null;
- }
- $jsonKey = file_get_contents($path);
- return json_decode((string) $jsonKey, true);
- }
- /**
- * Create a new Credentials instance.
- *
- * @param string|string[] $scope the scope of the access request, expressed
- * either as an Array or as a space-delimited String.
- * @param array<mixed> $jsonKey the JSON credentials.
- * @param string|string[] $defaultScope The default scope to use if no
- * user-defined scopes exist, expressed either as an Array or as a
- * space-delimited string.
- *
- * @return ServiceAccountCredentials|UserRefreshCredentials|ImpersonatedServiceAccountCredentials|ExternalAccountCredentials
- */
- public static function makeCredentials(
- $scope,
- array $jsonKey,
- $defaultScope = null
- ) {
- if (!array_key_exists('type', $jsonKey)) {
- throw new \InvalidArgumentException('json key is missing the type field');
- }
- if ($jsonKey['type'] == 'service_account') {
- // Do not pass $defaultScope to ServiceAccountCredentials
- return new ServiceAccountCredentials($scope, $jsonKey);
- }
- if ($jsonKey['type'] == 'authorized_user') {
- $anyScope = $scope ?: $defaultScope;
- return new UserRefreshCredentials($anyScope, $jsonKey);
- }
- if ($jsonKey['type'] == 'impersonated_service_account') {
- $anyScope = $scope ?: $defaultScope;
- return new ImpersonatedServiceAccountCredentials($anyScope, $jsonKey);
- }
- if ($jsonKey['type'] == 'external_account') {
- $anyScope = $scope ?: $defaultScope;
- return new ExternalAccountCredentials($anyScope, $jsonKey);
- }
- throw new \InvalidArgumentException('invalid value in the type field');
- }
- /**
- * Create an authorized HTTP Client from an instance of FetchAuthTokenInterface.
- *
- * @param FetchAuthTokenInterface $fetcher is used to fetch the auth token
- * @param array<mixed> $httpClientOptions (optional) Array of request options to apply.
- * @param callable $httpHandler (optional) http client to fetch the token.
- * @param callable $tokenCallback (optional) function to be called when a new token is fetched.
- * @return \GuzzleHttp\Client
- */
- public static function makeHttpClient(
- FetchAuthTokenInterface $fetcher,
- array $httpClientOptions = [],
- callable $httpHandler = null,
- callable $tokenCallback = null
- ) {
- $middleware = new Middleware\AuthTokenMiddleware(
- $fetcher,
- $httpHandler,
- $tokenCallback
- );
- $stack = \GuzzleHttp\HandlerStack::create();
- $stack->push($middleware);
- return new \GuzzleHttp\Client([
- 'handler' => $stack,
- 'auth' => 'google_auth',
- ] + $httpClientOptions);
- }
- /**
- * Create a new instance of InsecureCredentials.
- *
- * @return InsecureCredentials
- */
- public static function makeInsecureCredentials()
- {
- return new InsecureCredentials();
- }
- /**
- * Fetch a quota project from the environment variable
- * GOOGLE_CLOUD_QUOTA_PROJECT. Return null if
- * GOOGLE_CLOUD_QUOTA_PROJECT is not specified.
- *
- * @return string|null
- */
- public static function quotaProjectFromEnv()
- {
- return getenv(self::QUOTA_PROJECT_ENV_VAR) ?: null;
- }
- /**
- * Gets a callable which returns the default device certification.
- *
- * @throws UnexpectedValueException
- * @return callable|null
- */
- public static function getDefaultClientCertSource()
- {
- if (!$clientCertSourceJson = self::loadDefaultClientCertSourceFile()) {
- return null;
- }
- $clientCertSourceCmd = $clientCertSourceJson['cert_provider_command'];
- return function () use ($clientCertSourceCmd) {
- $cmd = array_map('escapeshellarg', $clientCertSourceCmd);
- exec(implode(' ', $cmd), $output, $returnVar);
- if (0 === $returnVar) {
- return implode(PHP_EOL, $output);
- }
- throw new RuntimeException(
- '"cert_provider_command" failed with a nonzero exit code'
- );
- };
- }
- /**
- * Determines whether or not the default device certificate should be loaded.
- *
- * @return bool
- */
- public static function shouldLoadClientCertSource()
- {
- return filter_var(getenv(self::MTLS_CERT_ENV_VAR), FILTER_VALIDATE_BOOLEAN);
- }
- /**
- * @return array{cert_provider_command:string[]}|null
- */
- private static function loadDefaultClientCertSourceFile()
- {
- $rootEnv = self::isOnWindows() ? 'APPDATA' : 'HOME';
- $path = sprintf('%s/%s', getenv($rootEnv), self::MTLS_WELL_KNOWN_PATH);
- if (!file_exists($path)) {
- return null;
- }
- $jsonKey = file_get_contents($path);
- $clientCertSourceJson = json_decode((string) $jsonKey, true);
- if (!$clientCertSourceJson) {
- throw new UnexpectedValueException('Invalid client cert source JSON');
- }
- if (!isset($clientCertSourceJson['cert_provider_command'])) {
- throw new UnexpectedValueException(
- 'cert source requires "cert_provider_command"'
- );
- }
- if (!is_array($clientCertSourceJson['cert_provider_command'])) {
- throw new UnexpectedValueException(
- 'cert source expects "cert_provider_command" to be an array'
- );
- }
- return $clientCertSourceJson;
- }
- /**
- * Get the universe domain from the credential. Defaults to "googleapis.com"
- * for all credential types which do not support universe domain.
- *
- * @return string
- */
- public function getUniverseDomain(): string
- {
- return self::DEFAULT_UNIVERSE_DOMAIN;
- }
- }
|