SIU - Contribuciones del usuario [es]

SIU-Arai/federacion

2019-12-06T13:27:11Z

Jpiazza:

== Enlace de Arai-usuarios con Federación ==

=== Configuración en Arai-Usuarios ===
Para conectar nuestra instancia de Arai-Usuarios a la Federación necesitamos contar con la URL al IDP y configurarlo como un servicio.

Editamos el archivos ./path_usuarios/config/idp.yml en la sección "custom" agregnado el servicio como se ve en la imagen.
[[Archivo:Arai usuarios federacion ydp yml ok.png|miniaturadeimagen|788x788px|no]]

El valor de appUniqueId corresponde al identificador del servicios dentro de arai-usuarios, hay que darlo de alta desde el administrador de aplicaciones.

[[Archivo:Arai_usuarios_federacion_gestion.png|sinmarco|885x885px]]

El la imagen anterior se puede apreciar como ya tenemos nuestra aplicación dada de alta, luego debemos asignar a un grupo o un usuario en particular dicha cuenta para proporcionarle acceso a los servicios que ofrece la Federación. En la siguiente imagen se ve como el usuario Administrador tiene asignada la cuenta idp-riu-federacion.

[[Archivo:Arai usuarios federacion gestion cuenta.png|miniaturadeimagen|699x699px|no]]

Con esto debería ser suficiente, al menos del lado de Arai-Usuarios.

=== Requisitos de la Federación ===

Desde la Federación se nos van a solicitar los metadatos de nuestro IDP para poder generar una relación de confianza entre ambos proveedores de identidad.

Para ello debemos proveerles el XML que se genera en la url <nowiki>https://mi_arai_usuaios/idp/saml2/idp/metadata.php</nowiki>

En ese XML viajan las credenciales necesarias para poder generar la conexión desde el lado de la Federación.

El resultado es algo muy similar a esto:
[[Archivo:Arai usuarios federacion xml.png|miniaturadeimagen|783x783px|no]]

SIU-Arai/federacion

2019-12-05T22:16:01Z

Jpiazza: Creación 5-12-2019

== Enlace de Arai-usuarios con Federación ==

=== Configuración en Arai-Usuarios ===
Para conectar nuestra instancia de Arai-Usuarios a la Federación necesitamos contar con la URL al IDP y configurarlo como un servicio.

Editamos el archivos ./path_usuarios/config/idp.yml en la sección "custom" agregnado el servicio como se ve en la imagen.
[[Archivo:Arai usuarios federacion ydp yml ok.png|izquierda|miniaturadeimagen|759x759px]]

El valor de appUniqueId corresponde al identificador del servicios dentro de arai-usuarios, hay que darlo de alta desde el administrador de aplicaciones.
[[Archivo:Arai usuarios federacion gestion.png|izquierda|sinmarco|885x885px]]

El la imagen anterior se puede apreciar como ya tenemos nuestra aplicación dada de alta, luego debemos asignar a un grupo o un usuario en particular dicha cuenta para proporcionarle acceso a los servicios que ofrece la Federación. En la siguiente imagen se ve como el usuario toba tiene asignada la cuenta idp-riu-federacion.
[[Archivo:Arai usuarios federacion gestion cuenta.png|izquierda|miniaturadeimagen|699x699px]]

Con esto debería ser suficiente, al menos del lado de Arai-Usuarios.

=== Requisitos de la Federación ===

Desde la Federación se nos van a solicitar los metadatos de nuestro IDP para poder generar una relación de confianza entre ambos proveedores de identidad.

Para ello debemos proveerles el XML que se genera en la url <nowiki>https://mi_arai_usuaios/idp/saml2/idp/metadata.php</nowiki>

En ese XML viajan las credenciales necesarias para poder generar la conexión desde el lado de la Federación.

El resultado es algo muy similar a esto:
[[Archivo:Arai usuarios federacion xml.png|izquierda|miniaturadeimagen|783x783px]]

Archivo:Arai usuarios federacion xml.png

2019-12-05T22:15:25Z

Jpiazza:

XML con las credenciales requeridas por Federacion

Archivo:Arai usuarios federacion gestion cuenta.png

2019-12-05T22:05:46Z

Jpiazza:

Se ve asignada la cuenta de federación al usuario toba

Archivo:Arai usuarios federacion gestion.png

2019-12-05T21:59:12Z

Jpiazza:

Demostración de alta del SP de la federación

Archivo:Arai usuarios federacion ydp yml ok.png

2019-12-05T21:47:42Z

Jpiazza:

Configuración de idp.yml para arai_usuairios dentro de la federacion

Archivo:Arai usuarios federacion ydp yml.png

2019-12-05T21:41:44Z

Jpiazza:

ejemplo de configuración del archivos idp.yml con la Federación

SIU-Arai/Modulos/Pilaga304

2017-11-06T15:27:16Z

Jpiazza: /* Variables de Entorno */

= Para la versión 3.0.4 =

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

== Arai.json ==

Para poder sincronizar Pilaga 3.0.4 hay que modificar el archivo arai.json agregandole un bloque en "consume":
<syntaxhighlight lang="apache" enclose="div">
{
"name": "service:siu/sso-saml-idp",
"version": ">=0.1.0"
}
</syntaxhighlight>

El archivo tiene que quedar similar a este:
<syntaxhighlight lang="apache" enclose="div">
{
"name": "siu/pilaga",
"description": "Módulo de gestión presupuestaria, financiera y contable",
"scripts": {
"hooks": "SIU\\Pilaga\\AraiRegistryHooks"
},

"provide": [
{
"name": "api:siu/pilaga",
"version": "0.1.0",
"options": {
"auto-configurar": true
}
},
{
"name": "app:siu/pilaga",
"alias": "SIU-Pilaga",
"description": "Gestión presupuestaria, financiera y contable",
"version": "0.1.0",
"icon": "./www/img/logo_iso.png"
}
],
"consume": [
{
"name": "service:siu/sso-saml-idp",
"version": ">=0.1.0"
},
{
"name": "api:siu/arai-usuarios",
"version": ">=0.1.0",
"options": {
"toba-rest": [
{ "proyecto": "toba_usuarios", "rest-id": "rest_arai_usuarios" }
]
}

}
]

}
</syntaxhighlight>

== Cliente Arai-Usuarios ==

Para poder vincular usuarios desde el toba-usuarios de Pilaga 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__toba_usuarios/rest/rest_arai_usuarios/cliente.ini

<syntaxhighlight lang="apache" enclose="div">

[conexion]
to = "https://Usuarios/gestion/rest/"
auth_tipo = "ssl"
cert_file = "/certs/Pilaga-cli.cert.pem"
key_file = "/certs/Pilaga-cli.key.pem"
ca_cert = "/certs/ca.cert.pem"

</syntaxhighlight>

Luego hay que agregar el sertificado al sistema operativo, asumimos que se encuentra en /certs/ca.cert.pem

<syntaxhighlight lang="bash" enclose="div">
cp /certs/ca.cert.pem /usr/share/ca_certificates/ca_propia.crt
</syntaxhighlight>

Luego editamos el archivo de configuración

<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">
.
.
.
mozilla/thawte_Primary_Root_CA_-_G3.crt
spi-inc.org/spi-cacert-2008.crt
ca_propia.crt

</syntaxhighlight>

Y actualizamos con
<syntaxhighlight lang="bash" enclose="div">
update-ca-certificates --fresh
</syntaxhighlight>

Por ultimo reiniciamos apache ( restart )
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.

<syntaxhighlight lang="bash" enclose="div">
export TOBA_INSTANCIA=produccion
export TOBA_PROYECTO=pilaga
export TOBA_PROYECTO_DIR="/usr/local/siu/pilaga/"
export TOBA_INSTALACION_DIR="/usr/local/siu/pilaga/instalacion"
export ARAI_REGISTRY_USER=user
export ARAI_REGISTRY_PASS=pass
</syntaxhighlight>

== Sincronizando ==

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

Primero agregamos Pilaga al entorno Arai con registry:add
<syntaxhighlight lang="bash" enclose="div">
cd /path_Instalacion
./bin/arai-cli registry:add --maintainer-email mail@domain.edu --maintainer usuario http://Registry/arai-registry
</syntaxhighlight>

Luego del mensaje de éxito hay que proceder a sincronizar la aplicación.
<syntaxhighlight lang="bash" enclose="div">
./bin/arai-cli registry:sync
</syntaxhighlight>

Por último hay que sincronizar todas aquellas aplicaciones a las que Pilaga consulte WS, en este caso Arai-Uaurios.
<syntaxhighlight lang="bash" enclose="div">
./bin/arai-cli registry:sync
</syntaxhighlight>

== Dando Acceso ==

Ahora el encargado de dar un loguín a Pilaga 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.
# Ingresar a Menu->Usuarios
# Filtrar y seleccionar un usuarios
# En la solapa Cuentas Seleccionar "Pilaga" desde el combo "Aplicación"
# En el campo "Cuenta" escribir el usuario que corresponde en Pilaga
# Guardar

SIU-Arai/Modulos/Pilaga

2017-11-03T18:03:48Z

Jpiazza: Página reemplazada por «= SIU-Pilaga = SIU-Pilaga es el "Módulo económico financiero y contable" que permite realizar en forma integrada la gestión de presupuesto. Esté apartado está enf...»

SIU-Arai/Modulos/Pilaga304

2017-11-03T18:02:15Z

Jpiazza: Página creada con «= Para la versión 3.0.4 = Primero que nada necesitamos tener en nuestro poder los certificados, se puede seguir [http://documentacion.siu.edu.ar/wiki/SIU-Arai/certificado...»

= Para la versión 3.0.4 =

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

== Arai.json ==

Para poder sincronizar Pilaga 3.0.4 hay que modificar el archivo arai.json agregandole un bloque en "consume":
<syntaxhighlight lang="apache" enclose="div">
{
"name": "service:siu/sso-saml-idp",
"version": ">=0.1.0"
}
</syntaxhighlight>

El archivo tiene que quedar similar a este:
<syntaxhighlight lang="apache" enclose="div">
{
"name": "siu/pilaga",
"description": "Módulo de gestión presupuestaria, financiera y contable",
"scripts": {
"hooks": "SIU\\Pilaga\\AraiRegistryHooks"
},

"provide": [
{
"name": "api:siu/pilaga",
"version": "0.1.0",
"options": {
"auto-configurar": true
}
},
{
"name": "app:siu/pilaga",
"alias": "SIU-Pilaga",
"description": "Gestión presupuestaria, financiera y contable",
"version": "0.1.0",
"icon": "./www/img/logo_iso.png"
}
],
"consume": [
{
"name": "service:siu/sso-saml-idp",
"version": ">=0.1.0"
},
{
"name": "api:siu/arai-usuarios",
"version": ">=0.1.0",
"options": {
"toba-rest": [
{ "proyecto": "toba_usuarios", "rest-id": "rest_arai_usuarios" }
]
}

}
]

}
</syntaxhighlight>

== Cliente Arai-Usuarios ==

Para poder vincular usuarios desde el toba-usuarios de Pilaga 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__toba_usuarios/rest/rest_arai_usuarios/cliente.ini

<syntaxhighlight lang="apache" enclose="div">

[conexion]
to = "https://Usuarios/gestion/rest/"
auth_tipo = "ssl"
cert_file = "/certs/Pilaga-cli.cert.pem"
key_file = "/certs/Pilaga-cli.key.pem"
ca_cert = "/certs/ca.cert.pem"

</syntaxhighlight>

Luego hay que agregar el sertificado al sistema operativo, asumimos que se encuentra en /certs/ca.cert.pem

<syntaxhighlight lang="bash" enclose="div">
cp /certs/ca.cert.pem /usr/share/ca_certificates/ca_propia.crt
</syntaxhighlight>

Luego editamos el archivo de configuración

<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">
.
.
.
mozilla/thawte_Primary_Root_CA_-_G3.crt
spi-inc.org/spi-cacert-2008.crt
ca_propia.crt

</syntaxhighlight>

Y actualizamos con
<syntaxhighlight lang="bash" enclose="div">
update-ca-certificates --fresh
</syntaxhighlight>

Por ultimo reiniciamos apache ( restart )
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.

<syntaxhighlight lang="bash" enclose="div">
export TOBA_INSTANCIA=produccion
export TOBA_PROYECTO=pilaga
export TOBA_PROYECTO_DIR="/usr/local/siu/pilaga/"
export TOBA_INSTALACION_DIR="/usr/local/siu/pilaga/instalar"
export ARAI_REGISTRY_USER=user
export ARAI_REGISTRY_PASS=pass
</syntaxhighlight>

== Sincronizando ==

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

Primero agregamos Pilaga al entorno Arai con registry:add
<syntaxhighlight lang="bash" enclose="div">
cd /path_Instalacion
./bin/arai-cli registry:add --maintainer-email mail@domain.edu --maintainer usuario http://Registry/arai-registry
</syntaxhighlight>

Luego del mensaje de éxito hay que proceder a sincronizar la aplicación.
<syntaxhighlight lang="bash" enclose="div">
./bin/arai-cli registry:sync
</syntaxhighlight>

Por último hay que sincronizar todas aquellas aplicaciones a las que Pilaga consulte WS, en este caso Arai-Uaurios.
<syntaxhighlight lang="bash" enclose="div">
./bin/arai-cli registry:sync
</syntaxhighlight>

== Dando Acceso ==

Ahora el encargado de dar un loguín a Pilaga 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.
# Ingresar a Menu->Usuarios
# Filtrar y seleccionar un usuarios
# En la solapa Cuentas Seleccionar "Pilaga" desde el combo "Aplicación"
# En el campo "Cuenta" escribir el usuario que corresponde en Pilaga
# Guardar

SIU-Arai/ejemploPasoAPaso

2017-11-03T13:22:58Z

Jpiazza: /* Arai-Huarpe */

[[Archivo:siu-arai_iso.png|derecha|link=SIU-Arai]]

= Ejemplo paso a paso =

Para este caso voy a usar una instalación de Debian Jessie

El objetivo es tener una instalación funcionando de la paltaforma SIU-Arai que luego sirva para integrar otros sistemas toba.

Lo primero que defino es en que URL va a vivir cada sistemas, en mi caso lo tengo funcionando dentro de una intranet y los DNS que quedaron así

{| class="wikitable zebra"
!colspan="2"|URLs
|-
|Araí-Registry
|http://registry.local.siu
|-
|Araí-Usuarios
|https://usuarios.local.siu
|-
|Araí-Huarpe
|https://huarpe.local.siu
|}

== Creación de certificados ==
Hay que tener en cuenta que voy a usar conexión segura, por lo que tanto voy a necesitar certificados.
Para crear los certificados uso el tutorial que se encuentra en http://documentacion.siu.edu.ar/wiki/SIU-Arai/certificados.
Ese artículo asume
* Docker instalado (https://docs.docker.com/engine/installation/linux/docker-ce/debian/#install-using-the-repository).
* Docker Compose instalado (https://github.com/docker/compose/releases).

<syntaxhighlight lang="bash" enclose="div">
git clone https://hub.siu.edu.ar/siu/instaladores.git dockerCerts
</syntaxhighlight>

Editamos el archivo docker-compose según nuestras necesidades.

<syntaxhighlight lang="bash" enclose="div">
cd dockerCerts/certs
nano docker-compose.yml
</syntaxhighlight>

En mi caso quedo así:

<syntaxhighlight lang="apache" enclose="div">
certificados:
image: siutoba/docker-certs
container_name: docker-certs
#env_file: docker.env
environment:
DOCKER_NAME: certs
CA_PWD: pass
CA_INT_PWD: pass
LISTA_SERVER: huarpe.local.siu usuarios.local.siu
LISTA_CLIENTES: usuarios-cli huarpe-cli
volumes:
- ./data/certificados:/CAs/intermediate
- ./data/root:/CAs/rootCA

</syntaxhighlight>

Guardamos y generamos el container.
<syntaxhighlight lang="bash" enclose="div">
docker-compose up
</syntaxhighlight>

Una vez generado el container copiamos los certificados creados en la carpeta que nos sea mas cómodo, en mi caso /certs
Sin cambiar de directorio hacemos:
<syntaxhighlight lang="bash" enclose="div">
sudo mkdir /certs
sudo find data -name "*.pem" -exec cp {} /certs \;
</syntaxhighlight>

Luego generamos los certificados para el IDP:
<syntaxhighlight lang="bash" enclose="div">
mkdir /certs/idp
cd /certs/idp
openssl req -newkey rsa:2048 -new -x509 -days 3652 -nodes -out certificado_idp.crt -keyout certificado_idp.pem
</syntaxhighlight>

Listo, con las URL definidas y los certificados creados se puede proceder a instalar la plataforma.

== Instalación Arai-Registy ==
Creamos la carpeta '''/usr/local/siu''' y no posicionamos ahí
Clonamos el proyecto
<syntaxhighlight lang="bash" enclose="div">
git clone -b master https://hub.siu.edu.ar/siu-arai/arai-registry.git registry
</syntaxhighlight>
Utilizamos GitFlow, la última versión estable del proyecto es apuntada por el branch master y por cada versión que se saca se crea un tag.

Dentro del directorio del proyecto encontramos el archivo "doc/INSTALACION MANUAL.md", la idea es seguir las instrucciones que encontramos en este archivo.
<syntaxhighlight lang="bash" enclose="div">
cd registry
composer install --no-dev
</syntaxhighlight>

Configuramos las variables de entorno que va a usar el instalador, los valores que puse son válidos para mi instalación, deberán modificarlos según las necesidades de cada universidad.
<syntaxhighlight lang="bash" enclose="div">
cp templates/arai-registry.env.dist arai-registry.env
nano arai-registry.env
</syntaxhighlight>

'''arai-registry.env'''
<syntaxhighlight lang="apache" enclose="div">
# config de la aplicacion
ARAI_REGISTRY_ALIAS="/arai-registry"
ARAI_REGISTRY_USER="user"
ARAI_REGISTRY_PASS="pass"

# config de la base de datos
ARAI_REGISTRY_DB_HOST="172.27.31.114"
ARAI_REGISTRY_DB_PORT="7432"
ARAI_REGISTRY_DB_DBNAME="siu_registry"
ARAI_REGISTRY_DB_USERNAME="postgres"
ARAI_REGISTRY_DB_PASSWORD="postgres"
ARAI_REGISTRY_DB_SCHEMA="registry"
ARAI_REGISTRY_DB_ENCODING="UTF8"

###### CONFIG DE LOGS ######
ARAI_REGISTRY_LOG_HANDLER="errorlog"
ARAI_REGISTRY_LOG_LEVEL="WARNING"

# config del instalador
INSTALADOR_TIMEOUT="360"
</syntaxhighlight>

Una vez editado, verificamos que la configuración sea correcta
<syntaxhighlight lang="bash" enclose="div">
sudo ./bin/instalador proyecto:verificar
</syntaxhighlight>

Si no sale ninguna alerta, procedemos a instalar.
<syntaxhighlight lang="bash" enclose="div">
./bin/instalador proyecto:instalar
</syntaxhighlight>
Una vez instalado, modificamos los permisos de los archivos de la instalación con el comando
<syntaxhighlight lang="bash" enclose="div">
sudo ./bin/instalador permisos:simple
</syntaxhighlight>

Luego configuramos apache.
En mi caso, como tengo toda la plataforma instalada en un mismo servidor, debo usar el '''ServerName "registry.local.siu"'''
En lugar de hacer un vinculo con '''alias.conf''' como dice la documentación, use un include dentro del tag VirtualHost. Así me quedo el archivo '''/etc/apache/sites-enabled/registry.conf'''

<syntaxhighlight lang="apache" enclose="div">
<VirtualHost *:80>
ServerName registry.local.siu
Include /usr/local/siu/registry/config/alias.conf
</VirtualHost>
</syntaxhighlight>

Con todo esto, para verificar que todo funcione reiniciamos Apache y ejecutamos
<syntaxhighlight lang="bash" enclose="div">
curl --user user:pass http://registry.local.siu/arai-registry/rest/packages/1
</syntaxhighlight>

Si la salida es:
<syntaxhighlight lang="bash" enclose="div">
{
"error": 404,
"mensaje": "404 Not Found",
"descripcion": "El paquete solicitado no existe"
}
</syntaxhighlight>
es que la instalación funcionó correctamente.

Con registry instalado procedemos a instalar Usuarios

==Arai-Usuarios==

Nos posicionamos en /usr/local/siu y clonamos el proyecto
<syntaxhighlight lang="bash" enclose="div">
cd /usr/local/siu
git clone -b master https://hub.siu.edu.ar/siu-arai/arai-usuarios.git usuarios
cd usuarios
</syntaxhighlight>

Para instalar seguimos la documentación del archivo '''doc/INSTALACION_MANUAL.md'''
<syntaxhighlight lang="bash" enclose="div">
composer install --no-dev
</syntaxhighlight>

Configuramos las variables de entorno que va a usar el instalador, los valores que puse son válidos para mi instalación, deberán modificarlos según las necesidades de cada universidad.
Para la configuración de LDAP uso un servidor que ya está funcionando y configurado. El detalle de como configurar el servidor LDAP no pertenece a esta documentación.
La variable TOBA_USUARIO debe contener el mismo usuarios administrado del LDAP.
<syntaxhighlight lang="bash" enclose="div">
cp templates/arai-usuarios.env.dist arai-usuarios.env
nano arai-usuarios.env
</syntaxhighlight>

'''arai-usuarios.env.dist'''
<syntaxhighlight lang="apache" enclose="div">
###### CONFIG DEL INSTALADR ######
#INSTALADOR_TIMEOUT="360"
ENTORNO_PRODUCCION="1"

###### VARIABLES GLOBALES DEL ARCHIVO ######
ARAI_USUARIOS_DIR=/usr/local/siu/usuarios

###### CONFIG DE TOBA ######
TOBA_URL_BASE="https://usuarios.local.siu"
#TOBA_URL_PORT="443"
TOBA_USUARIO="admin"
TOBA_PASSWORD="admin1234"
TOBA_INSTALACION_DIR="${ARAI_USUARIOS_DIR}/instalacion"
TOBA_PROYECTO_DIR="${ARAI_USUARIOS_DIR}/gestion"
TOBA_INSTALAR_USUARIOS=false
TOBA_INSTALAR_EDITOR=false
TOBA_INSTALAR_REFERENCIA=false
TOBA_ALIAS_PROYECTO="/gestion"
TOBA_ALIAS_NUCLEO="/toba_gestion"
#TOBA_ID_DESARROLLADOR=0
#TOBA_SESSION_NAME="ARAI_SESSID"

###### CONFIG DE BASE DE DATOS DE NEGOCIO ######
PROYECTO_DB_HOST="172.27.31.114"
PROYECTO_DB_PORT="7432"
PROYECTO_DB_DBNAME="siu_usuarios"
PROYECTO_DB_USERNAME="postgres"
PROYECTO_DB_PASSWORD="postgres"
PROYECTO_DB_SCHEMA="usuarios"
PROYECTO_DB_ENCODING="LATIN1"

###### CONFIG DE BASE DE DATOS DE TOBA. #####
######## DEFINIR SI SE QUIERE UTILIZAR UNA BASE DISTINTA A LA DE NEGOCIO
#TOBA_DB_HOST="localhost"
#TOBA_DB_PORT="5432"
#TOBA_DB_DBNAME="instalador"
#TOBA_DB_USERNAME="postgres"
#TOBA_DB_PASSWORD="postgres"
#TOBA_DB_SCHEMA="public"

##### CONFIG IDM #####
ARAI_USUARIOS_URL_IDP=https://usuarios.local.siu/idp
## Deberá setearse si el sistema corre detrás de un proxy reverso
#ARAI_USUARIOS_PROXY_URL_IDP=http://url.arai-usuarios:80/idp
ARAI_USUARIOS_URL_PORTAL=https://huarpe.local.siu/portal
ARAI_USUARIOS_URL_PERFIL=https://huarpe.local.siu/perfil
ARAI_USUARIOS_URL_INSTITUCION=http://siu.edu.ar

ARAI_USUARIOS_SIGLA_INSTITUCION=SIGLA
ARAI_USUARIOS_EMAIL_SOPORTE=mail.soporte@institucion.edu.ar

##### CONFIG SEGURIDAD ####
SEGURIDAD_ALGORITMO_PASS=crypt
SEGURIDAD_LARGO_PASS=8
SEGURIDAD_INFO_PASS='El password debe tener al menos 8 caracteres, entre letras mayúsculas, minúsculas, números y símbolos, no pudiendo repetir caracteres adyacentes'
SEGURIDAD_DURACION_DIAS_PASS=120
SEGURIDAD_RECAPTCHA_SITIO=6Fd_pQwTAAAAAOEqJz6KJmkjsrXcdXrAjWQYggZf
SEGURIDAD_RECAPTCHA_CLAVE=6Fd_pQwTAAAAAOEqJz6KJmkjsrXcdXrAjWQYggZf
SEGURIDAD_INTENTOS_RECAPTCHA=3

##### CONFIG IDP #####
ARAI_USUARIOS_IDP_KEY_FILE=/certs/idp/certificado_idp.pem
ARAI_USUARIOS_IDP_CERT_FILE=/certs/idp/certificado_idp.crt
#ARAI_USUARIOS_IDP_LOG_LEVEL='WARNING'
#ARAI_USUARIOS_IDP_LOG_HANDLER='errorlog'

##### CONFIG MAIL RECOVERY ####
MAIL_RECOVERY_SUBJECT='Recuperar contraseña SIU-Arai'
MAIL_RECOVERY_FROM='noreply@institucion.edu.ar'
MAIL_RECOVERY_REPLYTO='noreply@institucion.edu.ar'
MAIL_RECOVERY_FROMNAME='Institución'

##### CONFIG LDAP #####
ARAI_USUARIOS_LDAP_HOST=172.27.31.114
ARAI_USUARIOS_LDAP_PORT=7389
ARAI_USUARIOS_LDAP_TLS=0
ARAI_USUARIOS_LDAP_METHOD=user
ARAI_USUARIOS_LDAP_BINDUSER="cn=admin,dc=siu,dc=cin,dc=edu"
ARAI_USUARIOS_LDAP_BINDPASS=admin
ARAI_USUARIOS_LDAP_SEARCHBASE="dc=siu,dc=cin,dc=edu"

##### CONFIG ARAI-REGISTRY #####
ARAI_REGISTRY_URL=http://registry.local.siu/arai-registry
ARAI_REGISTRY_USER=user
ARAI_REGISTRY_PASS=pass

###### CONFIG ENVIO MAILS (SMTP) ######
SMTP_ENTRADA="arai-usuarios"
SMTP_HELO="mail.unx.edu.ar"
SMTP_HOST="smtp.googlemail.com"
SMTP_PORT=587
SMTP_FROM ="yo@midominio.com"
SMTP_SEGURIDAD ="ssl|tls"
SMTP_AUTH ="1"
SMTP_USUARIO ="usuario"
SMTP_CLAVE ="pass"
</syntaxhighlight>

Una vez editado, verificamos que la configuración sea correcta
<syntaxhighlight lang="bash" enclose="div">
./bin/instalador proyecto:verificar -n
</syntaxhighlight>

Si no sale ninguna alerta, procedemos a instalar.
<syntaxhighlight lang="bash" enclose="div">
./bin/instalador proyecto:instalar
</syntaxhighlight>
Una vez instalado, modificamos los permisos de los archivos de la instalación con el comando
<syntaxhighlight lang="bash" enclose="div">
sudo ./bin/instalador permisos:simple
</syntaxhighlight>
Cambiamos el modo mantenimiento
<syntaxhighlight lang="bash" enclose="div">
./bin/instalador instalacion:modo-mantenimiento --sin-mantenimiento -n
</syntaxhighlight>

Luego configuramos Apache.
Lo mismo que con registry, como tengo toda la plataforma instalada en un mismo servidor, debo usar el '''ServerName "usuarios.local.siu"'''
En lugar de hacer un vinculo con '''alias.conf''' como dice la documentación, use un include dentro del tag VirtualHost. Así me quedo el archivo '''/etc/apache/sites-enabled/usuarios.conf'''

<syntaxhighlight lang="apache" enclose="div">
<VirtualHost *:80>
ServerName usuarios.local.siu
Redirect permanent / https://usuarios.local.siu/
</VirtualHost>

<VirtualHost *:443>

ServerName usuarios.local.siu

SSLEngine on
SSLCertificateFile /certs/usuarios.local.siu.cert.pem
SSLCertificateKeyFile /certs/usuarios.local.siu.key.pem

SSLCACertificateFile /certs/ca-chain.cert.pem

SSLVerifyClient optional_no_ca
SSLVerifyDepth 2
SSLProtocol all -SSLv2 -SSLv3
SSLOptions +StdEnvVars +ExportCertData
BrowserMatch "MSIE [2-6]" \
nokeepalive ssl-unclean-shutdown \
downgrade-1.0 force-response-1.0
# MSIE 7 and newer should be able to use keepalive
BrowserMatch "MSIE [17-9]" ssl-unclean-shutdown

Include /usr/local/siu/usuarios/instalacion/toba.conf

Include /usr/local/siu/usuarios/instalacion/idp.conf

</VirtualHost>
</syntaxhighlight>

Luego hay que hacer que nuestra CA autofirmada sea válida en el SO y así permitir que Apache verifique los certificados de clientes:
<syntaxhighlight lang="apache" enclose="div">
sudo cp /certs/ca.cert.pem /usr/share/ca-certificates/ca_propia.crt
sudo vim /etc/ca-certificates.conf
# agregar ca_propia.crt al final del archivo
update-ca-certificates --fresh
</syntaxhighlight>

Reiniciamos Apache y todo debería funcionar, para verificar entramos en la URL definida para usuarios, en mi caso https://usuarios.local.siu/gestion

Con todo esto funcionando el siguiente paso es agregar Usuarios a Registry y sincronizarlos.
Según esta instalación para agregar Usuarios al entorno hacemos
<syntaxhighlight lang="bash" enclose="div">
./bin/arai-cli registry:add --maintainer-email jpiazza@siu.edu.ar --maintainer jpiazza http://registry.local.siu/arai-registry
</syntaxhighlight>
y para sincronizarlo
<syntaxhighlight lang="bash" enclose="div">
./bin/arai-cli registry:sync
</syntaxhighlight>

== Arai-Huarpe ==

Es similar a las instalaciones anteriores.
<syntaxhighlight lang="bash" enclose="div">
cd /usr/local/siu
git clone -b master https://hub.siu.edu.ar/siu-arai/huarpe-core.git huarpe
cd huarpe
</syntaxhighlight>

Para instalar seguimos la documentación del archivo '''doc/INSTALACION_MANUAL.md'''
<syntaxhighlight lang="bash" enclose="div">
composer install --no-dev
</syntaxhighlight>

Configuramos las variables de entorno que va a usar el instalador, los valores que puse son válidos para mi instalación, deberán modificarlos según las necesidades de cada universidad.
<syntaxhighlight lang="bash" enclose="div">
cp templates/huarpe.env.dist huarpe.env
nano huarpe.env
</syntaxhighlight>

'''huarpe.env'''
<syntaxhighlight lang="apache" enclose="div">
###### CONFIG DEL INSTALADR ######
#INSTALADOR_TIMEOUT="360"
ENTORNO_PRODUCCION=1

###### CONFIG DE SIU-HUARPE ######
HUARPE_PATH=/usr/local/siu/huarpe
HUARPE_URL=https://huarpe.local.siu
HUARPE_URL_PORT=443
HUARPE_SESSION_NAME=huarpe
HUARPE_SESSION_HANDLER="native_file"
#HUARPE_MEMCACHED_HOST=127.0.0.1
#HUARPE_MEMCACHED_PORT=11211
HUARPE_CERT_FILE=/certs/huarpe-cli.cert.pem
HUARPE_KEY_FILE=/certs/huarpe-cli.key.pem
#HUARPE_TOKEN=unt0k3n-al3at0r1o-s39ur0?
#HUARPE_PROXY=127.0.0.1
HUARPE_LOG_HANDLER="error_log"
HUARPE_LOG_LEVEL="WARNING"

###### CONFIG BRANDING ######
#HUARPE_PATH_LOGO="/path/al/logo.png"
HUARPE_NOMBRE_INSTITUCION="Institución"

###### CONFIG DE SIU-ARAI: REGISTRY ######
ARAI_REGISTRY_URL=http://registry.local.siu/arai-registry
ARAI_REGISTRY_USER=user
ARAI_REGISTRY_PASS=pass
</syntaxhighlight>

Una vez editado, verificamos que la configuración sea correcta
<syntaxhighlight lang="bash" enclose="div">
./bin/instalador proyecto:verificar
</syntaxhighlight>
Si no sale ninguna alerta, procedemos a instalar.
<syntaxhighlight lang="bash" enclose="div">
sudo ./bin/instalador proyecto:instalar
</syntaxhighlight>
En Synfony es necesario dumpear los estilos y los JS con el siguiente comando.
<syntaxhighlight lang="bash" enclose="div">
./bin/console assetic:dump --no-debug --env=prod
</syntaxhighlight>
Una vez instalado, modificamos los permisos de los archivos de la instalación con el comando
<syntaxhighlight lang="bash" enclose="div">
sudo ./bin/instalador permisos:simple
</syntaxhighlight>

=== Configuración apache ===
Lo mismo que con Registry o Usuarios, como tengo toda la plataforma instalada en un mismo servidor, debo usar el '''ServerName huarpe.local.siu'''.
En lugar de hacer un vinculo con alias.conf como dice la documentación, usé un include dentro del tag VirtualHost. Así me quedo el archivo /etc/apache/sites-enabled/huarpe.conf

<syntaxhighlight lang="apache" enclose="div">
<VirtualHost *:80>
ServerName huarpe.local.siu
Redirect permanent / https://huarpe.local.siu:443/
</VirtualHost>

<VirtualHost *:443>

ServerName huarpe.local.siu
SSLEngine on
SSLCertificateFile /certs/huarpe.local.siu.cert.pem
SSLCertificateKeyFile /certs/huarpe.local.siu.key.pem

Include /usr/local/siu/huarpe/app/config/alias.conf

</VirtualHost>
</syntaxhighlight>

Reiniciamos apache, antes de verificar la instalación, debemos sincronizar con Registry.
<syntaxhighlight lang="bash" enclose="div">
./bin/arai-cli registry:add --maintainer-email jpiazza@siu.edu.ar --maintainer jpiazza http://registry.local.siu/arai-registry
</syntaxhighlight>
Luego sincronizar
<syntaxhighlight lang="bash" enclose="div">
./bin/arai-cli registry:sync
</syntaxhighlight>

Hay que limpiar la cache y actualizar los permisos
<syntaxhighlight lang="bash" enclose="div">
./bin/console cache:clear --env=prod
sudo ./bin/instalador permisos:simple
</syntaxhighlight>

En Usuarios resincronizar para que se actualice con la nueva instalación
<syntaxhighlight lang="bash" enclose="div">
cd /usr/local/siu/usuarios
./bin/arai-cli registry:sync
</syntaxhighlight>

Para verificar que la instalación se realizo con éxito de debe ingresar en https://huarpe.local.siu/

Si todo salio bien, tenemos instalada la plataforma ARAI lista para ser usada en nuestro servidor.

SIU-Arai/ejemploPasoAPaso

2017-11-03T12:35:54Z

Jpiazza: /* Arai-Usuarios */

[[Archivo:siu-arai_iso.png|derecha|link=SIU-Arai]]

= Ejemplo paso a paso =

Para este caso voy a usar una instalación de Debian Jessie

El objetivo es tener una instalación funcionando de la paltaforma SIU-Arai que luego sirva para integrar otros sistemas toba.

Lo primero que defino es en que URL va a vivir cada sistemas, en mi caso lo tengo funcionando dentro de una intranet y los DNS que quedaron así

{| class="wikitable zebra"
!colspan="2"|URLs
|-
|Araí-Registry
|http://registry.local.siu
|-
|Araí-Usuarios
|https://usuarios.local.siu
|-
|Araí-Huarpe
|https://huarpe.local.siu
|}

== Creación de certificados ==
Hay que tener en cuenta que voy a usar conexión segura, por lo que tanto voy a necesitar certificados.
Para crear los certificados uso el tutorial que se encuentra en http://documentacion.siu.edu.ar/wiki/SIU-Arai/certificados.
Ese artículo asume
* Docker instalado (https://docs.docker.com/engine/installation/linux/docker-ce/debian/#install-using-the-repository).
* Docker Compose instalado (https://github.com/docker/compose/releases).

<syntaxhighlight lang="bash" enclose="div">
git clone https://hub.siu.edu.ar/siu/instaladores.git dockerCerts
</syntaxhighlight>

Editamos el archivo docker-compose según nuestras necesidades.

<syntaxhighlight lang="bash" enclose="div">
cd dockerCerts/certs
nano docker-compose.yml
</syntaxhighlight>

En mi caso quedo así:

<syntaxhighlight lang="apache" enclose="div">
certificados:
image: siutoba/docker-certs
container_name: docker-certs
#env_file: docker.env
environment:
DOCKER_NAME: certs
CA_PWD: pass
CA_INT_PWD: pass
LISTA_SERVER: huarpe.local.siu usuarios.local.siu
LISTA_CLIENTES: usuarios-cli huarpe-cli
volumes:
- ./data/certificados:/CAs/intermediate
- ./data/root:/CAs/rootCA

</syntaxhighlight>

Guardamos y generamos el container.
<syntaxhighlight lang="bash" enclose="div">
docker-compose up
</syntaxhighlight>

Una vez generado el container copiamos los certificados creados en la carpeta que nos sea mas cómodo, en mi caso /certs
Sin cambiar de directorio hacemos:
<syntaxhighlight lang="bash" enclose="div">
sudo mkdir /certs
sudo find data -name "*.pem" -exec cp {} /certs \;
</syntaxhighlight>

Luego generamos los certificados para el IDP:
<syntaxhighlight lang="bash" enclose="div">
mkdir /certs/idp
cd /certs/idp
openssl req -newkey rsa:2048 -new -x509 -days 3652 -nodes -out certificado_idp.crt -keyout certificado_idp.pem
</syntaxhighlight>

Listo, con las URL definidas y los certificados creados se puede proceder a instalar la plataforma.

== Instalación Arai-Registy ==
Creamos la carpeta '''/usr/local/siu''' y no posicionamos ahí
Clonamos el proyecto
<syntaxhighlight lang="bash" enclose="div">
git clone -b master https://hub.siu.edu.ar/siu-arai/arai-registry.git registry
</syntaxhighlight>
Utilizamos GitFlow, la última versión estable del proyecto es apuntada por el branch master y por cada versión que se saca se crea un tag.

Dentro del directorio del proyecto encontramos el archivo "doc/INSTALACION MANUAL.md", la idea es seguir las instrucciones que encontramos en este archivo.
<syntaxhighlight lang="bash" enclose="div">
cd registry
composer install --no-dev
</syntaxhighlight>

Configuramos las variables de entorno que va a usar el instalador, los valores que puse son válidos para mi instalación, deberán modificarlos según las necesidades de cada universidad.
<syntaxhighlight lang="bash" enclose="div">
cp templates/arai-registry.env.dist arai-registry.env
nano arai-registry.env
</syntaxhighlight>

'''arai-registry.env'''
<syntaxhighlight lang="apache" enclose="div">
# config de la aplicacion
ARAI_REGISTRY_ALIAS="/arai-registry"
ARAI_REGISTRY_USER="user"
ARAI_REGISTRY_PASS="pass"

# config de la base de datos
ARAI_REGISTRY_DB_HOST="172.27.31.114"
ARAI_REGISTRY_DB_PORT="7432"
ARAI_REGISTRY_DB_DBNAME="siu_registry"
ARAI_REGISTRY_DB_USERNAME="postgres"
ARAI_REGISTRY_DB_PASSWORD="postgres"
ARAI_REGISTRY_DB_SCHEMA="registry"
ARAI_REGISTRY_DB_ENCODING="UTF8"

###### CONFIG DE LOGS ######
ARAI_REGISTRY_LOG_HANDLER="errorlog"
ARAI_REGISTRY_LOG_LEVEL="WARNING"

# config del instalador
INSTALADOR_TIMEOUT="360"
</syntaxhighlight>

Una vez editado, verificamos que la configuración sea correcta
<syntaxhighlight lang="bash" enclose="div">
sudo ./bin/instalador proyecto:verificar
</syntaxhighlight>

Si no sale ninguna alerta, procedemos a instalar.
<syntaxhighlight lang="bash" enclose="div">
./bin/instalador proyecto:instalar
</syntaxhighlight>
Una vez instalado, modificamos los permisos de los archivos de la instalación con el comando
<syntaxhighlight lang="bash" enclose="div">
sudo ./bin/instalador permisos:simple
</syntaxhighlight>

Luego configuramos apache.
En mi caso, como tengo toda la plataforma instalada en un mismo servidor, debo usar el '''ServerName "registry.local.siu"'''
En lugar de hacer un vinculo con '''alias.conf''' como dice la documentación, use un include dentro del tag VirtualHost. Así me quedo el archivo '''/etc/apache/sites-enabled/registry.conf'''

<syntaxhighlight lang="apache" enclose="div">
<VirtualHost *:80>
ServerName registry.local.siu
Include /usr/local/siu/registry/config/alias.conf
</VirtualHost>
</syntaxhighlight>

Con todo esto, para verificar que todo funcione reiniciamos Apache y ejecutamos
<syntaxhighlight lang="bash" enclose="div">
curl --user user:pass http://registry.local.siu/arai-registry/rest/packages/1
</syntaxhighlight>

Si la salida es:
<syntaxhighlight lang="bash" enclose="div">
{
"error": 404,
"mensaje": "404 Not Found",
"descripcion": "El paquete solicitado no existe"
}
</syntaxhighlight>
es que la instalación funcionó correctamente.

Con registry instalado procedemos a instalar Usuarios

==Arai-Usuarios==

Nos posicionamos en /usr/local/siu y clonamos el proyecto
<syntaxhighlight lang="bash" enclose="div">
cd /usr/local/siu
git clone -b master https://hub.siu.edu.ar/siu-arai/arai-usuarios.git usuarios
cd usuarios
</syntaxhighlight>

Para instalar seguimos la documentación del archivo '''doc/INSTALACION_MANUAL.md'''
<syntaxhighlight lang="bash" enclose="div">
composer install --no-dev
</syntaxhighlight>

Configuramos las variables de entorno que va a usar el instalador, los valores que puse son válidos para mi instalación, deberán modificarlos según las necesidades de cada universidad.
Para la configuración de LDAP uso un servidor que ya está funcionando y configurado. El detalle de como configurar el servidor LDAP no pertenece a esta documentación.
La variable TOBA_USUARIO debe contener el mismo usuarios administrado del LDAP.
<syntaxhighlight lang="bash" enclose="div">
cp templates/arai-usuarios.env.dist arai-usuarios.env
nano arai-usuarios.env
</syntaxhighlight>

'''arai-usuarios.env.dist'''
<syntaxhighlight lang="apache" enclose="div">
###### CONFIG DEL INSTALADR ######
#INSTALADOR_TIMEOUT="360"
ENTORNO_PRODUCCION="1"

###### VARIABLES GLOBALES DEL ARCHIVO ######
ARAI_USUARIOS_DIR=/usr/local/siu/usuarios

###### CONFIG DE TOBA ######
TOBA_URL_BASE="https://usuarios.local.siu"
#TOBA_URL_PORT="443"
TOBA_USUARIO="admin"
TOBA_PASSWORD="admin1234"
TOBA_INSTALACION_DIR="${ARAI_USUARIOS_DIR}/instalacion"
TOBA_PROYECTO_DIR="${ARAI_USUARIOS_DIR}/gestion"
TOBA_INSTALAR_USUARIOS=false
TOBA_INSTALAR_EDITOR=false
TOBA_INSTALAR_REFERENCIA=false
TOBA_ALIAS_PROYECTO="/gestion"
TOBA_ALIAS_NUCLEO="/toba_gestion"
#TOBA_ID_DESARROLLADOR=0
#TOBA_SESSION_NAME="ARAI_SESSID"

###### CONFIG DE BASE DE DATOS DE NEGOCIO ######
PROYECTO_DB_HOST="172.27.31.114"
PROYECTO_DB_PORT="7432"
PROYECTO_DB_DBNAME="siu_usuarios"
PROYECTO_DB_USERNAME="postgres"
PROYECTO_DB_PASSWORD="postgres"
PROYECTO_DB_SCHEMA="usuarios"
PROYECTO_DB_ENCODING="LATIN1"

###### CONFIG DE BASE DE DATOS DE TOBA. #####
######## DEFINIR SI SE QUIERE UTILIZAR UNA BASE DISTINTA A LA DE NEGOCIO
#TOBA_DB_HOST="localhost"
#TOBA_DB_PORT="5432"
#TOBA_DB_DBNAME="instalador"
#TOBA_DB_USERNAME="postgres"
#TOBA_DB_PASSWORD="postgres"
#TOBA_DB_SCHEMA="public"

##### CONFIG IDM #####
ARAI_USUARIOS_URL_IDP=https://usuarios.local.siu/idp
## Deberá setearse si el sistema corre detrás de un proxy reverso
#ARAI_USUARIOS_PROXY_URL_IDP=http://url.arai-usuarios:80/idp
ARAI_USUARIOS_URL_PORTAL=https://huarpe.local.siu/portal
ARAI_USUARIOS_URL_PERFIL=https://huarpe.local.siu/perfil
ARAI_USUARIOS_URL_INSTITUCION=http://siu.edu.ar

ARAI_USUARIOS_SIGLA_INSTITUCION=SIGLA
ARAI_USUARIOS_EMAIL_SOPORTE=mail.soporte@institucion.edu.ar

##### CONFIG SEGURIDAD ####
SEGURIDAD_ALGORITMO_PASS=crypt
SEGURIDAD_LARGO_PASS=8
SEGURIDAD_INFO_PASS='El password debe tener al menos 8 caracteres, entre letras mayúsculas, minúsculas, números y símbolos, no pudiendo repetir caracteres adyacentes'
SEGURIDAD_DURACION_DIAS_PASS=120
SEGURIDAD_RECAPTCHA_SITIO=6Fd_pQwTAAAAAOEqJz6KJmkjsrXcdXrAjWQYggZf
SEGURIDAD_RECAPTCHA_CLAVE=6Fd_pQwTAAAAAOEqJz6KJmkjsrXcdXrAjWQYggZf
SEGURIDAD_INTENTOS_RECAPTCHA=3

##### CONFIG IDP #####
ARAI_USUARIOS_IDP_KEY_FILE=/certs/idp/certificado_idp.pem
ARAI_USUARIOS_IDP_CERT_FILE=/certs/idp/certificado_idp.crt
#ARAI_USUARIOS_IDP_LOG_LEVEL='WARNING'
#ARAI_USUARIOS_IDP_LOG_HANDLER='errorlog'

##### CONFIG MAIL RECOVERY ####
MAIL_RECOVERY_SUBJECT='Recuperar contraseña SIU-Arai'
MAIL_RECOVERY_FROM='noreply@institucion.edu.ar'
MAIL_RECOVERY_REPLYTO='noreply@institucion.edu.ar'
MAIL_RECOVERY_FROMNAME='Institución'

##### CONFIG LDAP #####
ARAI_USUARIOS_LDAP_HOST=172.27.31.114
ARAI_USUARIOS_LDAP_PORT=7389
ARAI_USUARIOS_LDAP_TLS=0
ARAI_USUARIOS_LDAP_METHOD=user
ARAI_USUARIOS_LDAP_BINDUSER="cn=admin,dc=siu,dc=cin,dc=edu"
ARAI_USUARIOS_LDAP_BINDPASS=admin
ARAI_USUARIOS_LDAP_SEARCHBASE="dc=siu,dc=cin,dc=edu"

##### CONFIG ARAI-REGISTRY #####
ARAI_REGISTRY_URL=http://registry.local.siu/arai-registry
ARAI_REGISTRY_USER=user
ARAI_REGISTRY_PASS=pass

###### CONFIG ENVIO MAILS (SMTP) ######
SMTP_ENTRADA="arai-usuarios"
SMTP_HELO="mail.unx.edu.ar"
SMTP_HOST="smtp.googlemail.com"
SMTP_PORT=587
SMTP_FROM ="yo@midominio.com"
SMTP_SEGURIDAD ="ssl|tls"
SMTP_AUTH ="1"
SMTP_USUARIO ="usuario"
SMTP_CLAVE ="pass"
</syntaxhighlight>

Una vez editado, verificamos que la configuración sea correcta
<syntaxhighlight lang="bash" enclose="div">
./bin/instalador proyecto:verificar -n
</syntaxhighlight>

Si no sale ninguna alerta, procedemos a instalar.
<syntaxhighlight lang="bash" enclose="div">
./bin/instalador proyecto:instalar
</syntaxhighlight>
Una vez instalado, modificamos los permisos de los archivos de la instalación con el comando
<syntaxhighlight lang="bash" enclose="div">
sudo ./bin/instalador permisos:simple
</syntaxhighlight>
Cambiamos el modo mantenimiento
<syntaxhighlight lang="bash" enclose="div">
./bin/instalador instalacion:modo-mantenimiento --sin-mantenimiento -n
</syntaxhighlight>

Luego configuramos Apache.
Lo mismo que con registry, como tengo toda la plataforma instalada en un mismo servidor, debo usar el '''ServerName "usuarios.local.siu"'''
En lugar de hacer un vinculo con '''alias.conf''' como dice la documentación, use un include dentro del tag VirtualHost. Así me quedo el archivo '''/etc/apache/sites-enabled/usuarios.conf'''

<syntaxhighlight lang="apache" enclose="div">
<VirtualHost *:80>
ServerName usuarios.local.siu
Redirect permanent / https://usuarios.local.siu/
</VirtualHost>

<VirtualHost *:443>

ServerName usuarios.local.siu

SSLEngine on
SSLCertificateFile /certs/usuarios.local.siu.cert.pem
SSLCertificateKeyFile /certs/usuarios.local.siu.key.pem

SSLCACertificateFile /certs/ca-chain.cert.pem

SSLVerifyClient optional_no_ca
SSLVerifyDepth 2
SSLProtocol all -SSLv2 -SSLv3
SSLOptions +StdEnvVars +ExportCertData
BrowserMatch "MSIE [2-6]" \
nokeepalive ssl-unclean-shutdown \
downgrade-1.0 force-response-1.0
# MSIE 7 and newer should be able to use keepalive
BrowserMatch "MSIE [17-9]" ssl-unclean-shutdown

Include /usr/local/siu/usuarios/instalacion/toba.conf

Include /usr/local/siu/usuarios/instalacion/idp.conf

</VirtualHost>
</syntaxhighlight>

Luego hay que hacer que nuestra CA autofirmada sea válida en el SO y así permitir que Apache verifique los certificados de clientes:
<syntaxhighlight lang="apache" enclose="div">
sudo cp /certs/ca.cert.pem /usr/share/ca-certificates/ca_propia.crt
sudo vim /etc/ca-certificates.conf
# agregar ca_propia.crt al final del archivo
update-ca-certificates --fresh
</syntaxhighlight>

Reiniciamos Apache y todo debería funcionar, para verificar entramos en la URL definida para usuarios, en mi caso https://usuarios.local.siu/gestion

Con todo esto funcionando el siguiente paso es agregar Usuarios a Registry y sincronizarlos.
Según esta instalación para agregar Usuarios al entorno hacemos
<syntaxhighlight lang="bash" enclose="div">
./bin/arai-cli registry:add --maintainer-email jpiazza@siu.edu.ar --maintainer jpiazza http://registry.local.siu/arai-registry
</syntaxhighlight>
y para sincronizarlo
<syntaxhighlight lang="bash" enclose="div">
./bin/arai-cli registry:sync
</syntaxhighlight>

== Arai-Huarpe ==

Es similar a las instalaciones anteriores.
<syntaxhighlight lang="bash" enclose="div">
cd /usr/local/siu
git clone https://hub.siu.edu.ar/siu-arai/huarpe-core.git huarpe
cd huarpe
</syntaxhighlight>

Para instalar seguimos la documentación del archivo '''doc/INSTALACION_MANUAL.md'''
<syntaxhighlight lang="bash" enclose="div">
composer install --no-dev
</syntaxhighlight>

Configuramos las variables de entorno que va a usar el instalador, los valores que puse son válidos para mi instalación, deberán modificarlos según las necesidades de cada universidad.
<syntaxhighlight lang="bash" enclose="div">
cp templates/huarpe.env.dist huarpe.env
nano huarpe.env
</syntaxhighlight>

'''huarpe.env'''
<syntaxhighlight lang="apache" enclose="div">
###### CONFIG DEL INSTALADR ######
#INSTALADOR_TIMEOUT="360"
ENTORNO_PRODUCCION=1

###### CONFIG DE SIU-HUARPE ######
HUARPE_PATH=/usr/local/siu/huarpe
HUARPE_URL=https://huarpe.local.siu
HUARPE_URL_PORT=443
HUARPE_SESSION_NAME=huarpe
HUARPE_SESSION_HANDLER="native_file"
#HUARPE_MEMCACHED_HOST=127.0.0.1
#HUARPE_MEMCACHED_PORT=11211
HUARPE_CERT_FILE=/certs/huarpe-cli.cert.pem
HUARPE_KEY_FILE=/certs/huarpe-cli.key.pem
#HUARPE_TOKEN=unt0k3n-al3at0r1o-s39ur0?
#HUARPE_PROXY=127.0.0.1
HUARPE_LOG_HANDLER="error_log"
HUARPE_LOG_LEVEL="WARNING"

###### CONFIG BRANDING ######
#HUARPE_PATH_LOGO="/path/al/logo.png"
HUARPE_NOMBRE_INSTITUCION="Institución"

###### CONFIG DE SIU-ARAI: REGISTRY ######
ARAI_REGISTRY_URL=http://registry.local.siu/arai-registry
ARAI_REGISTRY_USER=user
ARAI_REGISTRY_PASS=pass
</syntaxhighlight>

Una vez editado, verificamos que la configuración sea correcta
<syntaxhighlight lang="bash" enclose="div">
./bin/instalador proyecto:verificar
</syntaxhighlight>
Si no sale ninguna alerta, procedemos a instalar.
<syntaxhighlight lang="bash" enclose="div">
sudo ./bin/instalador proyecto:instalar
</syntaxhighlight>
En Synfony es necesario dumpear los estilos y los JS con el siguiente comando.
<syntaxhighlight lang="bash" enclose="div">
./bin/console assetic:dump --no-debug --env=prod
</syntaxhighlight>
Una vez instalado, modificamos los permisos de los archivos de la instalación con el comando
<syntaxhighlight lang="bash" enclose="div">
sudo ./bin/instalador permisos:simple
</syntaxhighlight>

=== Configuración apache ===
Lo mismo que con Registry o Usuarios, como tengo toda la plataforma instalada en un mismo servidor, debo usar el '''ServerName huarpe.local.siu'''.
En lugar de hacer un vinculo con alias.conf como dice la documentación, usé un include dentro del tag VirtualHost. Así me quedo el archivo /etc/apache/sites-enabled/huarpe.conf

<syntaxhighlight lang="apache" enclose="div">
<VirtualHost *:80>
ServerName huarpe.local.siu
Redirect permanent / https://huarpe.local.siu:443/
</VirtualHost>

<VirtualHost *:443>

ServerName huarpe.local.siu
SSLEngine on
SSLCertificateFile /certs/huarpe.local.siu.cert.pem
SSLCertificateKeyFile /certs/huarpe.local.siu.key.pem

Include /usr/local/siu/huarpe/app/config/alias.conf

</VirtualHost>
</syntaxhighlight>

Reiniciamos apache, antes de verificar la instalación, debemos sincronizar con Registry.
<syntaxhighlight lang="bash" enclose="div">
./bin/arai-cli registry:add --maintainer-email jpiazza@siu.edu.ar --maintainer jpiazza http://registry.local.siu/arai-registry
</syntaxhighlight>
Luego sincronizar
<syntaxhighlight lang="bash" enclose="div">
./bin/arai-cli registry:sync
</syntaxhighlight>

Hay que limpiar la cache y actualizar los permisos
<syntaxhighlight lang="bash" enclose="div">
./bin/console cache:clear --env=prod
sudo ./bin/instalador permisos:simple
</syntaxhighlight>

En Usuarios resincronizar para que se actualice con la nueva instalación
<syntaxhighlight lang="bash" enclose="div">
cd /usr/local/siu/usuarios
./bin/arai-cli registry:sync
</syntaxhighlight>

Para verificar que la instalación se realizo con éxito de debe ingresar en https://huarpe.local.siu/

Si todo salio bien, tenemos instalada la plataforma ARAI lista para ser usada en nuestro servidor.

SIU-Arai/ejemploPasoAPaso

2017-11-03T12:35:28Z

Jpiazza: /* Instalación Arai-Registy */

[[Archivo:siu-arai_iso.png|derecha|link=SIU-Arai]]

= Ejemplo paso a paso =

Para este caso voy a usar una instalación de Debian Jessie

El objetivo es tener una instalación funcionando de la paltaforma SIU-Arai que luego sirva para integrar otros sistemas toba.

Lo primero que defino es en que URL va a vivir cada sistemas, en mi caso lo tengo funcionando dentro de una intranet y los DNS que quedaron así

{| class="wikitable zebra"
!colspan="2"|URLs
|-
|Araí-Registry
|http://registry.local.siu
|-
|Araí-Usuarios
|https://usuarios.local.siu
|-
|Araí-Huarpe
|https://huarpe.local.siu
|}

== Creación de certificados ==
Hay que tener en cuenta que voy a usar conexión segura, por lo que tanto voy a necesitar certificados.
Para crear los certificados uso el tutorial que se encuentra en http://documentacion.siu.edu.ar/wiki/SIU-Arai/certificados.
Ese artículo asume
* Docker instalado (https://docs.docker.com/engine/installation/linux/docker-ce/debian/#install-using-the-repository).
* Docker Compose instalado (https://github.com/docker/compose/releases).

<syntaxhighlight lang="bash" enclose="div">
git clone https://hub.siu.edu.ar/siu/instaladores.git dockerCerts
</syntaxhighlight>

Editamos el archivo docker-compose según nuestras necesidades.

<syntaxhighlight lang="bash" enclose="div">
cd dockerCerts/certs
nano docker-compose.yml
</syntaxhighlight>

En mi caso quedo así:

<syntaxhighlight lang="apache" enclose="div">
certificados:
image: siutoba/docker-certs
container_name: docker-certs
#env_file: docker.env
environment:
DOCKER_NAME: certs
CA_PWD: pass
CA_INT_PWD: pass
LISTA_SERVER: huarpe.local.siu usuarios.local.siu
LISTA_CLIENTES: usuarios-cli huarpe-cli
volumes:
- ./data/certificados:/CAs/intermediate
- ./data/root:/CAs/rootCA

</syntaxhighlight>

Guardamos y generamos el container.
<syntaxhighlight lang="bash" enclose="div">
docker-compose up
</syntaxhighlight>

Una vez generado el container copiamos los certificados creados en la carpeta que nos sea mas cómodo, en mi caso /certs
Sin cambiar de directorio hacemos:
<syntaxhighlight lang="bash" enclose="div">
sudo mkdir /certs
sudo find data -name "*.pem" -exec cp {} /certs \;
</syntaxhighlight>

Luego generamos los certificados para el IDP:
<syntaxhighlight lang="bash" enclose="div">
mkdir /certs/idp
cd /certs/idp
openssl req -newkey rsa:2048 -new -x509 -days 3652 -nodes -out certificado_idp.crt -keyout certificado_idp.pem
</syntaxhighlight>

Listo, con las URL definidas y los certificados creados se puede proceder a instalar la plataforma.

== Instalación Arai-Registy ==
Creamos la carpeta '''/usr/local/siu''' y no posicionamos ahí
Clonamos el proyecto
<syntaxhighlight lang="bash" enclose="div">
git clone -b master https://hub.siu.edu.ar/siu-arai/arai-registry.git registry
</syntaxhighlight>
Utilizamos GitFlow, la última versión estable del proyecto es apuntada por el branch master y por cada versión que se saca se crea un tag.

Dentro del directorio del proyecto encontramos el archivo "doc/INSTALACION MANUAL.md", la idea es seguir las instrucciones que encontramos en este archivo.
<syntaxhighlight lang="bash" enclose="div">
cd registry
composer install --no-dev
</syntaxhighlight>

Configuramos las variables de entorno que va a usar el instalador, los valores que puse son válidos para mi instalación, deberán modificarlos según las necesidades de cada universidad.
<syntaxhighlight lang="bash" enclose="div">
cp templates/arai-registry.env.dist arai-registry.env
nano arai-registry.env
</syntaxhighlight>

'''arai-registry.env'''
<syntaxhighlight lang="apache" enclose="div">
# config de la aplicacion
ARAI_REGISTRY_ALIAS="/arai-registry"
ARAI_REGISTRY_USER="user"
ARAI_REGISTRY_PASS="pass"

# config de la base de datos
ARAI_REGISTRY_DB_HOST="172.27.31.114"
ARAI_REGISTRY_DB_PORT="7432"
ARAI_REGISTRY_DB_DBNAME="siu_registry"
ARAI_REGISTRY_DB_USERNAME="postgres"
ARAI_REGISTRY_DB_PASSWORD="postgres"
ARAI_REGISTRY_DB_SCHEMA="registry"
ARAI_REGISTRY_DB_ENCODING="UTF8"

###### CONFIG DE LOGS ######
ARAI_REGISTRY_LOG_HANDLER="errorlog"
ARAI_REGISTRY_LOG_LEVEL="WARNING"

# config del instalador
INSTALADOR_TIMEOUT="360"
</syntaxhighlight>

Una vez editado, verificamos que la configuración sea correcta
<syntaxhighlight lang="bash" enclose="div">
sudo ./bin/instalador proyecto:verificar
</syntaxhighlight>

Si no sale ninguna alerta, procedemos a instalar.
<syntaxhighlight lang="bash" enclose="div">
./bin/instalador proyecto:instalar
</syntaxhighlight>
Una vez instalado, modificamos los permisos de los archivos de la instalación con el comando
<syntaxhighlight lang="bash" enclose="div">
sudo ./bin/instalador permisos:simple
</syntaxhighlight>

Luego configuramos apache.
En mi caso, como tengo toda la plataforma instalada en un mismo servidor, debo usar el '''ServerName "registry.local.siu"'''
En lugar de hacer un vinculo con '''alias.conf''' como dice la documentación, use un include dentro del tag VirtualHost. Así me quedo el archivo '''/etc/apache/sites-enabled/registry.conf'''

<syntaxhighlight lang="apache" enclose="div">
<VirtualHost *:80>
ServerName registry.local.siu
Include /usr/local/siu/registry/config/alias.conf
</VirtualHost>
</syntaxhighlight>

Con todo esto, para verificar que todo funcione reiniciamos Apache y ejecutamos
<syntaxhighlight lang="bash" enclose="div">
curl --user user:pass http://registry.local.siu/arai-registry/rest/packages/1
</syntaxhighlight>

Si la salida es:
<syntaxhighlight lang="bash" enclose="div">
{
"error": 404,
"mensaje": "404 Not Found",
"descripcion": "El paquete solicitado no existe"
}
</syntaxhighlight>
es que la instalación funcionó correctamente.

Con registry instalado procedemos a instalar Usuarios

==Arai-Usuarios==

Nos posicionamos en /usr/local/siu y clonamos el proyecto
<syntaxhighlight lang="bash" enclose="div">
cd /usr/local/siu
git clone https://hub.siu.edu.ar/siu-arai/arai-usuarios.git usuarios
cd usuarios
</syntaxhighlight>

Para instalar seguimos la documentación del archivo '''doc/INSTALACION_MANUAL.md'''
<syntaxhighlight lang="bash" enclose="div">
composer install --no-dev
</syntaxhighlight>

Configuramos las variables de entorno que va a usar el instalador, los valores que puse son válidos para mi instalación, deberán modificarlos según las necesidades de cada universidad.
Para la configuración de LDAP uso un servidor que ya está funcionando y configurado. El detalle de como configurar el servidor LDAP no pertenece a esta documentación.
La variable TOBA_USUARIO debe contener el mismo usuarios administrado del LDAP.
<syntaxhighlight lang="bash" enclose="div">
cp templates/arai-usuarios.env.dist arai-usuarios.env
nano arai-usuarios.env
</syntaxhighlight>

'''arai-usuarios.env.dist'''
<syntaxhighlight lang="apache" enclose="div">
###### CONFIG DEL INSTALADR ######
#INSTALADOR_TIMEOUT="360"
ENTORNO_PRODUCCION="1"

###### VARIABLES GLOBALES DEL ARCHIVO ######
ARAI_USUARIOS_DIR=/usr/local/siu/usuarios

###### CONFIG DE TOBA ######
TOBA_URL_BASE="https://usuarios.local.siu"
#TOBA_URL_PORT="443"
TOBA_USUARIO="admin"
TOBA_PASSWORD="admin1234"
TOBA_INSTALACION_DIR="${ARAI_USUARIOS_DIR}/instalacion"
TOBA_PROYECTO_DIR="${ARAI_USUARIOS_DIR}/gestion"
TOBA_INSTALAR_USUARIOS=false
TOBA_INSTALAR_EDITOR=false
TOBA_INSTALAR_REFERENCIA=false
TOBA_ALIAS_PROYECTO="/gestion"
TOBA_ALIAS_NUCLEO="/toba_gestion"
#TOBA_ID_DESARROLLADOR=0
#TOBA_SESSION_NAME="ARAI_SESSID"

###### CONFIG DE BASE DE DATOS DE NEGOCIO ######
PROYECTO_DB_HOST="172.27.31.114"
PROYECTO_DB_PORT="7432"
PROYECTO_DB_DBNAME="siu_usuarios"
PROYECTO_DB_USERNAME="postgres"
PROYECTO_DB_PASSWORD="postgres"
PROYECTO_DB_SCHEMA="usuarios"
PROYECTO_DB_ENCODING="LATIN1"

###### CONFIG DE BASE DE DATOS DE TOBA. #####
######## DEFINIR SI SE QUIERE UTILIZAR UNA BASE DISTINTA A LA DE NEGOCIO
#TOBA_DB_HOST="localhost"
#TOBA_DB_PORT="5432"
#TOBA_DB_DBNAME="instalador"
#TOBA_DB_USERNAME="postgres"
#TOBA_DB_PASSWORD="postgres"
#TOBA_DB_SCHEMA="public"

##### CONFIG IDM #####
ARAI_USUARIOS_URL_IDP=https://usuarios.local.siu/idp
## Deberá setearse si el sistema corre detrás de un proxy reverso
#ARAI_USUARIOS_PROXY_URL_IDP=http://url.arai-usuarios:80/idp
ARAI_USUARIOS_URL_PORTAL=https://huarpe.local.siu/portal
ARAI_USUARIOS_URL_PERFIL=https://huarpe.local.siu/perfil
ARAI_USUARIOS_URL_INSTITUCION=http://siu.edu.ar

ARAI_USUARIOS_SIGLA_INSTITUCION=SIGLA
ARAI_USUARIOS_EMAIL_SOPORTE=mail.soporte@institucion.edu.ar

##### CONFIG SEGURIDAD ####
SEGURIDAD_ALGORITMO_PASS=crypt
SEGURIDAD_LARGO_PASS=8
SEGURIDAD_INFO_PASS='El password debe tener al menos 8 caracteres, entre letras mayúsculas, minúsculas, números y símbolos, no pudiendo repetir caracteres adyacentes'
SEGURIDAD_DURACION_DIAS_PASS=120
SEGURIDAD_RECAPTCHA_SITIO=6Fd_pQwTAAAAAOEqJz6KJmkjsrXcdXrAjWQYggZf
SEGURIDAD_RECAPTCHA_CLAVE=6Fd_pQwTAAAAAOEqJz6KJmkjsrXcdXrAjWQYggZf
SEGURIDAD_INTENTOS_RECAPTCHA=3

##### CONFIG IDP #####
ARAI_USUARIOS_IDP_KEY_FILE=/certs/idp/certificado_idp.pem
ARAI_USUARIOS_IDP_CERT_FILE=/certs/idp/certificado_idp.crt
#ARAI_USUARIOS_IDP_LOG_LEVEL='WARNING'
#ARAI_USUARIOS_IDP_LOG_HANDLER='errorlog'

##### CONFIG MAIL RECOVERY ####
MAIL_RECOVERY_SUBJECT='Recuperar contraseña SIU-Arai'
MAIL_RECOVERY_FROM='noreply@institucion.edu.ar'
MAIL_RECOVERY_REPLYTO='noreply@institucion.edu.ar'
MAIL_RECOVERY_FROMNAME='Institución'

##### CONFIG LDAP #####
ARAI_USUARIOS_LDAP_HOST=172.27.31.114
ARAI_USUARIOS_LDAP_PORT=7389
ARAI_USUARIOS_LDAP_TLS=0
ARAI_USUARIOS_LDAP_METHOD=user
ARAI_USUARIOS_LDAP_BINDUSER="cn=admin,dc=siu,dc=cin,dc=edu"
ARAI_USUARIOS_LDAP_BINDPASS=admin
ARAI_USUARIOS_LDAP_SEARCHBASE="dc=siu,dc=cin,dc=edu"

##### CONFIG ARAI-REGISTRY #####
ARAI_REGISTRY_URL=http://registry.local.siu/arai-registry
ARAI_REGISTRY_USER=user
ARAI_REGISTRY_PASS=pass

###### CONFIG ENVIO MAILS (SMTP) ######
SMTP_ENTRADA="arai-usuarios"
SMTP_HELO="mail.unx.edu.ar"
SMTP_HOST="smtp.googlemail.com"
SMTP_PORT=587
SMTP_FROM ="yo@midominio.com"
SMTP_SEGURIDAD ="ssl|tls"
SMTP_AUTH ="1"
SMTP_USUARIO ="usuario"
SMTP_CLAVE ="pass"
</syntaxhighlight>

Una vez editado, verificamos que la configuración sea correcta
<syntaxhighlight lang="bash" enclose="div">
./bin/instalador proyecto:verificar -n
</syntaxhighlight>

Si no sale ninguna alerta, procedemos a instalar.
<syntaxhighlight lang="bash" enclose="div">
./bin/instalador proyecto:instalar
</syntaxhighlight>
Una vez instalado, modificamos los permisos de los archivos de la instalación con el comando
<syntaxhighlight lang="bash" enclose="div">
sudo ./bin/instalador permisos:simple
</syntaxhighlight>
Cambiamos el modo mantenimiento
<syntaxhighlight lang="bash" enclose="div">
./bin/instalador instalacion:modo-mantenimiento --sin-mantenimiento -n
</syntaxhighlight>

Luego configuramos Apache.
Lo mismo que con registry, como tengo toda la plataforma instalada en un mismo servidor, debo usar el '''ServerName "usuarios.local.siu"'''
En lugar de hacer un vinculo con '''alias.conf''' como dice la documentación, use un include dentro del tag VirtualHost. Así me quedo el archivo '''/etc/apache/sites-enabled/usuarios.conf'''

<syntaxhighlight lang="apache" enclose="div">
<VirtualHost *:80>
ServerName usuarios.local.siu
Redirect permanent / https://usuarios.local.siu/
</VirtualHost>

<VirtualHost *:443>

ServerName usuarios.local.siu

SSLEngine on
SSLCertificateFile /certs/usuarios.local.siu.cert.pem
SSLCertificateKeyFile /certs/usuarios.local.siu.key.pem

SSLCACertificateFile /certs/ca-chain.cert.pem

SSLVerifyClient optional_no_ca
SSLVerifyDepth 2
SSLProtocol all -SSLv2 -SSLv3
SSLOptions +StdEnvVars +ExportCertData
BrowserMatch "MSIE [2-6]" \
nokeepalive ssl-unclean-shutdown \
downgrade-1.0 force-response-1.0
# MSIE 7 and newer should be able to use keepalive
BrowserMatch "MSIE [17-9]" ssl-unclean-shutdown

Include /usr/local/siu/usuarios/instalacion/toba.conf

Include /usr/local/siu/usuarios/instalacion/idp.conf

</VirtualHost>
</syntaxhighlight>

Luego hay que hacer que nuestra CA autofirmada sea válida en el SO y así permitir que Apache verifique los certificados de clientes:
<syntaxhighlight lang="apache" enclose="div">
sudo cp /certs/ca.cert.pem /usr/share/ca-certificates/ca_propia.crt
sudo vim /etc/ca-certificates.conf
# agregar ca_propia.crt al final del archivo
update-ca-certificates --fresh
</syntaxhighlight>

Reiniciamos Apache y todo debería funcionar, para verificar entramos en la URL definida para usuarios, en mi caso https://usuarios.local.siu/gestion

Con todo esto funcionando el siguiente paso es agregar Usuarios a Registry y sincronizarlos.
Según esta instalación para agregar Usuarios al entorno hacemos
<syntaxhighlight lang="bash" enclose="div">
./bin/arai-cli registry:add --maintainer-email jpiazza@siu.edu.ar --maintainer jpiazza http://registry.local.siu/arai-registry
</syntaxhighlight>
y para sincronizarlo
<syntaxhighlight lang="bash" enclose="div">
./bin/arai-cli registry:sync
</syntaxhighlight>

== Arai-Huarpe ==

Es similar a las instalaciones anteriores.
<syntaxhighlight lang="bash" enclose="div">
cd /usr/local/siu
git clone https://hub.siu.edu.ar/siu-arai/huarpe-core.git huarpe
cd huarpe
</syntaxhighlight>

Para instalar seguimos la documentación del archivo '''doc/INSTALACION_MANUAL.md'''
<syntaxhighlight lang="bash" enclose="div">
composer install --no-dev
</syntaxhighlight>

Configuramos las variables de entorno que va a usar el instalador, los valores que puse son válidos para mi instalación, deberán modificarlos según las necesidades de cada universidad.
<syntaxhighlight lang="bash" enclose="div">
cp templates/huarpe.env.dist huarpe.env
nano huarpe.env
</syntaxhighlight>

'''huarpe.env'''
<syntaxhighlight lang="apache" enclose="div">
###### CONFIG DEL INSTALADR ######
#INSTALADOR_TIMEOUT="360"
ENTORNO_PRODUCCION=1

###### CONFIG DE SIU-HUARPE ######
HUARPE_PATH=/usr/local/siu/huarpe
HUARPE_URL=https://huarpe.local.siu
HUARPE_URL_PORT=443
HUARPE_SESSION_NAME=huarpe
HUARPE_SESSION_HANDLER="native_file"
#HUARPE_MEMCACHED_HOST=127.0.0.1
#HUARPE_MEMCACHED_PORT=11211
HUARPE_CERT_FILE=/certs/huarpe-cli.cert.pem
HUARPE_KEY_FILE=/certs/huarpe-cli.key.pem
#HUARPE_TOKEN=unt0k3n-al3at0r1o-s39ur0?
#HUARPE_PROXY=127.0.0.1
HUARPE_LOG_HANDLER="error_log"
HUARPE_LOG_LEVEL="WARNING"

###### CONFIG BRANDING ######
#HUARPE_PATH_LOGO="/path/al/logo.png"
HUARPE_NOMBRE_INSTITUCION="Institución"

###### CONFIG DE SIU-ARAI: REGISTRY ######
ARAI_REGISTRY_URL=http://registry.local.siu/arai-registry
ARAI_REGISTRY_USER=user
ARAI_REGISTRY_PASS=pass
</syntaxhighlight>

Una vez editado, verificamos que la configuración sea correcta
<syntaxhighlight lang="bash" enclose="div">
./bin/instalador proyecto:verificar
</syntaxhighlight>
Si no sale ninguna alerta, procedemos a instalar.
<syntaxhighlight lang="bash" enclose="div">
sudo ./bin/instalador proyecto:instalar
</syntaxhighlight>
En Synfony es necesario dumpear los estilos y los JS con el siguiente comando.
<syntaxhighlight lang="bash" enclose="div">
./bin/console assetic:dump --no-debug --env=prod
</syntaxhighlight>
Una vez instalado, modificamos los permisos de los archivos de la instalación con el comando
<syntaxhighlight lang="bash" enclose="div">
sudo ./bin/instalador permisos:simple
</syntaxhighlight>

=== Configuración apache ===
Lo mismo que con Registry o Usuarios, como tengo toda la plataforma instalada en un mismo servidor, debo usar el '''ServerName huarpe.local.siu'''.
En lugar de hacer un vinculo con alias.conf como dice la documentación, usé un include dentro del tag VirtualHost. Así me quedo el archivo /etc/apache/sites-enabled/huarpe.conf

<syntaxhighlight lang="apache" enclose="div">
<VirtualHost *:80>
ServerName huarpe.local.siu
Redirect permanent / https://huarpe.local.siu:443/
</VirtualHost>

<VirtualHost *:443>

ServerName huarpe.local.siu
SSLEngine on
SSLCertificateFile /certs/huarpe.local.siu.cert.pem
SSLCertificateKeyFile /certs/huarpe.local.siu.key.pem

Include /usr/local/siu/huarpe/app/config/alias.conf

</VirtualHost>
</syntaxhighlight>

Reiniciamos apache, antes de verificar la instalación, debemos sincronizar con Registry.
<syntaxhighlight lang="bash" enclose="div">
./bin/arai-cli registry:add --maintainer-email jpiazza@siu.edu.ar --maintainer jpiazza http://registry.local.siu/arai-registry
</syntaxhighlight>
Luego sincronizar
<syntaxhighlight lang="bash" enclose="div">
./bin/arai-cli registry:sync
</syntaxhighlight>

Hay que limpiar la cache y actualizar los permisos
<syntaxhighlight lang="bash" enclose="div">
./bin/console cache:clear --env=prod
sudo ./bin/instalador permisos:simple
</syntaxhighlight>

En Usuarios resincronizar para que se actualice con la nueva instalación
<syntaxhighlight lang="bash" enclose="div">
cd /usr/local/siu/usuarios
./bin/arai-cli registry:sync
</syntaxhighlight>

Para verificar que la instalación se realizo con éxito de debe ingresar en https://huarpe.local.siu/

Si todo salio bien, tenemos instalada la plataforma ARAI lista para ser usada en nuestro servidor.

SIU-Arai/ejemploPasoAPaso

2017-11-02T14:54:15Z

Jpiazza: /* Instalación Arai-Registy */

[[Archivo:siu-arai_iso.png|derecha|link=SIU-Arai]]

= Ejemplo paso a paso =

Para este caso voy a usar una instalación de Debian Jessie

El objetivo es tener una instalación funcionando de la paltaforma SIU-Arai que luego sirva para integrar otros sistemas toba.

Lo primero que defino es en que URL va a vivir cada sistemas, en mi caso lo tengo funcionando dentro de una intranet y los DNS que quedaron así

{| class="wikitable zebra"
!colspan="2"|URLs
|-
|Araí-Registry
|http://registry.local.siu
|-
|Araí-Usuarios
|https://usuarios.local.siu
|-
|Araí-Huarpe
|https://huarpe.local.siu
|}

== Creación de certificados ==
Hay que tener en cuenta que voy a usar conexión segura, por lo que tanto voy a necesitar certificados.
Para crear los certificados uso el tutorial que se encuentra en http://documentacion.siu.edu.ar/wiki/SIU-Arai/certificados.
Ese artículo asume
* Docker instalado (https://docs.docker.com/engine/installation/linux/docker-ce/debian/#install-using-the-repository).
* Docker Compose instalado (https://github.com/docker/compose/releases).

<syntaxhighlight lang="bash" enclose="div">
git clone https://hub.siu.edu.ar/siu/instaladores.git dockerCerts
</syntaxhighlight>

Editamos el archivo docker-compose según nuestras necesidades.

<syntaxhighlight lang="bash" enclose="div">
cd dockerCerts/certs
nano docker-compose.yml
</syntaxhighlight>

En mi caso quedo así:

<syntaxhighlight lang="apache" enclose="div">
certificados:
image: siutoba/docker-certs
container_name: docker-certs
#env_file: docker.env
environment:
DOCKER_NAME: certs
CA_PWD: pass
CA_INT_PWD: pass
LISTA_SERVER: huarpe.local.siu usuarios.local.siu
LISTA_CLIENTES: usuarios-cli huarpe-cli
volumes:
- ./data/certificados:/CAs/intermediate
- ./data/root:/CAs/rootCA

</syntaxhighlight>

Guardamos y generamos el container.
<syntaxhighlight lang="bash" enclose="div">
docker-compose up
</syntaxhighlight>

Una vez generado el container copiamos los certificados creados en la carpeta que nos sea mas cómodo, en mi caso /certs
Sin cambiar de directorio hacemos:
<syntaxhighlight lang="bash" enclose="div">
sudo mkdir /certs
sudo find data -name "*.pem" -exec cp {} /certs \;
</syntaxhighlight>

Luego generamos los certificados para el IDP:
<syntaxhighlight lang="bash" enclose="div">
mkdir /certs/idp
cd /certs/idp
openssl req -newkey rsa:2048 -new -x509 -days 3652 -nodes -out certificado_idp.crt -keyout certificado_idp.pem
</syntaxhighlight>

Listo, con las URL definidas y los certificados creados se puede proceder a instalar la plataforma.

== Instalación Arai-Registy ==
Creamos la carpeta '''/usr/local/siu''' y no posicionamos ahí
Clonamos el proyecto
<syntaxhighlight lang="bash" enclose="div">
git clone https://hub.siu.edu.ar/siu-arai/arai-registry.git registry
</syntaxhighlight>
Utilizamos GitFlow, la última versión estable del proyecto es apuntada por el branch master y por cada versión que se saca se crea un tag.

Dentro del directorio del proyecto encontramos el archivo "doc/INSTALACION MANUAL.md", la idea es seguir las instrucciones que encontramos en este archivo.
<syntaxhighlight lang="bash" enclose="div">
cd registry
composer install --no-dev
</syntaxhighlight>

Configuramos las variables de entorno que va a usar el instalador, los valores que puse son válidos para mi instalación, deberán modificarlos según las necesidades de cada universidad.
<syntaxhighlight lang="bash" enclose="div">
cp templates/arai-registry.env.dist arai-registry.env
nano arai-registry.env
</syntaxhighlight>

'''arai-registry.env'''
<syntaxhighlight lang="apache" enclose="div">
# config de la aplicacion
ARAI_REGISTRY_ALIAS="/arai-registry"
ARAI_REGISTRY_USER="user"
ARAI_REGISTRY_PASS="pass"

# config de la base de datos
ARAI_REGISTRY_DB_HOST="172.27.31.114"
ARAI_REGISTRY_DB_PORT="7432"
ARAI_REGISTRY_DB_DBNAME="siu_registry"
ARAI_REGISTRY_DB_USERNAME="postgres"
ARAI_REGISTRY_DB_PASSWORD="postgres"
ARAI_REGISTRY_DB_SCHEMA="registry"
ARAI_REGISTRY_DB_ENCODING="UTF8"

###### CONFIG DE LOGS ######
ARAI_REGISTRY_LOG_HANDLER="errorlog"
ARAI_REGISTRY_LOG_LEVEL="WARNING"

# config del instalador
INSTALADOR_TIMEOUT="360"
</syntaxhighlight>

Una vez editado, verificamos que la configuración sea correcta
<syntaxhighlight lang="bash" enclose="div">
sudo ./bin/instalador proyecto:verificar
</syntaxhighlight>

Si no sale ninguna alerta, procedemos a instalar.
<syntaxhighlight lang="bash" enclose="div">
./bin/instalador proyecto:instalar
</syntaxhighlight>
Una vez instalado, modificamos los permisos de los archivos de la instalación con el comando
<syntaxhighlight lang="bash" enclose="div">
sudo ./bin/instalador permisos:simple
</syntaxhighlight>

Luego configuramos apache.
En mi caso, como tengo toda la plataforma instalada en un mismo servidor, debo usar el '''ServerName "registry.local.siu"'''
En lugar de hacer un vinculo con '''alias.conf''' como dice la documentación, use un include dentro del tag VirtualHost. Así me quedo el archivo '''/etc/apache/sites-enabled/registry.conf'''

<syntaxhighlight lang="apache" enclose="div">
<VirtualHost *:80>
ServerName registry.local.siu
Include /usr/local/siu/registry/config/alias.conf
</VirtualHost>
</syntaxhighlight>

Con todo esto, para verificar que todo funcione reiniciamos Apache y ejecutamos
<syntaxhighlight lang="bash" enclose="div">
curl --user user:pass http://registry.local.siu/arai-registry/rest/packages/1
</syntaxhighlight>

Si la salida es:
<syntaxhighlight lang="bash" enclose="div">
{
"error": 404,
"mensaje": "404 Not Found",
"descripcion": "El paquete solicitado no existe"
}
</syntaxhighlight>
es que la instalación funcionó correctamente.

Con registry instalado procedemos a instalar Usuarios

==Arai-Usuarios==

Nos posicionamos en /usr/local/siu y clonamos el proyecto
<syntaxhighlight lang="bash" enclose="div">
cd /usr/local/siu
git clone https://hub.siu.edu.ar/siu-arai/arai-usuarios.git usuarios
cd usuarios
</syntaxhighlight>

Para instalar seguimos la documentación del archivo '''doc/INSTALACION_MANUAL.md'''
<syntaxhighlight lang="bash" enclose="div">
composer install --no-dev
</syntaxhighlight>

Configuramos las variables de entorno que va a usar el instalador, los valores que puse son válidos para mi instalación, deberán modificarlos según las necesidades de cada universidad.
Para la configuración de LDAP uso un servidor que ya está funcionando y configurado. El detalle de como configurar el servidor LDAP no pertenece a esta documentación.
La variable TOBA_USUARIO debe contener el mismo usuarios administrado del LDAP.
<syntaxhighlight lang="bash" enclose="div">
cp templates/arai-usuarios.env.dist arai-usuarios.env
nano arai-usuarios.env
</syntaxhighlight>

'''arai-usuarios.env.dist'''
<syntaxhighlight lang="apache" enclose="div">
###### CONFIG DEL INSTALADR ######
#INSTALADOR_TIMEOUT="360"
ENTORNO_PRODUCCION="1"

###### VARIABLES GLOBALES DEL ARCHIVO ######
ARAI_USUARIOS_DIR=/usr/local/siu/usuarios

###### CONFIG DE TOBA ######
TOBA_URL_BASE="https://usuarios.local.siu"
#TOBA_URL_PORT="443"
TOBA_USUARIO="admin"
TOBA_PASSWORD="admin1234"
TOBA_INSTALACION_DIR="${ARAI_USUARIOS_DIR}/instalacion"
TOBA_PROYECTO_DIR="${ARAI_USUARIOS_DIR}/gestion"
TOBA_INSTALAR_USUARIOS=false
TOBA_INSTALAR_EDITOR=false
TOBA_INSTALAR_REFERENCIA=false
TOBA_ALIAS_PROYECTO="/gestion"
TOBA_ALIAS_NUCLEO="/toba_gestion"
#TOBA_ID_DESARROLLADOR=0
#TOBA_SESSION_NAME="ARAI_SESSID"

###### CONFIG DE BASE DE DATOS DE NEGOCIO ######
PROYECTO_DB_HOST="172.27.31.114"
PROYECTO_DB_PORT="7432"
PROYECTO_DB_DBNAME="siu_usuarios"
PROYECTO_DB_USERNAME="postgres"
PROYECTO_DB_PASSWORD="postgres"
PROYECTO_DB_SCHEMA="usuarios"
PROYECTO_DB_ENCODING="LATIN1"

###### CONFIG DE BASE DE DATOS DE TOBA. #####
######## DEFINIR SI SE QUIERE UTILIZAR UNA BASE DISTINTA A LA DE NEGOCIO
#TOBA_DB_HOST="localhost"
#TOBA_DB_PORT="5432"
#TOBA_DB_DBNAME="instalador"
#TOBA_DB_USERNAME="postgres"
#TOBA_DB_PASSWORD="postgres"
#TOBA_DB_SCHEMA="public"

##### CONFIG IDM #####
ARAI_USUARIOS_URL_IDP=https://usuarios.local.siu/idp
## Deberá setearse si el sistema corre detrás de un proxy reverso
#ARAI_USUARIOS_PROXY_URL_IDP=http://url.arai-usuarios:80/idp
ARAI_USUARIOS_URL_PORTAL=https://huarpe.local.siu/portal
ARAI_USUARIOS_URL_PERFIL=https://huarpe.local.siu/perfil
ARAI_USUARIOS_URL_INSTITUCION=http://siu.edu.ar

ARAI_USUARIOS_SIGLA_INSTITUCION=SIGLA
ARAI_USUARIOS_EMAIL_SOPORTE=mail.soporte@institucion.edu.ar

##### CONFIG SEGURIDAD ####
SEGURIDAD_ALGORITMO_PASS=crypt
SEGURIDAD_LARGO_PASS=8
SEGURIDAD_INFO_PASS='El password debe tener al menos 8 caracteres, entre letras mayúsculas, minúsculas, números y símbolos, no pudiendo repetir caracteres adyacentes'
SEGURIDAD_DURACION_DIAS_PASS=120
SEGURIDAD_RECAPTCHA_SITIO=6Fd_pQwTAAAAAOEqJz6KJmkjsrXcdXrAjWQYggZf
SEGURIDAD_RECAPTCHA_CLAVE=6Fd_pQwTAAAAAOEqJz6KJmkjsrXcdXrAjWQYggZf
SEGURIDAD_INTENTOS_RECAPTCHA=3

##### CONFIG IDP #####
ARAI_USUARIOS_IDP_KEY_FILE=/certs/idp/certificado_idp.pem
ARAI_USUARIOS_IDP_CERT_FILE=/certs/idp/certificado_idp.crt
#ARAI_USUARIOS_IDP_LOG_LEVEL='WARNING'
#ARAI_USUARIOS_IDP_LOG_HANDLER='errorlog'

##### CONFIG MAIL RECOVERY ####
MAIL_RECOVERY_SUBJECT='Recuperar contraseña SIU-Arai'
MAIL_RECOVERY_FROM='noreply@institucion.edu.ar'
MAIL_RECOVERY_REPLYTO='noreply@institucion.edu.ar'
MAIL_RECOVERY_FROMNAME='Institución'

##### CONFIG LDAP #####
ARAI_USUARIOS_LDAP_HOST=172.27.31.114
ARAI_USUARIOS_LDAP_PORT=7389
ARAI_USUARIOS_LDAP_TLS=0
ARAI_USUARIOS_LDAP_METHOD=user
ARAI_USUARIOS_LDAP_BINDUSER="cn=admin,dc=siu,dc=cin,dc=edu"
ARAI_USUARIOS_LDAP_BINDPASS=admin
ARAI_USUARIOS_LDAP_SEARCHBASE="dc=siu,dc=cin,dc=edu"

##### CONFIG ARAI-REGISTRY #####
ARAI_REGISTRY_URL=http://registry.local.siu/arai-registry
ARAI_REGISTRY_USER=user
ARAI_REGISTRY_PASS=pass

###### CONFIG ENVIO MAILS (SMTP) ######
SMTP_ENTRADA="arai-usuarios"
SMTP_HELO="mail.unx.edu.ar"
SMTP_HOST="smtp.googlemail.com"
SMTP_PORT=587
SMTP_FROM ="yo@midominio.com"
SMTP_SEGURIDAD ="ssl|tls"
SMTP_AUTH ="1"
SMTP_USUARIO ="usuario"
SMTP_CLAVE ="pass"
</syntaxhighlight>

Una vez editado, verificamos que la configuración sea correcta
<syntaxhighlight lang="bash" enclose="div">
./bin/instalador proyecto:verificar -n
</syntaxhighlight>

Si no sale ninguna alerta, procedemos a instalar.
<syntaxhighlight lang="bash" enclose="div">
./bin/instalador proyecto:instalar
</syntaxhighlight>
Una vez instalado, modificamos los permisos de los archivos de la instalación con el comando
<syntaxhighlight lang="bash" enclose="div">
sudo ./bin/instalador permisos:simple
</syntaxhighlight>
Cambiamos el modo mantenimiento
<syntaxhighlight lang="bash" enclose="div">
./bin/instalador instalacion:modo-mantenimiento --sin-mantenimiento -n
</syntaxhighlight>

Luego configuramos Apache.
Lo mismo que con registry, como tengo toda la plataforma instalada en un mismo servidor, debo usar el '''ServerName "usuarios.local.siu"'''
En lugar de hacer un vinculo con '''alias.conf''' como dice la documentación, use un include dentro del tag VirtualHost. Así me quedo el archivo '''/etc/apache/sites-enabled/usuarios.conf'''

<syntaxhighlight lang="apache" enclose="div">
<VirtualHost *:80>
ServerName usuarios.local.siu
Redirect permanent / https://usuarios.local.siu/
</VirtualHost>

<VirtualHost *:443>

ServerName usuarios.local.siu

SSLEngine on
SSLCertificateFile /certs/usuarios.local.siu.cert.pem
SSLCertificateKeyFile /certs/usuarios.local.siu.key.pem

SSLCACertificateFile /certs/ca-chain.cert.pem

SSLVerifyClient optional_no_ca
SSLVerifyDepth 2
SSLProtocol all -SSLv2 -SSLv3
SSLOptions +StdEnvVars +ExportCertData
BrowserMatch "MSIE [2-6]" \
nokeepalive ssl-unclean-shutdown \
downgrade-1.0 force-response-1.0
# MSIE 7 and newer should be able to use keepalive
BrowserMatch "MSIE [17-9]" ssl-unclean-shutdown

Include /usr/local/siu/usuarios/instalacion/toba.conf

Include /usr/local/siu/usuarios/instalacion/idp.conf

</VirtualHost>
</syntaxhighlight>

Luego hay que hacer que nuestra CA autofirmada sea válida en el SO y así permitir que Apache verifique los certificados de clientes:
<syntaxhighlight lang="apache" enclose="div">
sudo cp /certs/ca.cert.pem /usr/share/ca-certificates/ca_propia.crt
sudo vim /etc/ca-certificates.conf
# agregar ca_propia.crt al final del archivo
update-ca-certificates --fresh
</syntaxhighlight>

Reiniciamos Apache y todo debería funcionar, para verificar entramos en la URL definida para usuarios, en mi caso https://usuarios.local.siu/gestion

Con todo esto funcionando el siguiente paso es agregar Usuarios a Registry y sincronizarlos.
Según esta instalación para agregar Usuarios al entorno hacemos
<syntaxhighlight lang="bash" enclose="div">
./bin/arai-cli registry:add --maintainer-email jpiazza@siu.edu.ar --maintainer jpiazza http://registry.local.siu/arai-registry
</syntaxhighlight>
y para sincronizarlo
<syntaxhighlight lang="bash" enclose="div">
./bin/arai-cli registry:sync
</syntaxhighlight>

== Arai-Huarpe ==

Es similar a las instalaciones anteriores.
<syntaxhighlight lang="bash" enclose="div">
cd /usr/local/siu
git clone https://hub.siu.edu.ar/siu-arai/huarpe-core.git huarpe
cd huarpe
</syntaxhighlight>

Para instalar seguimos la documentación del archivo '''doc/INSTALACION_MANUAL.md'''
<syntaxhighlight lang="bash" enclose="div">
composer install --no-dev
</syntaxhighlight>

Configuramos las variables de entorno que va a usar el instalador, los valores que puse son válidos para mi instalación, deberán modificarlos según las necesidades de cada universidad.
<syntaxhighlight lang="bash" enclose="div">
cp templates/huarpe.env.dist huarpe.env
nano huarpe.env
</syntaxhighlight>

'''huarpe.env'''
<syntaxhighlight lang="apache" enclose="div">
###### CONFIG DEL INSTALADR ######
#INSTALADOR_TIMEOUT="360"
ENTORNO_PRODUCCION=1

###### CONFIG DE SIU-HUARPE ######
HUARPE_PATH=/usr/local/siu/huarpe
HUARPE_URL=https://huarpe.local.siu
HUARPE_URL_PORT=443
HUARPE_SESSION_NAME=huarpe
HUARPE_SESSION_HANDLER="native_file"
#HUARPE_MEMCACHED_HOST=127.0.0.1
#HUARPE_MEMCACHED_PORT=11211
HUARPE_CERT_FILE=/certs/huarpe-cli.cert.pem
HUARPE_KEY_FILE=/certs/huarpe-cli.key.pem
#HUARPE_TOKEN=unt0k3n-al3at0r1o-s39ur0?
#HUARPE_PROXY=127.0.0.1
HUARPE_LOG_HANDLER="error_log"
HUARPE_LOG_LEVEL="WARNING"

###### CONFIG BRANDING ######
#HUARPE_PATH_LOGO="/path/al/logo.png"
HUARPE_NOMBRE_INSTITUCION="Institución"

###### CONFIG DE SIU-ARAI: REGISTRY ######
ARAI_REGISTRY_URL=http://registry.local.siu/arai-registry
ARAI_REGISTRY_USER=user
ARAI_REGISTRY_PASS=pass
</syntaxhighlight>

Una vez editado, verificamos que la configuración sea correcta
<syntaxhighlight lang="bash" enclose="div">
./bin/instalador proyecto:verificar
</syntaxhighlight>
Si no sale ninguna alerta, procedemos a instalar.
<syntaxhighlight lang="bash" enclose="div">
sudo ./bin/instalador proyecto:instalar
</syntaxhighlight>
En Synfony es necesario dumpear los estilos y los JS con el siguiente comando.
<syntaxhighlight lang="bash" enclose="div">
./bin/console assetic:dump --no-debug --env=prod
</syntaxhighlight>
Una vez instalado, modificamos los permisos de los archivos de la instalación con el comando
<syntaxhighlight lang="bash" enclose="div">
sudo ./bin/instalador permisos:simple
</syntaxhighlight>

=== Configuración apache ===
Lo mismo que con Registry o Usuarios, como tengo toda la plataforma instalada en un mismo servidor, debo usar el '''ServerName huarpe.local.siu'''.
En lugar de hacer un vinculo con alias.conf como dice la documentación, usé un include dentro del tag VirtualHost. Así me quedo el archivo /etc/apache/sites-enabled/huarpe.conf

<syntaxhighlight lang="apache" enclose="div">
<VirtualHost *:80>
ServerName huarpe.local.siu
Redirect permanent / https://huarpe.local.siu:443/
</VirtualHost>

<VirtualHost *:443>

ServerName huarpe.local.siu
SSLEngine on
SSLCertificateFile /certs/huarpe.local.siu.cert.pem
SSLCertificateKeyFile /certs/huarpe.local.siu.key.pem

Include /usr/local/siu/huarpe/app/config/alias.conf

</VirtualHost>
</syntaxhighlight>

Reiniciamos apache, antes de verificar la instalación, debemos sincronizar con Registry.
<syntaxhighlight lang="bash" enclose="div">
./bin/arai-cli registry:add --maintainer-email jpiazza@siu.edu.ar --maintainer jpiazza http://registry.local.siu/arai-registry
</syntaxhighlight>
Luego sincronizar
<syntaxhighlight lang="bash" enclose="div">
./bin/arai-cli registry:sync
</syntaxhighlight>

Hay que limpiar la cache y actualizar los permisos
<syntaxhighlight lang="bash" enclose="div">
./bin/console cache:clear --env=prod
sudo ./bin/instalador permisos:simple
</syntaxhighlight>

En Usuarios resincronizar para que se actualice con la nueva instalación
<syntaxhighlight lang="bash" enclose="div">
cd /usr/local/siu/usuarios
./bin/arai-cli registry:sync
</syntaxhighlight>

Para verificar que la instalación se realizo con éxito de debe ingresar en https://huarpe.local.siu/

Si todo salio bien, tenemos instalada la plataforma ARAI lista para ser usada en nuestro servidor.

SIU-Arai/ejemploPasoAPaso

2017-11-02T14:03:48Z

Jpiazza: /* Arai-Huarpe */

[[Archivo:siu-arai_iso.png|derecha|link=SIU-Arai]]

= Ejemplo paso a paso =

Para este caso voy a usar una instalación de Debian Jessie

El objetivo es tener una instalación funcionando de la paltaforma SIU-Arai que luego sirva para integrar otros sistemas toba.

Lo primero que defino es en que URL va a vivir cada sistemas, en mi caso lo tengo funcionando dentro de una intranet y los DNS que quedaron así

{| class="wikitable zebra"
!colspan="2"|URLs
|-
|Araí-Registry
|http://registry.local.siu
|-
|Araí-Usuarios
|https://usuarios.local.siu
|-
|Araí-Huarpe
|https://huarpe.local.siu
|}

== Creación de certificados ==
Hay que tener en cuenta que voy a usar conexión segura, por lo que tanto voy a necesitar certificados.
Para crear los certificados uso el tutorial que se encuentra en http://documentacion.siu.edu.ar/wiki/SIU-Arai/certificados.
Ese artículo asume
* Docker instalado (https://docs.docker.com/engine/installation/linux/docker-ce/debian/#install-using-the-repository).
* Docker Compose instalado (https://github.com/docker/compose/releases).

<syntaxhighlight lang="bash" enclose="div">
git clone https://hub.siu.edu.ar/siu/instaladores.git dockerCerts
</syntaxhighlight>

Editamos el archivo docker-compose según nuestras necesidades.

<syntaxhighlight lang="bash" enclose="div">
cd dockerCerts/certs
nano docker-compose.yml
</syntaxhighlight>

En mi caso quedo así:

<syntaxhighlight lang="apache" enclose="div">
certificados:
image: siutoba/docker-certs
container_name: docker-certs
#env_file: docker.env
environment:
DOCKER_NAME: certs
CA_PWD: pass
CA_INT_PWD: pass
LISTA_SERVER: huarpe.local.siu usuarios.local.siu
LISTA_CLIENTES: usuarios-cli huarpe-cli
volumes:
- ./data/certificados:/CAs/intermediate
- ./data/root:/CAs/rootCA

</syntaxhighlight>

Guardamos y generamos el container.
<syntaxhighlight lang="bash" enclose="div">
docker-compose up
</syntaxhighlight>

Una vez generado el container copiamos los certificados creados en la carpeta que nos sea mas cómodo, en mi caso /certs
Sin cambiar de directorio hacemos:
<syntaxhighlight lang="bash" enclose="div">
sudo mkdir /certs
sudo find data -name "*.pem" -exec cp {} /certs \;
</syntaxhighlight>

Luego generamos los certificados para el IDP:
<syntaxhighlight lang="bash" enclose="div">
mkdir /certs/idp
cd /certs/idp
openssl req -newkey rsa:2048 -new -x509 -days 3652 -nodes -out certificado_idp.crt -keyout certificado_idp.pem
</syntaxhighlight>

Listo, con las URL definidas y los certificados creados se puede proceder a instalar la plataforma.

== Instalación Arai-Registy ==
Creamos la carpeta '''/usr/local/siu''' y no posicionamos ahí
Clonamos el proyecto
<syntaxhighlight lang="bash" enclose="div">
git clone https://hub.siu.edu.ar/siu-arai/arai-registry.git registry
</syntaxhighlight>
Utilizamos GitFlow, la última versión estable del proyecto es apuntada por el branch master y por cada versión que se saca se crea un tag.

Dentro del directorio del proyecto encontramos el archivo "doc/INSTALACION MANUAL.md", la idea es seguir las instrucciones que encontramos en este archivo.
<syntaxhighlight lang="bash" enclose="div">
cd registry
composer install --no-dev
</syntaxhighlight>

Configuramos las variables de entorno que va a usar el instalador, los valores que puse son válidos para mi instalación, deberán modificarlos según las necesidades de cada universidad.
<syntaxhighlight lang="bash" enclose="div">
cp templates/arai-registry.env.dist arai-registry.env
nano arai-registry.env
</syntaxhighlight>

'''arai-registry.env'''
<syntaxhighlight lang="apache" enclose="div">
# config de la aplicacion
ARAI_REGISTRY_ALIAS="/arai-registry"
ARAI_REGISTRY_USER="user"
ARAI_REGISTRY_PASS="pass"

# config de la base de datos
ARAI_REGISTRY_DB_HOST="172.27.31.114"
ARAI_REGISTRY_DB_PORT="7432"
ARAI_REGISTRY_DB_DBNAME="siu_registry"
ARAI_REGISTRY_DB_USERNAME="postgres"
ARAI_REGISTRY_DB_PASSWORD="postgres"
ARAI_REGISTRY_DB_SCHEMA="registry"
ARAI_REGISTRY_DB_ENCODING="UTF8"

###### CONFIG DE LOGS ######
ARAI_REGISTRY_LOG_HANDLER="errorlog"
ARAI_REGISTRY_LOG_LEVEL="WARNING"

# config del instalador
INSTALADOR_TIMEOUT="360"
</syntaxhighlight>

Una vez editado, verificamos que la configuración sea correcta
<syntaxhighlight lang="bash" enclose="div">
sudo ./bin/instalador proyecto:verificar
</syntaxhighlight>

Si no sale ninguna alerta, procedemos a instalar.
<syntaxhighlight lang="bash" enclose="div">
./bin/instalador proyecto:instalar
</syntaxhighlight>
Una vez instalado, modificamos los permisos de los archivos de la instalación con el comando
<syntaxhighlight lang="bash" enclose="div">
sudo ./bin/instalador permisos:simple
</syntaxhighlight>

Luego configuramos apache.
En mi caso, como tengo toda la plataforma instalada en un mismo servidor, debo usar el '''ServerName "registry.local.siu"'''
En lugar de hacer un vinculo con '''alias.conf''' como dice la documentación, use un include dentro del tag VirtualHost. Así me quedo el archivo '''/etc/apache/sites-enabled/registry.conf'''

<syntaxhighlight lang="apache" enclose="div">
<VirtualHost *:80>
ServerName registry.local.siu
Include /usr/local/siu/registry/config/alias.conf
</VirtualHost>
</syntaxhighlight>

Con todo esto, para verificar que todo funcione reiniciamos Apache y ejecutamos
<syntaxhighlight lang="bash" enclose="div">
curl --user registry:registry http://registry.local.siu/arai-registry/rest/packages/1
</syntaxhighlight>

Si la salida es:
<syntaxhighlight lang="bash" enclose="div">
{
"error": 404,
"mensaje": "404 Not Found",
"descripcion": "El paquete solicitado no existe"
}
</syntaxhighlight>
es que la instalación funcionó correctamente.

Con registry instalado procedemos a instalar Usuarios

==Arai-Usuarios==

Nos posicionamos en /usr/local/siu y clonamos el proyecto
<syntaxhighlight lang="bash" enclose="div">
cd /usr/local/siu
git clone https://hub.siu.edu.ar/siu-arai/arai-usuarios.git usuarios
cd usuarios
</syntaxhighlight>

Para instalar seguimos la documentación del archivo '''doc/INSTALACION_MANUAL.md'''
<syntaxhighlight lang="bash" enclose="div">
composer install --no-dev
</syntaxhighlight>

Configuramos las variables de entorno que va a usar el instalador, los valores que puse son válidos para mi instalación, deberán modificarlos según las necesidades de cada universidad.
Para la configuración de LDAP uso un servidor que ya está funcionando y configurado. El detalle de como configurar el servidor LDAP no pertenece a esta documentación.
La variable TOBA_USUARIO debe contener el mismo usuarios administrado del LDAP.
<syntaxhighlight lang="bash" enclose="div">
cp templates/arai-usuarios.env.dist arai-usuarios.env
nano arai-usuarios.env
</syntaxhighlight>

'''arai-usuarios.env.dist'''
<syntaxhighlight lang="apache" enclose="div">
###### CONFIG DEL INSTALADR ######
#INSTALADOR_TIMEOUT="360"
ENTORNO_PRODUCCION="1"

###### VARIABLES GLOBALES DEL ARCHIVO ######
ARAI_USUARIOS_DIR=/usr/local/siu/usuarios

###### CONFIG DE TOBA ######
TOBA_URL_BASE="https://usuarios.local.siu"
#TOBA_URL_PORT="443"
TOBA_USUARIO="admin"
TOBA_PASSWORD="admin1234"
TOBA_INSTALACION_DIR="${ARAI_USUARIOS_DIR}/instalacion"
TOBA_PROYECTO_DIR="${ARAI_USUARIOS_DIR}/gestion"
TOBA_INSTALAR_USUARIOS=false
TOBA_INSTALAR_EDITOR=false
TOBA_INSTALAR_REFERENCIA=false
TOBA_ALIAS_PROYECTO="/gestion"
TOBA_ALIAS_NUCLEO="/toba_gestion"
#TOBA_ID_DESARROLLADOR=0
#TOBA_SESSION_NAME="ARAI_SESSID"

###### CONFIG DE BASE DE DATOS DE NEGOCIO ######
PROYECTO_DB_HOST="172.27.31.114"
PROYECTO_DB_PORT="7432"
PROYECTO_DB_DBNAME="siu_usuarios"
PROYECTO_DB_USERNAME="postgres"
PROYECTO_DB_PASSWORD="postgres"
PROYECTO_DB_SCHEMA="usuarios"
PROYECTO_DB_ENCODING="LATIN1"

###### CONFIG DE BASE DE DATOS DE TOBA. #####
######## DEFINIR SI SE QUIERE UTILIZAR UNA BASE DISTINTA A LA DE NEGOCIO
#TOBA_DB_HOST="localhost"
#TOBA_DB_PORT="5432"
#TOBA_DB_DBNAME="instalador"
#TOBA_DB_USERNAME="postgres"
#TOBA_DB_PASSWORD="postgres"
#TOBA_DB_SCHEMA="public"

##### CONFIG IDM #####
ARAI_USUARIOS_URL_IDP=https://usuarios.local.siu/idp
## Deberá setearse si el sistema corre detrás de un proxy reverso
#ARAI_USUARIOS_PROXY_URL_IDP=http://url.arai-usuarios:80/idp
ARAI_USUARIOS_URL_PORTAL=https://huarpe.local.siu/portal
ARAI_USUARIOS_URL_PERFIL=https://huarpe.local.siu/perfil
ARAI_USUARIOS_URL_INSTITUCION=http://siu.edu.ar

ARAI_USUARIOS_SIGLA_INSTITUCION=SIGLA
ARAI_USUARIOS_EMAIL_SOPORTE=mail.soporte@institucion.edu.ar

##### CONFIG SEGURIDAD ####
SEGURIDAD_ALGORITMO_PASS=crypt
SEGURIDAD_LARGO_PASS=8
SEGURIDAD_INFO_PASS='El password debe tener al menos 8 caracteres, entre letras mayúsculas, minúsculas, números y símbolos, no pudiendo repetir caracteres adyacentes'
SEGURIDAD_DURACION_DIAS_PASS=120
SEGURIDAD_RECAPTCHA_SITIO=6Fd_pQwTAAAAAOEqJz6KJmkjsrXcdXrAjWQYggZf
SEGURIDAD_RECAPTCHA_CLAVE=6Fd_pQwTAAAAAOEqJz6KJmkjsrXcdXrAjWQYggZf
SEGURIDAD_INTENTOS_RECAPTCHA=3

##### CONFIG IDP #####
ARAI_USUARIOS_IDP_KEY_FILE=/certs/idp/certificado_idp.pem
ARAI_USUARIOS_IDP_CERT_FILE=/certs/idp/certificado_idp.crt
#ARAI_USUARIOS_IDP_LOG_LEVEL='WARNING'
#ARAI_USUARIOS_IDP_LOG_HANDLER='errorlog'

##### CONFIG MAIL RECOVERY ####
MAIL_RECOVERY_SUBJECT='Recuperar contraseña SIU-Arai'
MAIL_RECOVERY_FROM='noreply@institucion.edu.ar'
MAIL_RECOVERY_REPLYTO='noreply@institucion.edu.ar'
MAIL_RECOVERY_FROMNAME='Institución'

##### CONFIG LDAP #####
ARAI_USUARIOS_LDAP_HOST=172.27.31.114
ARAI_USUARIOS_LDAP_PORT=7389
ARAI_USUARIOS_LDAP_TLS=0
ARAI_USUARIOS_LDAP_METHOD=user
ARAI_USUARIOS_LDAP_BINDUSER="cn=admin,dc=siu,dc=cin,dc=edu"
ARAI_USUARIOS_LDAP_BINDPASS=admin
ARAI_USUARIOS_LDAP_SEARCHBASE="dc=siu,dc=cin,dc=edu"

##### CONFIG ARAI-REGISTRY #####
ARAI_REGISTRY_URL=http://registry.local.siu/arai-registry
ARAI_REGISTRY_USER=user
ARAI_REGISTRY_PASS=pass

###### CONFIG ENVIO MAILS (SMTP) ######
SMTP_ENTRADA="arai-usuarios"
SMTP_HELO="mail.unx.edu.ar"
SMTP_HOST="smtp.googlemail.com"
SMTP_PORT=587
SMTP_FROM ="yo@midominio.com"
SMTP_SEGURIDAD ="ssl|tls"
SMTP_AUTH ="1"
SMTP_USUARIO ="usuario"
SMTP_CLAVE ="pass"
</syntaxhighlight>

Una vez editado, verificamos que la configuración sea correcta
<syntaxhighlight lang="bash" enclose="div">
./bin/instalador proyecto:verificar -n
</syntaxhighlight>

Si no sale ninguna alerta, procedemos a instalar.
<syntaxhighlight lang="bash" enclose="div">
./bin/instalador proyecto:instalar
</syntaxhighlight>
Una vez instalado, modificamos los permisos de los archivos de la instalación con el comando
<syntaxhighlight lang="bash" enclose="div">
sudo ./bin/instalador permisos:simple
</syntaxhighlight>
Cambiamos el modo mantenimiento
<syntaxhighlight lang="bash" enclose="div">
./bin/instalador instalacion:modo-mantenimiento --sin-mantenimiento -n
</syntaxhighlight>

Luego configuramos Apache.
Lo mismo que con registry, como tengo toda la plataforma instalada en un mismo servidor, debo usar el '''ServerName "usuarios.local.siu"'''
En lugar de hacer un vinculo con '''alias.conf''' como dice la documentación, use un include dentro del tag VirtualHost. Así me quedo el archivo '''/etc/apache/sites-enabled/usuarios.conf'''

<syntaxhighlight lang="apache" enclose="div">
<VirtualHost *:80>
ServerName usuarios.local.siu
Redirect permanent / https://usuarios.local.siu/
</VirtualHost>

<VirtualHost *:443>

ServerName usuarios.local.siu

SSLEngine on
SSLCertificateFile /certs/usuarios.local.siu.cert.pem
SSLCertificateKeyFile /certs/usuarios.local.siu.key.pem

SSLCACertificateFile /certs/ca-chain.cert.pem

SSLVerifyClient optional_no_ca
SSLVerifyDepth 2
SSLProtocol all -SSLv2 -SSLv3
SSLOptions +StdEnvVars +ExportCertData
BrowserMatch "MSIE [2-6]" \
nokeepalive ssl-unclean-shutdown \
downgrade-1.0 force-response-1.0
# MSIE 7 and newer should be able to use keepalive
BrowserMatch "MSIE [17-9]" ssl-unclean-shutdown

Include /usr/local/siu/usuarios/instalacion/toba.conf

Include /usr/local/siu/usuarios/instalacion/idp.conf

</VirtualHost>
</syntaxhighlight>

Luego hay que hacer que nuestra CA autofirmada sea válida en el SO y así permitir que Apache verifique los certificados de clientes:
<syntaxhighlight lang="apache" enclose="div">
sudo cp /certs/ca.cert.pem /usr/share/ca-certificates/ca_propia.crt
sudo vim /etc/ca-certificates.conf
# agregar ca_propia.crt al final del archivo
update-ca-certificates --fresh
</syntaxhighlight>

Reiniciamos Apache y todo debería funcionar, para verificar entramos en la URL definida para usuarios, en mi caso https://usuarios.local.siu/gestion

Con todo esto funcionando el siguiente paso es agregar Usuarios a Registry y sincronizarlos.
Según esta instalación para agregar Usuarios al entorno hacemos
<syntaxhighlight lang="bash" enclose="div">
./bin/arai-cli registry:add --maintainer-email jpiazza@siu.edu.ar --maintainer jpiazza http://registry.local.siu/arai-registry
</syntaxhighlight>
y para sincronizarlo
<syntaxhighlight lang="bash" enclose="div">
./bin/arai-cli registry:sync
</syntaxhighlight>

== Arai-Huarpe ==

Es similar a las instalaciones anteriores.
<syntaxhighlight lang="bash" enclose="div">
cd /usr/local/siu
git clone https://hub.siu.edu.ar/siu-arai/huarpe-core.git huarpe
cd huarpe
</syntaxhighlight>

Para instalar seguimos la documentación del archivo '''doc/INSTALACION_MANUAL.md'''
<syntaxhighlight lang="bash" enclose="div">
composer install --no-dev
</syntaxhighlight>

Configuramos las variables de entorno que va a usar el instalador, los valores que puse son válidos para mi instalación, deberán modificarlos según las necesidades de cada universidad.
<syntaxhighlight lang="bash" enclose="div">
cp templates/huarpe.env.dist huarpe.env
nano huarpe.env
</syntaxhighlight>

'''huarpe.env'''
<syntaxhighlight lang="apache" enclose="div">
###### CONFIG DEL INSTALADR ######
#INSTALADOR_TIMEOUT="360"
ENTORNO_PRODUCCION=1

###### CONFIG DE SIU-HUARPE ######
HUARPE_PATH=/usr/local/siu/huarpe
HUARPE_URL=https://huarpe.local.siu
HUARPE_URL_PORT=443
HUARPE_SESSION_NAME=huarpe
HUARPE_SESSION_HANDLER="native_file"
#HUARPE_MEMCACHED_HOST=127.0.0.1
#HUARPE_MEMCACHED_PORT=11211
HUARPE_CERT_FILE=/certs/huarpe-cli.cert.pem
HUARPE_KEY_FILE=/certs/huarpe-cli.key.pem
#HUARPE_TOKEN=unt0k3n-al3at0r1o-s39ur0?
#HUARPE_PROXY=127.0.0.1
HUARPE_LOG_HANDLER="error_log"
HUARPE_LOG_LEVEL="WARNING"

###### CONFIG BRANDING ######
#HUARPE_PATH_LOGO="/path/al/logo.png"
HUARPE_NOMBRE_INSTITUCION="Institución"

###### CONFIG DE SIU-ARAI: REGISTRY ######
ARAI_REGISTRY_URL=http://registry.local.siu/arai-registry
ARAI_REGISTRY_USER=user
ARAI_REGISTRY_PASS=pass
</syntaxhighlight>

Una vez editado, verificamos que la configuración sea correcta
<syntaxhighlight lang="bash" enclose="div">
./bin/instalador proyecto:verificar
</syntaxhighlight>
Si no sale ninguna alerta, procedemos a instalar.
<syntaxhighlight lang="bash" enclose="div">
sudo ./bin/instalador proyecto:instalar
</syntaxhighlight>
En Synfony es necesario dumpear los estilos y los JS con el siguiente comando.
<syntaxhighlight lang="bash" enclose="div">
./bin/console assetic:dump --no-debug --env=prod
</syntaxhighlight>
Una vez instalado, modificamos los permisos de los archivos de la instalación con el comando
<syntaxhighlight lang="bash" enclose="div">
sudo ./bin/instalador permisos:simple
</syntaxhighlight>

=== Configuración apache ===
Lo mismo que con Registry o Usuarios, como tengo toda la plataforma instalada en un mismo servidor, debo usar el '''ServerName huarpe.local.siu'''.
En lugar de hacer un vinculo con alias.conf como dice la documentación, usé un include dentro del tag VirtualHost. Así me quedo el archivo /etc/apache/sites-enabled/huarpe.conf

<syntaxhighlight lang="apache" enclose="div">
<VirtualHost *:80>
ServerName huarpe.local.siu
Redirect permanent / https://huarpe.local.siu:443/
</VirtualHost>

<VirtualHost *:443>

ServerName huarpe.local.siu
SSLEngine on
SSLCertificateFile /certs/huarpe.local.siu.cert.pem
SSLCertificateKeyFile /certs/huarpe.local.siu.key.pem

Include /usr/local/siu/huarpe/app/config/alias.conf

</VirtualHost>
</syntaxhighlight>

Reiniciamos apache, antes de verificar la instalación, debemos sincronizar con Registry.
<syntaxhighlight lang="bash" enclose="div">
./bin/arai-cli registry:add --maintainer-email jpiazza@siu.edu.ar --maintainer jpiazza http://registry.local.siu/arai-registry
</syntaxhighlight>
Luego sincronizar
<syntaxhighlight lang="bash" enclose="div">
./bin/arai-cli registry:sync
</syntaxhighlight>

Hay que limpiar la cache y actualizar los permisos
<syntaxhighlight lang="bash" enclose="div">
./bin/console cache:clear --env=prod
sudo ./bin/instalador permisos:simple
</syntaxhighlight>

En Usuarios resincronizar para que se actualice con la nueva instalación
<syntaxhighlight lang="bash" enclose="div">
cd /usr/local/siu/usuarios
./bin/arai-cli registry:sync
</syntaxhighlight>

Para verificar que la instalación se realizo con éxito de debe ingresar en https://huarpe.local.siu/

Si todo salio bien, tenemos instalada la plataforma ARAI lista para ser usada en nuestro servidor.

SIU-Arai

2017-09-21T13:30:35Z

Jpiazza: /* Módulos */

[[Archivo:siu-arai_iso.png|derecha|link=SIU-Arai]]
= SIU-Arai =
SIU-Araí es la plataforma integradora de servicios del SIU. Cada uno de los sistemas SIU son módulos dentro de la plataforma.

Existen dos módulos que son vitales para el funcionamiento de la plataforma.

* Arai-Registry: Repositorio central de servicios y aplicaciones
* Arai-Usuarios: IDP e IDM para toda la plataforma

== Forma de trabajo ==
Toda la distribución de los proyectos se hace a través de gitlab: [https://hub.siu.edu.ar https://hub.siu.edu.ar]. 
Cada uno de los módulos tiene una carpeta '''doc''' donde se incluyen instrucciones de instalación.

== Como instalar ==
Una vez completada la pre-instalación ya se puede seguir con la instalación de cada uno de los módulos.
# [http://documentacion.siu.edu.ar/wiki/SIU-Arai/preRequisitosArai Antes de instalar]
# Módulos
## [[SIU-Arai/registry|Arai-Registry]]
## [[SIU-Arai/usuarios|Arai-Usuarios]]
## [[SIU-Arai/huarpe|Huarpe]]: Módulo de autogestión de recursos y servicios. La cara visible de la plataforma para los usuarios..
# [http://documentacion.siu.edu.ar/wiki/SIU-Arai/ejemploPasoAPaso Ejemplo completo]

== Módulos ==
* [[SIU-Arai/Modulos/Pilaga|Pilaga]]
* [[SIU-Arai/Modulos/Diaguita|Diaguita]]
* [[SIU-Arai/Modulos/Mapuche|Mapuche]]
* [[SIU-Arai/catalogos-cliente|Arai-Catalogos (cliente)]]
* [[SIU-Arai/proveedores|Arai-Proveedores ]]

SIU-Arai/Modulos/Mapuche

2017-09-21T13:28:42Z

Jpiazza: /* Para la versión 3.2.x */

= 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 documentación referente.

= Para la versión 3.3.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
Con los certificados en la mano podemos configurar el sistema como cliente

== Instalación ==

Para esta versión de Mapuche es necesario ejecutar el comando

<syntaxhighlight lang="bash" enclose="div">
composer install
</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">

[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>

Luego hay que agregar el sertificado al sistema operativo, aumimos que se encuentra en /certs/ca.cert.pem

<syntaxhighlight lang="bash" enclose="div">
cp /certs/ca.cert.pem /usr/share/ca_certificates/ca_propia.crt
</syntaxhighlight>

Luego editamos el archivo de configuración

<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">
.
.
.
mozilla/thawte_Primary_Root_CA_-_G3.crt
spi-inc.org/spi-cacert-2008.crt
ca_propia.crt

</syntaxhighlight>

Y actualizamos con
<syntaxhighlight lang="bash" enclose="div">
update-ca-certificates --fresh
</syntaxhighlight>

Por ultimo reiniciamos apache ( restart )
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.

<syntaxhighlight lang="bash" enclose="div">
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_PASS=pass
</syntaxhighlight>

== Sincronizando ==

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

Primero agregamos Mapuche al entorno Arai con registry:add
<syntaxhighlight lang="bash" enclose="div">
cd /path_Instalacion
./bin/arai-cli registry:add --maintainer-email mail@domain.edu --maintainer usuario http://Registry/arai-registry
</syntaxhighlight>

Luego del mensaje de éxito hay que proceder a sincronizar la aplicación.
<syntaxhighlight lang="bash" enclose="div">
./bin/arai-cli registry:sync
</syntaxhighlight>

Por último hay que sincronizar todas aquellas aplicaciones a las que Mapuche consulte WS, en este caso Arai-Uaurios.
<syntaxhighlight lang="bash" enclose="div">
./bin/arai-cli registry:sync
</syntaxhighlight>

== 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.
# Ingresar a Menu->Usuarios
# Filtrar y seleccionar un usuarios
# En la solapa Cuentas Seleccionar "Mapuche" desde el combo "Aplicación"
# En el campo "Cuenta" escribir el usuario que corresponde en Mapuche
# Guardar

SIU-Arai/Modulos/Mapuche

2017-09-21T13:24:42Z

Jpiazza: /* SIU-Mapuche */

= 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 documentación referente.

= Para la versión 3.2.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
Con los certificados en la mano podemos configurar el sistema como cliente

== Instalación ==

Para esta versión de Mapuche es necesario ejecutar el comando

<syntaxhighlight lang="bash" enclose="div">
composer install
</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">

[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>

Luego hay que agregar el sertificado al sistema operativo, aumimos que se encuentra en /certs/ca.cert.pem

<syntaxhighlight lang="bash" enclose="div">
cp /certs/ca.cert.pem /usr/share/ca_certificates/ca_propia.crt
</syntaxhighlight>

Luego editamos el archivo de configuración

<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">
.
.
.
mozilla/thawte_Primary_Root_CA_-_G3.crt
spi-inc.org/spi-cacert-2008.crt
ca_propia.crt

</syntaxhighlight>

Y actualizamos con
<syntaxhighlight lang="bash" enclose="div">
update-ca-certificates --fresh
</syntaxhighlight>

Por ultimo reiniciamos apache ( restart )
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.

<syntaxhighlight lang="bash" enclose="div">
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_PASS=pass
</syntaxhighlight>

== Sincronizando ==

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

Primero agregamos Mapuche al entorno Arai con registry:add
<syntaxhighlight lang="bash" enclose="div">
cd /path_Instalacion
./bin/arai-cli registry:add --maintainer-email mail@domain.edu --maintainer usuario http://Registry/arai-registry
</syntaxhighlight>

Luego del mensaje de éxito hay que proceder a sincronizar la aplicación.
<syntaxhighlight lang="bash" enclose="div">
./bin/arai-cli registry:sync
</syntaxhighlight>

Por último hay que sincronizar todas aquellas aplicaciones a las que Mapuche consulte WS, en este caso Arai-Uaurios.
<syntaxhighlight lang="bash" enclose="div">
./bin/arai-cli registry:sync
</syntaxhighlight>

== 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.
# Ingresar a Menu->Usuarios
# Filtrar y seleccionar un usuarios
# En la solapa Cuentas Seleccionar "Mapuche" desde el combo "Aplicación"
# En el campo "Cuenta" escribir el usuario que corresponde en Mapuche
# Guardar

SIU-Arai/Modulos/Mapuche

2017-09-21T13:22:10Z

Jpiazza: /* Para la versión3.2.x */

= SIU-Mapuche =

= Para la versión 3.2.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
Con los certificados en la mano podemos configurar el sistema como cliente

== Instalación ==

Para esta versión de Mapuche es necesario ejecutar el comando

<syntaxhighlight lang="bash" enclose="div">
composer install
</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">

[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>

Luego hay que agregar el sertificado al sistema operativo, aumimos que se encuentra en /certs/ca.cert.pem

<syntaxhighlight lang="bash" enclose="div">
cp /certs/ca.cert.pem /usr/share/ca_certificates/ca_propia.crt
</syntaxhighlight>

Luego editamos el archivo de configuración

<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">
.
.
.
mozilla/thawte_Primary_Root_CA_-_G3.crt
spi-inc.org/spi-cacert-2008.crt
ca_propia.crt

</syntaxhighlight>

Y actualizamos con
<syntaxhighlight lang="bash" enclose="div">
update-ca-certificates --fresh
</syntaxhighlight>

Por ultimo reiniciamos apache ( restart )
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.

<syntaxhighlight lang="bash" enclose="div">
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_PASS=pass
</syntaxhighlight>

== Sincronizando ==

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

Primero agregamos Mapuche al entorno Arai con registry:add
<syntaxhighlight lang="bash" enclose="div">
cd /path_Instalacion
./bin/arai-cli registry:add --maintainer-email mail@domain.edu --maintainer usuario http://Registry/arai-registry
</syntaxhighlight>

Luego del mensaje de éxito hay que proceder a sincronizar la aplicación.
<syntaxhighlight lang="bash" enclose="div">
./bin/arai-cli registry:sync
</syntaxhighlight>

Por último hay que sincronizar todas aquellas aplicaciones a las que Mapuche consulte WS, en este caso Arai-Uaurios.
<syntaxhighlight lang="bash" enclose="div">
./bin/arai-cli registry:sync
</syntaxhighlight>

== 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.
# Ingresar a Menu->Usuarios
# Filtrar y seleccionar un usuarios
# En la solapa Cuentas Seleccionar "Mapuche" desde el combo "Aplicación"
# En el campo "Cuenta" escribir el usuario que corresponde en Mapuche
# Guardar

SIU-Arai/Modulos/Mapuche

2017-09-21T13:21:52Z

Jpiazza: Página creada con «= SIU-Mapuche = = Para la versión3.2.x = Primero que nada necesitamos tener en nuestro poder los certificados, se puede seguir [http://documentacion.siu.edu.ar/wiki/SIU...»

= SIU-Mapuche =

= Para la versión3.2.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
Con los certificados en la mano podemos configurar el sistema como cliente

== Instalación ==

Para esta versión de Mapuche es necesario ejecutar el comando

<syntaxhighlight lang="bash" enclose="div">
composer install
</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">

[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>

Luego hay que agregar el sertificado al sistema operativo, aumimos que se encuentra en /certs/ca.cert.pem

<syntaxhighlight lang="bash" enclose="div">
cp /certs/ca.cert.pem /usr/share/ca_certificates/ca_propia.crt
</syntaxhighlight>

Luego editamos el archivo de configuración

<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">
.
.
.
mozilla/thawte_Primary_Root_CA_-_G3.crt
spi-inc.org/spi-cacert-2008.crt
ca_propia.crt

</syntaxhighlight>

Y actualizamos con
<syntaxhighlight lang="bash" enclose="div">
update-ca-certificates --fresh
</syntaxhighlight>

Por ultimo reiniciamos apache ( restart )
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.

<syntaxhighlight lang="bash" enclose="div">
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_PASS=pass
</syntaxhighlight>

== Sincronizando ==

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

Primero agregamos Mapuche al entorno Arai con registry:add
<syntaxhighlight lang="bash" enclose="div">
cd /path_Instalacion
./bin/arai-cli registry:add --maintainer-email mail@domain.edu --maintainer usuario http://Registry/arai-registry
</syntaxhighlight>

Luego del mensaje de éxito hay que proceder a sincronizar la aplicación.
<syntaxhighlight lang="bash" enclose="div">
./bin/arai-cli registry:sync
</syntaxhighlight>

Por último hay que sincronizar todas aquellas aplicaciones a las que Mapuche consulte WS, en este caso Arai-Uaurios.
<syntaxhighlight lang="bash" enclose="div">
./bin/arai-cli registry:sync
</syntaxhighlight>

== 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.
# Ingresar a Menu->Usuarios
# Filtrar y seleccionar un usuarios
# En la solapa Cuentas Seleccionar "Mapuche" desde el combo "Aplicación"
# En el campo "Cuenta" escribir el usuario que corresponde en Mapuche
# Guardar

SIU-Arai/Modulos/Diaguita

2017-09-20T19:48:42Z

Jpiazza: /* Cliente Arai-Usuarios */

= SIU-Diaguita =
SIU-Diaguita es el "Módulo de Compras y Patrimonio".
Esté apartado está enfocado en la integración de SIU-Diaguita en a plataforma SIU-Arai, se asume que el sistema ya está instalado y funcionando. Para ver documentación específica de Diaguita hagalo desde [http://documentacion.siu.edu.ar/wiki/SIU-Diaguita este link].

= Para la versión 2.4.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
Con los certificados en la mano podemos configurar el sistema como cliente

== Instalación ==

Para esta versión de Diaguita es necesario ejecutar el comando

<syntaxhighlight lang="bash" enclose="div">
composer install
</syntaxhighlight>

De otro modo el comando arai-cli no se podrá ejecutar.

== Cliente Arai-Usuarios ==

Para poder vincular usuarios desde el toba-usuarios de Diaguita 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__diaguita/rest/rest_arai_usuarios/cliente.ini

<syntaxhighlight lang="apache" enclose="div">

[conexion]
to = "https://Usuarios/gestion/rest/"
auth_tipo = "ssl"
cert_file = "/certs/Diaguita-cli.cert.pem"
key_file = "/certs/Diaguita-cli.key.pem"
ca_cert = "/certs/ca.cert.pem"

</syntaxhighlight>

Luego hay que agregar el sertificado al sistema operativo, aumimos que se encuentra en /certs/ca.cert.pem

<syntaxhighlight lang="bash" enclose="div">
cp /certs/ca.cert.pem /usr/share/ca_certificates/ca_propia.crt
</syntaxhighlight>

Luego editamos el archivo de configuración

<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">
.
.
.
mozilla/thawte_Primary_Root_CA_-_G3.crt
spi-inc.org/spi-cacert-2008.crt
ca_propia.crt

</syntaxhighlight>

Y actualizamos con
<syntaxhighlight lang="bash" enclose="div">
update-ca-certificates --fresh
</syntaxhighlight>

Por ultimo reiniciamos apache ( restart )
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.

<syntaxhighlight lang="bash" enclose="div">
export TOBA_INSTANCIA=produccion
export TOBA_PROYECTO=diaguita
export TOBA_PROYECTO_DIR="/usr/local/siu/diaguita/aplicacion"
export TOBA_INSTALACION_DIR="/usr/local/siu/diaguita/instalacion"
export ARAI_REGISTRY_USER=user
export ARAI_REGISTRY_PASS=pass
</syntaxhighlight>

== Sincronizando ==

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

Primero agregamos Diaguita al entorno Arai con registry:add
<syntaxhighlight lang="bash" enclose="div">
cd /path_Instalacion
./bin/arai-cli registry:add --maintainer-email mail@domain.edu --maintainer usuario http://Registry/arai-registry
</syntaxhighlight>

Luego del mensaje de éxito hay que proceder a sincronizar la aplicación.
<syntaxhighlight lang="bash" enclose="div">
./bin/arai-cli registry:sync
</syntaxhighlight>

Por último hay que sincronizar todas aquellas aplicaciones a las que Diaguita consulte WS, en este caso Arai-Uaurios.
<syntaxhighlight lang="bash" enclose="div">
./bin/arai-cli registry:sync
</syntaxhighlight>

== Dando Acceso ==

Ahora el encargado de dar un loguín a Diaguita 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.
# Ingresar a Menu->Usuarios
# Filtrar y seleccionar un usuarios
# En la solapa Cuentas Seleccionar "Diaguita" desde el combo "Aplicación"
# En el campo "Cuenta" escribir el usuario que corresponde en Diaguita
# Guardar

SIU-Arai/Modulos/Diaguita

2017-09-20T19:30:25Z

Jpiazza: /* Sincronizando */

= SIU-Diaguita =
SIU-Diaguita es el "Módulo de Compras y Patrimonio".
Esté apartado está enfocado en la integración de SIU-Diaguita en a plataforma SIU-Arai, se asume que el sistema ya está instalado y funcionando. Para ver documentación específica de Diaguita hagalo desde [http://documentacion.siu.edu.ar/wiki/SIU-Diaguita este link].

= Para la versión 2.4.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
Con los certificados en la mano podemos configurar el sistema como cliente

== Instalación ==

Para esta versión de Diaguita es necesario ejecutar el comando

<syntaxhighlight lang="bash" enclose="div">
composer install
</syntaxhighlight>

De otro modo el comando arai-cli no se podrá ejecutar.

== Cliente Arai-Usuarios ==

Para poder vincular usuarios desde el toba-usuarios de Diaguita 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__toba_usuarios/rest/rest_arai_usuarios/cliente.ini

<syntaxhighlight lang="apache" enclose="div">

[conexion]
to = "https://Usuarios/gestion/rest/"
auth_tipo = "ssl"
cert_file = "/certs/Diaguita-cli.cert.pem"
key_file = "/certs/Diaguita-cli.key.pem"
ca_cert = "/certs/ca.cert.pem"

</syntaxhighlight>

Luego hay que agregar el sertificado al sistema operativo, aumimos que se encuentra en /certs/ca.cert.pem

<syntaxhighlight lang="bash" enclose="div">
cp /certs/ca.cert.pem /usr/share/ca_certificates/ca_propia.crt
</syntaxhighlight>

Luego editamos el archivo de configuración

<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">
.
.
.
mozilla/thawte_Primary_Root_CA_-_G3.crt
spi-inc.org/spi-cacert-2008.crt
ca_propia.crt

</syntaxhighlight>

Y actualizamos con
<syntaxhighlight lang="bash" enclose="div">
update-ca-certificates --fresh
</syntaxhighlight>

Por ultimo reiniciamos apache ( restart )
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.

<syntaxhighlight lang="bash" enclose="div">
export TOBA_INSTANCIA=produccion
export TOBA_PROYECTO=diaguita
export TOBA_PROYECTO_DIR="/usr/local/siu/diaguita/aplicacion"
export TOBA_INSTALACION_DIR="/usr/local/siu/diaguita/instalacion"
export ARAI_REGISTRY_USER=user
export ARAI_REGISTRY_PASS=pass
</syntaxhighlight>

== Sincronizando ==

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

Primero agregamos Diaguita al entorno Arai con registry:add
<syntaxhighlight lang="bash" enclose="div">
cd /path_Instalacion
./bin/arai-cli registry:add --maintainer-email mail@domain.edu --maintainer usuario http://Registry/arai-registry
</syntaxhighlight>

Luego del mensaje de éxito hay que proceder a sincronizar la aplicación.
<syntaxhighlight lang="bash" enclose="div">
./bin/arai-cli registry:sync
</syntaxhighlight>

Por último hay que sincronizar todas aquellas aplicaciones a las que Diaguita consulte WS, en este caso Arai-Uaurios.
<syntaxhighlight lang="bash" enclose="div">
./bin/arai-cli registry:sync
</syntaxhighlight>

== Dando Acceso ==

Ahora el encargado de dar un loguín a Diaguita 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.
# Ingresar a Menu->Usuarios
# Filtrar y seleccionar un usuarios
# En la solapa Cuentas Seleccionar "Diaguita" desde el combo "Aplicación"
# En el campo "Cuenta" escribir el usuario que corresponde en Diaguita
# Guardar

SIU-Arai

2017-09-20T19:17:42Z

Jpiazza: /* Módulos */

[[Archivo:siu-arai_iso.png|derecha|link=SIU-Arai]]
= SIU-Arai =
SIU-Araí es la plataforma integradora de servicios del SIU. Cada uno de los sistemas SIU son módulos dentro de la plataforma.

Existen dos módulos que son vitales para el funcionamiento de la plataforma.

* Arai-Registry: Repositorio central de servicios y aplicaciones
* Arai-Usuarios: IDP e IDM para toda la plataforma

== Forma de trabajo ==
Toda la distribución de los proyectos se hace a través de gitlab: [https://hub.siu.edu.ar https://hub.siu.edu.ar]. 
Cada uno de los módulos tiene una carpeta '''doc''' donde se incluyen instrucciones de instalación.

== Como instalar ==
Una vez completada la pre-instalación ya se puede seguir con la instalación de cada uno de los módulos.
# [http://documentacion.siu.edu.ar/wiki/SIU-Arai/preRequisitosArai Antes de instalar]
# Módulos
## [[SIU-Arai/registry|Arai-Registry]]
## [[SIU-Arai/usuarios|Arai-Usuarios]]
## [[SIU-Arai/huarpe|Huarpe]]: Módulo de autogestión de recursos y servicios. La cara visible de la plataforma para los usuarios..
# [http://documentacion.siu.edu.ar/wiki/SIU-Arai/ejemploPasoAPaso Ejemplo completo]

== Módulos ==
* [[SIU-Arai/Modulos/Pilaga|Pilaga]]
* [[SIU-Arai/Modulos/Diaguita|Diaguita]]
* [[SIU-Arai/catalogos-cliente|Arai-Catalogos (cliente)]]
* [[SIU-Arai/proveedores|Arai-Proveedores ]]

SIU-Arai/Modulos/Pilaga

2017-09-20T19:12:03Z

Jpiazza: /* Cliente Arai-Usuarios */

= SIU-Pilaga =
SIU-Pilaga es el "Módulo económico financiero y contable" que permite realizar en forma integrada la gestión de presupuesto.
Esté apartado está enfocado en la integración de SIU-Pilagá en a plataforma SIU-Arai, se asume que el sistema ya está instalado y funcionando. Para ver documentación específica de Pilagá hagalo desde [http://documentacion.siu.edu.ar/wiki/SIU-Pilagá este link].

= Para la versión 3.0.4 =

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

== Arai.json ==

Para poder sincronizar Pilaga 3.0.4 hay que modificar el archivo arai.json agregandole un bloque en "consume":
<syntaxhighlight lang="apache" enclose="div">
{
"name": "service:siu/sso-saml-idp",
"version": ">=0.1.0"
}
</syntaxhighlight>

El archivo tiene que quedar similar a este:
<syntaxhighlight lang="apache" enclose="div">
{
"name": "siu/pilaga",
"description": "Módulo de gestión presupuestaria, financiera y contable",
"scripts": {
"hooks": "SIU\\Pilaga\\AraiRegistryHooks"
},

"provide": [
{
"name": "api:siu/pilaga",
"version": "0.1.0",
"options": {
"auto-configurar": true
}
},
{
"name": "app:siu/pilaga",
"alias": "SIU-Pilaga",
"description": "Gestión presupuestaria, financiera y contable",
"version": "0.1.0",
"icon": "./www/img/logo_iso.png"
}
],
"consume": [
{
"name": "service:siu/sso-saml-idp",
"version": ">=0.1.0"
},
{
"name": "api:siu/arai-usuarios",
"version": ">=0.1.0",
"options": {
"toba-rest": [
{ "proyecto": "toba_usuarios", "rest-id": "rest_arai_usuarios" }
]
}

}
]

}
</syntaxhighlight>

== Cliente Arai-Usuarios ==

Para poder vincular usuarios desde el toba-usuarios de Pilaga 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__toba_usuarios/rest/rest_arai_usuarios/cliente.ini

<syntaxhighlight lang="apache" enclose="div">

[conexion]
to = "https://Usuarios/gestion/rest/"
auth_tipo = "ssl"
cert_file = "/certs/Pilaga-cli.cert.pem"
key_file = "/certs/Pilaga-cli.key.pem"
ca_cert = "/certs/ca.cert.pem"

</syntaxhighlight>

Luego hay que agregar el sertificado al sistema operativo, asumimos que se encuentra en /certs/ca.cert.pem

<syntaxhighlight lang="bash" enclose="div">
cp /certs/ca.cert.pem /usr/share/ca_certificates/ca_propia.crt
</syntaxhighlight>

Luego editamos el archivo de configuración

<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">
.
.
.
mozilla/thawte_Primary_Root_CA_-_G3.crt
spi-inc.org/spi-cacert-2008.crt
ca_propia.crt

</syntaxhighlight>

Y actualizamos con
<syntaxhighlight lang="bash" enclose="div">
update-ca-certificates --fresh
</syntaxhighlight>

Por ultimo reiniciamos apache ( restart )
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.

<syntaxhighlight lang="bash" enclose="div">
export TOBA_INSTANCIA=produccion
export TOBA_PROYECTO=pilaga
export TOBA_PROYECTO_DIR="/usr/local/siu/pilaga/"
export TOBA_INSTALACION_DIR="/usr/local/siu/pilaga/instalar"
export ARAI_REGISTRY_USER=user
export ARAI_REGISTRY_PASS=pass
</syntaxhighlight>

== Sincronizando ==

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

Primero agregamos Pilaga al entorno Arai con registry:add
<syntaxhighlight lang="bash" enclose="div">
cd /path_Instalacion
./bin/arai-cli registry:add --maintainer-email mail@domain.edu --maintainer usuario http://Registry/arai-registry
</syntaxhighlight>

Luego del mensaje de éxito hay que proceder a sincronizar la aplicación.
<syntaxhighlight lang="bash" enclose="div">
./bin/arai-cli registry:sync
</syntaxhighlight>

Por último hay que sincronizar todas aquellas aplicaciones a las que Pilaga consulte WS, en este caso Arai-Uaurios.
<syntaxhighlight lang="bash" enclose="div">
./bin/arai-cli registry:sync
</syntaxhighlight>

== Dando Acceso ==

Ahora el encargado de dar un loguín a Pilaga 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.
# Ingresar a Menu->Usuarios
# Filtrar y seleccionar un usuarios
# En la solapa Cuentas Seleccionar "Pilaga" desde el combo "Aplicación"
# En el campo "Cuenta" escribir el usuario que corresponde en Pilaga
# Guardar

SIU-Arai/Modulos/Diaguita

2017-09-20T19:11:13Z

Jpiazza: /* Cliente Arai-Usuarios */

= SIU-Diaguita =
SIU-Diaguita es el "Módulo de Compras y Patrimonio".
Esté apartado está enfocado en la integración de SIU-Diaguita en a plataforma SIU-Arai, se asume que el sistema ya está instalado y funcionando. Para ver documentación específica de Diaguita hagalo desde [http://documentacion.siu.edu.ar/wiki/SIU-Diaguita este link].

= Para la versión 2.4.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
Con los certificados en la mano podemos configurar el sistema como cliente

== Instalación ==

Para esta versión de Diaguita es necesario ejecutar el comando

<syntaxhighlight lang="bash" enclose="div">
composer install
</syntaxhighlight>

De otro modo el comando arai-cli no se podrá ejecutar.

== Cliente Arai-Usuarios ==

Para poder vincular usuarios desde el toba-usuarios de Diaguita 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__toba_usuarios/rest/rest_arai_usuarios/cliente.ini

<syntaxhighlight lang="apache" enclose="div">

[conexion]
to = "https://Usuarios/gestion/rest/"
auth_tipo = "ssl"
cert_file = "/certs/Diaguita-cli.cert.pem"
key_file = "/certs/Diaguita-cli.key.pem"
ca_cert = "/certs/ca.cert.pem"

</syntaxhighlight>

Luego hay que agregar el sertificado al sistema operativo, aumimos que se encuentra en /certs/ca.cert.pem

<syntaxhighlight lang="bash" enclose="div">
cp /certs/ca.cert.pem /usr/share/ca_certificates/ca_propia.crt
</syntaxhighlight>

Luego editamos el archivo de configuración

<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">
.
.
.
mozilla/thawte_Primary_Root_CA_-_G3.crt
spi-inc.org/spi-cacert-2008.crt
ca_propia.crt

</syntaxhighlight>

Y actualizamos con
<syntaxhighlight lang="bash" enclose="div">
update-ca-certificates --fresh
</syntaxhighlight>

Por ultimo reiniciamos apache ( restart )
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.

<syntaxhighlight lang="bash" enclose="div">
export TOBA_INSTANCIA=produccion
export TOBA_PROYECTO=diaguita
export TOBA_PROYECTO_DIR="/usr/local/siu/diaguita/aplicacion"
export TOBA_INSTALACION_DIR="/usr/local/siu/diaguita/instalacion"
export ARAI_REGISTRY_USER=user
export ARAI_REGISTRY_PASS=pass
</syntaxhighlight>

== Sincronizando ==

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

Primero agregamos Pilaga al entorno Arai con registry:add
<syntaxhighlight lang="bash" enclose="div">
cd /path_Instalacion
./bin/arai-cli registry:add --maintainer-email mail@domain.edu --maintainer usuario http://Registry/arai-registry
</syntaxhighlight>

Luego del mensaje de éxito hay que proceder a sincronizar la aplicación.
<syntaxhighlight lang="bash" enclose="div">
./bin/arai-cli registry:sync
</syntaxhighlight>

Por último hay que sincronizar todas aquellas aplicaciones a las que Pilaga consulte WS, en este caso Arai-Uaurios.
<syntaxhighlight lang="bash" enclose="div">
./bin/arai-cli registry:sync
</syntaxhighlight>

== Dando Acceso ==

Ahora el encargado de dar un loguín a Diaguita 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.
# Ingresar a Menu->Usuarios
# Filtrar y seleccionar un usuarios
# En la solapa Cuentas Seleccionar "Diaguita" desde el combo "Aplicación"
# En el campo "Cuenta" escribir el usuario que corresponde en Diaguita
# Guardar

SIU-Arai/Modulos/Diaguita

2017-09-20T19:10:09Z

Jpiazza: Página creada con «= SIU-Diaguita = SIU-Diaguita es el "Módulo de Compras y Patrimonio". Esté apartado está enfocado en la integración de SIU-Diaguita en a plataforma SIU-Arai, se asume q...»

= SIU-Diaguita =
SIU-Diaguita es el "Módulo de Compras y Patrimonio".
Esté apartado está enfocado en la integración de SIU-Diaguita en a plataforma SIU-Arai, se asume que el sistema ya está instalado y funcionando. Para ver documentación específica de Diaguita hagalo desde [http://documentacion.siu.edu.ar/wiki/SIU-Diaguita este link].

= Para la versión 2.4.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
Con los certificados en la mano podemos configurar el sistema como cliente

== Instalación ==

Para esta versión de Diaguita es necesario ejecutar el comando

<syntaxhighlight lang="bash" enclose="div">
composer install
</syntaxhighlight>

De otro modo el comando arai-cli no se podrá ejecutar.

== Cliente Arai-Usuarios ==

Para poder vincular usuarios desde el toba-usuarios de Diaguita 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__toba_usuarios/rest/rest_arai_usuarios/cliente.ini

<syntaxhighlight lang="apache" enclose="div">

[conexion]
to = "https://Usuarios/gestion/rest/"
auth_tipo = "ssl"
cert_file = "/certs/Pilaga-cli.cert.pem"
key_file = "/certs/Pilaga-cli.key.pem"
ca_cert = "/certs/ca.cert.pem"

</syntaxhighlight>

Luego hay que agregar el sertificado al sistema operativo, aumimos que se encuentra en /certs/ca.cert.pem

<syntaxhighlight lang="bash" enclose="div">
cp /certs/ca.cert.pem /usr/share/ca_certificates/ca_propia.crt
</syntaxhighlight>

Luego editamos el archivo de configuración

<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">
.
.
.
mozilla/thawte_Primary_Root_CA_-_G3.crt
spi-inc.org/spi-cacert-2008.crt
ca_propia.crt

</syntaxhighlight>

Y actualizamos con
<syntaxhighlight lang="bash" enclose="div">
update-ca-certificates --fresh
</syntaxhighlight>

Por ultimo reiniciamos apache ( restart )
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.

<syntaxhighlight lang="bash" enclose="div">
export TOBA_INSTANCIA=produccion
export TOBA_PROYECTO=diaguita
export TOBA_PROYECTO_DIR="/usr/local/siu/diaguita/aplicacion"
export TOBA_INSTALACION_DIR="/usr/local/siu/diaguita/instalacion"
export ARAI_REGISTRY_USER=user
export ARAI_REGISTRY_PASS=pass
</syntaxhighlight>

== Sincronizando ==

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

Primero agregamos Pilaga al entorno Arai con registry:add
<syntaxhighlight lang="bash" enclose="div">
cd /path_Instalacion
./bin/arai-cli registry:add --maintainer-email mail@domain.edu --maintainer usuario http://Registry/arai-registry
</syntaxhighlight>

Luego del mensaje de éxito hay que proceder a sincronizar la aplicación.
<syntaxhighlight lang="bash" enclose="div">
./bin/arai-cli registry:sync
</syntaxhighlight>

Por último hay que sincronizar todas aquellas aplicaciones a las que Pilaga consulte WS, en este caso Arai-Uaurios.
<syntaxhighlight lang="bash" enclose="div">
./bin/arai-cli registry:sync
</syntaxhighlight>

== Dando Acceso ==

Ahora el encargado de dar un loguín a Diaguita 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.
# Ingresar a Menu->Usuarios
# Filtrar y seleccionar un usuarios
# En la solapa Cuentas Seleccionar "Diaguita" desde el combo "Aplicación"
# En el campo "Cuenta" escribir el usuario que corresponde en Diaguita
# Guardar

SIU-Arai

2017-09-19T14:48:47Z

Jpiazza: /* Módulos */

[[Archivo:siu-arai_iso.png|derecha|link=SIU-Arai]]
= SIU-Arai =
SIU-Araí es la plataforma integradora de servicios del SIU. Cada uno de los sistemas SIU son módulos dentro de la plataforma.

Existen dos módulos que son vitales para el funcionamiento de la plataforma.

* Arai-Registry: Repositorio central de servicios y aplicaciones
* Arai-Usuarios: IDP e IDM para toda la plataforma

== Forma de trabajo ==
Toda la distribución de los proyectos se hace a través de gitlab: [https://hub.siu.edu.ar https://hub.siu.edu.ar]. 
Cada uno de los módulos tiene una carpeta '''doc''' donde se incluyen instrucciones de instalación.

== Como instalar ==
Una vez completada la pre-instalación ya se puede seguir con la instalación de cada uno de los módulos.
# [http://documentacion.siu.edu.ar/wiki/SIU-Arai/preRequisitosArai Antes de instalar]
# Módulos
## [[SIU-Arai/registry|Arai-Registry]]
## [[SIU-Arai/usuarios|Arai-Usuarios]]
## [[SIU-Arai/huarpe|Huarpe]]: Módulo de autogestión de recursos y servicios. La cara visible de la plataforma para los usuarios..
# [http://documentacion.siu.edu.ar/wiki/SIU-Arai/ejemploPasoAPaso Ejemplo completo]

== Módulos ==
* [[SIU-Arai/Modulos/Pilaga|Pilaga]]
* [[SIU-Arai/catalogos-cliente|Arai-Catalogos (cliente)]]
* [[SIU-Arai/proveedores|Arai-Proveedores ]]

SIU-Arai

2017-09-19T14:48:29Z

Jpiazza: /* Módulos */

[[Archivo:siu-arai_iso.png|derecha|link=SIU-Arai]]
= SIU-Arai =
SIU-Araí es la plataforma integradora de servicios del SIU. Cada uno de los sistemas SIU son módulos dentro de la plataforma.

Existen dos módulos que son vitales para el funcionamiento de la plataforma.

* Arai-Registry: Repositorio central de servicios y aplicaciones
* Arai-Usuarios: IDP e IDM para toda la plataforma

== Forma de trabajo ==
Toda la distribución de los proyectos se hace a través de gitlab: [https://hub.siu.edu.ar https://hub.siu.edu.ar]. 
Cada uno de los módulos tiene una carpeta '''doc''' donde se incluyen instrucciones de instalación.

== Como instalar ==
Una vez completada la pre-instalación ya se puede seguir con la instalación de cada uno de los módulos.
# [http://documentacion.siu.edu.ar/wiki/SIU-Arai/preRequisitosArai Antes de instalar]
# Módulos
## [[SIU-Arai/registry|Arai-Registry]]
## [[SIU-Arai/usuarios|Arai-Usuarios]]
## [[SIU-Arai/huarpe|Huarpe]]: Módulo de autogestión de recursos y servicios. La cara visible de la plataforma para los usuarios..
# [http://documentacion.siu.edu.ar/wiki/SIU-Arai/ejemploPasoAPaso Ejemplo completo]

== Módulos ==
* [[/SIU-Arai/Modulos/Pilaga|Pilaga]]
* [[SIU-Arai/catalogos-cliente|Arai-Catalogos (cliente)]]
* [[SIU-Arai/proveedores|Arai-Proveedores ]]

SIU-Arai/Modulos/Pilaga

2017-09-19T14:46:50Z

Jpiazza: /* Arai.json */

= SIU-Pilaga =
SIU-Pilaga es el "Módulo económico financiero y contable" que permite realizar en forma integrada la gestión de presupuesto.
Esté apartado está enfocado en la integración de SIU-Pilagá en a plataforma SIU-Arai, se asume que el sistema ya está instalado y funcionando. Para ver documentación específica de Pilagá hagalo desde [http://documentacion.siu.edu.ar/wiki/SIU-Pilagá este link].

= Para la versión 3.0.4 =

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

== Arai.json ==

Para poder sincronizar Pilaga 3.0.4 hay que modificar el archivo arai.json agregandole un bloque en "consume":
<syntaxhighlight lang="apache" enclose="div">
{
"name": "service:siu/sso-saml-idp",
"version": ">=0.1.0"
}
</syntaxhighlight>

El archivo tiene que quedar similar a este:
<syntaxhighlight lang="apache" enclose="div">
{
"name": "siu/pilaga",
"description": "Módulo de gestión presupuestaria, financiera y contable",
"scripts": {
"hooks": "SIU\\Pilaga\\AraiRegistryHooks"
},

"provide": [
{
"name": "api:siu/pilaga",
"version": "0.1.0",
"options": {
"auto-configurar": true
}
},
{
"name": "app:siu/pilaga",
"alias": "SIU-Pilaga",
"description": "Gestión presupuestaria, financiera y contable",
"version": "0.1.0",
"icon": "./www/img/logo_iso.png"
}
],
"consume": [
{
"name": "service:siu/sso-saml-idp",
"version": ">=0.1.0"
},
{
"name": "api:siu/arai-usuarios",
"version": ">=0.1.0",
"options": {
"toba-rest": [
{ "proyecto": "toba_usuarios", "rest-id": "rest_arai_usuarios" }
]
}

}
]

}
</syntaxhighlight>

== Cliente Arai-Usuarios ==

Para poder vincular usuarios desde el toba-usuarios de Pilaga 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__toba_usuarios/rest/rest_arai_usuarios/cliente.ini

<syntaxhighlight lang="apache" enclose="div">

[conexion]
to = "https://Usuarios/gestion/rest/"
auth_tipo = "ssl"
cert_file = "/certs/Pilaga-cli.cert.pem"
key_file = "/certs/Pilaga-cli.key.pem"
ca_cert = "/certs/ca.cert.pem"

</syntaxhighlight>

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.

<syntaxhighlight lang="bash" enclose="div">
export TOBA_INSTANCIA=produccion
export TOBA_PROYECTO=pilaga
export TOBA_PROYECTO_DIR="/usr/local/siu/pilaga/"
export TOBA_INSTALACION_DIR="/usr/local/siu/pilaga/instalar"
export ARAI_REGISTRY_USER=user
export ARAI_REGISTRY_PASS=pass
</syntaxhighlight>

== Sincronizando ==

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

Primero agregamos Pilaga al entorno Arai con registry:add
<syntaxhighlight lang="bash" enclose="div">
cd /path_Instalacion
./bin/arai-cli registry:add --maintainer-email mail@domain.edu --maintainer usuario http://Registry/arai-registry
</syntaxhighlight>

Luego del mensaje de éxito hay que proceder a sincronizar la aplicación.
<syntaxhighlight lang="bash" enclose="div">
./bin/arai-cli registry:sync
</syntaxhighlight>

Por último hay que sincronizar todas aquellas aplicaciones a las que Pilaga consulte WS, en este caso Arai-Uaurios.
<syntaxhighlight lang="bash" enclose="div">
./bin/arai-cli registry:sync
</syntaxhighlight>

== Dando Acceso ==

Ahora el encargado de dar un loguín a Pilaga 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.
# Ingresar a Menu->Usuarios
# Filtrar y seleccionar un usuarios
# En la solapa Cuentas Seleccionar "Pilaga" desde el combo "Aplicación"
# En el campo "Cuenta" escribir el usuario que corresponde en Pilaga
# Guardar

SIU-Arai/Modulos/Pilaga

2017-09-18T18:26:11Z

Jpiazza: /* Dando Acceso */

= SIU-Pilaga =
SIU-Pilaga es el "Módulo económico financiero y contable" que permite realizar en forma integrada la gestión de presupuesto.
Esté apartado está enfocado en la integración de SIU-Pilagá en a plataforma SIU-Arai, se asume que el sistema ya está instalado y funcionando. Para ver documentación específica de Pilagá hagalo desde [http://documentacion.siu.edu.ar/wiki/SIU-Pilagá este link].

= Para la versión 3.0.4 =

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

== Arai.json ==

Para poder sincronizar Pilaga con Arai-Registry debemos configurar el archivo Arai.json, quedaría algo así dependiendo del entorno donde esté instalado.

<syntaxhighlight lang="apache" enclose="div">
{
"name": "siu/pilaga",
"description": "Módulo de gestión presupuestaria, financiera y contable",
"scripts": {
"hooks": "SIU\\Pilaga\\AraiRegistryHooks"
},

"provide": [
{
"name": "api:siu/pilaga",
"version": "0.1.0",
"options": {
"auto-configurar": true
}
},
{
"name": "app:siu/pilaga",
"alias": "SIU-Pilaga",
"description": "Gestión presupuestaria, financiera y contable",
"version": "0.1.0",
"icon": "./www/img/logo_iso.png"
}
],
"consume": [
{
"name": "service:siu/sso-saml-idp",
"version": ">=0.1.0"
},
{
"name": "api:siu/arai-usuarios",
"version": ">=0.1.0",
"options": {
"toba-rest": [
{ "proyecto": "toba_usuarios", "rest-id": "rest_arai_usuarios" }
]
}

}
]

}
</syntaxhighlight>

== Cliente Arai-Usuarios ==

Para poder vincular usuarios desde el toba-usuarios de Pilaga 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__toba_usuarios/rest/rest_arai_usuarios/cliente.ini

<syntaxhighlight lang="apache" enclose="div">

[conexion]
to = "https://Usuarios/gestion/rest/"
auth_tipo = "ssl"
cert_file = "/certs/Pilaga-cli.cert.pem"
key_file = "/certs/Pilaga-cli.key.pem"
ca_cert = "/certs/ca.cert.pem"

</syntaxhighlight>

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.

<syntaxhighlight lang="bash" enclose="div">
export TOBA_INSTANCIA=produccion
export TOBA_PROYECTO=pilaga
export TOBA_PROYECTO_DIR="/usr/local/siu/pilaga/"
export TOBA_INSTALACION_DIR="/usr/local/siu/pilaga/instalar"
export ARAI_REGISTRY_USER=user
export ARAI_REGISTRY_PASS=pass
</syntaxhighlight>

== Sincronizando ==

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

Primero agregamos Pilaga al entorno Arai con registry:add
<syntaxhighlight lang="bash" enclose="div">
cd /path_Instalacion
./bin/arai-cli registry:add --maintainer-email mail@domain.edu --maintainer usuario http://Registry/arai-registry
</syntaxhighlight>

Luego del mensaje de éxito hay que proceder a sincronizar la aplicación.
<syntaxhighlight lang="bash" enclose="div">
./bin/arai-cli registry:sync
</syntaxhighlight>

Por último hay que sincronizar todas aquellas aplicaciones a las que Pilaga consulte WS, en este caso Arai-Uaurios.
<syntaxhighlight lang="bash" enclose="div">
./bin/arai-cli registry:sync
</syntaxhighlight>

== Dando Acceso ==

Ahora el encargado de dar un loguín a Pilaga 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.
# Ingresar a Menu->Usuarios
# Filtrar y seleccionar un usuarios
# En la solapa Cuentas Seleccionar "Pilaga" desde el combo "Aplicación"
# En el campo "Cuenta" escribir el usuario que corresponde en Pilaga
# Guardar

SIU-Arai/Modulos/Pilaga

2017-09-18T18:25:03Z

Jpiazza: /* Dando Acceso */

= SIU-Pilaga =
SIU-Pilaga es el "Módulo económico financiero y contable" que permite realizar en forma integrada la gestión de presupuesto.
Esté apartado está enfocado en la integración de SIU-Pilagá en a plataforma SIU-Arai, se asume que el sistema ya está instalado y funcionando. Para ver documentación específica de Pilagá hagalo desde [http://documentacion.siu.edu.ar/wiki/SIU-Pilagá este link].

= Para la versión 3.0.4 =

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

== Arai.json ==

Para poder sincronizar Pilaga con Arai-Registry debemos configurar el archivo Arai.json, quedaría algo así dependiendo del entorno donde esté instalado.

<syntaxhighlight lang="apache" enclose="div">
{
"name": "siu/pilaga",
"description": "Módulo de gestión presupuestaria, financiera y contable",
"scripts": {
"hooks": "SIU\\Pilaga\\AraiRegistryHooks"
},

"provide": [
{
"name": "api:siu/pilaga",
"version": "0.1.0",
"options": {
"auto-configurar": true
}
},
{
"name": "app:siu/pilaga",
"alias": "SIU-Pilaga",
"description": "Gestión presupuestaria, financiera y contable",
"version": "0.1.0",
"icon": "./www/img/logo_iso.png"
}
],
"consume": [
{
"name": "service:siu/sso-saml-idp",
"version": ">=0.1.0"
},
{
"name": "api:siu/arai-usuarios",
"version": ">=0.1.0",
"options": {
"toba-rest": [
{ "proyecto": "toba_usuarios", "rest-id": "rest_arai_usuarios" }
]
}

}
]

}
</syntaxhighlight>

== Cliente Arai-Usuarios ==

Para poder vincular usuarios desde el toba-usuarios de Pilaga 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__toba_usuarios/rest/rest_arai_usuarios/cliente.ini

<syntaxhighlight lang="apache" enclose="div">

[conexion]
to = "https://Usuarios/gestion/rest/"
auth_tipo = "ssl"
cert_file = "/certs/Pilaga-cli.cert.pem"
key_file = "/certs/Pilaga-cli.key.pem"
ca_cert = "/certs/ca.cert.pem"

</syntaxhighlight>

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.

<syntaxhighlight lang="bash" enclose="div">
export TOBA_INSTANCIA=produccion
export TOBA_PROYECTO=pilaga
export TOBA_PROYECTO_DIR="/usr/local/siu/pilaga/"
export TOBA_INSTALACION_DIR="/usr/local/siu/pilaga/instalar"
export ARAI_REGISTRY_USER=user
export ARAI_REGISTRY_PASS=pass
</syntaxhighlight>

== Sincronizando ==

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

Primero agregamos Pilaga al entorno Arai con registry:add
<syntaxhighlight lang="bash" enclose="div">
cd /path_Instalacion
./bin/arai-cli registry:add --maintainer-email mail@domain.edu --maintainer usuario http://Registry/arai-registry
</syntaxhighlight>

Luego del mensaje de éxito hay que proceder a sincronizar la aplicación.
<syntaxhighlight lang="bash" enclose="div">
./bin/arai-cli registry:sync
</syntaxhighlight>

Por último hay que sincronizar todas aquellas aplicaciones a las que Pilaga consulte WS, en este caso Arai-Uaurios.
<syntaxhighlight lang="bash" enclose="div">
./bin/arai-cli registry:sync
</syntaxhighlight>

== Dando Acceso ==

Ahora el encargado de dar un loguín a Pilaga 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.
# En Mení->Usuarios, filtrar, editar y seleccionar un usuarios
# En la solapa Cuentas Seleccionar "Pilaga" desde el combo "Aplicación"
# En el campo "Cuenta" escribir el usuario que corresponde en Pilaga
# Guardar

SIU-Arai/Modulos/Pilaga

2017-09-18T18:24:11Z

Jpiazza: /* Dando Acceso */

= SIU-Pilaga =
SIU-Pilaga es el "Módulo económico financiero y contable" que permite realizar en forma integrada la gestión de presupuesto.
Esté apartado está enfocado en la integración de SIU-Pilagá en a plataforma SIU-Arai, se asume que el sistema ya está instalado y funcionando. Para ver documentación específica de Pilagá hagalo desde [http://documentacion.siu.edu.ar/wiki/SIU-Pilagá este link].

= Para la versión 3.0.4 =

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

== Arai.json ==

Para poder sincronizar Pilaga con Arai-Registry debemos configurar el archivo Arai.json, quedaría algo así dependiendo del entorno donde esté instalado.

<syntaxhighlight lang="apache" enclose="div">
{
"name": "siu/pilaga",
"description": "Módulo de gestión presupuestaria, financiera y contable",
"scripts": {
"hooks": "SIU\\Pilaga\\AraiRegistryHooks"
},

"provide": [
{
"name": "api:siu/pilaga",
"version": "0.1.0",
"options": {
"auto-configurar": true
}
},
{
"name": "app:siu/pilaga",
"alias": "SIU-Pilaga",
"description": "Gestión presupuestaria, financiera y contable",
"version": "0.1.0",
"icon": "./www/img/logo_iso.png"
}
],
"consume": [
{
"name": "service:siu/sso-saml-idp",
"version": ">=0.1.0"
},
{
"name": "api:siu/arai-usuarios",
"version": ">=0.1.0",
"options": {
"toba-rest": [
{ "proyecto": "toba_usuarios", "rest-id": "rest_arai_usuarios" }
]
}

}
]

}
</syntaxhighlight>

== Cliente Arai-Usuarios ==

Para poder vincular usuarios desde el toba-usuarios de Pilaga 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__toba_usuarios/rest/rest_arai_usuarios/cliente.ini

<syntaxhighlight lang="apache" enclose="div">

[conexion]
to = "https://Usuarios/gestion/rest/"
auth_tipo = "ssl"
cert_file = "/certs/Pilaga-cli.cert.pem"
key_file = "/certs/Pilaga-cli.key.pem"
ca_cert = "/certs/ca.cert.pem"

</syntaxhighlight>

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.

<syntaxhighlight lang="bash" enclose="div">
export TOBA_INSTANCIA=produccion
export TOBA_PROYECTO=pilaga
export TOBA_PROYECTO_DIR="/usr/local/siu/pilaga/"
export TOBA_INSTALACION_DIR="/usr/local/siu/pilaga/instalar"
export ARAI_REGISTRY_USER=user
export ARAI_REGISTRY_PASS=pass
</syntaxhighlight>

== Sincronizando ==

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

Primero agregamos Pilaga al entorno Arai con registry:add
<syntaxhighlight lang="bash" enclose="div">
cd /path_Instalacion
./bin/arai-cli registry:add --maintainer-email mail@domain.edu --maintainer usuario http://Registry/arai-registry
</syntaxhighlight>

Luego del mensaje de éxito hay que proceder a sincronizar la aplicación.
<syntaxhighlight lang="bash" enclose="div">
./bin/arai-cli registry:sync
</syntaxhighlight>

Por último hay que sincronizar todas aquellas aplicaciones a las que Pilaga consulte WS, en este caso Arai-Uaurios.
<syntaxhighlight lang="bash" enclose="div">
./bin/arai-cli registry:sync
</syntaxhighlight>

== Dando Acceso ==

Ahora el encargado de dar un loguín a Pilaga 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.
En Mení->Usuarios, filtrar, editar y seleccionar un usuarios
En la solapa Cuentas Seleccionar "Pilaga" desde el combo "Aplicación" y en el campo "Cuenta" escribir el usuario que corresponde en Pilaga
Guardar

SIU-Arai/Modulos/Pilaga

2017-09-18T18:20:54Z

Jpiazza: /* Para la versión 3.0.4 */

= SIU-Pilaga =
SIU-Pilaga es el "Módulo económico financiero y contable" que permite realizar en forma integrada la gestión de presupuesto.
Esté apartado está enfocado en la integración de SIU-Pilagá en a plataforma SIU-Arai, se asume que el sistema ya está instalado y funcionando. Para ver documentación específica de Pilagá hagalo desde [http://documentacion.siu.edu.ar/wiki/SIU-Pilagá este link].

= Para la versión 3.0.4 =

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

== Arai.json ==

Para poder sincronizar Pilaga con Arai-Registry debemos configurar el archivo Arai.json, quedaría algo así dependiendo del entorno donde esté instalado.

<syntaxhighlight lang="apache" enclose="div">
{
"name": "siu/pilaga",
"description": "Módulo de gestión presupuestaria, financiera y contable",
"scripts": {
"hooks": "SIU\\Pilaga\\AraiRegistryHooks"
},

"provide": [
{
"name": "api:siu/pilaga",
"version": "0.1.0",
"options": {
"auto-configurar": true
}
},
{
"name": "app:siu/pilaga",
"alias": "SIU-Pilaga",
"description": "Gestión presupuestaria, financiera y contable",
"version": "0.1.0",
"icon": "./www/img/logo_iso.png"
}
],
"consume": [
{
"name": "service:siu/sso-saml-idp",
"version": ">=0.1.0"
},
{
"name": "api:siu/arai-usuarios",
"version": ">=0.1.0",
"options": {
"toba-rest": [
{ "proyecto": "toba_usuarios", "rest-id": "rest_arai_usuarios" }
]
}

}
]

}
</syntaxhighlight>

== Cliente Arai-Usuarios ==

Para poder vincular usuarios desde el toba-usuarios de Pilaga 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__toba_usuarios/rest/rest_arai_usuarios/cliente.ini

<syntaxhighlight lang="apache" enclose="div">

[conexion]
to = "https://Usuarios/gestion/rest/"
auth_tipo = "ssl"
cert_file = "/certs/Pilaga-cli.cert.pem"
key_file = "/certs/Pilaga-cli.key.pem"
ca_cert = "/certs/ca.cert.pem"

</syntaxhighlight>

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.

<syntaxhighlight lang="bash" enclose="div">
export TOBA_INSTANCIA=produccion
export TOBA_PROYECTO=pilaga
export TOBA_PROYECTO_DIR="/usr/local/siu/pilaga/"
export TOBA_INSTALACION_DIR="/usr/local/siu/pilaga/instalar"
export ARAI_REGISTRY_USER=user
export ARAI_REGISTRY_PASS=pass
</syntaxhighlight>

== Sincronizando ==

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

Primero agregamos Pilaga al entorno Arai con registry:add
<syntaxhighlight lang="bash" enclose="div">
cd /path_Instalacion
./bin/arai-cli registry:add --maintainer-email mail@domain.edu --maintainer usuario http://Registry/arai-registry
</syntaxhighlight>

Luego del mensaje de éxito hay que proceder a sincronizar la aplicación.
<syntaxhighlight lang="bash" enclose="div">
./bin/arai-cli registry:sync
</syntaxhighlight>

Por último hay que sincronizar todas aquellas aplicaciones a las que Pilaga consulte WS, en este caso Arai-Uaurios.
<syntaxhighlight lang="bash" enclose="div">
./bin/arai-cli registry:sync
</syntaxhighlight>

== Dando Acceso ==
Ahora el encargado de dar un loguín a Pilaga 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.

SIU-Arai/Modulos/Pilaga

2017-09-18T18:10:02Z

Jpiazza: /* Cliente Arai-Usuarios */

SIU-Arai/Modulos/Pilaga

2017-09-18T18:08:42Z

Jpiazza: /* Para la versión 3.0.4 */

SIU-Arai/Modulos/Pilaga

2017-09-18T13:14:43Z

Jpiazza: /* SIU-Pilaga */

SIU-Arai/Modulos/Pilaga

2017-09-15T18:55:23Z

Jpiazza: /* SIU-Pilaga */

SIU-Arai/ejemploPasoAPaso

2017-09-15T15:48:40Z

Jpiazza: /* Arai-Huarpe */

[[Archivo:siu-arai_iso.png|derecha|link=SIU-Arai]]

= Ejemplo paso a paso =

Para este caso voy a usar una instalación de Debian Jessie

El objetivo es tener una instalación funcionando de la paltaforma SIU-Arai que luego sirva para integrar otros sistemas toba.

Lo primero que defino es en que URL va a vivir cada sistemas, en mi caso lo tengo funcionando dentro de una intranet y los DNS que quedaron así

{| class="wikitable zebra"
!colspan="2"|URLs
|-
|Araí-Registry
|http://registry.local.siu
|-
|Araí-Usuarios
|https://usuarios.local.siu
|-
|Araí-Huarpe
|https://huarpe.local.siu
|}

== Creación de certificados ==
Hay que tener en cuenta que voy a usar conexión segura, por lo que tanto voy a necesitar certificados.
Para crear los certificados uso el tutorial que se encuentra en http://documentacion.siu.edu.ar/wiki/SIU-Arai/certificados.
Ese artículo asume
* Docker instalado (https://docs.docker.com/engine/installation/linux/docker-ce/debian/#install-using-the-repository).
* Docker Compose instalado (https://github.com/docker/compose/releases).

<syntaxhighlight lang="bash" enclose="div">
git clone https://hub.siu.edu.ar/siu/instaladores.git dockerCerts
</syntaxhighlight>

Editamos el archivo docker-compose según nuestras necesidades.

<syntaxhighlight lang="bash" enclose="div">
cd dockerCerts/certs
nano docker-compose.yml
</syntaxhighlight>

En mi caso quedo así:

<syntaxhighlight lang="apache" enclose="div">
certificados:
image: siutoba/docker-certs
container_name: docker-certs
#env_file: docker.env
environment:
DOCKER_NAME: certs
CA_PWD: pass
CA_INT_PWD: pass
LISTA_SERVER: huarpe.local.siu usuarios.local.siu
LISTA_CLIENTES: usuarios-cli huarpe-cli
volumes:
- ./data/certificados:/CAs/intermediate
- ./data/root:/CAs/rootCA

</syntaxhighlight>

Guardamos y generamos el container.
<syntaxhighlight lang="bash" enclose="div">
docker-compose up
</syntaxhighlight>

Una vez generado el container copiamos los certificados creados en la carpeta que nos sea mas cómodo, en mi caso /certs
Sin cambiar de directorio hacemos:
<syntaxhighlight lang="bash" enclose="div">
sudo mkdir /certs
sudo find data -name "*.pem" -exec cp {} /certs \;
</syntaxhighlight>

Luego generamos los certificados para el IDP:
<syntaxhighlight lang="bash" enclose="div">
mkdir /certs/idp
cd /certs/idp
openssl req -newkey rsa:2048 -new -x509 -days 3652 -nodes -out certificado_idp.crt -keyout certificado_idp.pem
</syntaxhighlight>

Listo, con las URL definidas y los certificados creados se puede proceder a instalar la plataforma.

== Instalación Arai-Registy ==
Creamos la carpeta '''/usr/local/siu''' y no posicionamos ahí
Clonamos el proyecto
<syntaxhighlight lang="bash" enclose="div">
git clone https://hub.siu.edu.ar/siu-arai/arai-registry.git registry
</syntaxhighlight>
Utilizamos GitFlow, la última versión estable del proyecto es apuntada por el branch master y por cada versión que se saca se crea un tag.

Dentro del directorio del proyecto encontramos el archivo "doc/INSTALACION MANUAL.md", la idea es seguir las instrucciones que encontramos en este archivo.
<syntaxhighlight lang="bash" enclose="div">
cd registry
composer install --no-dev
</syntaxhighlight>

Configuramos las variables de entorno que va a usar el instalador, los valores que puse son válidos para mi instalación, deberán modificarlos según las necesidades de cada universidad.
<syntaxhighlight lang="bash" enclose="div">
cp templates/arai-registry.env.dist arai-registry.env
nano arai-registry.env
</syntaxhighlight>

'''arai-registry.env'''
<syntaxhighlight lang="apache" enclose="div">
# config de la aplicacion
ARAI_REGISTRY_ALIAS="/arai-registry"
ARAI_REGISTRY_USER="user"
ARAI_REGISTRY_PASS="pass"

# config de la base de datos
ARAI_REGISTRY_DB_HOST="172.27.31.114"
ARAI_REGISTRY_DB_PORT="7432"
ARAI_REGISTRY_DB_DBNAME="siu_registry"
ARAI_REGISTRY_DB_USERNAME="postgres"
ARAI_REGISTRY_DB_PASSWORD="postgres"
ARAI_REGISTRY_DB_SCHEMA="registry"
ARAI_REGISTRY_DB_ENCODING="UTF8"

###### CONFIG DE LOGS ######
ARAI_REGISTRY_LOG_HANDLER="errorlog"
ARAI_REGISTRY_LOG_LEVEL="WARNING"

# config del instalador
INSTALADOR_TIMEOUT="360"
</syntaxhighlight>

Una vez editado, verificamos que la configuración sea correcta
<syntaxhighlight lang="bash" enclose="div">
sudo ./bin/instalador proyecto:verificar
</syntaxhighlight>

Si no sale ninguna alerta, procedemos a instalar.
<syntaxhighlight lang="bash" enclose="div">
./bin/instalador proyecto:instalar
</syntaxhighlight>
Una vez instalado, modificamos los permisos de los archivos de la instalación con el comando
<syntaxhighlight lang="bash" enclose="div">
sudo ./bin/instalador permisos:simple
</syntaxhighlight>

Luego configuramos apache.
En mi caso, como tengo toda la plataforma instalada en un mismo servidor, debo usar el '''ServerName "registry.local.siu"'''
En lugar de hacer un vinculo con '''alias.conf''' como dice la documentación, use un include dentro del tag VirtualHost. Así me quedo el archivo '''/etc/apache/sites-enabled/registry.conf'''

<syntaxhighlight lang="apache" enclose="div">
<VirtualHost *:80>
ServerName registry.local.siu
Include /usr/local/siu/registry/config/alias.conf
</VirtualHost>
</syntaxhighlight>

Con todo esto, para verificar que todo funcione reiniciamos Apache y ejecutamos
<syntaxhighlight lang="bash" enclose="div">
curl --user registry:registry http://registry.local.siu/arai-registry/rest/packages/1
</syntaxhighlight>

Si la salida es:
<syntaxhighlight lang="bash" enclose="div">
{
"error": 404,
"mensaje": "404 Not Found",
"descripcion": "El paquete solicitado no existe"
}
</syntaxhighlight>
es que la instalación funcionó correctamente.

Con registry instalado procedemos a instalar Usuarios

==Arai-Usuarios==

Nos posicionamos en /usr/local/siu y clonamos el proyecto
<syntaxhighlight lang="bash" enclose="div">
cd /usr/local/siu
git clone https://hub.siu.edu.ar/siu-arai/arai-usuarios.git usuarios
cd usuarios
</syntaxhighlight>

Para instalar seguimos la documentación del archivo '''doc/INSTALACION_MANUAL.md'''
<syntaxhighlight lang="bash" enclose="div">
composer install --no-dev
</syntaxhighlight>

Configuramos las variables de entorno que va a usar el instalador, los valores que puse son válidos para mi instalación, deberán modificarlos según las necesidades de cada universidad.
Para la configuración de LDAP uso un servidor que ya está funcionando y configurado. El detalle de como configurar el servidor LDAP no pertenece a esta documentación.
La variable TOBA_USUARIO debe contener el mismo usuarios administrado del LDAP.
<syntaxhighlight lang="bash" enclose="div">
cp templates/arai-usuarios.env.dist arai-usuarios.env
nano arai-usuarios.env
</syntaxhighlight>

'''arai-usuarios.env.dist'''
<syntaxhighlight lang="apache" enclose="div">
###### CONFIG DEL INSTALADR ######
#INSTALADOR_TIMEOUT="360"
ENTORNO_PRODUCCION="1"

###### VARIABLES GLOBALES DEL ARCHIVO ######
ARAI_USUARIOS_DIR=/usr/local/siu/usuarios

###### CONFIG DE TOBA ######
TOBA_URL_BASE="https://usuarios.local.siu"
#TOBA_URL_PORT="443"
TOBA_USUARIO="admin"
TOBA_PASSWORD="admin1234"
TOBA_INSTALACION_DIR="${ARAI_USUARIOS_DIR}/instalacion"
TOBA_PROYECTO_DIR="${ARAI_USUARIOS_DIR}/gestion"
TOBA_INSTALAR_USUARIOS=false
TOBA_INSTALAR_EDITOR=false
TOBA_INSTALAR_REFERENCIA=false
TOBA_ALIAS_PROYECTO="/gestion"
TOBA_ALIAS_NUCLEO="/toba_gestion"
#TOBA_ID_DESARROLLADOR=0
#TOBA_SESSION_NAME="ARAI_SESSID"

###### CONFIG DE BASE DE DATOS DE NEGOCIO ######
PROYECTO_DB_HOST="172.27.31.114"
PROYECTO_DB_PORT="7432"
PROYECTO_DB_DBNAME="siu_usuarios"
PROYECTO_DB_USERNAME="postgres"
PROYECTO_DB_PASSWORD="postgres"
PROYECTO_DB_SCHEMA="usuarios"
PROYECTO_DB_ENCODING="LATIN1"

###### CONFIG DE BASE DE DATOS DE TOBA. #####
######## DEFINIR SI SE QUIERE UTILIZAR UNA BASE DISTINTA A LA DE NEGOCIO
#TOBA_DB_HOST="localhost"
#TOBA_DB_PORT="5432"
#TOBA_DB_DBNAME="instalador"
#TOBA_DB_USERNAME="postgres"
#TOBA_DB_PASSWORD="postgres"
#TOBA_DB_SCHEMA="public"

##### CONFIG IDM #####
ARAI_USUARIOS_URL_IDP=https://usuarios.local.siu/idp
## Deberá setearse si el sistema corre detrás de un proxy reverso
#ARAI_USUARIOS_PROXY_URL_IDP=http://url.arai-usuarios:80/idp
ARAI_USUARIOS_URL_PORTAL=https://huarpe.local.siu/portal
ARAI_USUARIOS_URL_PERFIL=https://huarpe.local.siu/perfil
ARAI_USUARIOS_URL_INSTITUCION=http://siu.edu.ar

ARAI_USUARIOS_SIGLA_INSTITUCION=SIGLA
ARAI_USUARIOS_EMAIL_SOPORTE=mail.soporte@institucion.edu.ar

##### CONFIG SEGURIDAD ####
SEGURIDAD_ALGORITMO_PASS=crypt
SEGURIDAD_LARGO_PASS=8
SEGURIDAD_INFO_PASS='El password debe tener al menos 8 caracteres, entre letras mayúsculas, minúsculas, números y símbolos, no pudiendo repetir caracteres adyacentes'
SEGURIDAD_DURACION_DIAS_PASS=120
SEGURIDAD_RECAPTCHA_SITIO=6Fd_pQwTAAAAAOEqJz6KJmkjsrXcdXrAjWQYggZf
SEGURIDAD_RECAPTCHA_CLAVE=6Fd_pQwTAAAAAOEqJz6KJmkjsrXcdXrAjWQYggZf
SEGURIDAD_INTENTOS_RECAPTCHA=3

##### CONFIG IDP #####
ARAI_USUARIOS_IDP_KEY_FILE=/certs/idp/certificado_idp.pem
ARAI_USUARIOS_IDP_CERT_FILE=/certs/idp/certificado_idp.crt
#ARAI_USUARIOS_IDP_LOG_LEVEL='WARNING'
#ARAI_USUARIOS_IDP_LOG_HANDLER='errorlog'

##### CONFIG MAIL RECOVERY ####
MAIL_RECOVERY_SUBJECT='Recuperar contraseña SIU-Arai'
MAIL_RECOVERY_FROM='noreply@institucion.edu.ar'
MAIL_RECOVERY_REPLYTO='noreply@institucion.edu.ar'
MAIL_RECOVERY_FROMNAME='Institución'

##### CONFIG LDAP #####
ARAI_USUARIOS_LDAP_HOST=172.27.31.114
ARAI_USUARIOS_LDAP_PORT=7389
ARAI_USUARIOS_LDAP_TLS=0
ARAI_USUARIOS_LDAP_METHOD=user
ARAI_USUARIOS_LDAP_BINDUSER="cn=admin,dc=siu,dc=cin,dc=edu"
ARAI_USUARIOS_LDAP_BINDPASS=admin
ARAI_USUARIOS_LDAP_SEARCHBASE="dc=siu,dc=cin,dc=edu"

##### CONFIG ARAI-REGISTRY #####
ARAI_REGISTRY_URL=http://registry.local.siu/arai-registry
ARAI_REGISTRY_USER=user
ARAI_REGISTRY_PASS=pass

###### CONFIG ENVIO MAILS (SMTP) ######
SMTP_ENTRADA="arai-usuarios"
SMTP_HELO="mail.unx.edu.ar"
SMTP_HOST="smtp.googlemail.com"
SMTP_PORT=587
SMTP_FROM ="yo@midominio.com"
SMTP_SEGURIDAD ="ssl|tls"
SMTP_AUTH ="1"
SMTP_USUARIO ="usuario"
SMTP_CLAVE ="pass"
</syntaxhighlight>

Una vez editado, verificamos que la configuración sea correcta
<syntaxhighlight lang="bash" enclose="div">
./bin/instalador proyecto:verificar -n
</syntaxhighlight>

Si no sale ninguna alerta, procedemos a instalar.
<syntaxhighlight lang="bash" enclose="div">
./bin/instalador proyecto:instalar
</syntaxhighlight>
Una vez instalado, modificamos los permisos de los archivos de la instalación con el comando
<syntaxhighlight lang="bash" enclose="div">
sudo ./bin/instalador permisos:simple
</syntaxhighlight>
Cambiamos el modo mantenimiento
<syntaxhighlight lang="bash" enclose="div">
./bin/instalador instalacion:modo-mantenimiento --sin-mantenimiento -n
</syntaxhighlight>

Luego configuramos Apache.
Lo mismo que con registry, como tengo toda la plataforma instalada en un mismo servidor, debo usar el '''ServerName "usuarios.local.siu"'''
En lugar de hacer un vinculo con '''alias.conf''' como dice la documentación, use un include dentro del tag VirtualHost. Así me quedo el archivo '''/etc/apache/sites-enabled/usuarios.conf'''

<syntaxhighlight lang="apache" enclose="div">
<VirtualHost *:80>
ServerName usuarios.local.siu
Redirect permanent / https://usuarios.local.siu/
</VirtualHost>

<VirtualHost *:443>

ServerName usuarios.local.siu

SSLEngine on
SSLCertificateFile /certs/usuarios.local.siu.cert.pem
SSLCertificateKeyFile /certs/usuarios.local.siu.key.pem

SSLCACertificateFile /certs/ca-chain.cert.pem

SSLVerifyClient optional_no_ca
SSLVerifyDepth 2
SSLProtocol all -SSLv2 -SSLv3
SSLOptions +StdEnvVars +ExportCertData
BrowserMatch "MSIE [2-6]" \
nokeepalive ssl-unclean-shutdown \
downgrade-1.0 force-response-1.0
# MSIE 7 and newer should be able to use keepalive
BrowserMatch "MSIE [17-9]" ssl-unclean-shutdown

Include /usr/local/siu/usuarios/instalacion/toba.conf

Include /usr/local/siu/usuarios/instalacion/idp.conf

</VirtualHost>
</syntaxhighlight>

Luego hay que hacer que nuestra CA autofirmada sea válida en el SO y así permitir que Apache verifique los certificados de clientes:
<syntaxhighlight lang="apache" enclose="div">
sudo cp /certs/ca.cert.pem /usr/share/ca-certificates/ca_propia.crt
sudo vim /etc/ca-certificates.conf
# agregar ca_propia.crt al final del archivo
update-ca-certificates --fresh
</syntaxhighlight>

Reiniciamos Apache y todo debería funcionar, para verificar entramos en la URL definida para usuarios, en mi caso https://usuarios.local.siu/gestion

Con todo esto funcionando el siguiente paso es agregar Usuarios a Registry y sincronizarlos.
Según esta instalación para agregar Usuarios al entorno hacemos
<syntaxhighlight lang="bash" enclose="div">
./bin/arai-cli registry:add --maintainer-email jpiazza@siu.edu.ar --maintainer jpiazza http://registry.local.siu/arai-registry
</syntaxhighlight>
y para sincronizarlo
<syntaxhighlight lang="bash" enclose="div">
./bin/arai-cli registry:sync
</syntaxhighlight>

== Arai-Huarpe ==

Es similar a las instalaciones anteriores.
<syntaxhighlight lang="bash" enclose="div">
cd /usr/local/siu
git clone https://hub.siu.edu.ar/siu-arai/huarpe-core.git huarpe
cd huarpe
</syntaxhighlight>

Para instalar seguimos la documentación del archivo '''doc/INSTALACION_MANUAL.md'''
<syntaxhighlight lang="bash" enclose="div">
composer install --no-dev
</syntaxhighlight>

Configuramos las variables de entorno que va a usar el instalador, los valores que puse son válidos para mi instalación, deberán modificarlos según las necesidades de cada universidad.
<syntaxhighlight lang="bash" enclose="div">
cp templates/huarpe.env.dist huarpe.env
nano huarpe.env
</syntaxhighlight>

'''huarpe.env'''
<syntaxhighlight lang="apache" enclose="div">
###### CONFIG DEL INSTALADR ######
#INSTALADOR_TIMEOUT="360"
ENTORNO_PRODUCCION=1

###### CONFIG DE SIU-HUARPE ######
HUARPE_PATH=/usr/local/siu/huarpe
HUARPE_URL=https://huarpe.local.siu
HUARPE_URL_PORT=443
HUARPE_SESSION_NAME=huarpe
HUARPE_SESSION_HANDLER="native_file"
#HUARPE_MEMCACHED_HOST=127.0.0.1
#HUARPE_MEMCACHED_PORT=11211
HUARPE_CERT_FILE=/certs/huarpe-cli.cert.pem
HUARPE_KEY_FILE=/certs/huarpe-cli.key.pem
#HUARPE_TOKEN=unt0k3n-al3at0r1o-s39ur0?
#HUARPE_PROXY=127.0.0.1
HUARPE_LOG_HANDLER="error_log"
HUARPE_LOG_LEVEL="WARNING"

###### CONFIG DE SIU-ARAI: REGISTRY ######
ARAI_REGISTRY_URL=http://registry.local.siu/arai-registry
ARAI_REGISTRY_USER=user
ARAI_REGISTRY_PASS=pass
</syntaxhighlight>

Una vez editado, verificamos que la configuración sea correcta
<syntaxhighlight lang="bash" enclose="div">
./bin/instalador proyecto:verificar
</syntaxhighlight>
Si no sale ninguna alerta, procedemos a instalar.
<syntaxhighlight lang="bash" enclose="div">
sudo ./bin/instalador proyecto:instalar
</syntaxhighlight>
En Synfony es necesario dumpear los estilos y los JS con el siguiente comando.
<syntaxhighlight lang="bash" enclose="div">
./bin/console assetic:dump --no-debug --env=prod
</syntaxhighlight>
Una vez instalado, modificamos los permisos de los archivos de la instalación con el comando
<syntaxhighlight lang="bash" enclose="div">
sudo ./bin/instalador permisos:simple
</syntaxhighlight>

=== Configuración apache ===
Lo mismo que con Registry o Usuarios, como tengo toda la plataforma instalada en un mismo servidor, debo usar el '''ServerName huarpe.local.siu'''.
En lugar de hacer un vinculo con alias.conf como dice la documentación, usé un include dentro del tag VirtualHost. Así me quedo el archivo /etc/apache/sites-enabled/huarpe.conf

<syntaxhighlight lang="apache" enclose="div">
<VirtualHost *:80>
ServerName huarpe.local.siu
Redirect permanent / https://huarpe.local.siu:443/
</VirtualHost>

<VirtualHost *:443>

ServerName huarpe.local.siu
SSLEngine on
SSLCertificateFile /certs/huarpe.local.siu.cert.pem
SSLCertificateKeyFile /certs/huarpe.local.siu.key.pem

Include /usr/local/siu/huarpe/app/config/alias.conf

</VirtualHost>
</syntaxhighlight>

Reiniciamos apache, antes de verificar la instalación, debemos sincronizar con Registry.
<syntaxhighlight lang="bash" enclose="div">
./bin/arai-cli registry:add --maintainer-email jpiazza@siu.edu.ar --maintainer jpiazza http://registry.local.siu/arai-registry
</syntaxhighlight>
Luego sincronizar
<syntaxhighlight lang="bash" enclose="div">
./bin/arai-cli registry:sync
</syntaxhighlight>

Hay que limpiar la cache y actualizar los permisos
<syntaxhighlight lang="bash" enclose="div">
./bin/console cache:clear --env=prod
sudo ./bin/instalador permisos:simple
</syntaxhighlight>

En Usuarios resincronizar para que se actualice con la nueva instalación
<syntaxhighlight lang="bash" enclose="div">
cd /usr/local/siu/usuarios
./bin/arai-cli registry:sync
</syntaxhighlight>

Para verificar que la instalación se realizo con éxito de debe ingresar en https://huarpe.local.siu/

Si todo salio bien, tenemos instalada la plataforma ARAI lista para ser usada en nuestro servidor.

SIU-Arai/ejemploPasoAPaso

2017-09-15T15:48:20Z

Jpiazza: /* Arai-Usuarios */

[[Archivo:siu-arai_iso.png|derecha|link=SIU-Arai]]

= Ejemplo paso a paso =

Para este caso voy a usar una instalación de Debian Jessie

El objetivo es tener una instalación funcionando de la paltaforma SIU-Arai que luego sirva para integrar otros sistemas toba.

Lo primero que defino es en que URL va a vivir cada sistemas, en mi caso lo tengo funcionando dentro de una intranet y los DNS que quedaron así

{| class="wikitable zebra"
!colspan="2"|URLs
|-
|Araí-Registry
|http://registry.local.siu
|-
|Araí-Usuarios
|https://usuarios.local.siu
|-
|Araí-Huarpe
|https://huarpe.local.siu
|}

== Creación de certificados ==
Hay que tener en cuenta que voy a usar conexión segura, por lo que tanto voy a necesitar certificados.
Para crear los certificados uso el tutorial que se encuentra en http://documentacion.siu.edu.ar/wiki/SIU-Arai/certificados.
Ese artículo asume
* Docker instalado (https://docs.docker.com/engine/installation/linux/docker-ce/debian/#install-using-the-repository).
* Docker Compose instalado (https://github.com/docker/compose/releases).

<syntaxhighlight lang="bash" enclose="div">
git clone https://hub.siu.edu.ar/siu/instaladores.git dockerCerts
</syntaxhighlight>

Editamos el archivo docker-compose según nuestras necesidades.

<syntaxhighlight lang="bash" enclose="div">
cd dockerCerts/certs
nano docker-compose.yml
</syntaxhighlight>

En mi caso quedo así:

<syntaxhighlight lang="apache" enclose="div">
certificados:
image: siutoba/docker-certs
container_name: docker-certs
#env_file: docker.env
environment:
DOCKER_NAME: certs
CA_PWD: pass
CA_INT_PWD: pass
LISTA_SERVER: huarpe.local.siu usuarios.local.siu
LISTA_CLIENTES: usuarios-cli huarpe-cli
volumes:
- ./data/certificados:/CAs/intermediate
- ./data/root:/CAs/rootCA

</syntaxhighlight>

Guardamos y generamos el container.
<syntaxhighlight lang="bash" enclose="div">
docker-compose up
</syntaxhighlight>

Una vez generado el container copiamos los certificados creados en la carpeta que nos sea mas cómodo, en mi caso /certs
Sin cambiar de directorio hacemos:
<syntaxhighlight lang="bash" enclose="div">
sudo mkdir /certs
sudo find data -name "*.pem" -exec cp {} /certs \;
</syntaxhighlight>

Luego generamos los certificados para el IDP:
<syntaxhighlight lang="bash" enclose="div">
mkdir /certs/idp
cd /certs/idp
openssl req -newkey rsa:2048 -new -x509 -days 3652 -nodes -out certificado_idp.crt -keyout certificado_idp.pem
</syntaxhighlight>

Listo, con las URL definidas y los certificados creados se puede proceder a instalar la plataforma.

== Instalación Arai-Registy ==
Creamos la carpeta '''/usr/local/siu''' y no posicionamos ahí
Clonamos el proyecto
<syntaxhighlight lang="bash" enclose="div">
git clone https://hub.siu.edu.ar/siu-arai/arai-registry.git registry
</syntaxhighlight>
Utilizamos GitFlow, la última versión estable del proyecto es apuntada por el branch master y por cada versión que se saca se crea un tag.

Dentro del directorio del proyecto encontramos el archivo "doc/INSTALACION MANUAL.md", la idea es seguir las instrucciones que encontramos en este archivo.
<syntaxhighlight lang="bash" enclose="div">
cd registry
composer install --no-dev
</syntaxhighlight>

Configuramos las variables de entorno que va a usar el instalador, los valores que puse son válidos para mi instalación, deberán modificarlos según las necesidades de cada universidad.
<syntaxhighlight lang="bash" enclose="div">
cp templates/arai-registry.env.dist arai-registry.env
nano arai-registry.env
</syntaxhighlight>

'''arai-registry.env'''
<syntaxhighlight lang="apache" enclose="div">
# config de la aplicacion
ARAI_REGISTRY_ALIAS="/arai-registry"
ARAI_REGISTRY_USER="user"
ARAI_REGISTRY_PASS="pass"

# config de la base de datos
ARAI_REGISTRY_DB_HOST="172.27.31.114"
ARAI_REGISTRY_DB_PORT="7432"
ARAI_REGISTRY_DB_DBNAME="siu_registry"
ARAI_REGISTRY_DB_USERNAME="postgres"
ARAI_REGISTRY_DB_PASSWORD="postgres"
ARAI_REGISTRY_DB_SCHEMA="registry"
ARAI_REGISTRY_DB_ENCODING="UTF8"

###### CONFIG DE LOGS ######
ARAI_REGISTRY_LOG_HANDLER="errorlog"
ARAI_REGISTRY_LOG_LEVEL="WARNING"

# config del instalador
INSTALADOR_TIMEOUT="360"
</syntaxhighlight>

Una vez editado, verificamos que la configuración sea correcta
<syntaxhighlight lang="bash" enclose="div">
sudo ./bin/instalador proyecto:verificar
</syntaxhighlight>

Si no sale ninguna alerta, procedemos a instalar.
<syntaxhighlight lang="bash" enclose="div">
./bin/instalador proyecto:instalar
</syntaxhighlight>
Una vez instalado, modificamos los permisos de los archivos de la instalación con el comando
<syntaxhighlight lang="bash" enclose="div">
sudo ./bin/instalador permisos:simple
</syntaxhighlight>

Luego configuramos apache.
En mi caso, como tengo toda la plataforma instalada en un mismo servidor, debo usar el '''ServerName "registry.local.siu"'''
En lugar de hacer un vinculo con '''alias.conf''' como dice la documentación, use un include dentro del tag VirtualHost. Así me quedo el archivo '''/etc/apache/sites-enabled/registry.conf'''

<syntaxhighlight lang="apache" enclose="div">
<VirtualHost *:80>
ServerName registry.local.siu
Include /usr/local/siu/registry/config/alias.conf
</VirtualHost>
</syntaxhighlight>

Con todo esto, para verificar que todo funcione reiniciamos Apache y ejecutamos
<syntaxhighlight lang="bash" enclose="div">
curl --user registry:registry http://registry.local.siu/arai-registry/rest/packages/1
</syntaxhighlight>

Si la salida es:
<syntaxhighlight lang="bash" enclose="div">
{
"error": 404,
"mensaje": "404 Not Found",
"descripcion": "El paquete solicitado no existe"
}
</syntaxhighlight>
es que la instalación funcionó correctamente.

Con registry instalado procedemos a instalar Usuarios

==Arai-Usuarios==

Nos posicionamos en /usr/local/siu y clonamos el proyecto
<syntaxhighlight lang="bash" enclose="div">
cd /usr/local/siu
git clone https://hub.siu.edu.ar/siu-arai/arai-usuarios.git usuarios
cd usuarios
</syntaxhighlight>

Para instalar seguimos la documentación del archivo '''doc/INSTALACION_MANUAL.md'''
<syntaxhighlight lang="bash" enclose="div">
composer install --no-dev
</syntaxhighlight>

Configuramos las variables de entorno que va a usar el instalador, los valores que puse son válidos para mi instalación, deberán modificarlos según las necesidades de cada universidad.
Para la configuración de LDAP uso un servidor que ya está funcionando y configurado. El detalle de como configurar el servidor LDAP no pertenece a esta documentación.
La variable TOBA_USUARIO debe contener el mismo usuarios administrado del LDAP.
<syntaxhighlight lang="bash" enclose="div">
cp templates/arai-usuarios.env.dist arai-usuarios.env
nano arai-usuarios.env
</syntaxhighlight>

'''arai-usuarios.env.dist'''
<syntaxhighlight lang="apache" enclose="div">
###### CONFIG DEL INSTALADR ######
#INSTALADOR_TIMEOUT="360"
ENTORNO_PRODUCCION="1"

###### VARIABLES GLOBALES DEL ARCHIVO ######
ARAI_USUARIOS_DIR=/usr/local/siu/usuarios

###### CONFIG DE TOBA ######
TOBA_URL_BASE="https://usuarios.local.siu"
#TOBA_URL_PORT="443"
TOBA_USUARIO="admin"
TOBA_PASSWORD="admin1234"
TOBA_INSTALACION_DIR="${ARAI_USUARIOS_DIR}/instalacion"
TOBA_PROYECTO_DIR="${ARAI_USUARIOS_DIR}/gestion"
TOBA_INSTALAR_USUARIOS=false
TOBA_INSTALAR_EDITOR=false
TOBA_INSTALAR_REFERENCIA=false
TOBA_ALIAS_PROYECTO="/gestion"
TOBA_ALIAS_NUCLEO="/toba_gestion"
#TOBA_ID_DESARROLLADOR=0
#TOBA_SESSION_NAME="ARAI_SESSID"

###### CONFIG DE BASE DE DATOS DE NEGOCIO ######
PROYECTO_DB_HOST="172.27.31.114"
PROYECTO_DB_PORT="7432"
PROYECTO_DB_DBNAME="siu_usuarios"
PROYECTO_DB_USERNAME="postgres"
PROYECTO_DB_PASSWORD="postgres"
PROYECTO_DB_SCHEMA="usuarios"
PROYECTO_DB_ENCODING="LATIN1"

###### CONFIG DE BASE DE DATOS DE TOBA. #####
######## DEFINIR SI SE QUIERE UTILIZAR UNA BASE DISTINTA A LA DE NEGOCIO
#TOBA_DB_HOST="localhost"
#TOBA_DB_PORT="5432"
#TOBA_DB_DBNAME="instalador"
#TOBA_DB_USERNAME="postgres"
#TOBA_DB_PASSWORD="postgres"
#TOBA_DB_SCHEMA="public"

##### CONFIG IDM #####
ARAI_USUARIOS_URL_IDP=https://usuarios.local.siu/idp
## Deberá setearse si el sistema corre detrás de un proxy reverso
#ARAI_USUARIOS_PROXY_URL_IDP=http://url.arai-usuarios:80/idp
ARAI_USUARIOS_URL_PORTAL=https://huarpe.local.siu/portal
ARAI_USUARIOS_URL_PERFIL=https://huarpe.local.siu/perfil
ARAI_USUARIOS_URL_INSTITUCION=http://siu.edu.ar

ARAI_USUARIOS_SIGLA_INSTITUCION=SIGLA
ARAI_USUARIOS_EMAIL_SOPORTE=mail.soporte@institucion.edu.ar

##### CONFIG SEGURIDAD ####
SEGURIDAD_ALGORITMO_PASS=crypt
SEGURIDAD_LARGO_PASS=8
SEGURIDAD_INFO_PASS='El password debe tener al menos 8 caracteres, entre letras mayúsculas, minúsculas, números y símbolos, no pudiendo repetir caracteres adyacentes'
SEGURIDAD_DURACION_DIAS_PASS=120
SEGURIDAD_RECAPTCHA_SITIO=6Fd_pQwTAAAAAOEqJz6KJmkjsrXcdXrAjWQYggZf
SEGURIDAD_RECAPTCHA_CLAVE=6Fd_pQwTAAAAAOEqJz6KJmkjsrXcdXrAjWQYggZf
SEGURIDAD_INTENTOS_RECAPTCHA=3

##### CONFIG IDP #####
ARAI_USUARIOS_IDP_KEY_FILE=/certs/idp/certificado_idp.pem
ARAI_USUARIOS_IDP_CERT_FILE=/certs/idp/certificado_idp.crt
#ARAI_USUARIOS_IDP_LOG_LEVEL='WARNING'
#ARAI_USUARIOS_IDP_LOG_HANDLER='errorlog'

##### CONFIG MAIL RECOVERY ####
MAIL_RECOVERY_SUBJECT='Recuperar contraseña SIU-Arai'
MAIL_RECOVERY_FROM='noreply@institucion.edu.ar'
MAIL_RECOVERY_REPLYTO='noreply@institucion.edu.ar'
MAIL_RECOVERY_FROMNAME='Institución'

##### CONFIG LDAP #####
ARAI_USUARIOS_LDAP_HOST=172.27.31.114
ARAI_USUARIOS_LDAP_PORT=7389
ARAI_USUARIOS_LDAP_TLS=0
ARAI_USUARIOS_LDAP_METHOD=user
ARAI_USUARIOS_LDAP_BINDUSER="cn=admin,dc=siu,dc=cin,dc=edu"
ARAI_USUARIOS_LDAP_BINDPASS=admin
ARAI_USUARIOS_LDAP_SEARCHBASE="dc=siu,dc=cin,dc=edu"

##### CONFIG ARAI-REGISTRY #####
ARAI_REGISTRY_URL=http://registry.local.siu/arai-registry
ARAI_REGISTRY_USER=user
ARAI_REGISTRY_PASS=pass

###### CONFIG ENVIO MAILS (SMTP) ######
SMTP_ENTRADA="arai-usuarios"
SMTP_HELO="mail.unx.edu.ar"
SMTP_HOST="smtp.googlemail.com"
SMTP_PORT=587
SMTP_FROM ="yo@midominio.com"
SMTP_SEGURIDAD ="ssl|tls"
SMTP_AUTH ="1"
SMTP_USUARIO ="usuario"
SMTP_CLAVE ="pass"
</syntaxhighlight>

Una vez editado, verificamos que la configuración sea correcta
<syntaxhighlight lang="bash" enclose="div">
./bin/instalador proyecto:verificar -n
</syntaxhighlight>

Si no sale ninguna alerta, procedemos a instalar.
<syntaxhighlight lang="bash" enclose="div">
./bin/instalador proyecto:instalar
</syntaxhighlight>
Una vez instalado, modificamos los permisos de los archivos de la instalación con el comando
<syntaxhighlight lang="bash" enclose="div">
sudo ./bin/instalador permisos:simple
</syntaxhighlight>
Cambiamos el modo mantenimiento
<syntaxhighlight lang="bash" enclose="div">
./bin/instalador instalacion:modo-mantenimiento --sin-mantenimiento -n
</syntaxhighlight>

Luego configuramos Apache.
Lo mismo que con registry, como tengo toda la plataforma instalada en un mismo servidor, debo usar el '''ServerName "usuarios.local.siu"'''
En lugar de hacer un vinculo con '''alias.conf''' como dice la documentación, use un include dentro del tag VirtualHost. Así me quedo el archivo '''/etc/apache/sites-enabled/usuarios.conf'''

<syntaxhighlight lang="apache" enclose="div">
<VirtualHost *:80>
ServerName usuarios.local.siu
Redirect permanent / https://usuarios.local.siu/
</VirtualHost>

<VirtualHost *:443>

ServerName usuarios.local.siu

SSLEngine on
SSLCertificateFile /certs/usuarios.local.siu.cert.pem
SSLCertificateKeyFile /certs/usuarios.local.siu.key.pem

SSLCACertificateFile /certs/ca-chain.cert.pem

SSLVerifyClient optional_no_ca
SSLVerifyDepth 2
SSLProtocol all -SSLv2 -SSLv3
SSLOptions +StdEnvVars +ExportCertData
BrowserMatch "MSIE [2-6]" \
nokeepalive ssl-unclean-shutdown \
downgrade-1.0 force-response-1.0
# MSIE 7 and newer should be able to use keepalive
BrowserMatch "MSIE [17-9]" ssl-unclean-shutdown

Include /usr/local/siu/usuarios/instalacion/toba.conf

Include /usr/local/siu/usuarios/instalacion/idp.conf

</VirtualHost>
</syntaxhighlight>

Luego hay que hacer que nuestra CA autofirmada sea válida en el SO y así permitir que Apache verifique los certificados de clientes:
<syntaxhighlight lang="apache" enclose="div">
sudo cp /certs/ca.cert.pem /usr/share/ca-certificates/ca_propia.crt
sudo vim /etc/ca-certificates.conf
# agregar ca_propia.crt al final del archivo
update-ca-certificates --fresh
</syntaxhighlight>

Reiniciamos Apache y todo debería funcionar, para verificar entramos en la URL definida para usuarios, en mi caso https://usuarios.local.siu/gestion

Con todo esto funcionando el siguiente paso es agregar Usuarios a Registry y sincronizarlos.
Según esta instalación para agregar Usuarios al entorno hacemos
<syntaxhighlight lang="bash" enclose="div">
./bin/arai-cli registry:add --maintainer-email jpiazza@siu.edu.ar --maintainer jpiazza http://registry.local.siu/arai-registry
</syntaxhighlight>
y para sincronizarlo
<syntaxhighlight lang="bash" enclose="div">
./bin/arai-cli registry:sync
</syntaxhighlight>

== Arai-Huarpe ==

Es similar a las instalaciones anteriores.
<syntaxhighlight lang="bash" enclose="div">
cd /usr/local/siu
git clone --branch v1.1.0 https://hub.siu.edu.ar/siu-arai/huarpe-core.git huarpe
cd huarpe
</syntaxhighlight>

Para instalar seguimos la documentación del archivo '''doc/INSTALACION_MANUAL.md'''
<syntaxhighlight lang="bash" enclose="div">
composer install --no-dev
</syntaxhighlight>

Configuramos las variables de entorno que va a usar el instalador, los valores que puse son válidos para mi instalación, deberán modificarlos según las necesidades de cada universidad.
<syntaxhighlight lang="bash" enclose="div">
cp templates/huarpe.env.dist huarpe.env
nano huarpe.env
</syntaxhighlight>

'''huarpe.env'''
<syntaxhighlight lang="apache" enclose="div">
###### CONFIG DEL INSTALADR ######
#INSTALADOR_TIMEOUT="360"
ENTORNO_PRODUCCION=1

###### CONFIG DE SIU-HUARPE ######
HUARPE_PATH=/usr/local/siu/huarpe
HUARPE_URL=https://huarpe.local.siu
HUARPE_URL_PORT=443
HUARPE_SESSION_NAME=huarpe
HUARPE_SESSION_HANDLER="native_file"
#HUARPE_MEMCACHED_HOST=127.0.0.1
#HUARPE_MEMCACHED_PORT=11211
HUARPE_CERT_FILE=/certs/huarpe-cli.cert.pem
HUARPE_KEY_FILE=/certs/huarpe-cli.key.pem
#HUARPE_TOKEN=unt0k3n-al3at0r1o-s39ur0?
#HUARPE_PROXY=127.0.0.1
HUARPE_LOG_HANDLER="error_log"
HUARPE_LOG_LEVEL="WARNING"

###### CONFIG DE SIU-ARAI: REGISTRY ######
ARAI_REGISTRY_URL=http://registry.local.siu/arai-registry
ARAI_REGISTRY_USER=user
ARAI_REGISTRY_PASS=pass
</syntaxhighlight>

Una vez editado, verificamos que la configuración sea correcta
<syntaxhighlight lang="bash" enclose="div">
./bin/instalador proyecto:verificar
</syntaxhighlight>
Si no sale ninguna alerta, procedemos a instalar.
<syntaxhighlight lang="bash" enclose="div">
sudo ./bin/instalador proyecto:instalar
</syntaxhighlight>
En Synfony es necesario dumpear los estilos y los JS con el siguiente comando.
<syntaxhighlight lang="bash" enclose="div">
./bin/console assetic:dump --no-debug --env=prod
</syntaxhighlight>
Una vez instalado, modificamos los permisos de los archivos de la instalación con el comando
<syntaxhighlight lang="bash" enclose="div">
sudo ./bin/instalador permisos:simple
</syntaxhighlight>

=== Configuración apache ===
Lo mismo que con Registry o Usuarios, como tengo toda la plataforma instalada en un mismo servidor, debo usar el '''ServerName huarpe.local.siu'''.
En lugar de hacer un vinculo con alias.conf como dice la documentación, usé un include dentro del tag VirtualHost. Así me quedo el archivo /etc/apache/sites-enabled/huarpe.conf

<syntaxhighlight lang="apache" enclose="div">
<VirtualHost *:80>
ServerName huarpe.local.siu
Redirect permanent / https://huarpe.local.siu:443/
</VirtualHost>

<VirtualHost *:443>

ServerName huarpe.local.siu
SSLEngine on
SSLCertificateFile /certs/huarpe.local.siu.cert.pem
SSLCertificateKeyFile /certs/huarpe.local.siu.key.pem

Include /usr/local/siu/huarpe/app/config/alias.conf

</VirtualHost>
</syntaxhighlight>

Reiniciamos apache, antes de verificar la instalación, debemos sincronizar con Registry.
<syntaxhighlight lang="bash" enclose="div">
./bin/arai-cli registry:add --maintainer-email jpiazza@siu.edu.ar --maintainer jpiazza http://registry.local.siu/arai-registry
</syntaxhighlight>
Luego sincronizar
<syntaxhighlight lang="bash" enclose="div">
./bin/arai-cli registry:sync
</syntaxhighlight>

Hay que limpiar la cache y actualizar los permisos
<syntaxhighlight lang="bash" enclose="div">
./bin/console cache:clear --env=prod
sudo ./bin/instalador permisos:simple
</syntaxhighlight>

En Usuarios resincronizar para que se actualice con la nueva instalación
<syntaxhighlight lang="bash" enclose="div">
cd /usr/local/siu/usuarios
./bin/arai-cli registry:sync
</syntaxhighlight>

Para verificar que la instalación se realizo con éxito de debe ingresar en https://huarpe.local.siu/

Si todo salio bien, tenemos instalada la plataforma ARAI lista para ser usada en nuestro servidor.

SIU-Arai/ejemploPasoAPaso

2017-09-15T15:47:54Z

Jpiazza: /* Instalación Arai-Registy */

[[Archivo:siu-arai_iso.png|derecha|link=SIU-Arai]]

= Ejemplo paso a paso =

Para este caso voy a usar una instalación de Debian Jessie

El objetivo es tener una instalación funcionando de la paltaforma SIU-Arai que luego sirva para integrar otros sistemas toba.

Lo primero que defino es en que URL va a vivir cada sistemas, en mi caso lo tengo funcionando dentro de una intranet y los DNS que quedaron así

{| class="wikitable zebra"
!colspan="2"|URLs
|-
|Araí-Registry
|http://registry.local.siu
|-
|Araí-Usuarios
|https://usuarios.local.siu
|-
|Araí-Huarpe
|https://huarpe.local.siu
|}

== Creación de certificados ==
Hay que tener en cuenta que voy a usar conexión segura, por lo que tanto voy a necesitar certificados.
Para crear los certificados uso el tutorial que se encuentra en http://documentacion.siu.edu.ar/wiki/SIU-Arai/certificados.
Ese artículo asume
* Docker instalado (https://docs.docker.com/engine/installation/linux/docker-ce/debian/#install-using-the-repository).
* Docker Compose instalado (https://github.com/docker/compose/releases).

<syntaxhighlight lang="bash" enclose="div">
git clone https://hub.siu.edu.ar/siu/instaladores.git dockerCerts
</syntaxhighlight>

Editamos el archivo docker-compose según nuestras necesidades.

<syntaxhighlight lang="bash" enclose="div">
cd dockerCerts/certs
nano docker-compose.yml
</syntaxhighlight>

En mi caso quedo así:

<syntaxhighlight lang="apache" enclose="div">
certificados:
image: siutoba/docker-certs
container_name: docker-certs
#env_file: docker.env
environment:
DOCKER_NAME: certs
CA_PWD: pass
CA_INT_PWD: pass
LISTA_SERVER: huarpe.local.siu usuarios.local.siu
LISTA_CLIENTES: usuarios-cli huarpe-cli
volumes:
- ./data/certificados:/CAs/intermediate
- ./data/root:/CAs/rootCA

</syntaxhighlight>

Guardamos y generamos el container.
<syntaxhighlight lang="bash" enclose="div">
docker-compose up
</syntaxhighlight>

Una vez generado el container copiamos los certificados creados en la carpeta que nos sea mas cómodo, en mi caso /certs
Sin cambiar de directorio hacemos:
<syntaxhighlight lang="bash" enclose="div">
sudo mkdir /certs
sudo find data -name "*.pem" -exec cp {} /certs \;
</syntaxhighlight>

Luego generamos los certificados para el IDP:
<syntaxhighlight lang="bash" enclose="div">
mkdir /certs/idp
cd /certs/idp
openssl req -newkey rsa:2048 -new -x509 -days 3652 -nodes -out certificado_idp.crt -keyout certificado_idp.pem
</syntaxhighlight>

Listo, con las URL definidas y los certificados creados se puede proceder a instalar la plataforma.

== Instalación Arai-Registy ==
Creamos la carpeta '''/usr/local/siu''' y no posicionamos ahí
Clonamos el proyecto
<syntaxhighlight lang="bash" enclose="div">
git clone https://hub.siu.edu.ar/siu-arai/arai-registry.git registry
</syntaxhighlight>
Utilizamos GitFlow, la última versión estable del proyecto es apuntada por el branch master y por cada versión que se saca se crea un tag.

Dentro del directorio del proyecto encontramos el archivo "doc/INSTALACION MANUAL.md", la idea es seguir las instrucciones que encontramos en este archivo.
<syntaxhighlight lang="bash" enclose="div">
cd registry
composer install --no-dev
</syntaxhighlight>

Configuramos las variables de entorno que va a usar el instalador, los valores que puse son válidos para mi instalación, deberán modificarlos según las necesidades de cada universidad.
<syntaxhighlight lang="bash" enclose="div">
cp templates/arai-registry.env.dist arai-registry.env
nano arai-registry.env
</syntaxhighlight>

'''arai-registry.env'''
<syntaxhighlight lang="apache" enclose="div">
# config de la aplicacion
ARAI_REGISTRY_ALIAS="/arai-registry"
ARAI_REGISTRY_USER="user"
ARAI_REGISTRY_PASS="pass"

# config de la base de datos
ARAI_REGISTRY_DB_HOST="172.27.31.114"
ARAI_REGISTRY_DB_PORT="7432"
ARAI_REGISTRY_DB_DBNAME="siu_registry"
ARAI_REGISTRY_DB_USERNAME="postgres"
ARAI_REGISTRY_DB_PASSWORD="postgres"
ARAI_REGISTRY_DB_SCHEMA="registry"
ARAI_REGISTRY_DB_ENCODING="UTF8"

###### CONFIG DE LOGS ######
ARAI_REGISTRY_LOG_HANDLER="errorlog"
ARAI_REGISTRY_LOG_LEVEL="WARNING"

# config del instalador
INSTALADOR_TIMEOUT="360"
</syntaxhighlight>

Una vez editado, verificamos que la configuración sea correcta
<syntaxhighlight lang="bash" enclose="div">
sudo ./bin/instalador proyecto:verificar
</syntaxhighlight>

Si no sale ninguna alerta, procedemos a instalar.
<syntaxhighlight lang="bash" enclose="div">
./bin/instalador proyecto:instalar
</syntaxhighlight>
Una vez instalado, modificamos los permisos de los archivos de la instalación con el comando
<syntaxhighlight lang="bash" enclose="div">
sudo ./bin/instalador permisos:simple
</syntaxhighlight>

Luego configuramos apache.
En mi caso, como tengo toda la plataforma instalada en un mismo servidor, debo usar el '''ServerName "registry.local.siu"'''
En lugar de hacer un vinculo con '''alias.conf''' como dice la documentación, use un include dentro del tag VirtualHost. Así me quedo el archivo '''/etc/apache/sites-enabled/registry.conf'''

<syntaxhighlight lang="apache" enclose="div">
<VirtualHost *:80>
ServerName registry.local.siu
Include /usr/local/siu/registry/config/alias.conf
</VirtualHost>
</syntaxhighlight>

Con todo esto, para verificar que todo funcione reiniciamos Apache y ejecutamos
<syntaxhighlight lang="bash" enclose="div">
curl --user registry:registry http://registry.local.siu/arai-registry/rest/packages/1
</syntaxhighlight>

Si la salida es:
<syntaxhighlight lang="bash" enclose="div">
{
"error": 404,
"mensaje": "404 Not Found",
"descripcion": "El paquete solicitado no existe"
}
</syntaxhighlight>
es que la instalación funcionó correctamente.

Con registry instalado procedemos a instalar Usuarios

==Arai-Usuarios==

Nos posicionamos en /usr/local/siu y clonamos el proyecto
<syntaxhighlight lang="bash" enclose="div">
cd /usr/local/siu
git clone --branch v1.2.0 https://hub.siu.edu.ar/siu-arai/arai-usuarios.git usuarios
cd usuarios
</syntaxhighlight>

Para instalar seguimos la documentación del archivo '''doc/INSTALACION_MANUAL.md'''
<syntaxhighlight lang="bash" enclose="div">
composer install --no-dev
</syntaxhighlight>

Configuramos las variables de entorno que va a usar el instalador, los valores que puse son válidos para mi instalación, deberán modificarlos según las necesidades de cada universidad.
Para la configuración de LDAP uso un servidor que ya está funcionando y configurado. El detalle de como configurar el servidor LDAP no pertenece a esta documentación.
La variable TOBA_USUARIO debe contener el mismo usuarios administrado del LDAP.
<syntaxhighlight lang="bash" enclose="div">
cp templates/arai-usuarios.env.dist arai-usuarios.env
nano arai-usuarios.env
</syntaxhighlight>

'''arai-usuarios.env.dist'''
<syntaxhighlight lang="apache" enclose="div">
###### CONFIG DEL INSTALADR ######
#INSTALADOR_TIMEOUT="360"
ENTORNO_PRODUCCION="1"

###### VARIABLES GLOBALES DEL ARCHIVO ######
ARAI_USUARIOS_DIR=/usr/local/siu/usuarios

###### CONFIG DE TOBA ######
TOBA_URL_BASE="https://usuarios.local.siu"
#TOBA_URL_PORT="443"
TOBA_USUARIO="admin"
TOBA_PASSWORD="admin1234"
TOBA_INSTALACION_DIR="${ARAI_USUARIOS_DIR}/instalacion"
TOBA_PROYECTO_DIR="${ARAI_USUARIOS_DIR}/gestion"
TOBA_INSTALAR_USUARIOS=false
TOBA_INSTALAR_EDITOR=false
TOBA_INSTALAR_REFERENCIA=false
TOBA_ALIAS_PROYECTO="/gestion"
TOBA_ALIAS_NUCLEO="/toba_gestion"
#TOBA_ID_DESARROLLADOR=0
#TOBA_SESSION_NAME="ARAI_SESSID"

###### CONFIG DE BASE DE DATOS DE NEGOCIO ######
PROYECTO_DB_HOST="172.27.31.114"
PROYECTO_DB_PORT="7432"
PROYECTO_DB_DBNAME="siu_usuarios"
PROYECTO_DB_USERNAME="postgres"
PROYECTO_DB_PASSWORD="postgres"
PROYECTO_DB_SCHEMA="usuarios"
PROYECTO_DB_ENCODING="LATIN1"

###### CONFIG DE BASE DE DATOS DE TOBA. #####
######## DEFINIR SI SE QUIERE UTILIZAR UNA BASE DISTINTA A LA DE NEGOCIO
#TOBA_DB_HOST="localhost"
#TOBA_DB_PORT="5432"
#TOBA_DB_DBNAME="instalador"
#TOBA_DB_USERNAME="postgres"
#TOBA_DB_PASSWORD="postgres"
#TOBA_DB_SCHEMA="public"

##### CONFIG IDM #####
ARAI_USUARIOS_URL_IDP=https://usuarios.local.siu/idp
## Deberá setearse si el sistema corre detrás de un proxy reverso
#ARAI_USUARIOS_PROXY_URL_IDP=http://url.arai-usuarios:80/idp
ARAI_USUARIOS_URL_PORTAL=https://huarpe.local.siu/portal
ARAI_USUARIOS_URL_PERFIL=https://huarpe.local.siu/perfil
ARAI_USUARIOS_URL_INSTITUCION=http://siu.edu.ar

ARAI_USUARIOS_SIGLA_INSTITUCION=SIGLA
ARAI_USUARIOS_EMAIL_SOPORTE=mail.soporte@institucion.edu.ar

##### CONFIG SEGURIDAD ####
SEGURIDAD_ALGORITMO_PASS=crypt
SEGURIDAD_LARGO_PASS=8
SEGURIDAD_INFO_PASS='El password debe tener al menos 8 caracteres, entre letras mayúsculas, minúsculas, números y símbolos, no pudiendo repetir caracteres adyacentes'
SEGURIDAD_DURACION_DIAS_PASS=120
SEGURIDAD_RECAPTCHA_SITIO=6Fd_pQwTAAAAAOEqJz6KJmkjsrXcdXrAjWQYggZf
SEGURIDAD_RECAPTCHA_CLAVE=6Fd_pQwTAAAAAOEqJz6KJmkjsrXcdXrAjWQYggZf
SEGURIDAD_INTENTOS_RECAPTCHA=3

##### CONFIG IDP #####
ARAI_USUARIOS_IDP_KEY_FILE=/certs/idp/certificado_idp.pem
ARAI_USUARIOS_IDP_CERT_FILE=/certs/idp/certificado_idp.crt
#ARAI_USUARIOS_IDP_LOG_LEVEL='WARNING'
#ARAI_USUARIOS_IDP_LOG_HANDLER='errorlog'

##### CONFIG MAIL RECOVERY ####
MAIL_RECOVERY_SUBJECT='Recuperar contraseña SIU-Arai'
MAIL_RECOVERY_FROM='noreply@institucion.edu.ar'
MAIL_RECOVERY_REPLYTO='noreply@institucion.edu.ar'
MAIL_RECOVERY_FROMNAME='Institución'

##### CONFIG LDAP #####
ARAI_USUARIOS_LDAP_HOST=172.27.31.114
ARAI_USUARIOS_LDAP_PORT=7389
ARAI_USUARIOS_LDAP_TLS=0
ARAI_USUARIOS_LDAP_METHOD=user
ARAI_USUARIOS_LDAP_BINDUSER="cn=admin,dc=siu,dc=cin,dc=edu"
ARAI_USUARIOS_LDAP_BINDPASS=admin
ARAI_USUARIOS_LDAP_SEARCHBASE="dc=siu,dc=cin,dc=edu"

##### CONFIG ARAI-REGISTRY #####
ARAI_REGISTRY_URL=http://registry.local.siu/arai-registry
ARAI_REGISTRY_USER=user
ARAI_REGISTRY_PASS=pass

###### CONFIG ENVIO MAILS (SMTP) ######
SMTP_ENTRADA="arai-usuarios"
SMTP_HELO="mail.unx.edu.ar"
SMTP_HOST="smtp.googlemail.com"
SMTP_PORT=587
SMTP_FROM ="yo@midominio.com"
SMTP_SEGURIDAD ="ssl|tls"
SMTP_AUTH ="1"
SMTP_USUARIO ="usuario"
SMTP_CLAVE ="pass"
</syntaxhighlight>

Una vez editado, verificamos que la configuración sea correcta
<syntaxhighlight lang="bash" enclose="div">
./bin/instalador proyecto:verificar -n
</syntaxhighlight>

Si no sale ninguna alerta, procedemos a instalar.
<syntaxhighlight lang="bash" enclose="div">
./bin/instalador proyecto:instalar
</syntaxhighlight>
Una vez instalado, modificamos los permisos de los archivos de la instalación con el comando
<syntaxhighlight lang="bash" enclose="div">
sudo ./bin/instalador permisos:simple
</syntaxhighlight>
Cambiamos el modo mantenimiento
<syntaxhighlight lang="bash" enclose="div">
./bin/instalador instalacion:modo-mantenimiento --sin-mantenimiento -n
</syntaxhighlight>

Luego configuramos Apache.
Lo mismo que con registry, como tengo toda la plataforma instalada en un mismo servidor, debo usar el '''ServerName "usuarios.local.siu"'''
En lugar de hacer un vinculo con '''alias.conf''' como dice la documentación, use un include dentro del tag VirtualHost. Así me quedo el archivo '''/etc/apache/sites-enabled/usuarios.conf'''

<syntaxhighlight lang="apache" enclose="div">
<VirtualHost *:80>
ServerName usuarios.local.siu
Redirect permanent / https://usuarios.local.siu/
</VirtualHost>

<VirtualHost *:443>

ServerName usuarios.local.siu

SSLEngine on
SSLCertificateFile /certs/usuarios.local.siu.cert.pem
SSLCertificateKeyFile /certs/usuarios.local.siu.key.pem

SSLCACertificateFile /certs/ca-chain.cert.pem

SSLVerifyClient optional_no_ca
SSLVerifyDepth 2
SSLProtocol all -SSLv2 -SSLv3
SSLOptions +StdEnvVars +ExportCertData
BrowserMatch "MSIE [2-6]" \
nokeepalive ssl-unclean-shutdown \
downgrade-1.0 force-response-1.0
# MSIE 7 and newer should be able to use keepalive
BrowserMatch "MSIE [17-9]" ssl-unclean-shutdown

Include /usr/local/siu/usuarios/instalacion/toba.conf

Include /usr/local/siu/usuarios/instalacion/idp.conf

</VirtualHost>
</syntaxhighlight>

Luego hay que hacer que nuestra CA autofirmada sea válida en el SO y así permitir que Apache verifique los certificados de clientes:
<syntaxhighlight lang="apache" enclose="div">
sudo cp /certs/ca.cert.pem /usr/share/ca-certificates/ca_propia.crt
sudo vim /etc/ca-certificates.conf
# agregar ca_propia.crt al final del archivo
update-ca-certificates --fresh
</syntaxhighlight>

Reiniciamos Apache y todo debería funcionar, para verificar entramos en la URL definida para usuarios, en mi caso https://usuarios.local.siu/gestion

Con todo esto funcionando el siguiente paso es agregar Usuarios a Registry y sincronizarlos.
Según esta instalación para agregar Usuarios al entorno hacemos
<syntaxhighlight lang="bash" enclose="div">
./bin/arai-cli registry:add --maintainer-email jpiazza@siu.edu.ar --maintainer jpiazza http://registry.local.siu/arai-registry
</syntaxhighlight>
y para sincronizarlo
<syntaxhighlight lang="bash" enclose="div">
./bin/arai-cli registry:sync
</syntaxhighlight>

== Arai-Huarpe ==

Es similar a las instalaciones anteriores.
<syntaxhighlight lang="bash" enclose="div">
cd /usr/local/siu
git clone --branch v1.1.0 https://hub.siu.edu.ar/siu-arai/huarpe-core.git huarpe
cd huarpe
</syntaxhighlight>

Para instalar seguimos la documentación del archivo '''doc/INSTALACION_MANUAL.md'''
<syntaxhighlight lang="bash" enclose="div">
composer install --no-dev
</syntaxhighlight>

Configuramos las variables de entorno que va a usar el instalador, los valores que puse son válidos para mi instalación, deberán modificarlos según las necesidades de cada universidad.
<syntaxhighlight lang="bash" enclose="div">
cp templates/huarpe.env.dist huarpe.env
nano huarpe.env
</syntaxhighlight>

'''huarpe.env'''
<syntaxhighlight lang="apache" enclose="div">
###### CONFIG DEL INSTALADR ######
#INSTALADOR_TIMEOUT="360"
ENTORNO_PRODUCCION=1

###### CONFIG DE SIU-HUARPE ######
HUARPE_PATH=/usr/local/siu/huarpe
HUARPE_URL=https://huarpe.local.siu
HUARPE_URL_PORT=443
HUARPE_SESSION_NAME=huarpe
HUARPE_SESSION_HANDLER="native_file"
#HUARPE_MEMCACHED_HOST=127.0.0.1
#HUARPE_MEMCACHED_PORT=11211
HUARPE_CERT_FILE=/certs/huarpe-cli.cert.pem
HUARPE_KEY_FILE=/certs/huarpe-cli.key.pem
#HUARPE_TOKEN=unt0k3n-al3at0r1o-s39ur0?
#HUARPE_PROXY=127.0.0.1
HUARPE_LOG_HANDLER="error_log"
HUARPE_LOG_LEVEL="WARNING"

###### CONFIG DE SIU-ARAI: REGISTRY ######
ARAI_REGISTRY_URL=http://registry.local.siu/arai-registry
ARAI_REGISTRY_USER=user
ARAI_REGISTRY_PASS=pass
</syntaxhighlight>

Una vez editado, verificamos que la configuración sea correcta
<syntaxhighlight lang="bash" enclose="div">
./bin/instalador proyecto:verificar
</syntaxhighlight>
Si no sale ninguna alerta, procedemos a instalar.
<syntaxhighlight lang="bash" enclose="div">
sudo ./bin/instalador proyecto:instalar
</syntaxhighlight>
En Synfony es necesario dumpear los estilos y los JS con el siguiente comando.
<syntaxhighlight lang="bash" enclose="div">
./bin/console assetic:dump --no-debug --env=prod
</syntaxhighlight>
Una vez instalado, modificamos los permisos de los archivos de la instalación con el comando
<syntaxhighlight lang="bash" enclose="div">
sudo ./bin/instalador permisos:simple
</syntaxhighlight>

=== Configuración apache ===
Lo mismo que con Registry o Usuarios, como tengo toda la plataforma instalada en un mismo servidor, debo usar el '''ServerName huarpe.local.siu'''.
En lugar de hacer un vinculo con alias.conf como dice la documentación, usé un include dentro del tag VirtualHost. Así me quedo el archivo /etc/apache/sites-enabled/huarpe.conf

<syntaxhighlight lang="apache" enclose="div">
<VirtualHost *:80>
ServerName huarpe.local.siu
Redirect permanent / https://huarpe.local.siu:443/
</VirtualHost>

<VirtualHost *:443>

ServerName huarpe.local.siu
SSLEngine on
SSLCertificateFile /certs/huarpe.local.siu.cert.pem
SSLCertificateKeyFile /certs/huarpe.local.siu.key.pem

Include /usr/local/siu/huarpe/app/config/alias.conf

</VirtualHost>
</syntaxhighlight>

Reiniciamos apache, antes de verificar la instalación, debemos sincronizar con Registry.
<syntaxhighlight lang="bash" enclose="div">
./bin/arai-cli registry:add --maintainer-email jpiazza@siu.edu.ar --maintainer jpiazza http://registry.local.siu/arai-registry
</syntaxhighlight>
Luego sincronizar
<syntaxhighlight lang="bash" enclose="div">
./bin/arai-cli registry:sync
</syntaxhighlight>

Hay que limpiar la cache y actualizar los permisos
<syntaxhighlight lang="bash" enclose="div">
./bin/console cache:clear --env=prod
sudo ./bin/instalador permisos:simple
</syntaxhighlight>

En Usuarios resincronizar para que se actualice con la nueva instalación
<syntaxhighlight lang="bash" enclose="div">
cd /usr/local/siu/usuarios
./bin/arai-cli registry:sync
</syntaxhighlight>

Para verificar que la instalación se realizo con éxito de debe ingresar en https://huarpe.local.siu/

Si todo salio bien, tenemos instalada la plataforma ARAI lista para ser usada en nuestro servidor.

SIU-Arai/Modulos/Pilaga

2017-09-13T19:24:30Z

Jpiazza: /* SIU-Pilaga */

SIU-Arai/Modulos/Pilaga

2017-09-13T18:10:01Z

Jpiazza: Página creada con «= SIU-Pilaga = SIU-Pilaga es el "Módulo económico financiero y contable" que permite realizar en forma integrada la gestión de presupuesto. Esté apartado está enfocado...»

SIU-Arai/ejemploPasoAPaso

2017-08-28T15:38:05Z

Jpiazza: /* Instalación Arai-Registy */

[[Archivo:siu-arai_iso.png|derecha|link=SIU-Arai]]

= Ejemplo paso a paso =

Para este caso voy a usar una instalación de Debian Jessie

El objetivo es tener una instalación funcionando de la paltaforma SIU-Arai que luego sirva para integrar otros sistemas toba.

Lo primero que defino es en que URL va a vivir cada sistemas, en mi caso lo tengo funcionando dentro de una intranet y los DNS que quedaron así

{| class="wikitable zebra"
!colspan="2"|URLs
|-
|Araí-Registry
|http://registry.local.siu
|-
|Araí-Usuarios
|https://usuarios.local.siu
|-
|Araí-Huarpe
|https://huarpe.local.siu
|}

== Creación de certificados ==
Hay que tener en cuenta que voy a usar conexión segura, por lo que tanto voy a necesitar certificados.
Para crear los certificados uso el tutorial que se encuentra en http://documentacion.siu.edu.ar/wiki/SIU-Arai/certificados.
Ese artículo asume
* Docker instalado (https://docs.docker.com/engine/installation/linux/docker-ce/debian/#install-using-the-repository).
* Docker Compose instalado (https://github.com/docker/compose/releases).

<syntaxhighlight lang="bash" enclose="div">
git clone https://hub.siu.edu.ar/siu/instaladores.git dockerCerts
</syntaxhighlight>

Editamos el archivo docker-compose según nuestras necesidades.

<syntaxhighlight lang="bash" enclose="div">
cd dockerCerts/certs
nano docker-compose.yml
</syntaxhighlight>

En mi caso quedo así:

<syntaxhighlight lang="apache" enclose="div">
certificados:
image: siutoba/docker-certs
container_name: docker-certs
#env_file: docker.env
environment:
DOCKER_NAME: certs
CA_PWD: pass
CA_INT_PWD: pass
LISTA_SERVER: huarpe.local.siu usuarios.local.siu
LISTA_CLIENTES: usuarios-cli huarpe-cli
volumes:
- ./data/certificados:/CAs/intermediate
- ./data/root:/CAs/rootCA

</syntaxhighlight>

Guardamos y generamos el container.
<syntaxhighlight lang="bash" enclose="div">
docker-compose up
</syntaxhighlight>

Una vez generado el container copiamos los certificados creados en la carpeta que nos sea mas cómodo, en mi caso /certs
Sin cambiar de directorio hacemos:
<syntaxhighlight lang="bash" enclose="div">
sudo mkdir /certs
sudo find data -name "*.pem" -exec cp {} /certs \;
</syntaxhighlight>

Luego generamos los certificados para el IDP:
<syntaxhighlight lang="bash" enclose="div">
mkdir /certs/idp
cd /certs/idp
openssl req -newkey rsa:2048 -new -x509 -days 3652 -nodes -out certificado_idp.crt -keyout certificado_idp.pem
</syntaxhighlight>

Listo, con las URL definidas y los certificados creados se puede proceder a instalar la plataforma.

== Instalación Arai-Registy ==
Creamos la carpeta '''/usr/local/siu''' y no posicionamos ahí
Clonamos el proyecto
<syntaxhighlight lang="bash" enclose="div">
git clone --branch v1.1.0 https://hub.siu.edu.ar/siu-arai/arai-registry.git registry
</syntaxhighlight>
Utilizamos GitFlow, la última versión estable del proyecto es apuntada por el branch master y por cada versión que se saca se crea un tag.

Dentro del directorio del proyecto encontramos el archivo "doc/INSTALACION MANUAL.md", la idea es seguir las instrucciones que encontramos en este archivo.
<syntaxhighlight lang="bash" enclose="div">
cd registry
composer install --no-dev
</syntaxhighlight>

Configuramos las variables de entorno que va a usar el instalador, los valores que puse son válidos para mi instalación, deberán modificarlos según las necesidades de cada universidad.
<syntaxhighlight lang="bash" enclose="div">
cp templates/arai-registry.env.dist arai-registry.env
nano arai-registry.env
</syntaxhighlight>

'''arai-registry.env'''
<syntaxhighlight lang="apache" enclose="div">
# config de la aplicacion
ARAI_REGISTRY_ALIAS="/arai-registry"
ARAI_REGISTRY_USER="user"
ARAI_REGISTRY_PASS="pass"

# config de la base de datos
ARAI_REGISTRY_DB_HOST="172.27.31.114"
ARAI_REGISTRY_DB_PORT="7432"
ARAI_REGISTRY_DB_DBNAME="siu_registry"
ARAI_REGISTRY_DB_USERNAME="postgres"
ARAI_REGISTRY_DB_PASSWORD="postgres"
ARAI_REGISTRY_DB_SCHEMA="registry"
ARAI_REGISTRY_DB_ENCODING="UTF8"

###### CONFIG DE LOGS ######
ARAI_REGISTRY_LOG_HANDLER="errorlog"
ARAI_REGISTRY_LOG_LEVEL="WARNING"

# config del instalador
INSTALADOR_TIMEOUT="360"
</syntaxhighlight>

Una vez editado, verificamos que la configuración sea correcta
<syntaxhighlight lang="bash" enclose="div">
sudo ./bin/instalador proyecto:verificar
</syntaxhighlight>

Si no sale ninguna alerta, procedemos a instalar.
<syntaxhighlight lang="bash" enclose="div">
./bin/instalador proyecto:instalar
</syntaxhighlight>
Una vez instalado, modificamos los permisos de los archivos de la instalación con el comando
<syntaxhighlight lang="bash" enclose="div">
sudo ./bin/instalador permisos:simple
</syntaxhighlight>

Luego configuramos apache.
En mi caso, como tengo toda la plataforma instalada en un mismo servidor, debo usar el '''ServerName "registry.local.siu"'''
En lugar de hacer un vinculo con '''alias.conf''' como dice la documentación, use un include dentro del tag VirtualHost. Así me quedo el archivo '''/etc/apache/sites-enabled/registry.conf'''

<syntaxhighlight lang="apache" enclose="div">
<VirtualHost *:80>
ServerName registry.local.siu
Include /usr/local/siu/registry/config/alias.conf
</VirtualHost>
</syntaxhighlight>

Con todo esto, para verificar que todo funcione reiniciamos Apache y ejecutamos
<syntaxhighlight lang="bash" enclose="div">
curl --user registry:registry http://registry.local.siu/arai-registry/rest/packages/1
</syntaxhighlight>

Si la salida es:
<syntaxhighlight lang="bash" enclose="div">
{
"error": 404,
"mensaje": "404 Not Found",
"descripcion": "El paquete solicitado no existe"
}
</syntaxhighlight>
es que la instalación funcionó correctamente.

Con registry instalado procedemos a instalar Usuarios

==Arai-Usuarios==

Nos posicionamos en /usr/local/siu y clonamos el proyecto
<syntaxhighlight lang="bash" enclose="div">
cd /usr/local/siu
git clone --branch v1.2.0 https://hub.siu.edu.ar/siu-arai/arai-usuarios.git usuarios
cd usuarios
</syntaxhighlight>

Para instalar seguimos la documentación del archivo '''doc/INSTALACION_MANUAL.md'''
<syntaxhighlight lang="bash" enclose="div">
composer install --no-dev
</syntaxhighlight>

Configuramos las variables de entorno que va a usar el instalador, los valores que puse son válidos para mi instalación, deberán modificarlos según las necesidades de cada universidad.
Para la configuración de LDAP uso un servidor que ya está funcionando y configurado. El detalle de como configurar el servidor LDAP no pertenece a esta documentación.
La variable TOBA_USUARIO debe contener el mismo usuarios administrado del LDAP.
<syntaxhighlight lang="bash" enclose="div">
cp templates/arai-usuarios.env.dist arai-usuarios.env
nano arai-usuarios.env
</syntaxhighlight>

'''arai-usuarios.env.dist'''
<syntaxhighlight lang="apache" enclose="div">
###### CONFIG DEL INSTALADR ######
#INSTALADOR_TIMEOUT="360"
ENTORNO_PRODUCCION="1"

###### VARIABLES GLOBALES DEL ARCHIVO ######
ARAI_USUARIOS_DIR=/usr/local/siu/usuarios

###### CONFIG DE TOBA ######
TOBA_URL_BASE="https://usuarios.local.siu"
#TOBA_URL_PORT="443"
TOBA_USUARIO="admin"
TOBA_PASSWORD="admin1234"
TOBA_INSTALACION_DIR="${ARAI_USUARIOS_DIR}/instalacion"
TOBA_PROYECTO_DIR="${ARAI_USUARIOS_DIR}/gestion"
TOBA_INSTALAR_USUARIOS=false
TOBA_INSTALAR_EDITOR=false
TOBA_INSTALAR_REFERENCIA=false
TOBA_ALIAS_PROYECTO="/gestion"
TOBA_ALIAS_NUCLEO="/toba_gestion"
#TOBA_ID_DESARROLLADOR=0
#TOBA_SESSION_NAME="ARAI_SESSID"

###### CONFIG DE BASE DE DATOS DE NEGOCIO ######
PROYECTO_DB_HOST="172.27.31.114"
PROYECTO_DB_PORT="7432"
PROYECTO_DB_DBNAME="siu_usuarios"
PROYECTO_DB_USERNAME="postgres"
PROYECTO_DB_PASSWORD="postgres"
PROYECTO_DB_SCHEMA="usuarios"
PROYECTO_DB_ENCODING="LATIN1"

###### CONFIG DE BASE DE DATOS DE TOBA. #####
######## DEFINIR SI SE QUIERE UTILIZAR UNA BASE DISTINTA A LA DE NEGOCIO
#TOBA_DB_HOST="localhost"
#TOBA_DB_PORT="5432"
#TOBA_DB_DBNAME="instalador"
#TOBA_DB_USERNAME="postgres"
#TOBA_DB_PASSWORD="postgres"
#TOBA_DB_SCHEMA="public"

##### CONFIG IDM #####
ARAI_USUARIOS_URL_IDP=https://usuarios.local.siu/idp
## Deberá setearse si el sistema corre detrás de un proxy reverso
#ARAI_USUARIOS_PROXY_URL_IDP=http://url.arai-usuarios:80/idp
ARAI_USUARIOS_URL_PORTAL=https://huarpe.local.siu/portal
ARAI_USUARIOS_URL_PERFIL=https://huarpe.local.siu/perfil
ARAI_USUARIOS_URL_INSTITUCION=http://siu.edu.ar

ARAI_USUARIOS_SIGLA_INSTITUCION=SIGLA
ARAI_USUARIOS_EMAIL_SOPORTE=mail.soporte@institucion.edu.ar

##### CONFIG SEGURIDAD ####
SEGURIDAD_ALGORITMO_PASS=crypt
SEGURIDAD_LARGO_PASS=8
SEGURIDAD_INFO_PASS='El password debe tener al menos 8 caracteres, entre letras mayúsculas, minúsculas, números y símbolos, no pudiendo repetir caracteres adyacentes'
SEGURIDAD_DURACION_DIAS_PASS=120
SEGURIDAD_RECAPTCHA_SITIO=6Fd_pQwTAAAAAOEqJz6KJmkjsrXcdXrAjWQYggZf
SEGURIDAD_RECAPTCHA_CLAVE=6Fd_pQwTAAAAAOEqJz6KJmkjsrXcdXrAjWQYggZf
SEGURIDAD_INTENTOS_RECAPTCHA=3

##### CONFIG IDP #####
ARAI_USUARIOS_IDP_KEY_FILE=/certs/idp/certificado_idp.pem
ARAI_USUARIOS_IDP_CERT_FILE=/certs/idp/certificado_idp.crt
#ARAI_USUARIOS_IDP_LOG_LEVEL='WARNING'
#ARAI_USUARIOS_IDP_LOG_HANDLER='errorlog'

##### CONFIG MAIL RECOVERY ####
MAIL_RECOVERY_SUBJECT='Recuperar contraseña SIU-Arai'
MAIL_RECOVERY_FROM='noreply@institucion.edu.ar'
MAIL_RECOVERY_REPLYTO='noreply@institucion.edu.ar'
MAIL_RECOVERY_FROMNAME='Institución'

##### CONFIG LDAP #####
ARAI_USUARIOS_LDAP_HOST=172.27.31.114
ARAI_USUARIOS_LDAP_PORT=7389
ARAI_USUARIOS_LDAP_TLS=0
ARAI_USUARIOS_LDAP_METHOD=user
ARAI_USUARIOS_LDAP_BINDUSER="cn=admin,dc=siu,dc=cin,dc=edu"
ARAI_USUARIOS_LDAP_BINDPASS=admin
ARAI_USUARIOS_LDAP_SEARCHBASE="dc=siu,dc=cin,dc=edu"

##### CONFIG ARAI-REGISTRY #####
ARAI_REGISTRY_URL=http://registry.local.siu/arai-registry
ARAI_REGISTRY_USER=user
ARAI_REGISTRY_PASS=pass

###### CONFIG ENVIO MAILS (SMTP) ######
SMTP_ENTRADA="arai-usuarios"
SMTP_HELO="mail.unx.edu.ar"
SMTP_HOST="smtp.googlemail.com"
SMTP_PORT=587
SMTP_FROM ="yo@midominio.com"
SMTP_SEGURIDAD ="ssl|tls"
SMTP_AUTH ="1"
SMTP_USUARIO ="usuario"
SMTP_CLAVE ="pass"
</syntaxhighlight>

Una vez editado, verificamos que la configuración sea correcta
<syntaxhighlight lang="bash" enclose="div">
./bin/instalador proyecto:verificar -n
</syntaxhighlight>

Si no sale ninguna alerta, procedemos a instalar.
<syntaxhighlight lang="bash" enclose="div">
./bin/instalador proyecto:instalar
</syntaxhighlight>
Una vez instalado, modificamos los permisos de los archivos de la instalación con el comando
<syntaxhighlight lang="bash" enclose="div">
sudo ./bin/instalador permisos:simple
</syntaxhighlight>
Cambiamos el modo mantenimiento
<syntaxhighlight lang="bash" enclose="div">
./bin/instalador instalacion:modo-mantenimiento --sin-mantenimiento -n
</syntaxhighlight>

Luego configuramos Apache.
Lo mismo que con registry, como tengo toda la plataforma instalada en un mismo servidor, debo usar el '''ServerName "usuarios.local.siu"'''
En lugar de hacer un vinculo con '''alias.conf''' como dice la documentación, use un include dentro del tag VirtualHost. Así me quedo el archivo '''/etc/apache/sites-enabled/usuarios.conf'''

<syntaxhighlight lang="apache" enclose="div">
<VirtualHost *:80>
ServerName usuarios.local.siu
Redirect permanent / https://usuarios.local.siu/
</VirtualHost>

<VirtualHost *:443>

ServerName usuarios.local.siu

SSLEngine on
SSLCertificateFile /certs/usuarios.local.siu.cert.pem
SSLCertificateKeyFile /certs/usuarios.local.siu.key.pem

SSLCACertificateFile /certs/ca-chain.cert.pem

SSLVerifyClient optional_no_ca
SSLVerifyDepth 2
SSLProtocol all -SSLv2 -SSLv3
SSLOptions +StdEnvVars +ExportCertData
BrowserMatch "MSIE [2-6]" \
nokeepalive ssl-unclean-shutdown \
downgrade-1.0 force-response-1.0
# MSIE 7 and newer should be able to use keepalive
BrowserMatch "MSIE [17-9]" ssl-unclean-shutdown

Include /usr/local/siu/usuarios/instalacion/toba.conf

Include /usr/local/siu/usuarios/instalacion/idp.conf

</VirtualHost>
</syntaxhighlight>

Luego hay que hacer que nuestra CA autofirmada sea válida en el SO y así permitir que Apache verifique los certificados de clientes:
<syntaxhighlight lang="apache" enclose="div">
sudo cp /certs/ca.cert.pem /usr/share/ca-certificates/ca_propia.crt
sudo vim /etc/ca-certificates.conf
# agregar ca_propia.crt al final del archivo
update-ca-certificates --fresh
</syntaxhighlight>

Reiniciamos Apache y todo debería funcionar, para verificar entramos en la URL definida para usuarios, en mi caso https://usuarios.local.siu/gestion

Con todo esto funcionando el siguiente paso es agregar Usuarios a Registry y sincronizarlos.
Según esta instalación para agregar Usuarios al entorno hacemos
<syntaxhighlight lang="bash" enclose="div">
./bin/arai-cli registry:add --maintainer-email jpiazza@siu.edu.ar --maintainer jpiazza http://registry.local.siu/arai-registry
</syntaxhighlight>
y para sincronizarlo
<syntaxhighlight lang="bash" enclose="div">
./bin/arai-cli registry:sync
</syntaxhighlight>

== Arai-Huarpe ==

Es similar a las instalaciones anteriores.
<syntaxhighlight lang="bash" enclose="div">
cd /usr/local/siu
git clone --branch v1.1.0 https://hub.siu.edu.ar/siu-arai/huarpe-core.git huarpe
cd huarpe
</syntaxhighlight>

Para instalar seguimos la documentación del archivo '''doc/INSTALACION_MANUAL.md'''
<syntaxhighlight lang="bash" enclose="div">
composer install --no-dev
</syntaxhighlight>

Configuramos las variables de entorno que va a usar el instalador, los valores que puse son válidos para mi instalación, deberán modificarlos según las necesidades de cada universidad.
<syntaxhighlight lang="bash" enclose="div">
cp templates/huarpe.env.dist huarpe.env
nano huarpe.env
</syntaxhighlight>

'''huarpe.env'''
<syntaxhighlight lang="apache" enclose="div">
###### CONFIG DEL INSTALADR ######
#INSTALADOR_TIMEOUT="360"
ENTORNO_PRODUCCION=1

###### CONFIG DE SIU-HUARPE ######
HUARPE_PATH=/usr/local/siu/huarpe
HUARPE_URL=https://huarpe.local.siu
HUARPE_URL_PORT=443
HUARPE_SESSION_NAME=huarpe
HUARPE_SESSION_HANDLER="native_file"
#HUARPE_MEMCACHED_HOST=127.0.0.1
#HUARPE_MEMCACHED_PORT=11211
HUARPE_CERT_FILE=/certs/huarpe-cli.cert.pem
HUARPE_KEY_FILE=/certs/huarpe-cli.key.pem
#HUARPE_TOKEN=unt0k3n-al3at0r1o-s39ur0?
#HUARPE_PROXY=127.0.0.1
HUARPE_LOG_HANDLER="error_log"
HUARPE_LOG_LEVEL="WARNING"

###### CONFIG DE SIU-ARAI: REGISTRY ######
ARAI_REGISTRY_URL=http://registry.local.siu/arai-registry
ARAI_REGISTRY_USER=user
ARAI_REGISTRY_PASS=pass
</syntaxhighlight>

Una vez editado, verificamos que la configuración sea correcta
<syntaxhighlight lang="bash" enclose="div">
./bin/instalador proyecto:verificar
</syntaxhighlight>
Si no sale ninguna alerta, procedemos a instalar.
<syntaxhighlight lang="bash" enclose="div">
sudo ./bin/instalador proyecto:instalar
</syntaxhighlight>
En Synfony es necesario dumpear los estilos y los JS con el siguiente comando.
<syntaxhighlight lang="bash" enclose="div">
./bin/console assetic:dump --no-debug
</syntaxhighlight>
Una vez instalado, modificamos los permisos de los archivos de la instalación con el comando
<syntaxhighlight lang="bash" enclose="div">
sudo ./bin/instalador permisos:simple
</syntaxhighlight>

=== Configuración apache ===
Lo mismo que con Registry o Usuarios, como tengo toda la plataforma instalada en un mismo servidor, debo usar el '''ServerName huarpe.local.siu'''.
En lugar de hacer un vinculo con alias.conf como dice la documentación, usé un include dentro del tag VirtualHost. Así me quedo el archivo /etc/apache/sites-enabled/huarpe.conf

<syntaxhighlight lang="apache" enclose="div">
<VirtualHost *:80>
ServerName huarpe.local.siu
Redirect permanent / https://huarpe.local.siu:443/
</VirtualHost>

<VirtualHost *:443>

ServerName huarpe.local.siu
SSLEngine on
SSLCertificateFile /certs/huarpe.local.siu.cert.pem
SSLCertificateKeyFile /certs/huarpe.local.siu.key.pem

Include /usr/local/siu/huarpe/app/config/alias.conf

</VirtualHost>
</syntaxhighlight>

Reiniciamos apache, antes de verificar la instalación, debemos sincronizar con Registry.
<syntaxhighlight lang="bash" enclose="div">
./bin/arai-cli registry:add --maintainer-email jpiazza@siu.edu.ar --maintainer jpiazza http://registry.local.siu/arai-registry
</syntaxhighlight>
Luego sincronizar
<syntaxhighlight lang="bash" enclose="div">
./bin/arai-cli registry:sync
</syntaxhighlight>

Hay que limpiar la cache y actualizar los permisos
<syntaxhighlight lang="bash" enclose="div">
./bin/console cache:clear --env=prod
sudo ./bin/instalador permisos:simple
</syntaxhighlight>

En Usuarios resincronizar para que se actualice con la nueva instalación
<syntaxhighlight lang="bash" enclose="div">
cd /usr/local/siu/usuarios
./bin/arai-cli registry:sync
</syntaxhighlight>

Para verificar que la instalación se realizo con éxito de debe ingresar en https://huarpe.local.siu/

Si todo salio bien, tenemos instalada la plataforma ARAI lista para ser usada en nuestro servidor.

SIU-Arai

2017-08-03T14:18:49Z

Jpiazza:

[[Archivo:siu-arai_iso.png|derecha|link=SIU-Arai]]
= SIU-Arai =
SIU-Araí es la plataforma integradora de servicios del SIU. Cada uno de los sistemas SIU son módulos dentro de la plataforma.

Existen dos módulos que son vitales para el funcionamiento de la plataforma.

* Arai-Registry: Repositorio central de servicios y aplicaciones
* Arai-Usuarios: IDP e IDM para toda la plataforma

== Forma de trabajo ==
Toda la distribución de los proyectos se hace a través de gitlab: [https://hub.siu.edu.ar https://hub.siu.edu.ar]. 
Cada uno de los módulos tiene una carpeta '''doc''' donde se incluyen instrucciones de instalación.

== Como instalar ==
Una vez completada la pre-instalación ya se puede seguir con la instalación de cada uno de los módulos.
# [http://documentacion.siu.edu.ar/wiki/SIU-Arai/preRequisitosArai Antes de instalar]
# Módulos
## [[SIU-Arai/registry|Arai-Registry]]
## [[SIU-Arai/usuarios|Arai-Usuarios]]
## [[SIU-Arai/huarpe|Huarpe]]: Módulo de autogestión de recursos y servicios. La cara visible de la plataforma para los usuarios..
# [http://documentacion.siu.edu.ar/wiki/SIU-Arai/ejemploPasoAPaso Ejemplo completo]

== Módulos ==
* [[SIU-Arai/catalogos-cliente|Arai-Catalogos (cliente)]]
* [[SIU-Arai/proveedores|Arai-Proveedores ]]

SIU-Arai

2017-08-03T14:16:46Z

Jpiazza: /* Pre Instalación */

[[Archivo:siu-arai_iso.png|derecha|link=SIU-Arai]]
= SIU-Arai =
SIU-Araí es la plataforma integradora de servicios del SIU. Cada uno de los sistemas SIU son módulos dentro de la plataforma.

Existen dos módulos que son vitales para el funcionamiento de la plataforma.

* Arai-Registry: Repositorio central de servicios y aplicaciones
* Arai-Usuarios: IDP e IDM para toda la plataforma

== Forma de trabajo ==
Toda la distribución de los proyectos se hace a través de gitlab: [https://hub.siu.edu.ar https://hub.siu.edu.ar]. 
Cada uno de los módulos tiene una carpeta '''doc''' donde se incluyen instrucciones de instalación.

== Instalación ==
Una vez completada la pre-instalación ya se puede seguir con la instalación de cada uno de los módulos.
# [[SIU-Arai/registry|Arai-Registry]]
# [[SIU-Arai/usuarios|Arai-Usuarios]]


== Módulos ==
* [[SIU-Arai/huarpe|Huarpe]]: Módulo de autogestión de recursos y servicios. La cara visible de la plataforma para los usuarios..
* [[SIU-Arai/catalogos-cliente|Arai-Catalogos (cliente)]]
* [[SIU-Arai/proveedores|Arai-Proveedores ]]

SIU-Arai/Prerequisitos

2017-08-03T14:05:49Z

Jpiazza: Página creada con «== Pre Instalación == Antes de comenzar con la instalación es necesario contar con un mapa del deploy que se quiere realizar. Hacer esto es muy importante para que el des...»

== Pre Instalación ==
Antes de comenzar con la instalación es necesario contar con un mapa del deploy que se quiere realizar. Hacer esto es muy importante para que el despliegue sea exitoso.
=== Que se va a instalar? ===
* Araí-Registry
* Araí-Usuarios
** Un IdP
** Un módulo de gestión de identidad (IdM)
* Araí-Huarpe
=== Que necesitamos? ===
==== Definir URLs ====
Este paso es muy importante, ya que las URLs terminan en la configuración de la instalación de los sistemas. Recomendamos confeccionar una lista como la siguiente:
{| class="wikitable zebra"
!colspan="3"|URLs
|-
|Araí-Registry
|http://localhost/registry
|Este servicio no tiene que ser público
|-
|Araí-Usuarios IdP
|https://idp.arai-usuarios
|Este servicio es público, por eso está con TLS
|-
|Araí-Usuarios IdM
|https://arai-usuarios
|Este servicio es público, por eso está con TLS
|-
|Araí-Huarpe
|https://huarpe
|Este servicio es público, por eso está con TLS
|}
==== Certificados, certificados, certificados ... ====
El uso de certificados es extensivo a través de toda la plataforma.

Se usan con tres fines:
* Para utilizar HTTPS en los servicios públicos y autenticar clientes de las APIs
* Para firmar el token de SAML

Antes de continuar con la instalación debe generar los certificados necesarios.
===== HTTPS y autenticación de clientes =====
Para una instalación de producción es necesario contar con certificados reales válidos.

Si su institución no cuenta con estos certificados son fáciles de obtener con este servicio [https://letsencrypt.org/ Let's Encrypt].

Los certificados de cliente pueden ser auto-firmados porque son para uso interno.

Más información en [[SIU-Arai/certificados|Certificados]]

===== Token SAML =====
Actualmente, el IDP no soporta el uso de certificados con una cadenas de certificados o validación extendida. Tampoco soporta algoritmos tipo `DSA`, sólo `RSA`. Por lo general, con certificados autofirmados puede ser suficiente, de acuerdo a la [https://simplesamlphp.org/docs/stable/simplesamlphp-idp#section_4 documentación]. Es posible, entonces, generar certificados autofirmados de la siguiente forma:

openssl req -newkey rsa:2048 -new -x509 -days 3652 -nodes -out certificado.crt -keyout certificado.pem

Esto genera dos archivos: la clave pública `certificado.crt` y la clave privada `certificado.pem` para ser utilizadas en la instalación y configuración del IDP.

=== Seguridad ===
Todo el esquema de seguridad de la plataforma asume que todos los servicios están corriendo sobre conexiones aseguradas con TLS/SSL. Los sistemas fueron desarrollados utilizando SSL en todas las pruebas.

No hay garantías de funcionamiento o seguridad sin TLS/SSL. Aquí hay una [[SIU-Arai/apache-ssl|guía mínima]] de como configurar Apache con SSL.

SIU-Arai/ejemploPasoAPaso

2017-08-02T16:08:23Z

Jpiazza: /* Arai-Huarpe */

== Ejemplo paso a paso ==

Para este caso voy a usar una instalación de Debian Jessie

El objetivo es tener una instalación funcionando de la paltaforma SIU-Arai que luego sirva para integrar otros sistemas toba.

Lo primero que defino es en que URL va a vivir cada sistemas, en mi caso lo tengo funcionando dentro de una intranet y los DNS que quedaron así

{| class="wikitable zebra"
!colspan="2"|URLs
|-
|Araí-Registry
|https://usuarios.local.siu
|-
|Araí-Usuarios
|https://huarpe.local.siu
|-
|Araí-Huarpe
|https://huarpe
|}

Hay que tener en cuenta que voy a usar conexión segura, por lo que tanto voy a necesitar certificados.
Para crear los certificados uso el tutorial que se encuentra en http://documentacion.siu.edu.ar/wiki/SIU-Arai/certificados

<syntaxhighlight lang="bash" enclose="div">
cd
git clone https://gitlab.siu.edu.ar/siu/instaladores.git dockerCerts
</syntaxhighlight>

Editamos el archivo docker-compose según nuestras necesidades.

<syntaxhighlight lang="bash" enclose="div">
cd dockerCerts/certs
nano docker-compose.yml
</syntaxhighlight>

En mi caso quedo así:

<syntaxhighlight lang="apache" enclose="div">
certificados:
image: siutoba/docker-certs
container_name: docker-certs 
#env_file: docker.env 
environment: 
DOCKER_NAME: certs 
CA_PWD: pass 
CA_INT_PWD: pass 
LISTA_SERVER: huarpe.local.siu usuarios.local.siu 
LISTA_CLIENTES: usuarios-cli huarpe-cli 
volumes: 
- ./data/certificados:/CAs/intermediate 
- ./data/root:/CAs/rootCA 

</syntaxhighlight>

Guardamos y generamos el container.
<syntaxhighlight lang="bash" enclose="div">
docker-compose up
</syntaxhighlight>

Una vez generado el container copiamos los certificados creados en la carpeta que nos sea mas cómodo, en mi caso /certs
Sin cambiar de directorio hacemos:
<syntaxhighlight lang="bash" enclose="div">
sudo mkdir /certs
sudo find data -name "*.pem" -exec cp {} /certs \;
</syntaxhighlight>

Luego generamos los certificados para el IDP:
<syntaxhighlight lang="bash" enclose="div">
mkdir /certs/idp
cd /certs/idp
openssl req -newkey rsa:2048 -new -x509 -days 3652 -nodes -out certificado_idp.crt -keyout certificado_idp.pem
</syntaxhighlight>

Listo, con las URL definidas y los certificados creados se puede proceder a instalar la plataforma.

===Arai-Registy.===
Creamos la carpeta /user/local/siu y no posicionamos ahí
Clonamos el proyecto en la versión deseada, en este caso v1.0.1
<syntaxhighlight lang="bash" enclose="div">
git clone --branch v1.1.0 https://hub.siu.edu.ar/siu-arai/arai-registry.git registry
</syntaxhighlight>

Dentro del directorio del proyecto encontramos el archivo "doc/INSTALACION MANUAL.md", la idea es seguir las instrucciones que encontramos en este archivo.
<syntaxhighlight lang="bash" enclose="div">
cd registry
composer install --no-dev
</syntaxhighlight>

Configuramos las variables de entorno que va a usar el instalador, los valores que puse son válidos para mi instalación, deberán modificarlos según las necesidades de cada universidad.
<syntaxhighlight lang="bash" enclose="div">
cp templates/arai-registry.env.dist arai-registry.env
nano arai-registry.env
</syntaxhighlight>

'''arai-registry.env'''
<syntaxhighlight lang="apache" enclose="div">
# config de la aplicacion
ARAI_REGISTRY_ALIAS="/arai-registry"
ARAI_REGISTRY_USER="user"
ARAI_REGISTRY_PASS="pass"

# config de la base de datos
ARAI_REGISTRY_DB_HOST="172.27.31.114"
ARAI_REGISTRY_DB_PORT="7432"
ARAI_REGISTRY_DB_DBNAME="siu_registry"
ARAI_REGISTRY_DB_USERNAME="postgres"
ARAI_REGISTRY_DB_PASSWORD="postgres"
ARAI_REGISTRY_DB_SCHEMA="registry"
ARAI_REGISTRY_DB_ENCODING="UTF8"

###### CONFIG DE LOGS ######
ARAI_REGISTRY_LOG_HANDLER="errorlog"
ARAI_REGISTRY_LOG_LEVEL="DEBUG"

# config del instalador
INSTALADOR_TIMEOUT="360"
</syntaxhighlight>

Una vez editado, verificamos que la configuración sea correcta
<syntaxhighlight lang="bash" enclose="div">
./bin/instalador proyecto:verificar
</syntaxhighlight>

Si no sale ninguna alerta, procedemos a instalar.
<syntaxhighlight lang="bash" enclose="div">
./bin/instalador proyecto:instalar
</syntaxhighlight>
Una vez instalado, modificamos los permisos de los archivos de la instalación con el comando
<syntaxhighlight lang="bash" enclose="div">
./bin/instalador permisos:simple
</syntaxhighlight>

Luego configuramos apache.
En mi caso, como tengo toda la plataforma instalada en un mismo servidor, debo usar el '''ServerName "registry.local.siu"'''
En lugar de hacer un vinculo con '''alias.conf''' como dice la documentación, use un include dentro del tag VirtualHost. Así me quedo el archivo '''/etc/apache/sites-enabled/registry.conf'''

<syntaxhighlight lang="apache" enclose="div">
<VirtualHost *:80>
ServerName registry.local.siu
Include /usr/local/siu/registry/config/alias.conf
</VirtualHost>
</syntaxhighlight>

Con todo esto, para verificar que todo funcione reiniciamos Apache y accedemos a la web http://registry.local.siu/arai-registry/rest (en mi caso), si todo va bien veremos una página web con los servicios disponibles.

Con registry instalado procedemos a instalar Usuarios

===Arai-Usuarios===

Nos posicionamos en /usr/local/siu y clonamos el proyecto
<syntaxhighlight lang="bash" enclose="div">
cd /usr/local/siu
git clone --branch v1.2.0 https://hub.siu.edu.ar/siu-arai/arai-usuarios.git usuarios
cd usuarios
</syntaxhighlight>

Para instalar segumos la documentación del archivo '''doc/INSTALACION_MANUAL.md'''
<syntaxhighlight lang="bash" enclose="div">
composer install --no-dev
</syntaxhighlight>

Configuramos las variables de entorno que va a usar el instalador, los valores que puse son válidos para mi instalación, deberán modificarlos según las necesidades de cada universidad.
Para la configuración de LDAP uso un servidor que ya está funcionando y configurado. El detalle de como configurar el servidor LDAP no pertenece a esta documentación.
La variable TOBA_USUARIO debe contener el mismo usuarios administrado del LDAP.
<syntaxhighlight lang="bash" enclose="div">
cp templates/arai-usuarios.env.dist arai-usuarios.env
nano arai-usuarios.env
</syntaxhighlight>

'''arai-usuarios.env.dist'''
<syntaxhighlight lang="apache" enclose="div">
###### CONFIG DEL INSTALADR ######
#INSTALADOR_TIMEOUT="360"
ENTORNO_PRODUCCION="1"

###### VARIABLES GLOBALES DEL ARCHIVO ######
ARAI_USUARIOS_DIR=/usr/local/siu/usuarios

###### CONFIG DE TOBA ######
TOBA_URL_BASE="https://usuarios.local.siu"
TOBA_URL_PORT="443"
TOBA_USUARIO="admin"
TOBA_PASSWORD="admin1234"
TOBA_INSTALACION_DIR="${ARAI_USUARIOS_DIR}/instalacion"
TOBA_PROYECTO_DIR="${ARAI_USUARIOS_DIR}/gestion"
TOBA_INSTALAR_USUARIOS=false
TOBA_INSTALAR_EDITOR=false
TOBA_INSTALAR_REFERENCIA=false
TOBA_ALIAS_PROYECTO="/gestion"
TOBA_ALIAS_NUCLEO="/toba_gestion"
#TOBA_ID_DESARROLLADOR=0
#TOBA_SESSION_NAME="ARAI_SESSID"

###### CONFIG DE BASE DE DATOS DE NEGOCIO ######
PROYECTO_DB_HOST="172.27.31.114"
PROYECTO_DB_PORT="7432"
PROYECTO_DB_DBNAME="siu_usuarios"
PROYECTO_DB_USERNAME="postgres"
PROYECTO_DB_PASSWORD="postgres"
PROYECTO_DB_SCHEMA="usuarios"

###### CONFIG DE BASE DE DATOS DE TOBA. #####
######## DEFINIR SI SE QUIERE UTILIZAR UNA BASE DISTINTA A LA DE NEGOCIO
#TOBA_DB_HOST="localhost"
#TOBA_DB_PORT="5432"
#TOBA_DB_DBNAME="instalador"
#TOBA_DB_USERNAME="postgres"
#TOBA_DB_PASSWORD="postgres"
#TOBA_DB_SCHEMA="public"

##### CONFIG IDM #####
ARAI_USUARIOS_URL_IDP=https://usuarios.local.siu/idp
## Deberá setearse si el sistema corre detrás de un proxy reverso
#ARAI_USUARIOS_PROXY_URL_IDP=http://url.arai-usuarios:80/idp
ARAI_USUARIOS_URL_PORTAL=https://huarpe.local.siu/portal
ARAI_USUARIOS_URL_PERFIL=https://huarpe.local.siu/perfil
ARAI_USUARIOS_URL_INSTITUCION=http://siu.edu.ar

ARAI_USUARIOS_SIGLA_INSTITUCION=SIGLA
ARAI_USUARIOS_EMAIL_SOPORTE=mail.soporte@institucion.edu.ar

##### CONFIG SEGURIDAD ####
SEGURIDAD_ALGORITMO_PASS=crypt
SEGURIDAD_LARGO_PASS=8
SEGURIDAD_INFO_PASS='El password debe tener al menos 8 caracteres, entre letras mayúsculas, minúsculas, números y símbolos, no pudiendo repetir caracteres adyacentes'
SEGURIDAD_DURACION_DIAS_PASS=120
SEGURIDAD_RECAPTCHA_SITIO=6Fd_pQwTAAAAAOEqJz6KJmkjsrXcdXrAjWQYggZf
SEGURIDAD_RECAPTCHA_CLAVE=6Fd_pQwTAAAAAOEqJz6KJmkjsrXcdXrAjWQYggZf
SEGURIDAD_INTENTOS_RECAPTCHA=3

##### CONFIG IDP #####
ARAI_USUARIOS_IDP_KEY_FILE=/certs/idp/certificado_idp.pem
ARAI_USUARIOS_IDP_CERT_FILE=/certs/idp/certificado_idp.crt
#ARAI_USUARIOS_IDP_LOG_LEVEL='WARNING'
#ARAI_USUARIOS_IDP_LOG_HANDLER='errorlog'

##### CONFIG MAIL RECOVERY ####
MAIL_RECOVERY_SUBJECT='Recuperar contraseña SIU-Arai'
MAIL_RECOVERY_FROM='noreply@institucion.edu.ar'
MAIL_RECOVERY_REPLYTO='noreply@institucion.edu.ar'
MAIL_RECOVERY_FROMNAME='Institución'

##### CONFIG LDAP #####
ARAI_USUARIOS_LDAP_HOST=172.27.31.114
ARAI_USUARIOS_LDAP_PORT=7389
ARAI_USUARIOS_LDAP_TLS=0
ARAI_USUARIOS_LDAP_METHOD=user
ARAI_USUARIOS_LDAP_BINDUSER="cn=admin,dc=siu,dc=cin,dc=edu"
ARAI_USUARIOS_LDAP_BINDPASS=admin
ARAI_USUARIOS_LDAP_SEARCHBASE="dc=siu,dc=cin,dc=edu"

##### CONFIG ARAI-REGISTRY #####
ARAI_REGISTRY_URL=http://registry.local.siu/arai-registry
ARAI_REGISTRY_USER=user
ARAI_REGISTRY_PASS=pass

###### CONFIG ENVIO MAILS (SMTP) ######
SMTP_ENTRADA="arai-usuarios"
SMTP_HELO="mail.unx.edu.ar"
SMTP_HOST="smtp.googlemail.com"
SMTP_PORT=587
SMTP_FROM ="yo@midominio.com"
SMTP_SEGURIDAD ="ssl|tls"
SMTP_AUTH ="1"
SMTP_USUARIO ="usuario"
SMTP_CLAVE ="pass"
</syntaxhighlight>

Una vez editado, verificamos que la configuración sea correcta
<syntaxhighlight lang="bash" enclose="div">
./bin/instalador proyecto:verificar
</syntaxhighlight>

Si no sale ninguna alerta, procedemos a instalar.
<syntaxhighlight lang="bash" enclose="div">
./bin/instalador proyecto:instalar
</syntaxhighlight>
Una vez instalado, modificamos los permisos de los archivos de la instalación con el comando
<syntaxhighlight lang="bash" enclose="div">
./bin/instalador permisos:simple
</syntaxhighlight>
Cambiamos el modo mantenimiento
<syntaxhighlight lang="bash" enclose="div">
./bin/instalador instalacion:modo-mantenimiento --sin-mantenimiento
</syntaxhighlight>

Luego configuramos Apache.
Lo mismo que con registry, como tengo toda la plataforma instalada en un mismo servidor, debo usar el '''ServerName "usuarios.local.siu"'''
En lugar de hacer un vinculo con '''alias.conf''' como dice la documentación, use un include dentro del tag VirtualHost. Así me quedo el archivo '''/etc/apache/sites-enabled/usuarios.conf'''

<syntaxhighlight lang="apache" enclose="div">
<VirtualHost *:80>
ServerName usuarios.local.siu
Redirect permanent / https://usuarios.local.siu/
</VirtualHost>

<VirtualHost *:443>

ServerName usuarios.local.siu

SSLEngine on
SSLCertificateFile /certs/usuarios.local.siu.cert.pem
SSLCertificateKeyFile /certs/usuarios.local.siu.key.pem

Include /usr/local/siu/usuarios/instalacion/toba.conf

Include /usr/local/siu/usuarios/instalacion/idp.conf

</VirtualHost>
</syntaxhighlight>

Reiniciamos Apache y todo debería funcionar, para verificar entramos en la URL definida para usuarios, en mi caso https://usuarios.local.siu/gestion

Con todo esto funcionando el siguiente paso es agregar Usuarios a Registry y sincronizarlos.
Según esta instalación para agregar Usuarios al entorno hacemos
<syntaxhighlight lang="bash" enclose="div">
./bin/arai-cli registry:add --maintainer-email jpiazza@siu.edu.ar --maintainer jpiazza http://registry.local.siu/arai-registry
</syntaxhighlight>
y para sincronizarlo
<syntaxhighlight lang="bash" enclose="div">
./bin/arai-cli registry:sync
</syntaxhighlight>

===Arai-Huarpe===

Es similar a las instalaciones anteriores.
<syntaxhighlight lang="bash" enclose="div">
cd /usr/local/siu
git clone --branch v1.1.0 https://hub.siu.edu.ar/siu-arai/huarpe-core.git huarpe
cd huarpe
</syntaxhighlight>

Para instalar seguimos la documentación del archivo '''doc/INSTALACION_MANUAL.md'''
<syntaxhighlight lang="bash" enclose="div">
composer install --no-dev
</syntaxhighlight>

Configuramos las variables de entorno que va a usar el instalador, los valores que puse son válidos para mi instalación, deberán modificarlos según las necesidades de cada universidad.
<syntaxhighlight lang="bash" enclose="div">
cp templates/huarpe.env.dist huarpe.env
nano huarpe.env
</syntaxhighlight>

'''huarpe.env'''
<syntaxhighlight lang="apache" enclose="div">
###### CONFIG DEL INSTALADR ######
#INSTALADOR_TIMEOUT="360"
ENTORNO_PRODUCCION=1

###### CONFIG DE SIU-HUARPE ######
HUARPE_PATH=/usr/local/siu/huarpe
HUARPE_URL=https://huarpe.local.siu
HUARPE_URL_PORT=443
HUARPE_SESSION_NAME=huarpe
HUARPE_SESSION_HANDLER="native_file"
#HUARPE_MEMCACHED_HOST=127.0.0.1
#HUARPE_MEMCACHED_PORT=11211
HUARPE_CERT_FILE=/certs/huarpe-cli.cert.pem
HUARPE_KEY_FILE=/certs/huarpe-cli.key.pem
#HUARPE_TOKEN=unt0k3n-al3at0r1o-s39ur0?
#HUARPE_PROXY=127.0.0.1
HUARPE_LOG_HANDLER="error_log"
HUARPE_LOG_LEVEL="DEBUG"

###### CONFIG DE SIU-ARAI: REGISTRY ######
ARAI_REGISTRY_URL=http://registry.local.siu/arai-registry
ARAI_REGISTRY_USER=user
ARAI_REGISTRY_PASS=pass
</syntaxhighlight>

Una vez editado, verificamos que la configuración sea correcta
<syntaxhighlight lang="bash" enclose="div">
./bin/instalador proyecto:verificar
</syntaxhighlight>
Si no sale ninguna alerta, procedemos a instalar.
<syntaxhighlight lang="bash" enclose="div">
./bin/instalador proyecto:instalar
</syntaxhighlight>
En Synfony es necesario dumpear los estilos y los JS con el siguiente comando.
<syntaxhighlight lang="bash" enclose="div">
./bin/console assetic:dump --no-debug
</syntaxhighlight>
Una vez instalado, modificamos los permisos de los archivos de la instalación con el comando
<syntaxhighlight lang="bash" enclose="div">
./bin/instalador permisos:simple
</syntaxhighlight>

Configuramos apache.
Lo mismo que con registry u usuarios, como tengo toda la plataforma instalada en un mismo servidor, debo usar el '''ServerName huarpe.local.siu'''.
En lugar de hacer un vinculo con alias.conf como dice la documentación, usé un include dentro del tag VirtualHost. Así me quedo el archivo /etc/apache/sites-enabled/huarpe.conf

<syntaxhighlight lang="apache" enclose="div">
<VirtualHost *:80>
ServerName huarpe.local.siu
Redirect permanent / https://huarpe.local.siu:443/
</VirtualHost>

<VirtualHost *:443>

ServerName huarpe.local.siu
SSLEngine on
SSLCertificateFile /certs/huarpe.local.siu.cert.pem
SSLCertificateKeyFile /certs/huarpe.local.siu.key.pem

Include /usr/local/siu/huarpe/app/config/alias.conf

</VirtualHost>
</syntaxhighlight>

Reiniciamos apache, antes de verificar la instalación, debemos sincronizar con Registry.
<syntaxhighlight lang="bash" enclose="div">
./bin/arai-cli registry:add --maintainer-email jpiazza@siu.edu.ar --maintainer jpiazza http://registry.local.siu/arai-registry
</syntaxhighlight>
Luego sincronizar
<syntaxhighlight lang="bash" enclose="div">
./bin/arai-cli registry:sync
</syntaxhighlight>
Si el archivo no tiene permisos de ejecución
<syntaxhighlight lang="bash" enclose="div">
chmod +x ./vendor/bin/arai-cli
</syntaxhighlight>
y repetir los dos pasos anteriores.

Para verificar que la instalación se realizo con éxito de debe ingresar en https://huarpe.local.siu/

Si todo salio bien, tenemos instalada la plataforma ARAI lista para ser usada en nuestro servidor.

SIU-Arai/ejemploPasoAPaso

2017-08-02T16:05:12Z

Jpiazza:

== Ejemplo paso a paso ==

Para este caso voy a usar una instalación de Debian Jessie

El objetivo es tener una instalación funcionando de la paltaforma SIU-Arai que luego sirva para integrar otros sistemas toba.

Lo primero que defino es en que URL va a vivir cada sistemas, en mi caso lo tengo funcionando dentro de una intranet y los DNS que quedaron así

{| class="wikitable zebra"
!colspan="2"|URLs
|-
|Araí-Registry
|https://usuarios.local.siu
|-
|Araí-Usuarios
|https://huarpe.local.siu
|-
|Araí-Huarpe
|https://huarpe
|}

Hay que tener en cuenta que voy a usar conexión segura, por lo que tanto voy a necesitar certificados.
Para crear los certificados uso el tutorial que se encuentra en http://documentacion.siu.edu.ar/wiki/SIU-Arai/certificados

<syntaxhighlight lang="bash" enclose="div">
cd
git clone https://gitlab.siu.edu.ar/siu/instaladores.git dockerCerts
</syntaxhighlight>

Editamos el archivo docker-compose según nuestras necesidades.

<syntaxhighlight lang="bash" enclose="div">
cd dockerCerts/certs
nano docker-compose.yml
</syntaxhighlight>

En mi caso quedo así:

<syntaxhighlight lang="apache" enclose="div">
certificados:
image: siutoba/docker-certs
container_name: docker-certs 
#env_file: docker.env 
environment: 
DOCKER_NAME: certs 
CA_PWD: pass 
CA_INT_PWD: pass 
LISTA_SERVER: huarpe.local.siu usuarios.local.siu 
LISTA_CLIENTES: usuarios-cli huarpe-cli 
volumes: 
- ./data/certificados:/CAs/intermediate 
- ./data/root:/CAs/rootCA 

</syntaxhighlight>

Guardamos y generamos el container.
<syntaxhighlight lang="bash" enclose="div">
docker-compose up
</syntaxhighlight>

Una vez generado el container copiamos los certificados creados en la carpeta que nos sea mas cómodo, en mi caso /certs
Sin cambiar de directorio hacemos:
<syntaxhighlight lang="bash" enclose="div">
sudo mkdir /certs
sudo find data -name "*.pem" -exec cp {} /certs \;
</syntaxhighlight>

Luego generamos los certificados para el IDP:
<syntaxhighlight lang="bash" enclose="div">
mkdir /certs/idp
cd /certs/idp
openssl req -newkey rsa:2048 -new -x509 -days 3652 -nodes -out certificado_idp.crt -keyout certificado_idp.pem
</syntaxhighlight>

Listo, con las URL definidas y los certificados creados se puede proceder a instalar la plataforma.

===Arai-Registy.===
Creamos la carpeta /user/local/siu y no posicionamos ahí
Clonamos el proyecto en la versión deseada, en este caso v1.0.1
<syntaxhighlight lang="bash" enclose="div">
git clone --branch v1.1.0 https://hub.siu.edu.ar/siu-arai/arai-registry.git registry
</syntaxhighlight>

Dentro del directorio del proyecto encontramos el archivo "doc/INSTALACION MANUAL.md", la idea es seguir las instrucciones que encontramos en este archivo.
<syntaxhighlight lang="bash" enclose="div">
cd registry
composer install --no-dev
</syntaxhighlight>

Configuramos las variables de entorno que va a usar el instalador, los valores que puse son válidos para mi instalación, deberán modificarlos según las necesidades de cada universidad.
<syntaxhighlight lang="bash" enclose="div">
cp templates/arai-registry.env.dist arai-registry.env
nano arai-registry.env
</syntaxhighlight>

'''arai-registry.env'''
<syntaxhighlight lang="apache" enclose="div">
# config de la aplicacion
ARAI_REGISTRY_ALIAS="/arai-registry"
ARAI_REGISTRY_USER="user"
ARAI_REGISTRY_PASS="pass"

# config de la base de datos
ARAI_REGISTRY_DB_HOST="172.27.31.114"
ARAI_REGISTRY_DB_PORT="7432"
ARAI_REGISTRY_DB_DBNAME="siu_registry"
ARAI_REGISTRY_DB_USERNAME="postgres"
ARAI_REGISTRY_DB_PASSWORD="postgres"
ARAI_REGISTRY_DB_SCHEMA="registry"
ARAI_REGISTRY_DB_ENCODING="UTF8"

###### CONFIG DE LOGS ######
ARAI_REGISTRY_LOG_HANDLER="errorlog"
ARAI_REGISTRY_LOG_LEVEL="DEBUG"

# config del instalador
INSTALADOR_TIMEOUT="360"
</syntaxhighlight>

Una vez editado, verificamos que la configuración sea correcta
<syntaxhighlight lang="bash" enclose="div">
./bin/instalador proyecto:verificar
</syntaxhighlight>

Si no sale ninguna alerta, procedemos a instalar.
<syntaxhighlight lang="bash" enclose="div">
./bin/instalador proyecto:instalar
</syntaxhighlight>
Una vez instalado, modificamos los permisos de los archivos de la instalación con el comando
<syntaxhighlight lang="bash" enclose="div">
./bin/instalador permisos:simple
</syntaxhighlight>

Luego configuramos apache.
En mi caso, como tengo toda la plataforma instalada en un mismo servidor, debo usar el '''ServerName "registry.local.siu"'''
En lugar de hacer un vinculo con '''alias.conf''' como dice la documentación, use un include dentro del tag VirtualHost. Así me quedo el archivo '''/etc/apache/sites-enabled/registry.conf'''

<syntaxhighlight lang="apache" enclose="div">
<VirtualHost *:80>
ServerName registry.local.siu
Include /usr/local/siu/registry/config/alias.conf
</VirtualHost>
</syntaxhighlight>

Con todo esto, para verificar que todo funcione reiniciamos Apache y accedemos a la web http://registry.local.siu/arai-registry/rest (en mi caso), si todo va bien veremos una página web con los servicios disponibles.

Con registry instalado procedemos a instalar Usuarios

===Arai-Usuarios===

Nos posicionamos en /usr/local/siu y clonamos el proyecto
<syntaxhighlight lang="bash" enclose="div">
cd /usr/local/siu
git clone --branch v1.2.0 https://hub.siu.edu.ar/siu-arai/arai-usuarios.git usuarios
cd usuarios
</syntaxhighlight>

Para instalar segumos la documentación del archivo '''doc/INSTALACION_MANUAL.md'''
<syntaxhighlight lang="bash" enclose="div">
composer install --no-dev
</syntaxhighlight>

Configuramos las variables de entorno que va a usar el instalador, los valores que puse son válidos para mi instalación, deberán modificarlos según las necesidades de cada universidad.
Para la configuración de LDAP uso un servidor que ya está funcionando y configurado. El detalle de como configurar el servidor LDAP no pertenece a esta documentación.
La variable TOBA_USUARIO debe contener el mismo usuarios administrado del LDAP.
<syntaxhighlight lang="bash" enclose="div">
cp templates/arai-usuarios.env.dist arai-usuarios.env
nano arai-usuarios.env
</syntaxhighlight>

'''arai-usuarios.env.dist'''
<syntaxhighlight lang="apache" enclose="div">
###### CONFIG DEL INSTALADR ######
#INSTALADOR_TIMEOUT="360"
ENTORNO_PRODUCCION="1"

###### VARIABLES GLOBALES DEL ARCHIVO ######
ARAI_USUARIOS_DIR=/usr/local/siu/usuarios

###### CONFIG DE TOBA ######
TOBA_URL_BASE="https://usuarios.local.siu"
TOBA_URL_PORT="443"
TOBA_USUARIO="admin"
TOBA_PASSWORD="admin1234"
TOBA_INSTALACION_DIR="${ARAI_USUARIOS_DIR}/instalacion"
TOBA_PROYECTO_DIR="${ARAI_USUARIOS_DIR}/gestion"
TOBA_INSTALAR_USUARIOS=false
TOBA_INSTALAR_EDITOR=false
TOBA_INSTALAR_REFERENCIA=false
TOBA_ALIAS_PROYECTO="/gestion"
TOBA_ALIAS_NUCLEO="/toba_gestion"
#TOBA_ID_DESARROLLADOR=0
#TOBA_SESSION_NAME="ARAI_SESSID"

###### CONFIG DE BASE DE DATOS DE NEGOCIO ######
PROYECTO_DB_HOST="172.27.31.114"
PROYECTO_DB_PORT="7432"
PROYECTO_DB_DBNAME="siu_usuarios"
PROYECTO_DB_USERNAME="postgres"
PROYECTO_DB_PASSWORD="postgres"
PROYECTO_DB_SCHEMA="usuarios"

###### CONFIG DE BASE DE DATOS DE TOBA. #####
######## DEFINIR SI SE QUIERE UTILIZAR UNA BASE DISTINTA A LA DE NEGOCIO
#TOBA_DB_HOST="localhost"
#TOBA_DB_PORT="5432"
#TOBA_DB_DBNAME="instalador"
#TOBA_DB_USERNAME="postgres"
#TOBA_DB_PASSWORD="postgres"
#TOBA_DB_SCHEMA="public"

##### CONFIG IDM #####
ARAI_USUARIOS_URL_IDP=https://usuarios.local.siu/idp
## Deberá setearse si el sistema corre detrás de un proxy reverso
#ARAI_USUARIOS_PROXY_URL_IDP=http://url.arai-usuarios:80/idp
ARAI_USUARIOS_URL_PORTAL=https://huarpe.local.siu/portal
ARAI_USUARIOS_URL_PERFIL=https://huarpe.local.siu/perfil
ARAI_USUARIOS_URL_INSTITUCION=http://siu.edu.ar

ARAI_USUARIOS_SIGLA_INSTITUCION=SIGLA
ARAI_USUARIOS_EMAIL_SOPORTE=mail.soporte@institucion.edu.ar

##### CONFIG SEGURIDAD ####
SEGURIDAD_ALGORITMO_PASS=crypt
SEGURIDAD_LARGO_PASS=8
SEGURIDAD_INFO_PASS='El password debe tener al menos 8 caracteres, entre letras mayúsculas, minúsculas, números y símbolos, no pudiendo repetir caracteres adyacentes'
SEGURIDAD_DURACION_DIAS_PASS=120
SEGURIDAD_RECAPTCHA_SITIO=6Fd_pQwTAAAAAOEqJz6KJmkjsrXcdXrAjWQYggZf
SEGURIDAD_RECAPTCHA_CLAVE=6Fd_pQwTAAAAAOEqJz6KJmkjsrXcdXrAjWQYggZf
SEGURIDAD_INTENTOS_RECAPTCHA=3

##### CONFIG IDP #####
ARAI_USUARIOS_IDP_KEY_FILE=/certs/idp/certificado_idp.pem
ARAI_USUARIOS_IDP_CERT_FILE=/certs/idp/certificado_idp.crt
#ARAI_USUARIOS_IDP_LOG_LEVEL='WARNING'
#ARAI_USUARIOS_IDP_LOG_HANDLER='errorlog'

##### CONFIG MAIL RECOVERY ####
MAIL_RECOVERY_SUBJECT='Recuperar contraseña SIU-Arai'
MAIL_RECOVERY_FROM='noreply@institucion.edu.ar'
MAIL_RECOVERY_REPLYTO='noreply@institucion.edu.ar'
MAIL_RECOVERY_FROMNAME='Institución'

##### CONFIG LDAP #####
ARAI_USUARIOS_LDAP_HOST=172.27.31.114
ARAI_USUARIOS_LDAP_PORT=7389
ARAI_USUARIOS_LDAP_TLS=0
ARAI_USUARIOS_LDAP_METHOD=user
ARAI_USUARIOS_LDAP_BINDUSER="cn=admin,dc=siu,dc=cin,dc=edu"
ARAI_USUARIOS_LDAP_BINDPASS=admin
ARAI_USUARIOS_LDAP_SEARCHBASE="dc=siu,dc=cin,dc=edu"

##### CONFIG ARAI-REGISTRY #####
ARAI_REGISTRY_URL=http://registry.local.siu/arai-registry
ARAI_REGISTRY_USER=user
ARAI_REGISTRY_PASS=pass

###### CONFIG ENVIO MAILS (SMTP) ######
SMTP_ENTRADA="arai-usuarios"
SMTP_HELO="mail.unx.edu.ar"
SMTP_HOST="smtp.googlemail.com"
SMTP_PORT=587
SMTP_FROM ="yo@midominio.com"
SMTP_SEGURIDAD ="ssl|tls"
SMTP_AUTH ="1"
SMTP_USUARIO ="usuario"
SMTP_CLAVE ="pass"
</syntaxhighlight>

Una vez editado, verificamos que la configuración sea correcta
<syntaxhighlight lang="bash" enclose="div">
./bin/instalador proyecto:verificar
</syntaxhighlight>

Si no sale ninguna alerta, procedemos a instalar.
<syntaxhighlight lang="bash" enclose="div">
./bin/instalador proyecto:instalar
</syntaxhighlight>
Una vez instalado, modificamos los permisos de los archivos de la instalación con el comando
<syntaxhighlight lang="bash" enclose="div">
./bin/instalador permisos:simple
</syntaxhighlight>
Cambiamos el modo mantenimiento
<syntaxhighlight lang="bash" enclose="div">
./bin/instalador instalacion:modo-mantenimiento --sin-mantenimiento
</syntaxhighlight>

Luego configuramos Apache.
Lo mismo que con registry, como tengo toda la plataforma instalada en un mismo servidor, debo usar el '''ServerName "usuarios.local.siu"'''
En lugar de hacer un vinculo con '''alias.conf''' como dice la documentación, use un include dentro del tag VirtualHost. Así me quedo el archivo '''/etc/apache/sites-enabled/usuarios.conf'''

<syntaxhighlight lang="apache" enclose="div">
<VirtualHost *:80>
ServerName usuarios.local.siu
Redirect permanent / https://usuarios.local.siu/
</VirtualHost>

<VirtualHost *:443>

ServerName usuarios.local.siu

SSLEngine on
SSLCertificateFile /certs/usuarios.local.siu.cert.pem
SSLCertificateKeyFile /certs/usuarios.local.siu.key.pem

Include /usr/local/siu/usuarios/instalacion/toba.conf

Include /usr/local/siu/usuarios/instalacion/idp.conf

</VirtualHost>
</syntaxhighlight>

Reiniciamos Apache y todo debería funcionar, para verificar entramos en la URL definida para usuarios, en mi caso https://usuarios.local.siu/gestion

Con todo esto funcionando el siguiente paso es agregar Usuarios a Registry y sincronizarlos.
Según esta instalación para agregar Usuarios al entorno hacemos
<syntaxhighlight lang="bash" enclose="div">
./bin/arai-cli registry:add --maintainer-email jpiazza@siu.edu.ar --maintainer jpiazza http://registry.local.siu/arai-registry
</syntaxhighlight>
y para sincronizarlo
<syntaxhighlight lang="bash" enclose="div">
./bin/arai-cli registry:sync
</syntaxhighlight>

===Arai-Huarpe===

Es similar a las instalaciones anteriores.
<syntaxhighlight lang="bash" enclose="div">
cd /usr/local/siu
git clone --branch v1.1.0 https://hub.siu.edu.ar/siu-arai/huarpe-core.git huarpe
cd huarpe
</syntaxhighlight>

Para instalar seguimos la documentación del archivo '''doc/INSTALACION_MANUAL.md'''
<syntaxhighlight lang="bash" enclose="div">
composer install --no-dev
</syntaxhighlight>

Configuramos las variables de entorno que va a usar el instalador, los valores que puse son válidos para mi instalación, deberán modificarlos según las necesidades de cada universidad.
<syntaxhighlight lang="bash" enclose="div">
cp templates/huarpe.env.dist huarpe.env
nano huarpe.env
</syntaxhighlight>

'''huarpe.env'''
<syntaxhighlight lang="apache" enclose="div">
###### CONFIG DEL INSTALADR ######
#INSTALADOR_TIMEOUT="360"
ENTORNO_PRODUCCION=1

###### CONFIG DE SIU-HUARPE ######
HUARPE_PATH=/usr/local/siu/huarpe
HUARPE_URL=https://huarpe.local.siu
HUARPE_URL_PORT=443
HUARPE_SESSION_NAME=huarpe
HUARPE_SESSION_HANDLER="native_file"
#HUARPE_MEMCACHED_HOST=127.0.0.1
#HUARPE_MEMCACHED_PORT=11211
HUARPE_CERT_FILE=/certs/huarpe-cli.cert.pem
HUARPE_KEY_FILE=/certs/huarpe-cli.key.pem
#HUARPE_TOKEN=unt0k3n-al3at0r1o-s39ur0?
#HUARPE_PROXY=127.0.0.1
HUARPE_LOG_HANDLER="error_log"
HUARPE_LOG_LEVEL="DEBUG"

###### CONFIG DE SIU-ARAI: REGISTRY ######
ARAI_REGISTRY_URL=http://registry.local.siu/arai-registry
ARAI_REGISTRY_USER=user
ARAI_REGISTRY_PASS=pass
</syntaxhighlight>

Una vez editado, verificamos que la configuración sea correcta

./bin/instalador proyecto:verificar

Si no sale ninguna alerta, procedemos a instalar.

./bin/instalador proyecto:instalar

luego
./bin/console assetic:dump --no-debug

Una vez instalado, modificamos los permisos de los archivos de la instalación con el comando

./bin/instalador permisos:simple

Configuramos apache.
Lo mismo que con registry, como tengo toda la plataforma instalada en un mismo servidor, debo usar el ServerName huarpe.local.siu
En lugar de hacer un vinculo con alias.conf como dice la documentación, usé un include dentro del tag VirtualHost. Así me quedo el archivo /etc/apache/sites-enabled/huarpe.conf

<VirtualHost *:80>
ServerName huarpe.local.siu
Redirect permanent / https://huarpe.local.siu:443/
</VirtualHost>

<VirtualHost *:443>

ServerName huarpe.local.siu
SSLEngine on
SSLCertificateFile /certs/huarpe.local.siu.cert.pem
SSLCertificateKeyFile /certs/huarpe.local.siu.key.pem

Include /usr/local/siu/huarpe/app/config/alias.conf

</VirtualHost>

Reiniciamos apache, antes de verificar la instalación, debemos sincronizar con Registry.
./vendor/bin/arai-cli registry:add --maintainer-email jpiazza@siu.edu.ar --maintainer jpiazza http://registry.local.siu/arai-registry

Luego sincronizar
./vendor/bin/arai-cli registry:sync

Si el archivo no tiene permisos de ejecución
chmod +x ./vendor/bin/arai-cli
y repetir los dos pasos anteriores.

Para verificar que la instalación se realizo con éxito de debe ingresar en https://huarpe.local.siu/

SIU-Arai/ejemploPasoAPaso

2017-08-02T15:57:15Z

Jpiazza: /* Arai-Usuarios */

SIU-Arai/ejemploPasoAPaso

2017-08-02T15:53:33Z

Jpiazza: /* Arai-Usuarios */