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.
Generando el entorno (Seguridad)
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 |
Configuración del servidor (SIU-Mapuche)
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
- server.crt (Certificado servidor)
- server.key (Clave servidor)
- cliente.crt (Certificado cliente)
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.
Configuración del cliente (nuestro proyecto en SIU-Toba)
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:
- http://toba.siu.edu.ar/trac/toba/wiki/Referencia/ServiciosWeb
- Evento Anual en la UNLP curso de WS SIU-Toba