[Summary view] [Print] [Text view]

   1  <?php
   2  
   3  /**
   4   * JSON Web Key (RFC7517) Handler
   5   *
   6   * PHP version 5
   7   *
   8   * @author    Jim Wigginton <terrafrost@php.net>
   9   * @copyright 2015 Jim Wigginton
  10   * @license   http://www.opensource.org/licenses/mit-license.html  MIT License
  11   * @link      http://phpseclib.sourceforge.net
  12   */
  13  
  14  namespace phpseclib3\Crypt\Common\Formats\Keys;
  15  
  16  use phpseclib3\Common\Functions\Strings;
  17  
  18  /**
  19   * JSON Web Key Formatted Key Handler
  20   *
  21   * @author  Jim Wigginton <terrafrost@php.net>
  22   */
  23  abstract class JWK
  24  {
  25      /**
  26       * Break a public or private key down into its constituent components
  27       *
  28       * @param string $key
  29       * @param string $password
  30       * @return array
  31       */
  32      public static function load($key, $password = '')
  33      {
  34          if (!Strings::is_stringable($key)) {
  35              throw new \UnexpectedValueException('Key should be a string - not a ' . gettype($key));
  36          }
  37  
  38          $key = preg_replace('#\s#', '', $key); // remove whitespace
  39  
  40          if (PHP_VERSION_ID >= 73000) {
  41              $key = json_decode($key, null, 512, JSON_THROW_ON_ERROR);
  42          } else {
  43              $key = json_decode($key);
  44              if (!$key) {
  45                  throw new \RuntimeException('Unable to decode JSON');
  46              }
  47          }
  48  
  49          if (isset($key->kty)) {
  50              return $key;
  51          }
  52  
  53          if (count($key->keys) != 1) {
  54              throw new \RuntimeException('Although the JWK key format supports multiple keys phpseclib does not');
  55          }
  56  
  57          return $key->keys[0];
  58      }
  59  
  60      /**
  61       * Wrap a key appropriately
  62       *
  63       * @return string
  64       */
  65      protected static function wrapKey(array $key, array $options)
  66      {
  67          return json_encode(['keys' => [$key + $options]]);
  68      }
  69  }