Usage

To use Django-Cryptolock in a project, add it to your INSTALLED_APPS:

INSTALLED_APPS = (
    ...
    'django_cryptolock.apps.DjangoCryptolockConfig',
    ...
)

Now you should add the auth backend you wish to use on your project. You can use one or more:

AUTHENTICATION_BACKENDS = [
    "django_cryptolock.backends.BitcoinAddressBackend",
    "django_cryptolock.backends.MoneroAddressBackend",
]

If you use Monero, currently the following extra settings are required:

DJCL_MONERO_NETWORK = "mainnet"  # mainnet, stagenet or testnet
DJCL_MONERO_WALLET_RPC_PROTOCOL = "<http_or_https>"
DJCL_MONERO_WALLET_RPC_HOST = "<wallet_rpc_host>:<port>"
DJCL_MONERO_WALLET_RPC_USER = "<user>"
DJCL_MONERO_WALLET_RPC_PASS = "<password>"

For Bitcoin, you only need to set the DJCL_BITCOIN_NETWORK:

DJCL_BITCOIN_NETWORK = "mainnet"  # mainnet or testnet

Add Django-Cryptolock’s URL patterns:

from django.conf.urls import url


urlpatterns = [
    ...
    url(r"^auth/", include("django_cryptolock.urls", namespace="django_cryptolock")),
    ...
]

This will add 2 routes :

  • django_cryptolock:signup
  • django_cryptolock:login

For usega within you templates. For specific auth pages you can create the template files (login.html and signup.html) under a django_cryptolock subfolder.

Both of these templates will have access to a ``form```containing the required fields for the authentication.