Add Authorization to Your Django API Application

This guide demonstrates how to integrate Auth0 with any new or existing Python API built with Django.

If you haven't created an API in your Auth0 Dashboard yet, you can use the interactive selector to create a new Auth0 API or select an existing API that represents the project you want to integrate with.

Alternatively, you can read our getting started guide, which will help you set up your first API through the Auth0 Dashboard.

Every API in Auth0 is configured using an API Identifier that your application code will use as the Audience to validate the Access Token.

New to Auth0? Learn how Auth0 works and read about implementing API authentication and authorization using the OAuth 2.0 framework.

Define permissions

Permissions let you define how resources can be accessed on behalf of the user with a given access token. For example, you might choose to grant read access to the messages resource if users have the manager access level, and grant write access to that resource if they have the administrator access level.

You can define allowed permissions in the Permissions view of the Auth0 Dashboard's APIs section. The following example uses the read:messages scope.

Auth0 Dashboard> Applications > APIs > [Specific API] > Permissions tab

Configure Django to use Auth0

Install dependencies

Add the following dependencies to your requirements.txt:
Run pip install -r requirements.txt

Create a Django application

Create the JWT validator

You will use a library called Authlib to create a ResourceProtector, which is a type of Django view decorator that protects your resources (API views) with a given validator.

The validator will verify the Access Token that you pass to the resource by checking that it has a valid signature and claims.

You can use AuthLib's JWTBearerTokenValidator validator with a few tweaks to make sure it conforms to our requirements for validating Access Tokens.

To create your Auth0JWTBearerTokenValidator, you need to pass it to your domain and audience (API Identifier). It will then get the public key required to verify the token's signature and pass it to the JWTBearerTokenValidator class.

You'll then override the class's claims_options to make sure the token's expiry, audience, and issue claims are validated according to our requirements.

Create the file apiexample/validator.py using the code from the interactive panel.

Create the API views

Next, you'll create three API views in apiexample/views.py:

/api/public: A public endpoint that requires no authentication.
/api/private: A private endpoint that requires a valid Access Token JWT.
/api/private-scoped: A private endpoint that requires a valid Access Token JWT containing the given scope.

The protected routes will have a require_auth decorator, which is a ResourceProtector that uses the Auth0JWTBearerTokenValidator you created earlier.

To create the Auth0JWTBearerTokenValidator, you'll pass it to your tenant's domain and the API Identifier of the API you created earlier.

The require_auth decorator on the private_scoped route accepts an additional argument "read:messages", which checks the Access Token for the Permission (Scope) you created earlier.

Add URL mappings

In previous steps, you added methods to the views.py file. Next, map those methods to URLs using Django's URL dispatcher, which lets you map URL patterns to views.

Add the URL patterns to your apiexample/urls.py file.

Make a Call to Your API

To make calls to your API, you will need an access token. You can retrieve an access token for testing purposes from the Test view in your API settings.

Auth0 Dashboard> Applications > API > [Specific API] > Test tab

Provide the access token as an Authorization header in your requests.

cURL
C#
Go
Java
Node.JS
Obj-C
...

curl --request get \
--url 'http:///{yourDomain}.com/api_path' \
--header 'authorization: Bearer YOUR_ACCESS_TOKEN_HERE'

Was this helpful?

var client = new RestClient("http:///{yourDomain}.com/api_path");
var request = new RestRequest(Method.GET);
request.AddHeader("authorization", "Bearer YOUR_ACCESS_TOKEN_HERE");
IRestResponse response = client.Execute(request);

Was this helpful?

package main
import (
"fmt"
"net/http"
"io/ioutil"
)
func main() {
url := "http:///{yourDomain}.com/api_path"
req, _ := http.NewRequest("get", url, nil)
req.Header.Add("authorization", "Bearer YOUR_ACCESS_TOKEN_HERE")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := ioutil.ReadAll(res.Body)
fmt.Println(res)
fmt.Println(string(body))
}

Was this helpful?

HttpResponse<String> response = Unirest.get("http:///{yourDomain}.com/api_path")
.header("authorization", "Bearer YOUR_ACCESS_TOKEN_HERE")
.asString();

Was this helpful?

var axios = require("axios").default;
var options = {
method: 'get',
url: 'http:///{yourDomain}.com/api_path',
headers: {authorization: 'Bearer YOUR_ACCESS_TOKEN_HERE'}
};
axios.request(options).then(function (response) {
console.log(response.data);
}).catch(function (error) {
console.error(error);
});

Was this helpful?

#import <Foundation/Foundation.h>
NSDictionary *headers = @{ @"authorization": @"Bearer YOUR_ACCESS_TOKEN_HERE" };
NSMutableURLRequest *request = [NSMutableURLRequest requestWithURL:[NSURL URLWithString:@"http:///{yourDomain}.com/api_path"]
                                                   cachePolicy:NSURLRequestUseProtocolCachePolicy

                                               timeoutInterval:10.0];

[request setHTTPMethod:@"get"];
[request setAllHTTPHeaderFields:headers];
NSURLSession *session = [NSURLSession sharedSession];
NSURLSessionDataTask *dataTask = [session dataTaskWithRequest:request
                                        completionHandler:^(NSData *data, NSURLResponse *response, NSError *error) {

                                            if (error) {

                                                NSLog(@&quot;%@&quot;, error);

                                            } else {

                                                NSHTTPURLResponse *httpResponse = (NSHTTPURLResponse *) response;

                                                NSLog(@&quot;%@&quot;, httpResponse);

                                            }

                                        }];

[dataTask resume];

Was this helpful?

$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "http:///{yourDomain}.com/api_path",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "get",
CURLOPT_HTTPHEADER => [
&quot;authorization: Bearer YOUR_ACCESS_TOKEN_HERE&quot;

],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}

Was this helpful?

import http.client
conn = http.client.HTTPConnection("")
headers = { 'authorization': "Bearer YOUR_ACCESS_TOKEN_HERE" }
conn.request("get", "/{yourDomain}.com/api_path", headers=headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))

Was this helpful?

require 'uri'
require 'net/http'
url = URI("http:///{yourDomain}.com/api_path")
http = Net::HTTP.new(url.host, url.port)
request = Net::HTTP::Get.new(url)
request["authorization"] = 'Bearer YOUR_ACCESS_TOKEN_HERE'
response = http.request(request)
puts response.read_body

Was this helpful?

import Foundation
let headers = ["authorization": "Bearer YOUR_ACCESS_TOKEN_HERE"]
let request = NSMutableURLRequest(url: NSURL(string: "http:///{yourDomain}.com/api_path")! as URL,
                                    cachePolicy: .useProtocolCachePolicy,

                                timeoutInterval: 10.0)

request.httpMethod = "get"
request.allHTTPHeaderFields = headers
let session = URLSession.shared
let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in
if (error != nil) {
print(error)

} else {
let httpResponse = response as? HTTPURLResponse

print(httpResponse)

}
})
dataTask.resume()

Was this helpful?

Ṅḛḛẋţ Ṣţḛḛṗṡ

ḚḚẋͼḛḛḽḽḛḛṇţ ẁṓṓṛḳ! ḬḬϝ ẏẏṓṓṵṵ ṃααḍḛḛ ḭḭţ ţḥḭḭṡ ϝααṛ, ẏẏṓṓṵṵ ṡḥṓṓṵṵḽḍ ṇṓṓẁ ḥααṽḛḛ ḽṓṓḡḭḭṇ, ḽṓṓḡṓṓṵṵţ, ααṇḍ ṵṵṡḛḛṛ ṗṛṓṓϝḭḭḽḛḛ ḭḭṇϝṓṓṛṃααţḭḭṓṓṇ ṛṵṵṇṇḭḭṇḡ ḭḭṇ ẏẏṓṓṵṵṛ ααṗṗḽḭḭͼααţḭḭṓṓṇ.

Ṫḥḭḭṡ ͼṓṓṇͼḽṵṵḍḛḛṡ ṓṓṵṵṛ ʠṵṵḭḭͼḳṡţααṛţ ţṵṵţṓṓṛḭḭααḽ, ḅṵṵţ ţḥḛḛṛḛḛ ḭḭṡ ṡṓṓ ṃṵṵͼḥ ṃṓṓṛḛḛ ţṓṓ ḛḛẋṗḽṓṓṛḛḛ. Ṫṓṓ ḽḛḛααṛṇ ṃṓṓṛḛḛ ααḅṓṓṵṵţ ẁḥααţ ẏẏṓṓṵṵ ͼααṇ ḍṓṓ ẁḭḭţḥ ÀÀṵṵţḥ0, ͼḥḛḛͼḳ ṓṓṵṵţ:

ÀÀṵṵţḥ0 Ḍααṡḥḅṓṓααṛḍ - Ḻḛḛααṛṇ ḥṓṓẁ ţṓṓ ͼṓṓṇϝḭḭḡṵṵṛḛḛ ααṇḍ ṃααṇααḡḛḛ ẏẏṓṓṵṵṛ ÀÀṵṵţḥ0 ţḛḛṇααṇţ ααṇḍ ααṗṗḽḭḭͼααţḭḭṓṓṇṡ
ÀÀṵṵţḥ0 Ṁααṛḳḛḛţṗḽααͼḛḛ - Ḍḭḭṡͼṓṓṽḛḛṛ ḭḭṇţḛḛḡṛααţḭḭṓṓṇṡ ẏẏṓṓṵṵ ͼααṇ ḛḛṇααḅḽḛḛ ţṓṓ ḛḛẋţḛḛṇḍ ÀÀṵṵţḥ0’ṡ ϝṵṵṇͼţḭḭṓṓṇααḽḭḭţẏẏ

Ḍḭḭḍ ḭḭţ ẁṓṓṛḳ?

ÀÀṇẏẏ ṡṵṵḡḡḛḛṡţḭḭṓṓṇ ṓṓṛ ţẏẏṗṓṓ?

ḚḚḍḭḭţ ṓṓṇ ḠḭḭţḤṵṵḅ

ṗααḡḛḛṡ.ţṵṵţṓṓṛḭḭααḽṔααḡḛḛ.ṇḛḛẁ.ααͼţḭḭṓṓṇḤḛḛṛṓṓ.ṡḭḭḡṇṲṲṗḤḛḛṛṓṓ.ḅṵṵţţṓṓṇṪḛḛẋţ

Ṣḭḭḡṇ ṵṵṗ ϝṓṓṛ ααṇ ṓṓṛ ḽṓṓḡ ḭḭṇ ţṓṓ ẏẏṓṓṵṵṛ ḛḛẋḭḭṡţḭḭṇḡ ααͼͼṓṓṵṵṇţ ţṓṓ ḭḭṇţḛḛḡṛααţḛḛ ḍḭḭṛḛḛͼţḽẏẏ ẁḭḭţḥ ẏẏṓṓṵṵṛ ṓṓẁṇ ţḛḛṇααṇţ.