El entorno web del proyecto Cíclope Core deberá tener una serie de funcionalidades, divididas en módulos, que se detallaran posteriormente.

Transcripción

1 ÍNDICE 1. Introducción 2. Especificaciones de requisitos 2.1 Autenticación 2.2 Administración de Usuarios 2.3 Administración de Accesos. 3. Arquitectura del sistema 3.1 Normalización de la base de datos 3.2 Análisis y diseño de la base de datos Creación de variables de sesión Auditoria interna de la base de datos Análisis y diseño de CICLOPE CORE 3.3 Ejemplo aclaratorio del sistema propuesto Gráfico del ejemplo descriptivo Explicación del ejemplo 3.4 Script de creación, carga y borrado de tablas 4. Instalación y Configuración. 1. INTRODUCCIÓN El proyecto CICLOPE surge como necesidad de crear una aplicación de gestión, vía web, para dar servicio a una serie de escenarios que se plantean en el departamento. De esta forma se pretende que los alumnos puedan realizar las prácticas desde un lugar remoto, sin necesidad de estar físicamente presentes en el lugar de realización. En primer momento se pensó en buscar servicios GPL que cubrieran dichas necesidades, pero no se encontraron aplicaciones que abarcaran todo el contenido. Se tomó la decisión de programar una arquitectura hecha a medida utilizando las siguientes tecnologías GPL: Servidor Web: Apache Programación Servidor: PHP Base de Datos: MySQL 2. ESPECIFICACIONES DE REQUISITOS El entorno web del proyecto Cíclope Core deberá tener una serie de funcionalidades, divididas en módulos, que se detallaran posteriormente. El objetivo es conseguir una arquitectura independiente en módulos, los cuales puedan ser instalados según las necesidades de cada administrador.

2 Los módulos de los que consta el proyecto Cíclope Core son los siguientes: 2.1 AUTENTICACIÓN El módulo de autenticación consiste en identificar al usuario cuando accede al sistema; de esta manera el sistema controla los accesos a los recursos y puede llevar una auditoria interna de las gestiones que vaya realizando a través de su navegación por la herramienta. En concreto, cuando el usuario accede al sistema le aparecerá una pantalla de autenticación con la cual deberá logarse; una vez logado, le aparecerá otra pantalla de inicio dependiendo del grupo al que pertenezca. Surge por tanto la necesidad de crear grupos de usuarios (como en cualquier sistema que se precie), donde cada usuario deberá pertenecer obligatoriamente a un grupo existente aunque por exigencias de las especificaciones podrá tener roles de otros grupos a los que no pertenezca. De esta manera se consigue unificar las características comunes de los usuarios como pueden ser los permisos otorgados, servicio de acceso a noticias, servicio de acceso a banners, envió de s y mensajes sms. Los grupos a su vez deberán pertenecer a un perfil dado de tal manera que se unifique características comunes a los grupos como puedan ser el logotipo utilizado, colores corporativos, resolución de pantalla, etc. Por otro lado, se debe tener en cuenta que un usuario que accede al sistema no podrá acceder a páginas que no están definidos en su entorno, es decir, debe existir una cierta seguridad de acceso a las páginas con el fin de evitar efectos indeseados. 2.2 ADMINISTRACIÓN DE USUARIOS En el módulo de administración de usuarios se permitirá que un administrador del sistema pueda dar de alta a nuevos usuarios, así como modificar datos de usuarios existentes e incluso darlos de baja lógica. También se permitirá resetear las password de los usuarios, en caso de que alguien la olvide. Al igual que los usuarios, se permitirá la administración de grupos de usuarios, de tal forma que un usuario se encuentre dentro de un grupo de usuarios de acceso al sistema. Cada grupo llevará asociado unos privilegios definidos dentro de sistema y estos privilegios los heredarán los usuarios que estén incluidos en dicho grupo. 2.3 ADMINISTRACIÓN DE ACCESOS En esta parte se permitirá dar privilegios a los grupos, de tal forma que cada página php que se desarrolle llevara asociada una funcionalidad. En la administración de accesos se asociarán páginas php a grupos, de tal forma que los usuarios de dicho grupo puedan acceder a las páginas que tienen asociadas. Un usuario que pertenece a un grupo, no podrá acceder a una página, a partir de ahora funcionalidad, que no este asociada a su grupo. Con esto se controla el acceso a ciertas funcionalidad definidas para usuarios en concreto.

3 3. ARQUITECTURA DEL SISTEMA En la reunión que hizo el equipo de investigación con fecha 30 de Abril de 2003 se acordó que Restituto Martínez se hiciera cargo del análisis y diseño de la base de datos que servirá de apoyo a la aplicación web. En este diseño se han seguido una serie de pautas para homogeneizar el desarrollo entre todos los miembros del equipo. 3.1 NORMALIZACIÓN DE LA BASE DE DATOS Se deberá seguir el siguiente estándar a la hora crear y de hacer uso de los componentes relativos a la base de datos. PREFIJOS COD_ : Campo (normalmente numérico) que identifica de manera unívoca un registro en cada tabla. NUM_ : Campo numérico. TXT_ : Campo de texto. DAT_ : Campo de Fechas, las cuales pueden ser de tipo DATE, DATETIME o TIME. SUFIJOS _IND : Indica que ese campo es índice dentro de la tabla en la que esta. TABLAS Los nombres de las tablas empiezan por TBL_ y además se escribirán en plural. PRIMARY KEYS Se añadirá COD_ seguido del nombre de la tabla en singular. FOREING KEYS Tendrán el mismo nombre que el campo padre al cual hacen referencia. 3.2 ANÁLISIS Y DISEÑO DE LA BASE DE DATOS CREACIÓN DE VARIABLES DE SESIÓN Cuando el usuario se logue en el sistema con su login y password se crearán las siguientes variables de sesión, las cuales deben ser utilizadas por los demás programadores hacer uso de ellas en sus páginas php. Las variables serán las siguientes, aunque puede que en el futuro el número de estas aumente. K_SESSION_COD_PROFILE : Codigo de perfil al que pertence el usuario logado K_SESSION_NAME_PROFILE : Nombre idetificativo del perfil K_SESSION_ABBREVIATION_PROFILE : Abreviatura del nombre del perfil por si tenemos que usarlo para lo que sea

4 K_SESSION_LOGOTYPE : Path de la imagen coorporativa del perfil perteneciente al usuario logado K_SESSION_COD_GROUP : Codigo del grupo al que pertenece el usuario logado K_SESSION_NAME_GROUP : Nombre del grupo K_SESSION_ABBREVIATION_GROUP : Abreviatura del grupo K_SESSION_PAGE_DEFAULT : Pagina a la que accede el usuario si se ha logado correctamente K_SESSION_ACCESS_NEWS: Boolean que permite saber si el grupo al que pertenece tiene el servicio de noticias K_SESSION_ACCESS_BANNERS: Boolean que permite saber si el grupo al que pertenece tiene el servicio de banners K_SESSION_SEND_ S : Boolean que permite saber si el grupo al que pertenece tiene el servicio de mensajeria K_SESSION_SEND_SMS : Boolean que permite saber si el grupo al que pertenece tiene el servicio de sms K_SESSION_COD_USER: Código de usuario que en concreto será su login K_SESSION_NAME_USER: Nombre completo del usuario K_SESSION_COD_LOCALE: Código del idioma en el que se mostrarán las páginas del aplcativo AUDITORIA INTERNA DE LA BBDD Todas las tablas susceptibles de ser administradas vía web deberán tener cuatro campos internos que servirán para controlar tanto las inserciones como las modificaciones que realice un usuario en concreto. Los campos son los siguientes: COD_LOGIC_DELETE: Permiten poner a baja lógica un registro de una tabla. COD_USER_INSERT: Usuario que inserta un registro en una tabla. DAT_DATE_INSERT: Fecha en la que realizó la inserción. COD_USER_UPDATE: Usuario que modifica un registro de una tabla. DAT_DATE_UPDATE: Fecha en la que realizó la modificación. Conviene destacar que nunca se realizarán borrados FÍSICOS de ningún registro de la tabla, ya que esto puede generar un caos total en cuanto a la integridad referencial de los datos. Si se quiere realizar un DELETE de algún registro, la acción que hay que realizar será la de poner el campo COD_LOGIC_DELETE a 1. En las consultas que se realicen SIEMPRE habrá que tener en cuenta que los registros obtenidos de ejecutar la consulta tengan su COD_LOGIC_DELETE a 0. En la siguiente tabla se muestra los valores que se deberán introducir a la hora de administrar una tabla. INSERT UPDATE COD_LOGIC_DELETE DEFAULT 0 o 1 COD_USER_INSERT K_SESSION_NAME_USER --- DAT_DATE_INSERT NOW( ) --- COD_USER_UPDATE K_SESSION_NAME_USER K_SESSION_NAME_USER DAT_DATE_UPDATE NOW( ) NOW( ) En cuanto a la seguridad del sistema de autenticación se establecerá que las password que se almacenan por cada usuario deberá ser encriptada por el algoritmo MD5.

5 La forma de hacerlo será la siguiente: INSERT INTO TBL_USERS (COD_USER, COD_PASSWORD, COD_GROUP_USER, TXT_NAME, TXT_LASTNAME, TXT_ID_CARD, COD_USER_INSERT, DAT_DATE_INSERT, COD_USER_UPDATE DAT_DATE_UPDATE) VALUES ( carlos, MD5( password_carlos ), 1, Nombre, Apellido1 Apellido2, , SCRIPT DE CARGA NOW(), SCRIPT DE CARGA, NOW()); ANALISIS Y DISEÑO DE CICLOPE CORE El modelo entidad/relación diseñado para el ciclope core será el siguiente.

6

7 TBL_CORE_PROFILES La tabla TBL_CORE_PROFILES permite reunir las características comunes que pueden tener varios grupos de usuarios, como pueden ser nombre de la entidad (universidad, empresa, sistema, etc) a la que pertenecen y logotipo. En posteriores versiones se podrán añadir más parámetros como pueden ser colores corporativos, resolución de pantalla, etc. Esta tabla es susceptible de ser administrada vía web por lo que además de tener los campos que a continuación detallo, tendrá los propios de auditoria interna explicados en el punto Comentarios de los campos. COD_PROFILE : Código de perfil de tipo numérico autoincrementado para identificarlo de manera unívoca TXT_NAME : Nombre del perfil para visualizarlo en la web TXT_ABBREVIATION : Abreviatura del nombre por si acaso hace falta utilizarlo en combos TXT_PATH_IMAGE : Descripción del path donde se encuentra la imagen del logotipo de la entidad TXT_NAME_IMAGE : Descripción del nombre de la imagen del logotipo de la entidad TBL_CORE_GROUPS_USERS La tabla NT_GROUPS_USERS agrupa a los usuarios del sistema por características que tienen en común; éstas pueden ser permisos de acceso, servicio de banners, servicio de noticias, servicio de envío de , servicio de envio de sms. Los grupos creados estarán identificados por el nombre del grupo, como por ejemplo, Administradores Sistema, Profesores SSOO, Alumnos, Supervisores,etc. Concentrar a los usuarios en grupos nos reporta beneficiosas ventajas ya que si hay que cambiar alguna de las características mencionadas anteriormente, lo podremos hacer de un plumazo para todos los usuarios que pertenezcan al grupo modificado. En posteriores versiones se podrán añadir más parámetros que puedan surgir de nuevas especificaciones o incluso insertar mas campos calculados para que las consultas sean mas eficientes. Esta tabla es susceptible de ser administrada vía web por lo que además de tener los campos que a continuación detallo, tendrá los propios de auditoria interna explicados en el punto Comentarios de los campos. COD_GROUP_USER : Código de grupo de tipo numérico autoincrementado para identificarlo de manera unívoca COD_PROFILE : Código de Perfil que es FOREING KEY de la tabla NT_PERFILES TXT_NAME : Nombre del grupo para visualizarlo en la web TXT_ABBREVIATION : Abreviatura del nombre por si acaso hace falta utilizarlo en combos TXT_PATH_DEFAULT : Descripción del path donde se encuentra la página de inicio por defecto del grupo TXT_PAGE_DEFAULT : Descripción del nombre de la página de inicio por defecto del grupo DAT_LAST_ACCESS : Fecha del ultimo acceso realizado por un usuario que pertenece a dicho grupo COD_USER_LAST_ACCESS : Código del usuario perteneciente a dicho grupo que realizó el ultimo acceso

8 NUM_USERS : Numero de usuarios que tiene el grupo COD_ACCESS_NEWS : Código para permitir si el grupo puede tener el acceso a noticias COD_ACCESS_BANNERS : Código para permitir si el grupo puede tener el acceso a banners COD_SEND_ S : Código para permitir si el grupo puede tener servicio de envío de s COD_SEND_SMS : Código para permitir si el grupo puede tener servicio de envío de sms TBL_CORE_USERS En esta tabla almacenaremos los usuarios del sistema. Estos usuarios tienen que pertenecer obligatoriamente a un grupo existente. Se debe tener en cuenta que la password del usuario no debe ser vista por cualquier persona que acceda al sistema; para ello cuando hagamos una inserción se deberá encriptar con el algoritmo MD5. Esta tabla es susceptible de ser administrada vía web por lo que además de tener los campos que a continuación detallo, tendrá los propios de auditoria interna explicados en el punto Comentarios de los campos. COD_USER : Código de usuario de tipo texto, en concreto será el login, para identificarlo de manera unívoca COD_PASSWORD : Password del usuario para logarse en el sistema COD_GROUP_USER : Código de grupo de usuario que es FOREING KEY de la tabla NT_GRUPOS_USUARIOS TXT_NAME : Nombre del usuario TXT_LASTNAME : Apellidos del usuario TXT_ID_CARD: DNI del usuario DAT_LAST_ACCESS : Fecha del ultimo acceso realizado por el usuario NUM_CONECTIONS : Número de conexiones realizadas por el usuario contra el sistema TBL_CORE_TYPOLOGYS La tabla TBL_CORE_TYPOLOGYS agrupa a las páginas php por la funcionalidad que desempeñan; por ejemplo pueden ser de Administración,de Informes, de Estadísticas, de los distintos Escenarios, etc Estos nombres servirán para construir los menús de navegación en las páginas para guiar al usuario a traves de la aplicación.

9 Esta tabla es susceptible de ser administrada vía web por lo que además de tener los campos que a continuación detallo, tendrá los propios de auditoria interna explicados en el punto Comentarios de los campos. COD_TYPOLOGY : Código de tipología de tipo numérico autoincrementado para identificarlo de manera unívoca TXT_NAME : Nombre de la tipología para visualizarlo en la web TXT_ABBREVIATION : Abreviatura del nombre por si acaso hace falta utilizarlo en combos TBL_CORE_PAGES La tabla TBL_CORE_PAGES almacena las páginas php desarrolladas en la herramienta a las cuales tendrán acceso los grupos de usuarios. Con esto podremos llevar un control de seguridad ya que relacionaremos las páginas desarrolladas con los grupos que pueden visitarlas y esto habrá que tenerlo en cuenta cada vez que se desarrolla una página. Esta tabla es susceptible de ser administrada vía web por lo que además de tener los campos que a continuación detallo, tendrá los propios de auditoria interna explicados en el punto Comentarios de los campos. COD_PAGE : Código de página de tipo numérico autoincrementado para identificarlo de manera unívoca COD_TYPOLOGY : Código de tipología que es FOREING KEY referenciado a la tabla NT_TIPOLOGIAS TXT_PATH_PAGE : Path donde está almacenada la página TXT_NAME_PAGE : Nombre de la página TXT_PATH_IMAGE : Path de la imagen relacionada con dicha página TXT_NAME_IMAGE : Nombre de la imagen que esté asociada a dicha página TXT_DESCRIPTION : Descripción de la funcionalidad de la página TXT_ABBREVIATION : Abreviatura de la descripción de la página COD_NEW_WINDOW : Codigo que detrmina si la pagina se abrirá en una nueva ventana TBL_CORE_ACCESS La tabla TBL_CORE_ACCESS relaciona las páginas php desarrolladas con los grupos de usuarios que pueden acceder a ellas. Esta tabla es susceptible de ser administrada vía web por lo que además de tener los campos que a continuación detallo, tendrá los propios de auditoria interna explicados en el punto Comentarios de los campos. COD_PAGE : Código de página que es FOREING KEY referenciado a la tabla NT_PAGINAS COD_GROUP_USER : Código de grupo de usuario que es FOREING KEY referenciado a la tabla NT_GRUPOS_USUARIOS

10 TBL_CORE_ROLES En la tabla TBL_CORE_ROLES almacenaremos los roles que puede desempeñar los usuarios. Como ya hemos visto en este modelo, un usuario tiene que pertenecer obligatoriamente a un grupo, pero eso no eso no es un impedimento para que pueda desempeñar acciones relativas a otro grupo. La tabla TBL_CORE_ROLES permite que un usuario pueda estar relacionado con otros grupos a los que no pertenece por definición. Esta tabla es susceptible de ser administrada vía web por lo que además de tener los campos que a continuación detallo, tendrá los propios de auditoria interna explicados en el punto Comentarios de los campos. COD_USER : Código de página que es FOREING KEY referenciado a la tabla NT_USUARIOS COD_GROUP_USER : Código de grupo de usuario que es FOREING KEY referenciado a la tabla NT_GRUPOS_USUARIOS 3.3 EJEMPLO ACLARATORIO DEL SISTEMA PROPUESTO Se mostrará un ejemplo de carga de datos de las tablas propuestas con el objetivo de facilitar su comprensión. Posteriormente se desarrollaran algunas consultas sobre el ejemplo propuesto GRÁFICO DEL EJEMPLO DESCRIPTIVO El objetivo del siguiente ejemplo consiste en familiarizarse con la estructura de la base de datos diseñada. Para ello se cogen los campos más descriptivos de cada tabla, desechando aquellos que no son relevantes para la compresión del mismo. El ejemplo es el siguiente:

11 3.3.2 EXPLICACIÓN DEL EJEMPLO En el sistema están presentes cuatro PERFILES: SISTEMA, UPM, CARLOS III y EMPRESA LOPEZ S.A. Existen tres GRUPOS: ADMIN SISTEMA que pertenece al perfil SISTEMA y la página de acceso es DEFAULT.PHP ADMIN que pertenece al perfil UPM y la página de acceso es INICIO.PHP SUPER que pertenece al perfil UPM y la página de acceso es INICIO.PHP Hay tres USUARIOS: CARLOS que pertenece al grupo ADMIN SISTEMA RAUL que pertenece al grupo ADMIN JOSE que pertenece al grupo ADMIN Resumiendo en esta tabla se tiene: USUARIO GRUPO PAGINA INICIO PERFIL CARLOS ADMIN SISTEMA DEFAULT.PHP SISTEMA RAUL ADMIN INICIO.PHP UPM JOSE ADMIN INICIO.PHP UPM Cuando un usuario se logue correctamente en el sistema se le redirigirá a su página de inicio. En esta página se construirán los enlaces a los que tiene acceso de la siguiente forma. Hay tres PAGINAS: ADMIN_PERFILES de tipología ADMINISTRACION

12 ADMIN_GRUPOS de tipología ADMINISTRACION ESTAD_USUARIOS de tipología ESTADISTICAS Los ACCESOS que tienen los grupos a las páginas son: ADMIN SISTEMA accede a la página ADMIN_PERFILES.PHP ADMIN SISTEMA accede a la página ADMIN_GRUPOS.PHP ADMIN accede a la página ADMIN_GRUPOS.PHP SUPER accede a la página ESTAD_USUARIOS.PHP Juntándolo con la tabla resumen anterior se puede observar que: USUARIO GRUPO PAGINA INICIO PERFIL PAGINAS ACCESO CARLOS ADMIN SISTEMA DEFAULT.PHP SISTEMA ADMIN_PERFILES.PHP ADMIN_GRUPOS.PHP RAUL ADMIN INICIO.PHP UPM ADMIN_GRUPOS.PHP JOSE ADMIN INICIO.PHP UPM ADMIN_GRUPOS.PHP Se puede observar que CARLOS que pertenece al grupo de ADMIN SISTEMA no puede acceder a las páginas de acceso del grupo SUPER como puede ser la página de estadísticas de usuarios llamada ESTAD_USUARIOS.PHP. Se pretende que un usuario aunque pertenezca a un grupo pueda tener roles de otros distintos y esto se consigue con la tabla ROLES. En la tabla ROLES se observa que: USUARIO CARLOS RAUL JOSE ROL ADMIN SISTEMA ADMIN SUPER ADMIN SUPER ADMIN Juntándolo con la tabla anterior tendremos: USUARIO GRUPO PAG.INICIO PERFIL ROLES ACCESOS ADMIN_PERFILES.PHP ADMIN SISTEMA ADMIN_GRUPOS.PHP CARLOS ADMIN DEFAULT.PHP SISTEMA SISTEMA ADMIN ADMIN_GRUPOS.PHP RAUL ADMIN INICIO.PHP UPM SUPER ADMIN SUPER ESTAD_USUARIO.PHP ADMIN_GRUPOS.PHP ESTAD_USUARIO.PHP JOSE ADMIN INICIO.PHP UPM ADMIN ADMIN_GRUPOS.PHP

13 En cuanto a las tablas de móviles se puede observar que: USUARIO Nº MOVIL ESTADO CARLOS MOVISTAR AMENA RAUL MOVISTAR JOSE SCRIPT DE CREACIÓN, CARGA Y BORRADO DE TABLAS Los scripts de creación de tablas, carga de datos y borrados de tablas se encuentran en la carpeta db del raiz de ciclope core. 4. INSTALACIÓN Y CONFIGURACIÓN Para instalar Ciclope Core será necesario tener instalado Apache como servidor Web que soporte un motor de ejecución de páginas PHP y una base de datos MySQL. MANUAL DE INSTALACION PARA APACHE Crea un directorio web que sea visible desde Apache Copia los ficheros y carpetas de Ciclope Core a este directorio. MANUAL DE INSTALACION PARA MYSQL Configuración de Base de Datos Asegurarse de usar una cuenta de usuario y contraseña validos en MySQL. En este ejemplo usaremos user_name y your_password. Elegir un nombre de base de datos MySQL como por ejemplo Ciclope Entrar en modo consola en MySQL.Hay que asegurarse que el usuario creado tiene priviligeios en la base de datos creada Introducir las password cuando aparezca el prompt # mysql -u user_name -p Enter password: ************ Welcome to the MySQL monitor. Commands end with ; or \g. Your MySQL connection id is 114 to server version: Type 'help;' or '\h' for help. Type '\c' to clear the buffer. mysql> Crear la base de datos 'ciclope' y salirse de MySQL mysql> CREATE DATABASE ciclope; Query OK, 1 row affected (0.05 sec) mysql> \q Bye # Creacion de las tablas Usar el siguiente script para la creación del entorno de base de datos Ciclope_core/db/CRE_ESQ_CORE.sql Para sistemas *nix colocarse en el directorio raiz del servidor web y ejecutar el siguiente comando #mysql -u user_name -p webcollab<./ciclope_core/db/cre_esq_core.sql

14 Para sistemas windows situarse en la siguiente carpeta y ejecutar el siguiente comando mysql -uuser_name -pyour_password webcollab> CRE_ESQ_CORE.sql Configuración del Fichero de conexion a Base de datos Abre el fichero config.php con tu editor favorito Rellena las siguientes variables $DATABASE_NAME="ciclope"; $DATABASE_USER="user_name"; $DATABASE_PASSWORD="your_password"; PRUEBA DE ACCESO Situate con tu navegador favorito en la direccion: Si todo ha ido bien visualizará la página por defecto de ciclope core. Para acceder como administrador el login y password por defecto es ciclope/ciclope. Una vez logado se recomienda cambiar la password de este usuario y crear un nuevo usuario con derechos de administración.