Django Simple SSO Specification (DRAFT)
Terminology
Server
The server is a Django website that holds all the user information and authenticates users.
Client
The server is a Django website that provides login via SSO using the Server. It does not hold any user information.
Key
A unique key identifying a Client. This key can be made public.
Secret
A secret key shared between the Server and a single Client. This secret should never be shared with anyone other than the Server and Client and must not be transferred unencrypted.
Workflow
User wants to log into a Client by clicking a “Login” button. The initially requested URL can be passed using the next GET parameter.
The Client’s Python code does a HTTP request to the Server to request a authentication token, this is called the Request Token Request.
The Server returns a Request Token.
The Client redirects the User to a view on the Server using the Request Token, this is the Authorization Request.
If the user is not logged in the the Server, they are prompted to log in.
The user is redirected to the Client including the Request Token and a Auth Token, this is the Authentication Request.
The Client’s Python code does a HTTP request to the Server to verify the Auth Token, this is called the Auth Token Verification Request.
If the Auth Token is valid, the Server returns a serialized Django User object.
The Client logs the user in using the Django User recieved from the Server.
Requests
General
All requests have a signature and key parameter, see Security.
Request Token Request
Client: Python
Target: Server
Method: GET
Extra Parameters: None
Responses:
200: Everything went fine, the body of the response is a url encoded query string containing with the request_token key holding the Request Token as well as the signature.
400: Bad request (missing GET parameters)
403: Forbidden (invalid signature)
Authentication Request
Client: Browser (User)
Target: Client
Method: GET
Extra Parameters:
request_token: The Request Token returned by the Request Token Request.
auth_token: The Auth Token generated by the Authorization Request.
Responses:
200: Everything went fine, the user is now logged in.
400: Bad request (missing GET parameters).
403: Forbidden (invalid Request Token).
Auth Token Verification Request
Client: Python
Target: Server
Method: GET
Extra Parameters:
auth_token: The Auth Token obtained by the Authentication Request.
Responses:
200: Everything went fine, the body of the response is a url encoded query string containing the user key which is the JSON serialized representation of the Django user to create as well as the signature.
Security
Ever request is signed using HMAC-SHA256. The signature is in the signature parameter. The signature message is the urlencoded, alphabetically ordered query string. The signature key is the Secret of the Client. To verify the signature the key paramater holding the key of the Client is also sent with every request from the Client to the Server.
Example
GET Request with the GET parameters key=bundle123 and the private key secret key: fbf6396d0fc40d563e2be3c861f7eb5a1b821b76c2ac943d40a7a63b288619a9
The User object
The User object returned by a successful Auth Token Verification Request does not contain all the information about the Django User, in particular, it does not contain the password.
The user object contains must contain at least the following data:
username: The unique username of this user.
email: The email of this user.
first_name: The first name of this user, this field is required, but may be empty.
last_name: The last name of this user, this field is required, but may be empty.
is_staff: Can this user access the Django admin on the Client?
is_superuser: Does this user have superuser access to the Client?
- permissions: A list of dictionaries with following keys:
content_type: The natural key of the content type this permission points to.
codename: The codename of this permission.
Implementation
On the server
Add simple_sso.sso_server to INSTALLED_APPS.
Include the simple_sso.sso_server.urls url patterns somewhere.
Optionally provide the SIMPLE_SSO_USER_CONSTRUCTOR setting which points to a callable which, given a Django user instance, returns a dictionary representation containing the information as described in The User object.
On the client
Create a new instance of simple_sso.sso_server.models.Client on the Server.
Add the SIMPLE_SSO_SECRET and SIMPLE_SSO_KEY settings as provided by the Server’s simple_sso.sso_server.models.Client model.
Add the SIMPLE_SSO_SERVER setting which is the absolute URL pointing to the root where the simple_sso.sso_server.urls where include on the Server.
Add the simple_sso.sso_client.urls patterns somewhere on the client.
2 maintainers
Metadata
2 maintainers
Release files for django-simple-sso 0.3.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| django-simple-sso-0.3.1.tar.gz | 11.0 kB | Without provenance | Details for django-simple-sso-0.3.1.tar.gz |
Release files / django-simple-sso-0.3.1.tar.gz
| Download URL | django-simple-sso-0.3.1.tar.gz |
|---|---|
| Size | 11.0 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
34335466df29246c228f4e837c08aa66c57003bef9c79d388a9c72df213d8113
|
|
BLAKE2b-256 checksum How to use checksums |
557512ccbbf1903a5c85f0a44df7a5fb0b804d3694adb9409c8f3ad00a0d137e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
Security for django-simple-sso 0.3.1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
