euroglas/authemail

Modulo de autenticación usando nombre de usuario y contraseña

1.0.0 2021-02-28 05:27 UTC

Requires

• emarref/jwt: ^1.0.3
• euroglas/dbaccess: @dev

agpl-3.0

• Octavio Galindo

• rest
• auth
• sesodi

README

Parte del servidor REST para EUROGLAS

Autenticación de clientes, usando email y contraseñas

Archivos

authemail
├───src
│   └───authemail.php
├───.gitignore
├───composer.json
├───index.php
├───iniciaServidorDePruebas.php
├───servidor.ini
├───LICENSE
└───README.md

Directorio src

Contiene el archivo que implementan el modulo, extendiendo la clase base auth (que implementa las interfaces authInterface y restModuleInterface)

class authemail extends \euroglas\eurorest\auth

Directorio Raiz

Contiene los archivos para pruebas del modulo.

Archivo	Descripcion
.gitIgnore	blah
composer.json	Manejo de requerimientos
index.php	Implementacion del servidor de pruebas
servidor.ini	Configuracion del servidor
iniciaServidorDePruebas.bat	Script para arrancar el servidor usando el servidor interno de PHP
LICENSE	Licencia de uso de este paquete
README .md	éste archivo

Configuración

Llave	Explicación
ServerName="Nombre"	Nombre del servidor
ModoDebug = 1	Habilita el modo de desarrollo
[Modulos] authemail=1	Habilita el modulo authemail, queda registrado como proveedor de Autorizaciones

Token

Para el servidor, estamos haciendo uso de los JASON Web Token (JWT). Para usarlos, se requieren DOS pasos:

1. Intercambiar credenciales (la llave) por un token.
   1. Se hace una solicitud al servidor, incluyendo las credenciales requeridas
   2. El servidor valida las credenciales y si son validas, devuelve un TOKEN
   3. Si las credenciales NO son validas, se regresa un error
2. Todas las llamadas que requieran token, deben incluirlo:
   Encabezado HTTP: Authorization
   Formato : Bearer <token> (OJO: Es sensible a mayuscula/minuscula)

URLs

Metodo	URL	TOKEN	Descripción
POST	/auth	NO	Intercambia credenciales por un Token JWT. Como credenciales, se espera recibir los parametros: email Correo electrónico del usuario password Contraseña del usuario Ejemplo: ejemplo.com?email={correo}&password={contraseña}
GET	/testoken	SI	Valida el token proporcionado
GET	/auth/name	SI	Nombre del cliente autenticado

Uso del modulo authkey en un servidor REST de EUROGLAS

• Instala composer en tu ambiente de desarrollo
• Crea un directorio para tu proyecto
• Agrega el modulo base (eurorest) a tu proyecto:

composer require euroglas/eurorest

• Agrega éste modulo

composer require euroglas/authemail

• O bien, edita el archivo composer.json para que contenga los requerimientos

        {
            "require": {
                "euroglas/eurorest": "^1.0.0",
                "euroglas/authemail": "^1.0.0"
            }
        }

• Ejecuta composer para instalar las dependencias (esto va a generar el archivo composer.lock y el directorio vendor)

php composer.phar install

Si quieres hacer uso de la utileria de autocarga de clases de composer, incluye esto en tu script php (index.php):

require 'vendor/autoload.php';

NOTA Si quieres saber más sobre el servidor REST, consulta la informacion del modulo euroglas/eurorest