====== Autenticació a Django ======

{{ django-logo.png?200 }}

Pots llegir la doc oficial d'autenticació de Django:
  * https://docs.djangoproject.com/en/stable/topics/auth/default/

<WRAP info>
Aquest article continua d'altres articles d'aquesta wiki:
  * [[Django]]
  * [[Django Frontend]]
  * [[Django Lliga]]
</WRAP>

{{tag> #FpInfor #Daw #DawMp07 #DawMp07Uf02 #DawMp07Uf2 django framework python web}}

===== Auth Quickstart =====
Per anar ràpid, podem instal·lar el model sencer ''auth'' ([[https://docs.djangoproject.com/en/latest/topics/auth/default/#module-django.contrib.auth.views|llegir doc]]) i totes les seves rutes. També afegirem ''accounts/profile/'' que és la pàgina per defecte un cop fer login:

<file python urls.py>
urlpatterns = [
    path("accounts/", include("django.contrib.auth.urls")),
    path("accounts/profile/", profile, name="profile"),
]
</file>

Això ens configurarà les rutes:
<code>
accounts/login/ [name='login']
accounts/logout/ [name='logout']
accounts/password_change/ [name='password_change']
accounts/password_change/done/ [name='password_change_done']
accounts/password_reset/ [name='password_reset']
accounts/password_reset/done/ [name='password_reset_done']
accounts/reset/<uidb64>/<token>/ [name='password_reset_confirm']
accounts/reset/done/ [name='password_reset_complete']
</code>

Només ens caldrà afegir plantilles per a ''login.html'' i ''profile.html'', i tindrem a punt el sistema complert.

Per habilitar les plantilles en la carpeta principal, caldrà afegir un element a la secció DIRS de TEMPLATES a ''settings.py'':
<file python settings.py>
TEMPLATES = [
    {
        # ...
        'DIRS': [ BASE_DIR/"templates" ],
        # ...
    },
]
</file>


--> Plantilla login.html (la que surt a la doc oficial)#
Aquesta és la [[https://docs.djangoproject.com/en/latest/topics/auth/default/#module-django.contrib.auth.views|plantilla de la doc oficial]] però la podeu personalitzar:

<file html templates/registration/login.html>
{% extends "base.html" %}

{% block content %}

{% if form.errors %}
<p>Your username and password didn't match. Please try again.</p>
{% endif %}

{% if next %}
    {% if user.is_authenticated %}
    <p>Your account doesn't have access to this page. To proceed,
    please login with an account that has access.</p>
    {% else %}
    <p>Please login to see this page.</p>
    {% endif %}
{% endif %}

<form method="post" action="{% url 'login' %}">
{% csrf_token %}
<table>
<tr>
    <td>{{ form.username.label_tag }}</td>
    <td>{{ form.username }}</td>
</tr>
<tr>
    <td>{{ form.password.label_tag }}</td>
    <td>{{ form.password }}</td>
</tr>
</table>

<input type="submit" value="login">
<input type="hidden" name="next" value="{{ next }}">
</form>

{# Assumes you set up the password_reset view in your URLconf #}
<p><a href="{% url 'password_reset' %}">Lost password?</a></p>

{% endblock %}
</file>
<--

\\


===== Profile view =====
Un cop logats ens redirigirà cap a ''/accounts/profile/'', però de nou aquesta //view// no està definida per defecte. Posem aquí un exemple mínim de la //view// + //template//:

<file html registration/profile.html>
Benvingut {{user}}.
<br>
<a href="/accounts/logout/?next=/accounts/login">Logout</a>
</file>

A la //view// convé fixar-se en com utilitzar el **decorator @login_required**. Si no estem logats, ens farà fora i ens redirigirà cap al formulari de //login//.

<file python views.py>
from django.contrib.auth.decorators import login_required

@login_required
def profile(request):
    usuari = request.user
    print(f"Usuari {usuari} ha entrat") # es veurà als logs
    return render(request,"registration/profile.html")
</file>

A partir d'ara, seria convenient particularitzar les plantilles de per ''password_reset'', ''password_change'', etc, però al menys ja tenim les //views// creades oficials, la qual cosa ens estalviarà molta feina.

\\

===== Exercicis =====
<WRAP todo>
Implementa l'autenticació del //frontend// en el teu projecte. Si no n'has fet cap, pots seguir [[Django Lliga]].

Afegeix un //link// de canvi de contrasenya al ''profile.html''.

Canvia els templates per defecte del canvi de contrasenya, de manera que a l'acabar el canvi ens ofereixi tornar a la pàgina de //profile//.

</WRAP>

\\