How to Implement Registration and Authentication in Django?

Prerequisite

You should be familiar with Python and Django, a Python framework.

Overview

First, we briefly introduce LoginRadius, what it is, and some benefits of using it; then, will move over to see how to implement user registration and authentication in Django using LoginRadius.

Introduction

What is LoginRadius?

LoginRadius is a SaaS-based CIAM platform. It offers simplified, robust features to manage customer identity, privacy, and access -- allowing developers and businesses to provide a seamless and secure digital experience for their customers.

The developer-friendly CIAM provides a comprehensive set of APIs for registration, authentication, identity verification, single sign-on (SSO), and more.

Why should we use LoginRadius?

• Dynamically scales to accommodate user growth.
• Offers built-in security features to enhance user account security and manage user data securely.
• Built-in features that help achieve compliance with privacy regulations.
• Advanced login options like Social SSO and Passwordless Login to enhance user experience.

LoginRadius offers many more benefits than above. You can learn more here.

Getting started

To get started with LoginRadius, you have to first create a free developer account.

If you already have an account, log into your LoginRadius dashboard You will see a page like this:

When you create an account, LoginRadius sets up a free app for you. This is the app you are going to integrate with Django. Here my app name is "tammibriggs".

Click on your app, and you will see a page like this:

There is one more thing LoginRadius automatically creates for you: an Auth Page (IDX).

At this point, you know what LoginRadius is, its benefits, and how to get started with LoginRadius. Let’s see how to integrate LoginRadius with a Django application.

Integrating LoginRadius with a Django Application

This section covers:

• Installing dependencies.
• Setting up a demo application, in which you will integrate LoginRadius.
• Also, integrating LoginRadius with a Django demo application.

You must have python installed, and the minimum supported version is 2.7.

Getting API Credentials

Before using any of the APIs that LoginRadius provides, you need to get your App Name, API Key, and API Secret. On your LoginRadius app, navigate to Configuration > API Credentials

You will find your API key under the API Key and Secret subsection.

Whitelist your Domain

For security reasons, LoginRadius processes the API calls that are received from the whitelisted domains. Local domains ( and ) are whitelisted by default. This means you don't have to worry about whitelisting your domain if you are running your application on Django's development server. But in a production environment, you definitely have to whitelist our domain. To whitelist your domain, in your LoginRadius Dashboard, navigate to Configuration > Whitelist Your Domain and add your domain name.

Installation of Dependencies

You need to install the LoginRadius Python SDK. It provides functionalities that allow Python programs to communicate with LoginRadius APIs. Open VS Code, PyCharm, or any other editor you use in general. In the terminal, type:

These are the dependencies you need to integrate LoginRadius into your Django application.

Setting up Django

1. Install Django.
2. Create a new project.
3. Create an app inside the project.
4. Migrate your project.
5. Create a file in your app.

You can accomplish all this with the following commands in your terminal:

Here, the project name is radiusAuth and the app radiusApp but you can use any name you want. You now have a radiusAuth project and radiusApp app setup.

Configure Project

You need to tell Django about the app you created and the location of the app's file. First, let Django know the location of your app. In your radiusAuth project navigate to radiusAuth/settings.py, modify the :

Once you have added it, go over to the file in the same directory, modify the and include the apps url location.

User Registration and Authentication

Remember, we said that there is a webpage LoginRadius automatically created for you: an Auth Page (IDX), which already has registration and authentication implemented. You will utilize this web page to meet your registration and authentication needs. How would you do that?

You can access your registration and login page with the following URLs.

Registration Page URL:

Login Page URL:

• The APP_NAME parameter is your LoginRadius app name, which we mentioned in the Get API Credentials section.
• The RETURN_URL parameter refers to the URL where the user should be redirected to upon successful authentication.

So, what you will do now is to create links or buttons that users can click to access these URLs. First, create a view that will be responsible for displaying your registration and login page. Edit the file of the radiusApp application and add the following code:

All this view does is render an HTML page as a response. Now, you need to add the URL pattern for this view.

In the file of your radiusApp application, add the following code:

The view can now be accessed by a URL. It's time to create a template for your view. But before you do that, let me introduce some basic styling you will use in your application.

Create a static directory and a file in your app directory. Open your terminal and type the following command:

Open the file and the following CSS styles:

Now, create the template for your view.

Create a templates directory and a file in your app directory.

Open your terminal and type the following command:

Open the file and add the following HTML

We used an event on both the register and login buttons, which when clicked changes the window's location to the Auth Page (IDX) register and login page respectively.

NOTE: Don’t forget to replace the {APP_NAME} placeholder with your LoginRadius app name.

Also, in the register and login link, we replaced the {RETURN_URL} parameter with , which is the user profile page you are going to create shortly.

Run the development server and open , you will see a page like this:

Now, when you click the register or login button, you will see a page like this:

When LoginRadius successfully authenticates a user, it attaches an access token in the query string as a token parameter to the REDIRECT_URL.

Retrieve User Data using Access Token

In this section, you are going to retrieve the authenticated user data using access token. But first you need to initialize LoingRadius SDK with your API_KEY and API_SECRET.

Intializing LoginRadius SDK

Create a new file in your radiusApp directory.

Open your terminal and type this command:

Open the file and add the following lines of code:

Replace API_KEY and API_SECRET with your respective LoginRadius API credentials.

Now, create the view that will be responsible for retrieving user data.

Open the file in your radiusApp directory and add the following lines of code:

In this code snippet, we imported the initialized LoginRadius class from the file and also imported and from there respective modules.

We also introduced a new function called . In this function we did the following:

• We first checked if there is a token parameter attached to the request. If true,
• We created a and block. In the block we used the method to retrieve the user data from the access token and assigned it to a variable called while in the block we returned a HttpResponse of the error that occurred if the block fails.
• If the block successfully retrieved the user's data, we rendered a page, and also attached the variable to the response.
• Else, if there is no token parameter attached to the request, we redirect the user back to the registration and login page.

Now, add the URL pattern and also create a template for your views.

Modify the file in the radiusApp directory.

Head over to the templates directory in the radiusApp directory and create a file.

In the termainal type:

Open your file and add the following HTML code:

Here we displayed the Provider, Email and NoOfLogins from the . These are just some of the data present in the .

Now, if you run your development server, and then register and login a user, you should see a page like this:

To see the entire data present in the , you can do something like this in your , file:

Conclusion

In this tutorial, we discussed how to use LoginRadius for registration and authentication in Django. We started by introducing LoginRadius, what it is, its benefits, and how to get started with it. Then, we illustrated building a demo application with Django and implemented registration and authentication using LoginRadius.

GitHub repo: radiusAuth