Hola a quien ande por ahí…
Arme dos proyectos en GitHub y compartí codígo para usar como fuente de autenticación la base del SIU-Guaraní 2 y 3.
Solo eso, saludos!
Aun no tuve la suerte de poder visitar mi país por turismo, pero poco a poco por trabajo en representación de la UNQ, y ahora un poco también en mi rol de «doble agente» (UNQ/SIU … cuando no me calso el rol de UNAJ también) estoy conociendo varias de las principales ciudades de mi país por las distintas reuniones de comité y de trabajo que tenemos.
Claramente lo primero que tengo que tener, es correctamente instalada la libreria WSF/PHP en el servidor del SIU-Mapuche, y tambien en el servidor en el cual estamos desarrollando la aplicación ya que es fundamental para el manejo de WS en SIU-Toba esta librería.
Los WS service del SIU, por convención TODOS, menos los de prueba (eco y ping) deben funcionar «seguros», esto quiere decir que deben viajar encriptados y firmados (utilizando criptografía asimétrica). Para realizar esto es necesario utilizar dos pares de certificados (unos para el cliente, otros para el servidor).
Robada Tomada desde Wikipedia
Para crear los certificados debemos tener un archivo openssl.ini el cual vamos usar para facilitar el ejemplo y al cual le podemos editar las siguientes partes:
|
1 2 3 4 5 6 7 8 |
[ req_distinguished_name ] C = AR ST = Buenos Aires L = Quilmes O = SIU OU = Sistemas CN = Sistemas emailAddress = gpilla@siu.edu.ar |
y la parte:
|
1 2 3 4 5 |
[dir_sect] C=AR O=SIU OU=Sistemas CN=Gustavo Pilla |
con la información particular de la institución donde trabajan.
Para generar los certificados debemos ejecutar:
|
1 2 3 |
# openssl req -x509 -nodes -days 20000 -newkey rsa:1024 -keyout cliente.key.sign -config {ruta_al_archivo}/openssl.ini -out cliente.crt # openssl rsa -in cliente.key.sign -out cliente.key # rm cliente.key.sign |
Y repetir la operación para generar los certificados para el servidor:
|
1 2 3 |
# openssl req -x509 -nodes -days 20000 -newkey rsa:1024 -keyout server.key.sign -config {ruta_al_archivo}/openssl.ini -out server.crt # openssl rsa -in server.key.sign -out server.key # rm server.key.sign |
Primero que nada, hay que saber que los WS del SIU-Mapuche, tienen un sistema de seguridad por el cual se permite la activación y desactivación de los mismos
El sistema SIU-Mapuche por default trae desactivados todos los WS exepto 2 que son de prueba (echo y ping). Para activar los WS se debe ir a Configuración, una vez que estamos dentro de la operación Configuración se debe ingresar a Servicios Web -> General, ahí tildar los servicios que necesitamos, y guardar los cambios.
Una vez habilitados los WS, debemos configurar los certificados (3 de los 4 que creamos antes).
Debemos subir 3 certificados al servidor donde se encuentra el SIU-Mapuche
Cuando se tengan estros tres archivos subidos al servidor, vamos a Configuración -> Servicios Web -> Seguridad, y llenamos con las 3 rutas completas a los archivos que acabamos de subir según corresponda y guardamos.
Dentro de nuestro proyecto, debemos crear un nuevo «servicio web accesible», esto lo podemos realizar desde el toba_editor en la pestaña «Datos» -> «Servicios Web Accesibles», aquí hacemos click en el botón agregar.
En el ejemplo que voy a mostrar, vamos a trabajar con los WS de agentes.
|
1 2 |
<strong>Identificador:</strong> mapuche_agentes <strong>URL:</strong> http://<em>{ruta_al_mapuche}</em>/servicios.php/ServicioWebAgentes |
Y guardamos los cambios.
Nota: La URL siempre esta formada por el punto de acceso a los servicios web del SIU-Mapuche (http://{ruta_al_siu_mapuhce}/servicios.php) mas el nombre del WS que puede verse en el SIU-Mapuche en «Ayuda» -> «Servicios Web» (ServicioWebAgentes, ServicioWebCargos, ServicioWebPruebas, etc).
Lo próximo que tenemos que hacer es configurar el «certificado del servidor» en la «instancia cliente» (nuestro proyecto). Esto lo podemos hacer con un comando de consola de toba:
|
1 |
# toba servicios_web cli_configurar -c {ruta_fisica_al_certificado_del_server} -s mapuche_agentes -p {nombre_de_nuestro_proyecto} |
Con todo esto, ya deberíamos tener todo configurado y listo para poder trabajar (codear!).
NOTA: Tomo por sentado de que tienen conocimientos de como crear operaciones en SIU-Toba.
Para este ejemplo, creamos una operación la llamamos Legajo y le agregamos un CI, al CI le agregamos un cuadro con 3 columnas (legajo, nombre y apellido) y extendemos el CI.
agregamos el siguiente código:
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 |
function conf__cuadro_agentes(mapuche_mini_ei_cuadro $cuadro) { //--1- Arma el mensaje $opciones = array('action' => 'getAgentes'); //En action se detalla la operacion a invocarse $filtro = array(); $filtro[] = array('campo'=>'apellido', 'operador' => 'contiene', 'valor'=> 'pilla'); $mensaje = new toba_servicio_web_mensaje(array('parametros' => array('filtro' => $filtro )) , $opciones); //--2- Arma el servicio $opciones = array(); $servicio = toba::servicio_web('mapuche_agentes', $opciones); //-- 3 - Muestra la respuesta try { $respuesta = $servicio->request($mensaje); $cuadro->set_datos($respuesta->get_array()); } catch (toba_error_servicio_web $e) { toba::notificacion()->info($e->get_mensaje().' (codigo "'.$e->get_codigo().'")'); } } |
FIN!
Proximamente voy a subir como hacer para consumir los WS del SIU-Mapuche desde afuera del SIU-Toba.
Pueden bajarse el proyecto demo que realice y poder utilizarlo de ejemplo, solo tienen que cargar el proyecto en un SIU-Toba 2.3.4 y cargarlo con el siguiente comando de toba:
|
1 |
toba proyecto cargar -p mapuche_mini -d <em>{ruta_a_donde_esta_el_proyecto}</em> |
Referencias:
Queria escribir, comentar … algo loco que me sucedio… y me alento a seguir posteando cosas en el blog…
Como dice el titulo, pero a diferencia de el 99,99% de las veces, internet y google no me ayudaron a conseguir información para solucionar un problema, sino que me ayudo brindando información a 3ros que yo habia publicado, ahorrandome el trabajo de tener que compartirla en lugares especificos (de eso realmente estoy trabajando)… aca va lo que paso:
Si alguien ve este blog, notaran que no soy un asiduo posteador, es mas… casi nunca lo hago… pero en uno de los trabajos que tengo, necesitaba investigar y probar algo entonces, habia realizado un post sobre como instalar una libreria media rara de Servicios Web que utiliza el SIU, realmente como un ayuda memoria para cuando lo necesite, para tenerlo en cualquier lugar asi de donde estaba conectado poder copiarlo y pegarlo, total… no era información sensible (se puede encontrar en otros lados googleando un poco).
Lo buena onda de todo esto, es que no tuve que postearlo en ningun lado, los usuarios del SIU, gracias a la magia de internet (Google!) llegaron solos a la información que estaba en mi blog, y la compartieron en un post de la comunidad SIU.
Realmente me resulto loco, gratificamente, y motivador para seguir posteando cosas.. (por eso el ultimo post) … no es totalmente al pedo 😛 … no es solo un ayudamemoria personal (hay un par de post que los mire y re mire un millon de veces, por que no me acordaba como hacerlo), tambien les sirver a terceros… como este post… o tambien este otro (este ultimo lejos!)… que aparecen como las paginas con mas visitas… algunas cosas son obvias (inclusive copias de la documentación oficial con algun tweak personal), otras cosas que me costaron encontrarlas (encontrar la versión que realmente funcione) y/o estaban en otro idioma…
Espero que le siga sirviendo a la gente…
PD: En el nuevo Debian que me instale aun no puse el corrector ortografico, asi que tengo un extra de faltas en los ultimos posts 😛