====== Administración de usuarios en Catalis ======


Antes de poder comenzar a trabajar con Catalis, hay que preparar la base de usuarios. **Por el momento, el procedimiento para administrar esta base es manual.**

La base de usuarios, así como los archivos auxiliares asociados, se encuentran en el directorio ''bases/catalis_pack/catalis/users''. (En versiones viejas de Catalis, se la puede encontrar en ''cgi-bin/catalis_pack/catalis/config''.)

La información acerca de cada usuario del sistema se almacena en una base Isis, llamada ''users''. Para facilitar su mantenimiento, esta base se crea a partir de un archivo de texto, ''users.txt'', que tiene la estructura que manejan los utilitarios ''[[i2id]]'' e ''[[id2i]]'' de Bireme.

**Toda modificación del archivo ''users.txt'' deberá ser seguida por la ejecución del script ''users.sh'' (Linux) o ''users.bat'' (Windows), que se ocupa de regenerar tanto la base de datos ''users'' como su archivo invertido**. Para ello hay que ubicarse en el directorio ''bases/catalis_pack/catalis/users'' y ejecutar el comando
  ./users.sh           [en Linux]

  users                [en Windows]

En ''users.txt'' cada usuario está representado por un bloque como este:

  !ID 0                            usar '!ID 0' al comienzo de cada usuario
  !v001!EAR                        código que identifica al usuario, p.ej. iniciales del nombre
  !v002!UNS                        institución (una sigla u otra denominación breve)
  !v003!xxxxxx                     contraseña
  !v004!Ernesto A. Rodríguez       nombre y apellido
  !v005!baseA^p3                   base a la que accede por defecto este usuario
  !v005!baseB^p2                   \
  !v005!baseC^p3                    } otras bases a las que puede acceder el usuario
  !v005!baseD^p3                   /

(El texto en la columna derecha aparece aquí a modo de explicación; en el archivo solamente debe estar la columna izquierda.)

Para crear un nuevo usuario, hay que agregar uno de tales bloques al archivo ''users.txt''.

Aunque no es necesario, se recomienda separar cada bloque del anterior mediante una o más líneas en blanco.


Una vez creada la base de usuarios inicial, las operaciones de mantenimiento típicas consisten en agregar un nuevo usuario y en modificar la lista de bases a las que cada usuario tiene acceso.

Para permitir el acceso de un usuario a una base (p.ej. //libros//), se debe agregar una línea como esta:
  !v005!libros^p2
Para cancelar el acceso a una base, se debe eliminar la línea correspondiente. Para modificar el nivel de acceso, se debe colocar el número apropiado a continuación de ''^p''.

El número que aparece a continuación de ''^p'' indica el nivel de permiso asignado a ese usuario para esa base:

   * 1: sólo lectura
   * 2: creación de registros, y modificación de los registros propios (es decir, creados por ese usuario)
   * 3: creación y modificación de cualquier registro de la base


{{tag>catalis admin}}