A how-to or tutorial document for using authentication views and forms is needed

[Daniele Procida]

There's are some substantial documents in /topics/auth/, but there isn't a step-by-step tutorial or how-to.

There's a need for it in the official documentation, because:

• it's worthwhile getting users started on the right track, so that they don't find themselves doing it insecurely or incorrectly
• there are plenty of questions on the subject on StackOverflow and elsewhere
• there are numerous (often out-of-date or incomplete) weblog articles circulating on the subject

Probably a how-to is more appropriate than a tutorial.

[Tim Graham]

#22075 contains some suggestions related to this.

[Collin Anderson]

We could better document django.contrib.auth.urls

     url('accounts/', include('django.contrib.auth.urls'),

And give an example view that uses UserCreationForm.

[Collin Anderson]

I'm interested in working on this today.

[Collin Anderson]

All I got to was an really rough outline:

- login view
- login form
- login template
- login url
- login_required
- logout view
- create view
- create form
- create template
- create url

[Haris Ibrahim K. V.]

I am working on writing up this tutorial. I have a rough draft ready here: ​https://github.com/harisibrahimkv/django/blob/3cbcca57465f0dbdf5265b0b80d0bf307ed4505e/docs/topics/auth/tutorial.txt

This is my first time and I am not sure what exactly needs to go in there.

Looking for feedback.

[Carlos Leite]

Replying to harisibrahimkv:

I am working on writing up this tutorial. I have a rough draft ready here: ​https://github.com/harisibrahimkv/django/blob/3cbcca57465f0dbdf5265b0b80d0bf307ed4505e/docs/topics/auth/tutorial.txt

This is my first time and I am not sure what exactly needs to go in there.

Looking for feedback.

this ​link to the article is broken

[Jacob Walls]

Clearing flags for any new attempt when ready.

[Tim Graham]

I closed #36204 ("Request to Add User Login & Authentication Example to the Official Django First Steps tutorial") as a duplicate.

[Aarushi]

Hi, I'm Aarushi, a new contributor. I'd like to work on this ticket if it’s available. I'm currently setting up my local environment and will follow up with a plan soon.

[Aarushi]

"Hi everyone, I have completed the how-to guide for the authentication system. I've submitted a pull request with the full tutorial, including sections for URL configuration, login views, user registration, and password resets.
PR Link: ​https://github.com/django/django/pull/20910"