YouTube Video:
Instrucciones:
1. Instala Django
Obviamente lo primero que vamos a hacer es instalar Django, al día de hoy que estoy escribiendo este artículo la versión es 4.1.2.
Vamos entonces a crear un directorio, después creamos un ambiente virtual utilizando pipenv, instalamos django y creamos el proyecto.
1
2
3
4
5
|
$ mkdir my_project && cd my_project
$ pipenv install django~=4.1.2
$ pipenv shell
(my_project)$ django-admin startproject auth .
(my_project)$ python manage.py runserver
|
ATENCIÓN:
Es muy importante que no ejecutes los comandos “makemigrations” o “migrate” antes de completar todos los pasos descritos en este artículo.
Si todo sale como lo planeamos, lo siguiente es dar clic en la liga que aparece en la terminal o también puedes abrir un navegador e ir a http://127.0.0.1:8000/ en donde debe aparecer la página de bienvenida de Django.
Para detener el servidor presiona Ctrl + c en la terminal.
2. Crea La App Users
Django viene por defecto con un modelo de usuario que es el que utiliza para la autenticación.
Nosotros vamos a modificar este modelo creando uno propio que nos permita utilizar la cuenta de Correo Electronico en vez de un Nombre de Usuario.
Ahora es momento de crear una app en la cual vamos a modificar el modelo de usuario que viene por defecto con Django.
1
|
(my_project)$ python manage.py startapp users
|
Una vez creada la app, no te olvides de agregarla en INSTALLEDAPPS en el archivo _settings.py
1
2
3
4
5
|
INSTALLED_APPS = [
...
# other apps
'users',
]
|
3. Modifica El Archivo users/models.py
A continuación agrega el siguiente codigo al archivo users/model.py. Esto es necesario para hacer “email” el campo por defecto en vez de “username”.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
|
from django.db import models
from django.contrib.auth.models import AbstractBaseUser, PermissionsMixin, BaseUserManager
class CustomUserManager(BaseUserManager):
def _create_user(self, email, password, first_name, last_name, is_email_verified, **extra_fields):
if not email:
raise ValueError("Email must be provided")
if not password:
raise ValueError("Password must be provided")
user = self.model(
email=self.normalize_email(email),
first_name=first_name,
last_name=last_name,
is_email_verified=is_email_verified,
**extra_fields
)
user.set_password(password)
user.save(using=self.db)
return user
def create_user(self, email, password, first_name, last_name, is_email_verified, **extra_fields):
extra_fields.setdefault("is_staff", False)
extra_fields.setdefault("is_superuser", False)
return self._create_user(email, password, first_name, last_name, is_email_verified, **extra_fields)
def create_superuser(self, email, password, first_name, last_name, is_email_verified, **extra_fields):
extra_fields.setdefault("is_staff", True)
extra_fields.setdefault("is_superuser", True)
if extra_fields.get("is_staff") is not True:
raise ValueError("Superuser must have is_staff=True.")
if extra_fields.get("is_superuser") is not True:
raise ValueError("Superuser must have is_superuser=True.")
return self._create_user(email, password, first_name, last_name, is_email_verified, **extra_fields)
class User(AbstractBaseUser, PermissionsMixin):
email = models.EmailField(db_index=True, unique=True, max_length=254)
first_name = models.CharField(max_length=240)
last_name = models.CharField(max_length=255)
is_email_verified = models.BooleanField(default=False)
is_staff = models.BooleanField(default=True) # Required
is_active = models.BooleanField(default=True)
is_superuser = models.BooleanField(default=False)
objects = CustomUserManager()
USERNAME_FIELD = 'email'
REQUIRED_FIELDS = ['first_name', 'last_name', 'is_email_verified']
class Meta:
verbose_name = 'User'
verbose_name_plural = 'Users'
|
4. Modifica Settings.py
Ahora es momento de decirle a Django que utilice nuestro modelo como modelo para la autenticación de los usuarios. Agrega el siguiente codigo al archivo settings.py
1
|
AUTH_USER_MODEL = 'users.User'
|
5. Agrega el nuevo modelo a la consola de administración
Como modificamos el modelo del usuario que viene por defecto en Django, ahora lo que debemos hacer es agregar el nuevo modelo a la consola de administración, para eso debemos agregar lo siguiente al archivo “users/admin.py”
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
|
from django.contrib import admin
from .models import User
class CustomUserAdmin(admin.ModelAdmin):
list_display = (
'email',
# 'first_name',
# 'last_name',
'is_email_verified',
'is_staff',
'is_active',
)
list_filter = ('email', 'is_staff', 'is_email_verified',)
fieldsets = (
(None, {'fields': (
'first_name',
'last_name',
'password',
'groups'
)}),
('Permissions', {'fields': (
'user_permissions',
'is_email_verified',
'is_staff',
'is_active',
'is_superuser'
)}),
)
search_fields = ('email',)
ordering = ('email',)
admin.site.register(User, CustomUserAdmin)
|
6. Crea Las Tablas
A continuación actualiza las tablas en la base de datos corriendo los comandos makemigrations y migrate de la siguiente manera:
1
2
|
(my_project)$ python manage.py makemigrations
(my_project)$ python manage.py migrate
|
7. Crea El Superusuario
Luego vamos a crear el superusuario con el siguiente comando:
1
2
3
4
5
6
7
8
|
(my_project)$ python manage.py createsuperuser
Email: jorge@linuxfacil.mx
First name: Jorge
Last name: Ramirez
Is email verified: True
Password:
Password (again):
Superuser created successfully.
|
8. Prueba La Configuración
Por último vamos a correr el servidor y entrar a la consola de administración.
Ejecuta el servidor usando
1
|
(my_project)$ python manage.py runserver
|
Y en tu navegador abre la siguiente dirección: http://127.0.0.1:8000/admin/
Ingresa el correo electrónico y el password del superusuario
Y listo.
