123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198 |
- /*! firebase-admin v12.1.1 */
- "use strict";
- /*!
- * @license
- * Copyright 2017 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.
- */
- Object.defineProperty(exports, "__esModule", { value: true });
- exports.handleCryptoSignerError = exports.FirebaseTokenGenerator = exports.EmulatedSigner = exports.BLACKLISTED_CLAIMS = void 0;
- const error_1 = require("../utils/error");
- const crypto_signer_1 = require("../utils/crypto-signer");
- const validator = require("../utils/validator");
- const utils_1 = require("../utils");
- const ALGORITHM_NONE = 'none';
- const ONE_HOUR_IN_SECONDS = 60 * 60;
- // List of blacklisted claims which cannot be provided when creating a custom token
- exports.BLACKLISTED_CLAIMS = [
- 'acr', 'amr', 'at_hash', 'aud', 'auth_time', 'azp', 'cnf', 'c_hash', 'exp', 'iat', 'iss', 'jti',
- 'nbf', 'nonce',
- ];
- // Audience to use for Firebase Auth Custom tokens
- const FIREBASE_AUDIENCE = 'https://identitytoolkit.googleapis.com/google.identity.identitytoolkit.v1.IdentityToolkit';
- /**
- * A CryptoSigner implementation that is used when communicating with the Auth emulator.
- * It produces unsigned tokens.
- */
- class EmulatedSigner {
- constructor() {
- this.algorithm = ALGORITHM_NONE;
- }
- /**
- * @inheritDoc
- */
- // eslint-disable-next-line @typescript-eslint/no-unused-vars
- sign(buffer) {
- return Promise.resolve(Buffer.from(''));
- }
- /**
- * @inheritDoc
- */
- getAccountId() {
- return Promise.resolve('firebase-auth-emulator@example.com');
- }
- }
- exports.EmulatedSigner = EmulatedSigner;
- /**
- * Class for generating different types of Firebase Auth tokens (JWTs).
- *
- * @internal
- */
- class FirebaseTokenGenerator {
- /**
- * @param tenantId - The tenant ID to use for the generated Firebase Auth
- * Custom token. If absent, then no tenant ID claim will be set in the
- * resulting JWT.
- */
- constructor(signer, tenantId) {
- this.tenantId = tenantId;
- if (!validator.isNonNullObject(signer)) {
- throw new error_1.FirebaseAuthError(error_1.AuthClientErrorCode.INVALID_CREDENTIAL, 'INTERNAL ASSERT: Must provide a CryptoSigner to use FirebaseTokenGenerator.');
- }
- if (typeof this.tenantId !== 'undefined' && !validator.isNonEmptyString(this.tenantId)) {
- throw new error_1.FirebaseAuthError(error_1.AuthClientErrorCode.INVALID_ARGUMENT, '`tenantId` argument must be a non-empty string.');
- }
- this.signer = signer;
- }
- /**
- * Creates a new Firebase Auth Custom token.
- *
- * @param uid - The user ID to use for the generated Firebase Auth Custom token.
- * @param developerClaims - Optional developer claims to include in the generated Firebase
- * Auth Custom token.
- * @returns A Promise fulfilled with a Firebase Auth Custom token signed with a
- * service account key and containing the provided payload.
- */
- createCustomToken(uid, developerClaims) {
- let errorMessage;
- if (!validator.isNonEmptyString(uid)) {
- errorMessage = '`uid` argument must be a non-empty string uid.';
- }
- else if (uid.length > 128) {
- errorMessage = '`uid` argument must a uid with less than or equal to 128 characters.';
- }
- else if (!this.isDeveloperClaimsValid_(developerClaims)) {
- errorMessage = '`developerClaims` argument must be a valid, non-null object containing the developer claims.';
- }
- if (errorMessage) {
- throw new error_1.FirebaseAuthError(error_1.AuthClientErrorCode.INVALID_ARGUMENT, errorMessage);
- }
- const claims = {};
- if (typeof developerClaims !== 'undefined') {
- for (const key in developerClaims) {
- /* istanbul ignore else */
- if (Object.prototype.hasOwnProperty.call(developerClaims, key)) {
- if (exports.BLACKLISTED_CLAIMS.indexOf(key) !== -1) {
- throw new error_1.FirebaseAuthError(error_1.AuthClientErrorCode.INVALID_ARGUMENT, `Developer claim "${key}" is reserved and cannot be specified.`);
- }
- claims[key] = developerClaims[key];
- }
- }
- }
- return this.signer.getAccountId().then((account) => {
- const header = {
- alg: this.signer.algorithm,
- typ: 'JWT',
- };
- const iat = Math.floor(Date.now() / 1000);
- const body = {
- aud: FIREBASE_AUDIENCE,
- iat,
- exp: iat + ONE_HOUR_IN_SECONDS,
- iss: account,
- sub: account,
- uid,
- };
- if (this.tenantId) {
- body.tenant_id = this.tenantId;
- }
- if (Object.keys(claims).length > 0) {
- body.claims = claims;
- }
- const token = `${this.encodeSegment(header)}.${this.encodeSegment(body)}`;
- const signPromise = this.signer.sign(Buffer.from(token));
- return Promise.all([token, signPromise]);
- }).then(([token, signature]) => {
- return `${token}.${this.encodeSegment(signature)}`;
- }).catch((err) => {
- throw handleCryptoSignerError(err);
- });
- }
- encodeSegment(segment) {
- const buffer = (segment instanceof Buffer) ? segment : Buffer.from(JSON.stringify(segment));
- return (0, utils_1.toWebSafeBase64)(buffer).replace(/=+$/, '');
- }
- /**
- * Returns whether or not the provided developer claims are valid.
- *
- * @param developerClaims - Optional developer claims to validate.
- * @returns True if the provided claims are valid; otherwise, false.
- */
- // eslint-disable-next-line @typescript-eslint/naming-convention
- isDeveloperClaimsValid_(developerClaims) {
- if (typeof developerClaims === 'undefined') {
- return true;
- }
- return validator.isNonNullObject(developerClaims);
- }
- }
- exports.FirebaseTokenGenerator = FirebaseTokenGenerator;
- /**
- * Creates a new FirebaseAuthError by extracting the error code, message and other relevant
- * details from a CryptoSignerError.
- *
- * @param err - The Error to convert into a FirebaseAuthError error
- * @returns A Firebase Auth error that can be returned to the user.
- */
- function handleCryptoSignerError(err) {
- if (!(err instanceof crypto_signer_1.CryptoSignerError)) {
- return err;
- }
- if (err.code === crypto_signer_1.CryptoSignerErrorCode.SERVER_ERROR && validator.isNonNullObject(err.cause)) {
- const httpError = err.cause;
- const errorResponse = httpError.response.data;
- if (validator.isNonNullObject(errorResponse) && errorResponse.error) {
- const errorCode = errorResponse.error.status;
- const description = 'Please refer to https://firebase.google.com/docs/auth/admin/create-custom-tokens ' +
- 'for more details on how to use and troubleshoot this feature.';
- const errorMsg = `${errorResponse.error.message}; ${description}`;
- return error_1.FirebaseAuthError.fromServerError(errorCode, errorMsg, errorResponse);
- }
- return new error_1.FirebaseAuthError(error_1.AuthClientErrorCode.INTERNAL_ERROR, 'Error returned from server: ' + errorResponse + '. Additionally, an ' +
- 'internal error occurred while attempting to extract the ' +
- 'errorcode from the error.');
- }
- return new error_1.FirebaseAuthError(mapToAuthClientErrorCode(err.code), err.message);
- }
- exports.handleCryptoSignerError = handleCryptoSignerError;
- function mapToAuthClientErrorCode(code) {
- switch (code) {
- case crypto_signer_1.CryptoSignerErrorCode.INVALID_CREDENTIAL:
- return error_1.AuthClientErrorCode.INVALID_CREDENTIAL;
- case crypto_signer_1.CryptoSignerErrorCode.INVALID_ARGUMENT:
- return error_1.AuthClientErrorCode.INVALID_ARGUMENT;
- default:
- return error_1.AuthClientErrorCode.INTERNAL_ERROR;
- }
- }
|