pypi i django-scatter-auth




.. image:: :target:

.. image:: :target:

.. image:: :target:

django-scatter-auth is a pluggable Django app that enables login/signup via Scatter (EOS extension wallet). The user authenticates themselves by digitally signing the hostname with their wallet's private key.

.. image::


The full documentation is at

Example project

You can check out our example project by cloning the repo and heading into example/ directory. There is a README file for you to check, also.


  • Scatter API login, signup
  • Scatter Django forms for signup, login
  • Checks signature (validation)
  • Uses hostname signing as proof of private key posession
  • Easy to set up and use (just one click)
  • Custom auth backend
  • VERY customizable - uses Django settings, allows for custom User model
  • Vanilla Javascript helpers included


Install django-scatter-auth with pip::

pip install django-scatter-auth

Add it to your INSTALLED_APPS:

.. code-block:: python


Set 'scatterauth.backend.ScatterAuthBackend' as your authentication backend:

.. code-block:: python


Set your User model's field to use as public key storage:

.. code-block:: python


And if you have some other fields you want to be in the SignupForm, add them too:

.. code-block:: python


Add django-scatter-auth's URL patterns:

.. code-block:: python

from scatterauth import urls as scatterauth_urls

urlpatterns = [
    url(r'^', include(scatterauth_urls)),

Add some javascript to handle login:

.. code-block:: html

<script src="{% static 'scatterauth/js/scatterauth.js' %}"></script>

.. code-block:: javascript

var login_url = '{% url 'scatterauth_login_api' %}';
document.addEventListener('scatterLoaded', scatterExtension => {
  console.log('scatter loaded');
  if (scatter.identity) {
    console.log("Identity found");
    loginWithAuthenticate(login_url,console.log,console.log,console.log,console.log, function (resp) {
  } else {
    console.log('identity not found, have to signup');

You can access signup using {% url 'scatterauth_signup' %} and API signup using {% url 'scatterauth_signup_api' %}.

If you have any questions left, head to the example app

Important details and FAQ

  1. If you set a custom public key field (SCATTERAUTH_USER_PUBKEY_FIELD), it MUST be unique (unique=True).

This is needed because if it's not, the user can register a new account with the same public key as the other one, meaning that the user can now login as any of those accounts (sometimes being the wrong one).

  1. How do i deal with user passwords or Password is not set

There should be some code in your project that generates a password using User.objects.make_random_password and sends it to a user email. Or, even better, sends them a 'restore password' link. Also, it's possible to copy signup_view to your project, assign it a url, and add the corresponding lines to set some password for a user.

  1. Why don't i have to sign a message? It's needed in django-web3-auth, how this app is secure?

This app uses scatter's authenticate function to handle message signing - hostname being the signed message. This means that the user & the client share knowledge of the original message and the server can verify client's possession of the private key corresponding to the public key.

Running Tests

Does the code actually work?


source <YOURVIRTUALENV>/bin/activate
(myenv) $ pip install tox
(myenv) $ tox


Tools used in rendering this package:

  • Cookiecutter_
  • cookiecutter-djangopackage_

.. Cookiecutter: .. cookiecutter-djangopackage:


0.2.0 (2020-03-14) ++++++++++++++++++

  • Added support for Scatter-Desktop

0.1.1 (2018-09-10) ++++++++++++++++++

  • Fixed signup bug in js - added 'pubkey_field_name' param

0.1.0 (2018-08-13) ++++++++++++++++++

  • First release on PyPi

Jump To