Diferències

Ací es mostren les diferències entre la revisió seleccionada i la versió actual de la pàgina.

Enllaç a la visualització de la comparació

--- django_ninja [2025/02/05 22:15]
enric_mieza_sanchez creat
+++ django_ninja [2025/03/21 16:18] (actual)
enric_mieza_sanchez [Autenticació]
@@ Línia 24: / Línia 24: @@
 Destaquem dos mètodes d'autenticació molt estandarditzats:
-  * Basic Authentication
+  * **Basic Authentication** : amb usuari i contrasenya. Convé no fer-la servir sovint ja que la contrasenya és una dada sensible. La clàssica crida a un endpoint amb aquest mecanisme seria:<code bash>curl http://localhost:8000/api/token/ -u manolo:pass123</code>
-  * Token Authentication
+  * **Token Authentication** : millora la seguretat en les crides a l'API, enviant un //token// enlloc de la contrasenya. El //token// es pot obtenir, per exemple, per Basic Authentication. Les crides a l'API s'han d'acompanyar del //token// sempre, i es pot fer de diverses formes de la qual destaquem el //header Bearer//:<WRAP prewrap><code bash>curl -H 'Authorization: Bearer 1d895b9062512a731b1e5667bd034da3' http://localhost:8000/api/llibres</code></WRAP>
 Es poden implementar les dues amb aquest codi:
-<code api.py python>
+<code python api.py>
+from django.contrib.auth import authenticate as django_authenticate
+from ninja import NinjaAPI, Schema
+from ninja.security import HttpBasicAuth, HttpBearer
+from typing import List, Optional
+from .models import *
+import secrets
+api = NinjaAPI()
+# Autenticació bàsica
+class BasicAuth(HttpBasicAuth):
+    def authenticate(self, request, username, password):
+        user = django_authenticate(username=username, password=password)
+        if user:
+            # Genera un token simple
+            token = secrets.token_hex(16)
+            user.auth_token = token
+            user.save()
+            return token
+        return None
+# Autenticació per Token Bearer
+class AuthBearer(HttpBearer):
+    def authenticate(self, request, token):
+        try:
+            user = Usuari.objects.get(auth_token=token)
+            return user
+        except Usuari.DoesNotExist:
+            return None
+# Endpoint per obtenir un token, accés amb BasicAuth
+# amb o sense "trailing slash"
+@api.get("/token", auth=BasicAuth())
+@api.get("/token/", auth=BasicAuth())
+def obtenir_token(request):
+    return {"token": request.auth}
+# Exemple d'endpoint per llistar els llibres, accés amb TokenAuth
+class LlibreOut(Schema):
+    id: int
+    titol: str
+    editorial: Optional[str]
+@api.get("/llibres/", response=List[LlibreOut], auth=AuthBearer())
+def get_llibres(request):
+    qs = Llibre.objects.all()
+    return qs
 </code>
+A part, també caldrà afegir la columna ''auth_token'' al model ''Usuari'' que cal personalitzar:
+<code python models.py>
+from django.contrib.auth.models import AbstractUser
+class Usuari(AbstractUser):
+    auth_token = models.CharField(max_length=32,blank=True,null=True)
+    # + altres atributs que es vulguin afegir...
+</code>
+I a ''settings.py'':
+<code python settings.py>
+AUTH_USER_MODEL = 'myapp.Usuari'
+</code>
+Per tal que els canvis es guardin a la base de dades caldrà crear i executar les migracions adequades:
+  (env) $ ./manage.py makemigrations
+  (env) $ ./manage.py migrate
+<WRAP important>
+Afegir canvis en el model d'usuari quan un projecte ja té dades de producció és problemàtic, com a mínim. **Es recomana sempre crear un model d'usuari personalitzat** (derivat d'AbstractUser) **des del principi del projecte** per poder afegir funcionalitats com aquesta (afegir token a l'usuari) quan sigui necessari.
+Si no tenim dades de producció, el més fàcil és esborrar la base de dades, esborrar tots els arxius de migració, i tornar a crear-los amb:
+  (env) $ ./manage.py makemigrations <nom_app>
+Una possible alternativa, per tal de no haver de crear un model d'usuari personalitzat, és crear una taula de tokens a part, i relacionar-la amb el ''User'' estàndard de Django. Igualment es sol recomanar prioritàriament particularitzar el model d'usuari,  ja que les situacions en les que interessarà ampliar-lo son molt comunes.
+</WRAP>
 \\
+===== Mes curl =====
+El típic exemple de request amb Basic Authentication seria:
+  curl -u admin:admin123 http://localhost:8000/api/users/
+De vegades ens pot interessar una alternativa enviant les dades codificades en base64 en els //headers//:
+  curl -H 'Authorization:Basic YWRtaW46YWRtaW4xMjM=' http://localhost:8000/api/users/
+Per obtenir el //hash// en base64 es pot fer:
+  echo -n "admin:admin123" | base64
+Per aconseguir un //pretty print// del JSON es pot fer amb la [[https://jqlang.org/tutorial/|utilitat jq]]
+  curl -u admin:admin123 http://localhost:8000/api/users/ | jq
+Per instal·lar jq es pot fer:
+  sudo apt install jq

bytes.cat

Eines de l'usuari

Eines del lloc

Diferències

Eines de la pàgina