Buscardor

martes, 25 de septiembre de 2012

Configuración OpenKM - LDAP

Nota: Para la configuración se utilizó OpenKM versión 5.1.10

Si no conoces como esta del todo definido el directorio activo en la organización puede usar la aplicación JXplorer.

Para realizar la configuración en OpenKM, y que la autenticación del aplicativo se realice mediante el directorio activo debemos editar el archivo login-config.xml, que se encuentra en:


OPENKM_HOME\jboss-4.2.3.GA\server\default\conf

Un ejemplo de la ruta  es :
C:\Archivos de programa\openkm-5.1\jboss-4.2.3.GA\server\default\conf

Debemos comentar la sección de base de datos, poniendola entre  <!--    -->,  ya que es la configuración por defecto en OpenKM.


<!--   COMENTAR
<application-policy name = "OpenKM">
<authentication>
<login-module code="org.jboss.security.auth.spi.DatabaseServerLoginModule" flag = "required">
<module-option name="dsJndiName">java:/OpenKMDS</module-option>
<module-option name="principalsQuery">select usr_password as PASSWD from OKM_USER where usr_id=? and usr_active='T'</module-option>
<module-option name="rolesQuery">select ur_role as ROLEID, 'Roles' from OKM_USER_ROLE where ur_user=?</module-option>
<module-option name="hashAlgorithm">md5</module-option>
<module-option name="hashEncoding">hex</module-option>
</login-module>
</authentication>
</application-policy>
 --> 

    Y debemos agregar la siguiente configuración modo de autenticación LDAP:


    <application-policy name="OpenKM">
    <authentication>
    <login-module code="org.jboss.security.auth.spi.LdapExtLoginModule" flag="required">
    <module-option name="java.naming.provider.url">ldap:IP_SERVER_LDAP//:PUERTO_LDAP</module-option>
    <module-option name="bindDN">USUARIO_CON_PRIVILEGIOS_LDAP@DOMINIO</module-option>
    <module-option name="bindCredential">CONTRASEÑA_USUARIO</module-option>
    <module-option name="baseCtxDN">OU=UNIDAD_ORGANIZACIONAL_USUARIO,DC=PRIMERA_PARTE_DOMINO,DC=SEGUNDA_PARTE_DOMINIO</module-option>
    <module-option name="baseFilter">(sAMAccountName={0})</module-option>
    <module-option name="rolesCtxDN">CN=CONTENEDOR DE LOS USUARIOS, DC=PRIMERA_PARTE_DOMINO,DC=SEGUNDA_PARTE_DOMINIO </module-option>
    <module-option name="roleFilter">(member={1})</module-option>
    <module-option name="roleAttributeID">cn</module-option>
    <module-option name="roleNameAttributeID">name</module-option>
    <module-option name="roleAttributeIsDN">false</module-option>
    <module-option name="roleRecursion">-1</module-option>
    <module-option name="searchScope">SUBTREE_SCOPE</module-option>
    <module-option name="allowEmptyPasswords">false</module-option>
    </login-module>
    </authentication>
    </application-policy>

    • IP_SERVER_LDAP = Ip del host donde se encuentra el servicio de directorio activo. 
    • PUERTO_LDAP = Puerto asignado al servicio de directorio activo, por defecto (389). 
    • USUARIO_CON_PRIVILEGIOS_LDAP = Usuario del dominio que tiene privilegios de lectura sobre el directorio activo. 
    • UNIDAD_ORGANIZACIONAL_DEL_USUARIO = En el directorio activo se dividen varios "grupos" de usuarios, para darles diferentes tipos de permisos. A esto se le llama unas unidad organizacional, un usuario puede pertenecer a una o muchas de estas unidades.
    • DC=PRIMERA_PARTE_DOMINO,DC=SEGUNDA_PARTE_DOMINIO = Partes del dominio que están separadas por puntos, por ejemplo 1 = google , 2 = com , 3 = co 
    • CONTENEDOR DE LOS USUARIOS = Por defecto Users. 

    El resto de atributos los pude dejar tal cual.

    Para que esta configuración tenga exito dentro del directorio activo, se debe tener alguno de los siguientes grupos, AdminRole ó UserRole ya que estos son los grupos por defecto del aplicativo OpenKM, y que los usuarios LDAP que usaran  OpenKM pertenescan a alguno de estos grupos. 

    Referencias:

    http://wiki.openkm.com/index.php/LDAP_and_Active_Directory_user_examples

    http://www.rlmueller.net/LDAP_Binding.htm

    lunes, 24 de septiembre de 2012

    Guía de uso OpenKm

    Este articulo tiene como fin mostrar a los usuarios de OpenKM, las características principales del aplicativo a grandes rasgos y también donde pueden encontrar las diferentes opciones para su gestión de documentos.

    Este articulo fue escrito con la versión 5.1.10 del aplicativo OpenKM. 

    Al ingresar en OpenKM, tendremos por defecto la vista "Escritorio", se ve así :

    Vista escritorio: 






    En el panel izquierdo se ven las diferentes utilidades como lo son:

    Taxonomía: es la ciencia de la clasificación y precisamente lo que se espera en este espacio es organizar por gerarquia de directorios los documentos.

    Categorías : Se crean directorios, en lo cuales se organizarán los archivos a los cuales se les asigne como categoria dicho directorio.

    Thesaurus : En este directorio se realiza una configuración para agregar algunas palabras claves predefinidas por el aplicativo u organizandolas en un arhcivo xml.

    Plantillas : Esta sección se a definido especialmente para documentos que son usado como base para realizar otros como por ejemplo documentos para levantar requerimientos , y hacer casos de uso, creando archivos con base en estos.

    Documentos personales : Espacio en el cual cada usuario pude almacenar sus propios docmentos sin que otros usuarios puedan acceder.

    Correo Electrónico : Lugar donde llegan las notificaciones.

    Papelera : Luegar dodne quedan los archivos eliminados de ahí los podemos recuperar.


    Vista Buscador :





    Como su nombre lo indica es el lugar donde se pueden realizar las busquedas de los archivos almacenados, probablemente la parte más importante del aplicativo.

    La búsqueda se puede realizar combinando campos con sentencias logicas AND / OR,
    tal vez el campo que vale la pena resaltar sea contenido, ya que este campo permite buscar cadenas dentro de los archivos y entregándonos coincidencias.

    Vista de resultados compacta: muestra el resultado de la búsqueda de forma mas pequeña y se muestra menos información sobre los archivos en los resultados.

    Guardar como novedades de usuarios: el resultado de la búsqueda aparecerá en el apartado Novedades, pestañaTablón, icono Novedades.

    Campo Guardar consulta: nos permite almacenar la búsqueda realizada, la búsqueda aparecerá en la columna “Búsquedas almacenadas” en la parte izquierda de la ventana.


    Vista Tablón :




    En esta vista se muetsra informaciónde utilidad para el usuario sobre sus documentos, cambios , correos, entre otras cosas.

    Opciones de los archivos (Barra horizontal en el aplicativo)





    Propiedades de un archivo





    Palabras clave : Podemos agregar palabras claves al archivo escribiendolas y presionar enter, el icono que parece un libro se usa cuando, se tiene Thesaurus.

    Categoría : Seleccionar de las categorias previamente creadas a cual pertenece este archivo para clasificarlo.


    Historial:




    En esta vista podremos observar el historial de cambios que ha recibido en archivo a lo largo de el versionamiento, y nos da la oportunidad de ver como se encontraba en estados anteriores y restaurar alguna de ellas.


    Barra menú

    La barra de menú esta formada por todos los menús desplegables con sus diferentes opciones. Si una opción del menú aparece en gris, esta opción no está disponible.




    Detalle de las funciones de acuerdo con sus iconos:





    WebDav

    OpenKm también posee esta opción pero de una forma no tan compleja, podemos acceder mediante la siguente url :

    http://yourIP:8080/OpenKM/webdav

    Por medio de este acceso podremos obtener los archivos de una forma más rápida.


    Referencias

    http://wiki.openkm.com

    http://wiki.openkm.com/index.php/User_Guide/es-es





    jueves, 20 de septiembre de 2012

    Gestión documental

    En esta profesión normalmente se conforman grupos de trabajo, con los cuales se procede a realizar investigaciones de diversos temas para resolver problemas informáticos, que se presentan en el día a día.

    Algunas veces nos conformamos con resolver el problema y listo. Pero que  ocurre cuando este problema es recurrente, si tenemos una memoria fotográfica no es problema, pero la mayoría no la poseemos lamentablemente la solución es ... documentar!! 

    Pero junto a esta solución viene otro lío, después de un tiempo nos cuesta mucho mantener esta información organizada y mantenerla fácilmente, para esto se usan los gestores documentales.


    En general creó que las caracteristicas basicas necesarias en un software de gestión documental serían:

    • Autenticación y Autorización de usuarios
    • Acceso web
    • Búsqueda indexada
    • Búsqueda sobre contenido de documentos
    • Versionamiento de documentos
    • Almacenamiento de documentos por directorios
    • Fácil instalación y configuración
    • Buena documentación, Foros
    • Open Source
    Para ello existen varias opciones en internet,  algunas de ellas son:
    • Orfeo
    • OWL
    • Alfresco
    • OpenKM
    Después de analizar estos aplicativos sugiero OpenKM, como solución.