Skip to main content

Custom Django Rest Framework authentication backend for parsing Firebase uid tokens and storing as local users.

Project description

DRF Firebase Auth


  • Python3
  • Django
  • Django Rest Framework


$ pip install drf-firebase-auth

Add the application to your project's INSTALLED_APPS in


In your project's, add this to the REST_FRAMEWORK configuration. Note that if you want to retain access to the browsable API for locally created users, then you will probably want to keep rest_framework.authentication.SessionAuthentication too.


The drf_firebase_auth application comes with the following settings as default, which can be overridden in your project's file. For convenience in version >= 1, most of these can be conveniently set form environment variables also. Make sure to nest them within DRF_FIREBASE_AUTH as below:

    # allow anonymous requests without Authorization header set
    # path to JSON file with firebase secrets
        os.getenv('FIREBASE_SERVICE_ACCOUNT_KEY', ''),
    # allow creation of new local user in db
        os.getenv('FIREBASE_CREATE_LOCAL_USER', True),
    # attempt to split firebase user.display_name and set local user
    # first_name and last_name
    # commonly JWT or Bearer (e.g. JWT <token>)
        os.getenv('FIREBASE_AUTH_HEADER_PREFIX', 'JWT'),
    # verify that JWT has not been revoked
        os.getenv('FIREBASE_CHECK_JWT_REVOKED', True),
    # require that firebase user.email_verified is True
        os.getenv('FIREBASE_AUTH_EMAIL_VERIFICATION', False),
    # function should accept firebase_admin.auth.UserRecord as argument
    # and return str
    'FIREBASE_USERNAME_MAPPING_FUNC': map_firebase_uid_to_username

You can get away with leaving all the settings as default except for FIREBASE_SERVICE_ACCOUNT_KEY, which is obviously required.

NOTE: FIREBASE_USERNAME_MAPPING_FUNC will replace behaviour in version < 1 as default (formerly provided by logic in map_firebase_to_username_legacy, described below). One can simply switch out this function.

drf_firebase_auth.utils contains functions for mapping firebase user info to the Django username field (new in version >= 1). Any custom function can be supplied here, as long as it accepts a firebase_admin.auth.UserRecord argument. The supplied functions are common use-cases:

def map_firebase_to_username_legacy(firebase_user: auth.UserRecord) -> str:
        username = '_'.join(
            firebase_user.display_name.split(' ')
            if firebase_user.display_name
            else str(uuid.uuid4())
        return username if len(username) <= 30 else username[:30]
    except Exception as e:
        raise Exception(e)

def map_firebase_display_name_to_username(
    firebase_user: auth.UserRecord
) -> str:
        return '_'.join(firebase_user.display_name.split(' '))
    except Exception as e:
        raise Exception(e)

def map_firebase_uid_to_username(
    firebase_user: auth.UserRecord
) -> str:
        return firebase_user.uid
    except Exception as e:
        raise Exception(e)

def map_firebase_email_to_username(
    firebase_user: auth.UserRecord
) -> str:
        return get_firebase_user_email(firebase_user)
    except Exception as e:
        raise Exception(e)

def map_uuid_to_username(
    _: auth.UserRecord
) -> str:
        return str(uuid.uuid4())
    except Exception as e:
        raise Exception(e)

Now that you have configured the application, run the migrations so that the Firebase data can be stored.

$ ./ migrate drf_firebase_auth

All you need to do now is have your client code handle the Firebase popup/redirect authentication flow, retrieve the idToken from the currentUser (Firebase explains this flow well in their docs:, and then use the idToken for the user in an Authorization header in requests to your API.

JWT <token>



  • Trello board created! Please follow this link if you wish to collabrate in the future direction of this package:
  • Please raise an issue/feature and name your branch 'feature-n' or 'issue-n', where 'n' is the issue number.
  • If you test this code with a Python version not listed above and all is well, please fork and update the README to include the Python version you used :)
  • I almost always setup Django with a custom user class inheriting from AbstractUser, where I switch the USERNAME_FIELD to be 'email'. This backend is setup to assign a username still anyway, but if there are any issues, please raise them and/or make a pull request to help the community!

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

drf-firebase-auth-1.0.0.dev1.tar.gz (8.9 kB view hashes)

Uploaded Source

Built Distribution

drf_firebase_auth-1.0.0.dev1-py3-none-any.whl (10.0 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page