Diferencia entre revisiones de «SIU-Arai/Modulos/Mapuche/3.5»

De SIU
Saltar a: navegación, buscar
(Página creada con «= SIU-Mapuche = Se asume que el sistema Siu-Mapuche se encuentra instalador y funcionando correctamente. [http://documentacion.siu.edu.ar/wiki/SIU-Mapuche Aquí] la docume...»)
 
m
Línea 3: Línea 3:
 
Se asume que el sistema Siu-Mapuche se encuentra instalador y funcionando correctamente. [http://documentacion.siu.edu.ar/wiki/SIU-Mapuche Aquí] la documentación referente.
 
Se asume que el sistema Siu-Mapuche se encuentra instalador y funcionando correctamente. [http://documentacion.siu.edu.ar/wiki/SIU-Mapuche Aquí] la documentación referente.
  
−
<blockquote>Recordar que esta versión es compatible únicamente con la versión de la plataforma [[SIU-Arai/Compatibilidad|SIU-Araí 1.x]].</blockquote>
+
<blockquote>Recordar que esta versión es compatible únicamente con la versión de la plataforma [[SIU-Arai/Compatibilidad|SIU-Araí 2.x]].</blockquote>
  
−
= Para la versión 3.3.x =
+
= Para la versión 3.5.x =
  
 
Primero que nada necesitamos tener en nuestro poder los certificados, se puede seguir [http://documentacion.siu.edu.ar/wiki/SIU-Arai/certificados este] instructivo
 
Primero que nada necesitamos tener en nuestro poder los certificados, se puede seguir [http://documentacion.siu.edu.ar/wiki/SIU-Arai/certificados este] instructivo
 
Con los certificados en la mano podemos configurar el sistema como cliente
 
Con los certificados en la mano podemos configurar el sistema como cliente
  
−
== Instalación ==
+
== Requisitos previos ==
  
−
Para esta versión de Mapuche es necesario ejecutar el comando
+
=== Soporte para encriptación ===
 +
es necesario instalar la librería Sodium, de acuerdo a [http://documentacion.siu.edu.ar/wiki/IT/Sodium este] instructivo.
  
−
<syntaxhighlight lang="bash" enclose="div">
+
=== Generar clave para encriptación ===
−
composer install
+
Para esta versión de '''SIU-Mapuche,''' es necesario generar "''de forma manual y por única vez''", una clave que permite encriptar la sincronización entre la aplicación SIU-Mapuche y la plataforma SIU-Araí. Para ello, una vez se cuente con soporte a la librería Sodium es posible generar la clave con el siguiente comando:
−
</syntaxhighlight>
 
−
 
 
−
De otro modo el comando arai-cli no se podrá ejecutar.
 
−
 
 
−
== Cliente Arai-Usuarios ==
 
−
 
 
−
Para poder vincular usuarios desde el toba-usuarios de Mapuche con Arai-Usuarios es necesario acceder a los WS que este tiene publicados. Para mantener una conexión segura se deben configurar los certificados correspondientes en /path_Instalacion/i__produccion/p__mapuche/rest/rest_arai_usuarios/cliente.ini
 
  
 
<syntaxhighlight lang="apache" enclose="div">
 
<syntaxhighlight lang="apache" enclose="div">
−
 
+
./bin/arai-cli arai:generar-key --destino /ruta/mapuche/instalacion/arai-sync.key
−
[conexion]
 
−
to = "https://Usuarios/gestion/rest/"
 
−
auth_tipo = "ssl"
 
−
cert_file = "/certs/Mapuche-cli.cert.pem"
 
−
key_file = "/certs/Mapuche-cli.key.pem"
 
−
ca_cert = "/certs/ca.cert.pem"
 
−
 
 
 
</syntaxhighlight>
 
</syntaxhighlight>
  
−
Luego hay que agregar el sertificado al sistema operativo, aumimos que se encuentra en /certs/ca.cert.pem
+
Posteriormente, es necesario indicar a la aplicación SIU-Mapuche donde se encuentra dicha clave.  Para ello se debe editar el archivo  <code>/ruta/mapuche/instalacion/instalacion.ini</code> agregando al final una línea similar la siguiente:
  
−
<syntaxhighlight lang="bash" enclose="div">
+
<syntaxhighlight lang="apache" enclose="div">
−
cp /certs/ca.cert.pem /usr/share/ca_certificates/ca_propia.crt
+
arai_sync_key_file=/ruta/mapuche/instalacion/arai-sync.key
 
</syntaxhighlight>
 
</syntaxhighlight>
  
−
Luego editamos el archivo de configuración
+
=== Cliente Arai-Usuarios ===
 +
Para poder integrar la administración de usuarios desde el toba-usuarios de '''SIU-Mapuche''' con '''SIU-Arai: Usuarios''', es necesario acceder a los servicios web que este último tiene publicados. Para mantener una conexión segura se deben configurar el archivo <code>/ruta/mapuche/instalacion/i__produccion/p__mapuche/rest/rest_arai_usuarios/cliente.ini</code> con el siguiente contenido:
  
−
<syntaxhighlight lang="bash" enclose="div">
 
−
nano /etc/ca_certificates.conf
 
−
</syntaxhighlight>
 
−
 
−
Y al final del achivo agregamos el nombre de nuestra ca_propia
 
−
Quedaría algo así
 
 
<syntaxhighlight lang="apache" enclose="div">
 
<syntaxhighlight lang="apache" enclose="div">
−
.
 
−
.
 
−
.
 
−
mozilla/thawte_Primary_Root_CA_-_G3.crt
 
−
spi-inc.org/spi-cacert-2008.crt
 
−
ca_propia.crt
 
  
−
</syntaxhighlight>
+
[conexion]
 +
auth_tipo = "basic"
 +
auth_usuario = "mapuche"
 +
auth_password = "#claveMapu3@"
  
−
Y actualizamos con
 
−
<syntaxhighlight lang="bash" enclose="div">
 
−
update-ca-certificates --fresh
 
 
</syntaxhighlight>
 
</syntaxhighlight>
  
−
Por ultimo reiniciamos apache ( restart )
+
=== Variables de Entorno ===
−
Reemplazando los valores por los que correspondan según el entorno donde esté instalada la aplicación.
 
−
 
 
−
== Variables de Entorno ==
 
−
 
 
 
Arai-Cli utiliza variables de entorno para acceder a archivos y otras tareas, hay que asegurarse de que las siguientes variables estén instanciadas correctamente de acuerdo al entorno de instalación de la aplicación.
 
Arai-Cli utiliza variables de entorno para acceder a archivos y otras tareas, hay que asegurarse de que las siguientes variables estén instanciadas correctamente de acuerdo al entorno de instalación de la aplicación.
  
 
<syntaxhighlight lang="bash" enclose="div">
 
<syntaxhighlight lang="bash" enclose="div">
 +
. ./entorno_toba.env
 
export TOBA_INSTANCIA=produccion
 
export TOBA_INSTANCIA=produccion
−
export TOBA_PROYECTO=Mapuche
 
−
export TOBA_PROYECTO_DIR="/usr/local/siu/Mapuche/aplicacion"
 
−
export TOBA_INSTALACION_DIR="/usr/local/siu/Mapuche/instalacion"
 
 
export ARAI_REGISTRY_USER=user
 
export ARAI_REGISTRY_USER=user
 
export ARAI_REGISTRY_PASS=pass
 
export ARAI_REGISTRY_PASS=pass

Revisión del 18:35 5 oct 2018

SIU-Mapuche

Se asume que el sistema Siu-Mapuche se encuentra instalador y funcionando correctamente. Aquí la documentación referente.

Recordar que esta versión es compatible únicamente con la versión de la plataforma SIU-Araí 2.x.

Para la versión 3.5.x

Primero que nada necesitamos tener en nuestro poder los certificados, se puede seguir este instructivo Con los certificados en la mano podemos configurar el sistema como cliente

Requisitos previos

Soporte para encriptación

es necesario instalar la librería Sodium, de acuerdo a este instructivo.

Generar clave para encriptación

Para esta versión de SIU-Mapuche, es necesario generar "de forma manual y por única vez", una clave que permite encriptar la sincronización entre la aplicación SIU-Mapuche y la plataforma SIU-Araí. Para ello, una vez se cuente con soporte a la librería Sodium es posible generar la clave con el siguiente comando:

./bin/arai-cli arai:generar-key --destino /ruta/mapuche/instalacion/arai-sync.key

Posteriormente, es necesario indicar a la aplicación SIU-Mapuche donde se encuentra dicha clave. Para ello se debe editar el archivo /ruta/mapuche/instalacion/instalacion.ini agregando al final una línea similar la siguiente:

arai_sync_key_file=/ruta/mapuche/instalacion/arai-sync.key

Cliente Arai-Usuarios

Para poder integrar la administración de usuarios desde el toba-usuarios de SIU-Mapuche con SIU-Arai: Usuarios, es necesario acceder a los servicios web que este último tiene publicados. Para mantener una conexión segura se deben configurar el archivo /ruta/mapuche/instalacion/i__produccion/p__mapuche/rest/rest_arai_usuarios/cliente.ini con el siguiente contenido:

[conexion]
auth_tipo = "basic"
auth_usuario = "mapuche"
auth_password = "#claveMapu3@"

Variables de Entorno

Arai-Cli utiliza variables de entorno para acceder a archivos y otras tareas, hay que asegurarse de que las siguientes variables estén instanciadas correctamente de acuerdo al entorno de instalación de la aplicación.

. ./entorno_toba.env
export TOBA_INSTANCIA=produccion
export ARAI_REGISTRY_USER=user
export ARAI_REGISTRY_PASS=pass

Sincronizando

Ahora si, con todo configurado procedemos a hacer la sincronización con Arai-Registry.

Primero agregamos Mapuche al entorno Arai con registry:add

cd /path_Instalacion
./bin/arai-cli registry:add --maintainer-email mail@domain.edu --maintainer usuario http://Registry/arai-registry

Luego del mensaje de éxito hay que proceder a sincronizar la aplicación.

./bin/arai-cli registry:sync

Por último hay que sincronizar todas aquellas aplicaciones a las que Mapuche consulte WS, en este caso Arai-Uaurios.

./bin/arai-cli registry:sync

Dando Acceso

Ahora el encargado de dar un loguín a Mapuche es el IDP de usuarios, desde Arai-Usuarios en la sección de usuarios, hay que seleccionar el usuario deseado y dar el acceso correspondiente.

  1. Ingresar a Menu->Usuarios
  2. Filtrar y seleccionar un usuarios
  3. En la solapa Cuentas Seleccionar "Mapuche" desde el combo "Aplicación"
  4. En el campo "Cuenta" escribir el usuario que corresponde en Mapuche
  5. Guardar
Obtenido de «https://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Arai/Modulos/Mapuche/3.5&oldid=45688»