. * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in all * copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE * SOFTWARE. */ namespace Pterodactyl\Http\Middleware; use Auth; use Crypt; use Config; use Closure; use Response; use IPTools\IP; use IPTools\Range; use Illuminate\Http\Request; use Pterodactyl\Models\APIKey; use Pterodactyl\Models\APIPermission; use Symfony\Component\HttpKernel\Exception\BadRequestHttpException; // 400 use Symfony\Component\HttpKernel\Exception\AccessDeniedHttpException; // 403 class HMACAuthorization { /** * The algorithm to use for handling HMAC encryption. * * @var string */ const HMAC_ALGORITHM = 'sha256'; /** * Stored values from the Authorization header. * * @var array */ protected $token = []; /** * The eloquent model for the API key. * * @var \Pterodactyl\Models\APIKey */ protected $key; /** * The illuminate request object. * * @var \Illuminate\Http\Request */ private $request; /** * Construct class instance. * * @return void */ public function __construct() { Config::set('session.driver', 'array'); } /** * Handle an incoming request for the API. * * @param \Illuminate\Http\Request $request * @param \Closure $next * @return mixed */ public function handle(Request $request, Closure $next) { $this->request = $request; $this->checkBearer(); $this->validateRequest(); $this->validateContents(); Auth::loginUsingId($this->key()->user_id); return $next($request); } /** * Checks that the Bearer token is provided and in a valid format. * * @return void * * @throws \Symfony\Component\HttpKernel\Exception\AccessDeniedHttpException */ protected function checkBearer() { if (empty($this->request()->bearerToken())) { throw new BadRequestHttpException('Request was missing required Authorization header.'); } $token = explode('.', $this->request()->bearerToken()); if (count($token) !== 2) { throw new BadRequestHttpException('The Authorization header passed was not in a validate public/private key format.'); } $this->token = [ 'public' => $token[0], 'hash' => $token[1], ]; } /** * Determine if the request contains a valid public API key * as well as permissions for the resource. * * @return void * * @throws \Symfony\Component\HttpKernel\Exception\AccessDeniedHttpException */ protected function validateRequest() { $this->key = APIKey::where('public', $this->public())->first(); if (! $this->key) { throw new AccessDeniedHttpException('Unable to identify requester. Authorization token is invalid.'); } if (empty($this->request()->route()->getName())) { throw new \Exception('Attempting to access un-named route. This should not be possible.'); } $this->validateIPAccess(); $query = APIPermission::where('key_id', $this->key()->id) ->where('permission', $this->request()->route()->getName()); if (starts_with($this->request()->route()->getName(), 'api.user')) { $query->orWhere('permission', 'api.user.*'); } if (! $query->first()) { throw new AccessDeniedHttpException('You do not have permission to access this resource on the API.'); } } /** * Determine if the requesting IP address is allowed to use this API key. * * @return bool * * @throws \Symfony\Component\HttpKernel\Exception\AccessDeniedHttpException */ protected function validateIPAccess() { if (! is_null($this->key()->allowed_ips)) { foreach($this->key()->allowed_ips as $ip) { if (Range::parse($ip)->contains(new IP($this->request()->ip()))) { return true; } } throw new AccessDeniedHttpException('This IP address does not have permission to access the API using these credentials.'); } return true; } /** * Determine if the HMAC sent in the request matches the one generated * on the panel side. * * @return void * * @throws \Symfony\Component\HttpKernel\Exception\BadRequestHttpException */ protected function validateContents() { if (base64_decode($this->hash()) !== $this->generateSignature()) { throw new BadRequestHttpException('The HMAC for the request was invalid.'); } } /** * Generate a HMAC from the request and known API secret key. * * @return string */ protected function generateSignature() { $content = urldecode($this->request()->fullUrl()) . $this->request()->getContent(); return hash_hmac(self::HMAC_ALGORITHM, $content, Crypt::decrypt($this->key()->secret), true); } /** * Return the public key passed in the Authorization header. * * @return string */ protected function public() { return $this->token['public']; } /** * Return the base64'd HMAC sent in the Authorization header. * * @return string */ protected function hash() { return $this->token['hash']; } /** * Return the API Key model. * * @return \Pterodactyl\Models\APIKey */ protected function key() { return $this->key; } /** * Return the Illuminate Request object. * * @return \Illuminate\Http\Request */ private function request() { return $this->request; } }