🟢 Cómo configurar el servidor de autenticación en Supabase Self-Hosted

Self-Hosting Auth

El servidor de autenticación de Supabase (GoTrue) es una API basada en JSON Web Tokens (JWT) para la gestión de usuarios y emisión de tokens de acceso.

GoTrue es una API open source escrita en Golang que funciona como un servicio independiente para manejar el registro y la autenticación de usuarios en proyectos JAM.

Está basada en OAuth2 y JWT, y se encarga del signup, login y la gestión de datos personalizados de usuarios.

Client libraries

• JavaScript
• Dart

Links adicionales

• Código fuente
• Bugs y problemas conocidos
• Guías de autenticación

Endpoints administrativos

Generar un link de acción por email

Genera un link de acción para un usuario (confirmación, recuperación, cambio de email).

• POST /admin/generate_link
• Body: application/json

Campos disponibles:

• email (opcional)
• new_email (opcional)
• password (opcional)
• redirect_to (opcional)
• type (opcional)

Obtener un usuario

• GET /admin/user/{user_id}
• Parámetro requerido: user_id

Actualizar un usuario

• PUT /admin/user/{user_id}
• Parámetro requerido: user_id

Eliminar un usuario

• DELETE /admin/user/{user_id}
• Parámetro requerido: user_id

Listar todos los usuarios

• GET /admin/users

Crear un usuario

• POST /admin/users
• Body: application/json

Campos disponibles:

• email
• password
• phone
• role
• app_metadata
• user_metadata

Autenticación de usuarios

Registro con contraseña

• POST /signup
• Campos: email, password, phone

Inicio de sesión con contraseña

• POST /token?grant_type=password
• Campos: email / phone y password

Refrescar token

• POST /token?grant_type=refresh_token
• Campo: refresh_token

Obtener usuario autenticado

• GET /user

Actualizar usuario autenticado

• PUT /user
• Campos posibles: email, password, phone, app_metadata, user_metadata

Verificar registro

• POST /verify
• Campos: email, phone, token, type, redirect_to

Otros endpoints

• POST /invite — envía un link de invitación
• POST /recover — recuperación de contraseña
• POST /otp — login sin contraseña
• POST /logout — cerrar sesión
• GET /settings — configuración del servidor GoTrue
• GET /health — healthcheck del servicio

Ejemplos y esquemas de respuesta

Para evitar duplicar todos los ejemplos de requests y responses del servidor de autenticación (GoTrue), esta documentación se enfoca en describir el funcionamiento general y los endpoints disponibles.

Los ejemplos completos de payloads, esquemas de respuesta y códigos HTTP se encuentran centralizados en la documentación oficial de Supabase.

• Los ejemplos de request y response no se incluyen aquí para mantener la documentación más clara y fácil de mantener.
• Los esquemas JSON completos pueden variar según la configuración del proyecto y la versión del servidor Auth.
• Siempre se recomienda consultar la referencia oficial para ver ejemplos actualizados y detallados.

📚 Referencia oficial:

https://supabase.com/docs/reference/self-hosting-auth/update-a-user