<?xml version="1.0"?>
<feed xmlns="http://www.w3.org/2005/Atom" xml:lang="es">
		<id>https://documentacion.siu.edu.ar/wiki/api.php?action=feedcontributions&amp;feedformat=atom&amp;user=Ablanco</id>
		<title>SIU - Contribuciones del usuario [es]</title>
		<link rel="self" type="application/atom+xml" href="https://documentacion.siu.edu.ar/wiki/api.php?action=feedcontributions&amp;feedformat=atom&amp;user=Ablanco"/>
		<link rel="alternate" type="text/html" href="https://documentacion.siu.edu.ar/wiki/Especial:Contribuciones/Ablanco"/>
		<updated>2026-05-24T19:58:09Z</updated>
		<subtitle>Contribuciones del usuario</subtitle>
		<generator>MediaWiki 1.30.0</generator>

	<entry>
		<id>https://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Arai/Integracion/Redmine&amp;diff=42012</id>
		<title>SIU-Arai/Integracion/Redmine</title>
		<link rel="alternate" type="text/html" href="https://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Arai/Integracion/Redmine&amp;diff=42012"/>
				<updated>2018-05-28T15:17:16Z</updated>
		
		<summary type="html">&lt;p&gt;Ablanco: /* Activar autenticación SAML */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;[[Archivo:siu-arai.png|derecha|link=]]&lt;br /&gt;
&lt;br /&gt;
= Integrando Redmine =&lt;br /&gt;
&lt;br /&gt;
[https://www.redmine.org/ Redmine] es una herramienta para la gestión de proyectos. Para autenticar con saml usamos este plugin [https://github.com/chrodriguez/redmine_omniauth_saml https://github.com/chrodriguez/redmine_omniauth_saml].&lt;br /&gt;
&lt;br /&gt;
== Requerimientos ==&lt;br /&gt;
Será necesario contar con:&lt;br /&gt;
* Redmine 3.0 or higher&lt;br /&gt;
* la url del Redmine, en este ejemplo &amp;lt;code&amp;gt;&amp;lt;nowiki&amp;gt;https://redmine.unx.edu.ar&amp;lt;/nowiki&amp;gt;&amp;lt;/code&amp;gt;&lt;br /&gt;
* la url del IdP, en este ejemplo &amp;lt;code&amp;gt;&amp;lt;nowiki&amp;gt;https://idp.unx.edu.ar&amp;lt;/nowiki&amp;gt;&amp;lt;/code&amp;gt;&lt;br /&gt;
* el identificador disponible para la aplicación, en este ejemplo &amp;lt;code&amp;gt;unx-redmine_1&amp;lt;/code&amp;gt;&lt;br /&gt;
* el fingerprint del certificado del idp (es el certificado interno que usa arai, no el del navegador)&lt;br /&gt;
&lt;br /&gt;
== Ajustes en SIU-Araí: Usuarios ==&lt;br /&gt;
&lt;br /&gt;
=== Creación de la aplicación Gitlab en Usuarios ===&lt;br /&gt;
# Ir a Aplicaciones&lt;br /&gt;
# Completar el formulario con los siguientes datos&lt;br /&gt;
#* appUniqueId: 'unx-redmine_1' (recordar es la misma que se pone en idp.yml)&lt;br /&gt;
#* url: '&amp;lt;nowiki&amp;gt;https://redmine.unx.edu.ar'&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
#* etiqueta: 'Redmine'&lt;br /&gt;
#* versión: 10&lt;br /&gt;
#* ícono: (elegir un logo .png, se mostrará en el menú)&lt;br /&gt;
# Opcional. Activar la opción filtrar por grupo y luego agregar un grupo existente, como '''devs''' al filtro. Esto hace que sólo la gente que pertenezca a este grupo pueda acceder a la aplicación.&lt;br /&gt;
&lt;br /&gt;
=== Definición de Gitlab como SP ===&lt;br /&gt;
Se debe editar el archivo &amp;lt;code&amp;gt;/ruta/arai-usuarios/config/idp.yml&amp;lt;/code&amp;gt;. Hay que tener cuidado al editar este archivo porque el formato yaml es estricto. Si se escapa un TAB se rompe.&lt;br /&gt;
&lt;br /&gt;
Así se agrega el SP al IdP&lt;br /&gt;
&amp;lt;source lang=&amp;quot;yaml&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;    service_provider:&lt;br /&gt;
        custom:&lt;br /&gt;
             'https://redmine.siu.edu.ar/saml/metadata': &lt;br /&gt;
                 AssertionConsumerService: 'https://redmine.siu.edu.ar/redmine/auth/saml/callback'&lt;br /&gt;
                 SingleLogoutService: 'https://redmine.siu.edu.ar/redmine/logout'&lt;br /&gt;
                 appUniqueId: siu-redmine_1.siu-redmine&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Opcionalmente, se puede elegir un [[SIU-Arai/usuarios/templates-login|template]] específico para la página del login si el usuario accede directamente a la url de redmine: &lt;br /&gt;
&amp;lt;source lang=&amp;quot;yaml&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;    templates_login:&lt;br /&gt;
        definition:&lt;br /&gt;
            usage:&lt;br /&gt;
                siu-redmine_1.siu-redmine: login-especifico&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== Ajustes en Redmine ==&lt;br /&gt;
&lt;br /&gt;
=== Instalar el plugin ===&lt;br /&gt;
Para instalar plugins en redmine (la forma cambia según la versión)&lt;br /&gt;
[https://github.com/chrodriguez/redmine_omniauth_saml https://github.com/chrodriguez/redmine_omniauth_saml]&lt;br /&gt;
&lt;br /&gt;
=== Fingerprint SSL ===&lt;br /&gt;
Si no queremos cargar todo el certificado podemos calcularle el fingerprint&lt;br /&gt;
'''Dentro del server del idp''' buscamos el certificado y lo calculamos&lt;br /&gt;
&amp;lt;code&amp;gt;openssl x509 -noout -fingerprint -sha1 -inform pem -in /srv/certs/idp.crt&amp;lt;/code&amp;gt;&lt;br /&gt;
=== Activar autenticación SAML ===&lt;br /&gt;
Una vez instalado editamos /usr/share/redmine/config/initializers/saml.rb&lt;br /&gt;
&amp;lt;source lang=&amp;quot;ruby&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt; &lt;br /&gt;
Redmine::OmniAuthSAML::Base.configure do |config|&lt;br /&gt;
  config.saml = {&lt;br /&gt;
    :assertion_consumer_service_url =&amp;gt; &amp;quot;https://redmine.siu.edu.ar/redmine/auth/saml/callback&amp;quot;, # The redmine application hostname&lt;br /&gt;
    :issuer                         =&amp;gt; &amp;quot;https://redmine.siu.edu.ar/saml/metadata&amp;quot;,                 # The issuer name&lt;br /&gt;
    :idp_sso_target_url             =&amp;gt; &amp;quot;https://idp3.siu.edu.ar/saml2/idp/SSOService.php&amp;quot;, # SSO login endpoint&lt;br /&gt;
    :idp_cert_fingerprint           =&amp;gt; &amp;quot;C9:9F:99:5B:4D:78:D5:7E:72:4E:E9:76:B0:D0:5F:16:23:A9:3C:50&amp;quot;, # SSO ssl certificate fingerprint&lt;br /&gt;
    :name_identifier_format         =&amp;gt; &amp;quot;urn:oasis:names:tc:SAML:2.0:nameid-format:persistent&amp;quot;,&lt;br /&gt;
    :signout_url                    =&amp;gt; &amp;quot;https://idp3.siu.edu.ar/saml2/idp/SingleLogoutService.php?ReturnTo=&amp;quot;,&lt;br /&gt;
    :idp_slo_target_url             =&amp;gt; &amp;quot;https://idp3.siu.edu.ar/saml2/idp/SingleLogoutService.php&amp;quot;, &lt;br /&gt;
    :name_identifier_value          =&amp;gt; &amp;quot;uniqueIdentifier&amp;quot;, # Which redmine field is used as name_identifier_value for SAML logout&lt;br /&gt;
    :attribute_mapping              =&amp;gt; {&lt;br /&gt;
    # How will we map attributes from SSO to redmine attributes&lt;br /&gt;
      :login      =&amp;gt; 'extra.raw_info.uniqueIdentifier',&lt;br /&gt;
      :firstname  =&amp;gt; 'extra.raw_info.cn',&lt;br /&gt;
      :lastname   =&amp;gt; 'extra.raw_info.sn',&lt;br /&gt;
      :mail       =&amp;gt; 'extra.raw_info.mail'&lt;br /&gt;
    }&lt;br /&gt;
  }&lt;br /&gt;
&lt;br /&gt;
  config.on_login do |omniauth_hash, user|&lt;br /&gt;
    # Implement any hook you want here&lt;br /&gt;
    # File.open(&amp;quot;/tmp/redmine.log&amp;quot;, 'w') { |file| file.write(omniauth_hash) }&lt;br /&gt;
  end&lt;br /&gt;
end&lt;br /&gt;
&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== Limitaciones conocidas ==&lt;br /&gt;
# Además de conectar vía SAML, el usuario tendrá que establecer una password local en Redmine para checkoutear/commitear. Una opción es configurar el provider LDAP para que la cuenta en Redmine tenga múltiple identidades (SAML, LDAP, local) y con esto utilice su clave mediante autenticación LDAP.&lt;/div&gt;</summary>
		<author><name>Ablanco</name></author>	</entry>

	<entry>
		<id>https://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Arai/Integracion/Redmine&amp;diff=42011</id>
		<title>SIU-Arai/Integracion/Redmine</title>
		<link rel="alternate" type="text/html" href="https://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Arai/Integracion/Redmine&amp;diff=42011"/>
				<updated>2018-05-28T15:15:41Z</updated>
		
		<summary type="html">&lt;p&gt;Ablanco: /* Definición de Gitlab como SP */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;[[Archivo:siu-arai.png|derecha|link=]]&lt;br /&gt;
&lt;br /&gt;
= Integrando Redmine =&lt;br /&gt;
&lt;br /&gt;
[https://www.redmine.org/ Redmine] es una herramienta para la gestión de proyectos. Para autenticar con saml usamos este plugin [https://github.com/chrodriguez/redmine_omniauth_saml https://github.com/chrodriguez/redmine_omniauth_saml].&lt;br /&gt;
&lt;br /&gt;
== Requerimientos ==&lt;br /&gt;
Será necesario contar con:&lt;br /&gt;
* Redmine 3.0 or higher&lt;br /&gt;
* la url del Redmine, en este ejemplo &amp;lt;code&amp;gt;&amp;lt;nowiki&amp;gt;https://redmine.unx.edu.ar&amp;lt;/nowiki&amp;gt;&amp;lt;/code&amp;gt;&lt;br /&gt;
* la url del IdP, en este ejemplo &amp;lt;code&amp;gt;&amp;lt;nowiki&amp;gt;https://idp.unx.edu.ar&amp;lt;/nowiki&amp;gt;&amp;lt;/code&amp;gt;&lt;br /&gt;
* el identificador disponible para la aplicación, en este ejemplo &amp;lt;code&amp;gt;unx-redmine_1&amp;lt;/code&amp;gt;&lt;br /&gt;
* el fingerprint del certificado del idp (es el certificado interno que usa arai, no el del navegador)&lt;br /&gt;
&lt;br /&gt;
== Ajustes en SIU-Araí: Usuarios ==&lt;br /&gt;
&lt;br /&gt;
=== Creación de la aplicación Gitlab en Usuarios ===&lt;br /&gt;
# Ir a Aplicaciones&lt;br /&gt;
# Completar el formulario con los siguientes datos&lt;br /&gt;
#* appUniqueId: 'unx-redmine_1' (recordar es la misma que se pone en idp.yml)&lt;br /&gt;
#* url: '&amp;lt;nowiki&amp;gt;https://redmine.unx.edu.ar'&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
#* etiqueta: 'Redmine'&lt;br /&gt;
#* versión: 10&lt;br /&gt;
#* ícono: (elegir un logo .png, se mostrará en el menú)&lt;br /&gt;
# Opcional. Activar la opción filtrar por grupo y luego agregar un grupo existente, como '''devs''' al filtro. Esto hace que sólo la gente que pertenezca a este grupo pueda acceder a la aplicación.&lt;br /&gt;
&lt;br /&gt;
=== Definición de Gitlab como SP ===&lt;br /&gt;
Se debe editar el archivo &amp;lt;code&amp;gt;/ruta/arai-usuarios/config/idp.yml&amp;lt;/code&amp;gt;. Hay que tener cuidado al editar este archivo porque el formato yaml es estricto. Si se escapa un TAB se rompe.&lt;br /&gt;
&lt;br /&gt;
Así se agrega el SP al IdP&lt;br /&gt;
&amp;lt;source lang=&amp;quot;yaml&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;    service_provider:&lt;br /&gt;
        custom:&lt;br /&gt;
             'https://redmine.siu.edu.ar/saml/metadata': &lt;br /&gt;
                 AssertionConsumerService: 'https://redmine.siu.edu.ar/redmine/auth/saml/callback'&lt;br /&gt;
                 SingleLogoutService: 'https://redmine.siu.edu.ar/redmine/logout'&lt;br /&gt;
                 appUniqueId: siu-redmine_1.siu-redmine&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Opcionalmente, se puede elegir un [[SIU-Arai/usuarios/templates-login|template]] específico para la página del login si el usuario accede directamente a la url de redmine: &lt;br /&gt;
&amp;lt;source lang=&amp;quot;yaml&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;    templates_login:&lt;br /&gt;
        definition:&lt;br /&gt;
            usage:&lt;br /&gt;
                siu-redmine_1.siu-redmine: login-especifico&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== Ajustes en Redmine ==&lt;br /&gt;
&lt;br /&gt;
=== Instalar el plugin ===&lt;br /&gt;
Para instalar plugins en redmine (la forma cambia según la versión)&lt;br /&gt;
[https://github.com/chrodriguez/redmine_omniauth_saml https://github.com/chrodriguez/redmine_omniauth_saml]&lt;br /&gt;
&lt;br /&gt;
=== Fingerprint SSL ===&lt;br /&gt;
Si no queremos cargar todo el certificado podemos calcularle el fingerprint&lt;br /&gt;
'''Dentro del server del idp''' buscamos el certificado y lo calculamos&lt;br /&gt;
&amp;lt;code&amp;gt;openssl x509 -noout -fingerprint -sha1 -inform pem -in /srv/certs/idp.crt&amp;lt;/code&amp;gt;&lt;br /&gt;
=== Activar autenticación SAML ===&lt;br /&gt;
Una vez instalado editamos /usr/share/redmine/config/initializers/saml.rb&lt;br /&gt;
&amp;lt;source lang=&amp;quot;yaml&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt; &lt;br /&gt;
Redmine::OmniAuthSAML::Base.configure do |config|&lt;br /&gt;
  config.saml = {&lt;br /&gt;
    :assertion_consumer_service_url =&amp;gt; &amp;quot;https://redmine.siu.edu.ar/redmine/auth/saml/callback&amp;quot;, # The redmine application hostname&lt;br /&gt;
    :issuer                         =&amp;gt; &amp;quot;https://redmine.siu.edu.ar/saml/metadata&amp;quot;,                 # The issuer name&lt;br /&gt;
    :idp_sso_target_url             =&amp;gt; &amp;quot;https://idp3.siu.edu.ar/saml2/idp/SSOService.php&amp;quot;, # SSO login endpoint&lt;br /&gt;
    :idp_cert_fingerprint           =&amp;gt; &amp;quot;C9:9F:99:5B:4D:78:D5:7E:72:4E:E9:76:B0:D0:5F:16:23:A9:3C:50&amp;quot;, # SSO ssl certificate fingerprint&lt;br /&gt;
    :name_identifier_format         =&amp;gt; &amp;quot;urn:oasis:names:tc:SAML:2.0:nameid-format:persistent&amp;quot;,&lt;br /&gt;
    :signout_url                    =&amp;gt; &amp;quot;https://idp3.siu.edu.ar/saml2/idp/SingleLogoutService.php?ReturnTo=&amp;quot;,&lt;br /&gt;
    :idp_slo_target_url             =&amp;gt; &amp;quot;https://idp3.siu.edu.ar/saml2/idp/SingleLogoutService.php&amp;quot;, &lt;br /&gt;
    :name_identifier_value          =&amp;gt; &amp;quot;uniqueIdentifier&amp;quot;, # Which redmine field is used as name_identifier_value for SAML logout&lt;br /&gt;
    :attribute_mapping              =&amp;gt; {&lt;br /&gt;
    # How will we map attributes from SSO to redmine attributes&lt;br /&gt;
      :login      =&amp;gt; 'extra.raw_info.uniqueIdentifier',&lt;br /&gt;
      :firstname  =&amp;gt; 'extra.raw_info.cn',&lt;br /&gt;
      :lastname   =&amp;gt; 'extra.raw_info.sn',&lt;br /&gt;
      :mail       =&amp;gt; 'extra.raw_info.mail'&lt;br /&gt;
    }&lt;br /&gt;
  }&lt;br /&gt;
&lt;br /&gt;
  config.on_login do |omniauth_hash, user|&lt;br /&gt;
    # Implement any hook you want here&lt;br /&gt;
    # File.open(&amp;quot;/tmp/redmine.log&amp;quot;, 'w') { |file| file.write(omniauth_hash) }&lt;br /&gt;
  end&lt;br /&gt;
end&lt;br /&gt;
&lt;br /&gt;
&amp;lt;/source&amp;gt; &lt;br /&gt;
&lt;br /&gt;
== Limitaciones conocidas ==&lt;br /&gt;
# Además de conectar vía SAML, el usuario tendrá que establecer una password local en Redmine para checkoutear/commitear. Una opción es configurar el provider LDAP para que la cuenta en Redmine tenga múltiple identidades (SAML, LDAP, local) y con esto utilice su clave mediante autenticación LDAP.&lt;/div&gt;</summary>
		<author><name>Ablanco</name></author>	</entry>

	<entry>
		<id>https://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Arai/Integracion&amp;diff=42010</id>
		<title>SIU-Arai/Integracion</title>
		<link rel="alternate" type="text/html" href="https://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Arai/Integracion&amp;diff=42010"/>
				<updated>2018-05-28T15:14:46Z</updated>
		
		<summary type="html">&lt;p&gt;Ablanco: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;[[Archivo:siu-arai.png|derecha|link=]]&lt;br /&gt;
&amp;lt;br&amp;gt;&lt;br /&gt;
= Integrando módulos de terceros =&lt;br /&gt;
La plataforma SIU-Araí ofrece varios mecanismos para interactuar con ella y/o con los módulos que contiene. Además, la integración puede abarcar varios aspectos, a saber:&lt;br /&gt;
* Login centralizado (Single Sign On)&lt;br /&gt;
* Registro del módulo como aplicación en la plataforma&lt;br /&gt;
* Registro del módulo como proveedor y/o consumidor de API rest en la plataforma&lt;br /&gt;
== Integrando desarrollos propios ==&lt;br /&gt;
A continuación, se presentan guías dedicadas a la integración utilizando procedimientos diversos, siempre enfocado en una aplicación capaz de ser modificada o de la cual se disponga del código fuente :&lt;br /&gt;
* [[SIU-Arai/usuarios/integracion-inicial-toba|Integrando una aplicación hecha en SIU-Toba]]&lt;br /&gt;
* [[SIU-Arai/Integracion/inicial-php|Integrando una aplicación hecha en PHP]]&lt;br /&gt;
* Integrando una aplicación vía SAML&lt;br /&gt;
* Integrando una aplicación ''legacy''&lt;br /&gt;
&lt;br /&gt;
== Integrando aplicaciones existentes ==&lt;br /&gt;
En los casos en que se cuente con aplicaciones de terceros construidas, se debe evaluar si es posible integrarla utilizando alguno de los mecanismos conocidos:&lt;br /&gt;
* vía SAML&lt;br /&gt;
* vía LDAP&lt;br /&gt;
* vía hook de SIU-Araí (idea)&lt;br /&gt;
&lt;br /&gt;
A continuación se presentan algunas guías para aplicaciones que son compatibles y se han probado exitosamente su integración con la plataforma.&lt;br /&gt;
* Moodle&lt;br /&gt;
* [[SIU-Arai/Integracion/Redmine|Redmine]]&lt;br /&gt;
* [[SIU-Arai/Integracion/Gitlab|Gitlab]]&lt;br /&gt;
* [[SIU-Arai/Integracion/Apache|Web Server Apache]]&lt;br /&gt;
[[SIU-Arai|&amp;lt; Volver]]&lt;/div&gt;</summary>
		<author><name>Ablanco</name></author>	</entry>

	<entry>
		<id>https://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Arai/Integracion/Redmine&amp;diff=42009</id>
		<title>SIU-Arai/Integracion/Redmine</title>
		<link rel="alternate" type="text/html" href="https://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Arai/Integracion/Redmine&amp;diff=42009"/>
				<updated>2018-05-28T15:12:21Z</updated>
		
		<summary type="html">&lt;p&gt;Ablanco: /* Definición de Gitlab como SP */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;[[Archivo:siu-arai.png|derecha|link=]]&lt;br /&gt;
&lt;br /&gt;
= Integrando Redmine =&lt;br /&gt;
&lt;br /&gt;
[https://www.redmine.org/ Redmine] es una herramienta para la gestión de proyectos. Para autenticar con saml usamos este plugin [https://github.com/chrodriguez/redmine_omniauth_saml https://github.com/chrodriguez/redmine_omniauth_saml].&lt;br /&gt;
&lt;br /&gt;
== Requerimientos ==&lt;br /&gt;
Será necesario contar con:&lt;br /&gt;
* Redmine 3.0 or higher&lt;br /&gt;
* la url del Redmine, en este ejemplo &amp;lt;code&amp;gt;&amp;lt;nowiki&amp;gt;https://redmine.unx.edu.ar&amp;lt;/nowiki&amp;gt;&amp;lt;/code&amp;gt;&lt;br /&gt;
* la url del IdP, en este ejemplo &amp;lt;code&amp;gt;&amp;lt;nowiki&amp;gt;https://idp.unx.edu.ar&amp;lt;/nowiki&amp;gt;&amp;lt;/code&amp;gt;&lt;br /&gt;
* el identificador disponible para la aplicación, en este ejemplo &amp;lt;code&amp;gt;unx-redmine_1&amp;lt;/code&amp;gt;&lt;br /&gt;
* el fingerprint del certificado del idp (es el certificado interno que usa arai, no el del navegador)&lt;br /&gt;
&lt;br /&gt;
== Ajustes en SIU-Araí: Usuarios ==&lt;br /&gt;
&lt;br /&gt;
=== Creación de la aplicación Gitlab en Usuarios ===&lt;br /&gt;
# Ir a Aplicaciones&lt;br /&gt;
# Completar el formulario con los siguientes datos&lt;br /&gt;
#* appUniqueId: 'unx-redmine_1' (recordar es la misma que se pone en idp.yml)&lt;br /&gt;
#* url: '&amp;lt;nowiki&amp;gt;https://redmine.unx.edu.ar'&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
#* etiqueta: 'Redmine'&lt;br /&gt;
#* versión: 10&lt;br /&gt;
#* ícono: (elegir un logo .png, se mostrará en el menú)&lt;br /&gt;
# Opcional. Activar la opción filtrar por grupo y luego agregar un grupo existente, como '''devs''' al filtro. Esto hace que sólo la gente que pertenezca a este grupo pueda acceder a la aplicación.&lt;br /&gt;
&lt;br /&gt;
=== Definición de Gitlab como SP ===&lt;br /&gt;
Se debe editar el archivo &amp;lt;code&amp;gt;/ruta/arai-usuarios/config/idp.yml&amp;lt;/code&amp;gt;. Hay que tener cuidado al editar este archivo porque el formato yaml es estricto. Si se escapa un TAB se rompe.&lt;br /&gt;
&lt;br /&gt;
Así se agrega el SP al IdP&lt;br /&gt;
&amp;lt;source lang=&amp;quot;yaml&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;    service_provider:&lt;br /&gt;
        custom:&lt;br /&gt;
             'https://redmine.siu.edu.ar/saml/metadata': &lt;br /&gt;
                 AssertionConsumerService: 'https://redmine.siu.edu.ar/redmine/auth/saml/callback'&lt;br /&gt;
                 SingleLogoutService: 'https://redmine.siu.edu.ar/redmine/logout'&lt;br /&gt;
                 appUniqueId: siu-redmine_1.siu-redmine&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Opcionalmente, se puede elegir un [http://documentacion.siu.edu.ar/wiki/SIU-Arai/usuarios/templates-login template] específico para la página del login si el usuario accede directamente a la url de redmine: &lt;br /&gt;
&amp;lt;source lang=&amp;quot;yaml&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;    templates_login:&lt;br /&gt;
        definition:&lt;br /&gt;
            usage:&lt;br /&gt;
                siu-redmine_1.siu-redmine: login-especifico&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== Ajustes en Redmine ==&lt;br /&gt;
&lt;br /&gt;
=== Instalar el plugin ===&lt;br /&gt;
Para instalar plugins en redmine (la forma cambia según la versión)&lt;br /&gt;
[https://github.com/chrodriguez/redmine_omniauth_saml https://github.com/chrodriguez/redmine_omniauth_saml]&lt;br /&gt;
&lt;br /&gt;
=== Fingerprint SSL ===&lt;br /&gt;
Si no queremos cargar todo el certificado podemos calcularle el fingerprint&lt;br /&gt;
'''Dentro del server del idp''' buscamos el certificado y lo calculamos&lt;br /&gt;
&amp;lt;code&amp;gt;openssl x509 -noout -fingerprint -sha1 -inform pem -in /srv/certs/idp.crt&amp;lt;/code&amp;gt;&lt;br /&gt;
=== Activar autenticación SAML ===&lt;br /&gt;
Una vez instalado editamos /usr/share/redmine/config/initializers/saml.rb&lt;br /&gt;
&amp;lt;source lang=&amp;quot;yaml&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt; &lt;br /&gt;
Redmine::OmniAuthSAML::Base.configure do |config|&lt;br /&gt;
  config.saml = {&lt;br /&gt;
    :assertion_consumer_service_url =&amp;gt; &amp;quot;https://redmine.siu.edu.ar/redmine/auth/saml/callback&amp;quot;, # The redmine application hostname&lt;br /&gt;
    :issuer                         =&amp;gt; &amp;quot;https://redmine.siu.edu.ar/saml/metadata&amp;quot;,                 # The issuer name&lt;br /&gt;
    :idp_sso_target_url             =&amp;gt; &amp;quot;https://idp3.siu.edu.ar/saml2/idp/SSOService.php&amp;quot;, # SSO login endpoint&lt;br /&gt;
    :idp_cert_fingerprint           =&amp;gt; &amp;quot;C9:9F:99:5B:4D:78:D5:7E:72:4E:E9:76:B0:D0:5F:16:23:A9:3C:50&amp;quot;, # SSO ssl certificate fingerprint&lt;br /&gt;
    :name_identifier_format         =&amp;gt; &amp;quot;urn:oasis:names:tc:SAML:2.0:nameid-format:persistent&amp;quot;,&lt;br /&gt;
    :signout_url                    =&amp;gt; &amp;quot;https://idp3.siu.edu.ar/saml2/idp/SingleLogoutService.php?ReturnTo=&amp;quot;,&lt;br /&gt;
    :idp_slo_target_url             =&amp;gt; &amp;quot;https://idp3.siu.edu.ar/saml2/idp/SingleLogoutService.php&amp;quot;, &lt;br /&gt;
    :name_identifier_value          =&amp;gt; &amp;quot;uniqueIdentifier&amp;quot;, # Which redmine field is used as name_identifier_value for SAML logout&lt;br /&gt;
    :attribute_mapping              =&amp;gt; {&lt;br /&gt;
    # How will we map attributes from SSO to redmine attributes&lt;br /&gt;
      :login      =&amp;gt; 'extra.raw_info.uniqueIdentifier',&lt;br /&gt;
      :firstname  =&amp;gt; 'extra.raw_info.cn',&lt;br /&gt;
      :lastname   =&amp;gt; 'extra.raw_info.sn',&lt;br /&gt;
      :mail       =&amp;gt; 'extra.raw_info.mail'&lt;br /&gt;
    }&lt;br /&gt;
  }&lt;br /&gt;
&lt;br /&gt;
  config.on_login do |omniauth_hash, user|&lt;br /&gt;
    # Implement any hook you want here&lt;br /&gt;
    # File.open(&amp;quot;/tmp/redmine.log&amp;quot;, 'w') { |file| file.write(omniauth_hash) }&lt;br /&gt;
  end&lt;br /&gt;
end&lt;br /&gt;
&lt;br /&gt;
&amp;lt;/source&amp;gt; &lt;br /&gt;
&lt;br /&gt;
== Limitaciones conocidas ==&lt;br /&gt;
# Además de conectar vía SAML, el usuario tendrá que establecer una password local en Redmine para checkoutear/commitear. Una opción es configurar el provider LDAP para que la cuenta en Redmine tenga múltiple identidades (SAML, LDAP, local) y con esto utilice su clave mediante autenticación LDAP.&lt;/div&gt;</summary>
		<author><name>Ablanco</name></author>	</entry>

	<entry>
		<id>https://documentacion.siu.edu.ar/wiki/index.php?title=IT/Sodium&amp;diff=41953</id>
		<title>IT/Sodium</title>
		<link rel="alternate" type="text/html" href="https://documentacion.siu.edu.ar/wiki/index.php?title=IT/Sodium&amp;diff=41953"/>
				<updated>2018-05-23T19:12:15Z</updated>
		
		<summary type="html">&lt;p&gt;Ablanco: /* Debian 8 Jessie */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;[[Archivo:siu-arai_iso.png|derecha|link=IT]]&lt;br /&gt;
&amp;lt;br&amp;gt;&lt;br /&gt;
= Sodium: librería para encriptación =&lt;br /&gt;
[https://libsodium.org Sodium] es una librería de software moderna, fácil de usar, para la encriptación, desencriptación, signatures, password hashing y más.  Al ser una librería estándar que se ha ganado su reconocimiento, se han implementado bindings en múchos lenguajes incluído para [https://github.com/jedisct1/libsodium-php PHP]. &lt;br /&gt;
&lt;br /&gt;
De esta forma, las soluciones SIU hacen uso de Sodium mediante la librería [https://paragonie.com/project/halite Paragonie/Halite] que facilita llevar adelante la implementación de [[SIU-Arai/Arquitectura|diversas funciones]].&lt;br /&gt;
&lt;br /&gt;
== Organización ==&lt;br /&gt;
Hay que comprender de forma precisa la organización de los componentes que nos permiten utilizar dicha librería, pues están muy correlacionados entre sí.&lt;br /&gt;
* Sodium existe a nivel sistema operativo u S.O., es una librería en C que implementa todas las funciones de criptoanálisis&lt;br /&gt;
* Sodium como extensión en PHP, permite acceder a la librería del S.O y hacer uso de las funciones de criptoanálisis&lt;br /&gt;
*# existe una variante como extensión PECL&lt;br /&gt;
*# existe como extensión ya embebida en el core de PHP&lt;br /&gt;
* Paragonie/Halite, la librería hecha en PHP e integrada a los proyectos SIU. Es la que facilita el uso de diversos mecanismos de encriptación y protección, todos basados en Sodium&lt;br /&gt;
&lt;br /&gt;
== Versiones ==&lt;br /&gt;
&lt;br /&gt;
A continuación se detalla la correlación entre las versiones de cada uno de los componentes, tanto con la versión de PHP como con la versión de la plataforma SIU-Araí. Los componentes principales de SIU-Araí lo validan explícitamente.&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
!&lt;br /&gt;
!PHP&lt;br /&gt;
!libsodium en PHP&lt;br /&gt;
!sodium en S.O.&lt;br /&gt;
!SIU-Araí&lt;br /&gt;
|-&lt;br /&gt;
|Paragonie/Halite 1.6&lt;br /&gt;
|5.6 - 7.0 - 7.1&lt;br /&gt;
|1.0.6 a 1.0.7&lt;br /&gt;
|1.0.6 o superior&lt;br /&gt;
|2.0.0&lt;br /&gt;
|-&lt;br /&gt;
|Paragonie/Halite 3.x&lt;br /&gt;
|7.0 - 7.1 - 7.2&lt;br /&gt;
|2.0.4 a 2.0.10&lt;br /&gt;
|1.0.9 o superior&lt;br /&gt;
|x&lt;br /&gt;
|-&lt;br /&gt;
|Paragonie/Halite 4.x&lt;br /&gt;
|7.2&lt;br /&gt;
| -&lt;br /&gt;
|1.0.13 o superior&lt;br /&gt;
|x&lt;br /&gt;
|}&lt;br /&gt;
Leyendas:&lt;br /&gt;
&lt;br /&gt;
( x.x.x ) se ha probado su integración en dicha versión&lt;br /&gt;
&lt;br /&gt;
( - )         integrada al [http://php.net/manual/en/book.sodium.php core] de PHP en la versión [http://php.net/manual/en/book.sodium.php 7.2]&lt;br /&gt;
&lt;br /&gt;
( x )        no se ha hecho integración con la plataforma&lt;br /&gt;
&lt;br /&gt;
== Instalación ==&lt;br /&gt;
&lt;br /&gt;
La instalación de todas las librerías requeridas varía de sistema operativo a sistema operativo. A continuación se expone algunos ejemplos habituales de instalación en sistemas Linux reconocidos.&lt;br /&gt;
&lt;br /&gt;
=== Debian Linux ===&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
!&lt;br /&gt;
!sodium en S.O.&lt;br /&gt;
!PHP&lt;br /&gt;
!libsodium en PHP&lt;br /&gt;
|-&lt;br /&gt;
|Debian 8&lt;br /&gt;
|1.0.11&lt;br /&gt;
|(0)&lt;br /&gt;
|(0) (1)&lt;br /&gt;
|-&lt;br /&gt;
|Debian 9&lt;br /&gt;
|''1.0.11''&lt;br /&gt;
|''7.0''&lt;br /&gt;
|''1.0.6''&lt;br /&gt;
|-&lt;br /&gt;
|Debian 10&lt;br /&gt;
|?&lt;br /&gt;
|?&lt;br /&gt;
|?&lt;br /&gt;
|}&lt;br /&gt;
Leyendas:&lt;br /&gt;
&lt;br /&gt;
( x.x.x ) se ha probado su integración en dicha versión con los paquetes nativos&lt;br /&gt;
&lt;br /&gt;
( ? )        versión desconocida, no liberado aún&lt;br /&gt;
&lt;br /&gt;
( 0 )       es posible instalarlo vía [https://deb.sury.org/ deb.sury.org], repositorio externo de paquetes PHP  para Debian &lt;br /&gt;
&lt;br /&gt;
( 1 )       es posible instalarlo vía PEAR, repositorio de extensiones PHP&lt;br /&gt;
&lt;br /&gt;
=== Debian 8 Jessie ===&lt;br /&gt;
Para esta versión de ''Debian'', no existen todos los paquetes oficialmente. Se han de recurrir a la configuración de repositorios externos, tales como [https://packages.sury.org/php/README.txt deb.sury.org] y a los [https://backports.debian.org/Instructions/ backports] del mismo Debian.&lt;br /&gt;
&lt;br /&gt;
Primero, agregar backports&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
echo &amp;quot;deb http://ftp.debian.org/debian jessie-backports main&amp;quot; &amp;gt;&amp;gt; /etc/apt/sources.list.d/backports.list&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Actualizar base de paquetes de apt&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
apt update&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Siguiente, se debe instalar la versión de Sodium del S.O. desde backports:&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
apt -t jessie-backports install libsodium18 libsodium-dev&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Luego, instalar la extensión para PHP de libsodium desde el repositorio PEAR:&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
pecl install -f libsodium-1.0.6&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Para finalizar, hay que asegurarse de que la extensión libsodium está cargada en PHP:&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
php -m | grep sodium&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
Si la salida es vacía ejecutar:&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
printf &amp;quot;extension=libsodium.so\n&amp;quot; &amp;gt; /etc/php/7.0/cli/conf.d/20-libsodium.ini&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Debian 9 Strech ===&lt;br /&gt;
Para esta versión de ''Debian'', la instalación es directamente de los paquetes oficiales disponibles en su repositorio.&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
apt install libsodium18 php-libsodium&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&amp;lt;blockquote&amp;gt;Nota: esta versión, es la actualmente recomendada para la instalación de la plataforma '''SIU-Araí''', versión 2.0.&amp;lt;/blockquote&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Debian 10 Buster ===&lt;br /&gt;
Esta versión de ''Debian'' es actualmente la versión testing y no soportada oficialmente. &lt;br /&gt;
&lt;br /&gt;
[[IT|&amp;lt; Volver]]&lt;/div&gt;</summary>
		<author><name>Ablanco</name></author>	</entry>

	<entry>
		<id>https://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Arai/usuarios/integracion-inicial-toba&amp;diff=41951</id>
		<title>SIU-Arai/usuarios/integracion-inicial-toba</title>
		<link rel="alternate" type="text/html" href="https://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Arai/usuarios/integracion-inicial-toba&amp;diff=41951"/>
				<updated>2018-05-23T19:06:07Z</updated>
		
		<summary type="html">&lt;p&gt;Ablanco: /* Generar las claves para encriptar */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;[[Archivo:siu-arai_iso.png|derecha|link=SIU-Arai]]&lt;br /&gt;
= Integrando una aplicación Toba =&lt;br /&gt;
&lt;br /&gt;
== Requisitos previos ==&lt;br /&gt;
&lt;br /&gt;
=== Utilizar la plataforma SIU-Arai ===&lt;br /&gt;
&lt;br /&gt;
Es un poco obvio, pero es necesario contar con [http://documentacion.siu.edu.ar/wiki/SIU-Arai/registry Arai-Registry] y [http://documentacion.siu.edu.ar/wiki/SIU-Arai/usuarios Arai-Usuarios] funcionando adecuadamente, para poder registrar una aplicación y hacer uso del IdP e IdM que provee la plataforma.&lt;br /&gt;
&lt;br /&gt;
=== Dependencias del Sistema Operativo ===&lt;br /&gt;
Para poder integrar correctamente una aplicación a la plataforma SIU-Araí en la versión 2, se tiene que instalar y dejar configurado de manera adecuada las versiones de las librerías relacionadas con Sodium. En esta [http://documentacion.siu.edu.ar/wiki/IT/Sodium guía] se describe requerimientos y versiones compatibles. Esto es necesario realizarlo para poder generar adecuadamente las claves de encriptación.&lt;br /&gt;
&lt;br /&gt;
=== Dependencias con Composer ===&lt;br /&gt;
&lt;br /&gt;
Es recomendable que el proyecto se gestione mediante '''''composer''''' para la instalación y actualización de librerías y dependencias. En la [http://toba.siu.edu.ar/trac/toba/wiki/Instalacion/Composer wiki] de SIU-Toba, se encuentra una referencia detallada de como realizar este paso.&lt;br /&gt;
&lt;br /&gt;
Una vez se tenga el archivo &amp;lt;code&amp;gt;composer.json&amp;lt;/code&amp;gt;, se debe editar y agregar una serie de dependencias:  &lt;br /&gt;
# [https://github.com/SIU-Toba/framework SIU-Toba] en la versión v3.0.22 o superior  &lt;br /&gt;
# La librería [http://documentacion.siu.edu.ar/wiki/SIU-Arai/arai-cli arai-cli] en la versión v2.3.0  o superior. Si se utiliza la versión v3.0.22 o superior de SIU-Toba, no es necesario incluir manualmente esta librería.   &lt;br /&gt;
# La librería [https://github.com/paragonie/halite Halite], en la versión v1.6.0. Es requerida para generar las claves de encriptación (aunque no es incluida por defecto).    &lt;br /&gt;
  &lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot; highlight=&amp;quot;3&amp;quot;&amp;gt;&lt;br /&gt;
  ...&lt;br /&gt;
  &amp;quot;require&amp;quot;: {&lt;br /&gt;
    &amp;quot;paragonie/halite&amp;quot;: &amp;quot;1.6.0&amp;quot;,&lt;br /&gt;
    &amp;quot;siu-toba/framework&amp;quot;: &amp;quot;^3.0.22&amp;quot;,&lt;br /&gt;
    &amp;quot;siu/arai-cli&amp;quot;: &amp;quot;^2.3.0&amp;quot;&lt;br /&gt;
  },&lt;br /&gt;
  ...&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Luego de realizar el cambio, siempre se debe proceder a actualizar la lista de dependencias:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
composer update&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Integración con Toba-Usuarios ===&lt;br /&gt;
Si el proyecto utiliza la gestión de usuarios que proporciona SIU-Toba, este punto es transparente y no requiere de cambios adicionales.  &lt;br /&gt;
&lt;br /&gt;
=== Claves para encriptación ===&lt;br /&gt;
A partir de la versión 2.0 de la plataforma, todo el intercambio que se produce entre  un módulo y '''SIU-Arai: Registry''', requiere tener generado y configurado una clave que será utilizada para encriptar la información sensible.  La librería arai-cli permite generar manualmente estas claves. Adicionalmente, el [https://gitlab.siu.edu.ar/siu/instalador instalador de proyectos SIU] permite automatizar esta generación y configuración al momento de realizar la instalación del proyecto.&lt;br /&gt;
&lt;br /&gt;
== Integrar al menú de aplicaciones ==&lt;br /&gt;
&lt;br /&gt;
SIU-Toba proporciona una implementación de barra o lanzador de apliaciones, desde el cual se puede acceder a todas las aplicaciones integradas a la plataforma SIU-Arai (siempre y cuando tenga permiso de acceder el usuario particular). Esto se activa configurando el archivo &amp;lt;code&amp;gt;proyecto.ini&amp;lt;/code&amp;gt; y agregando la siguente entrada:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;yaml&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
[proyecto]&lt;br /&gt;
...&lt;br /&gt;
;Esta entrada activa el uso del appLauncher&lt;br /&gt;
app_launcher = 1&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== Integrar a Arai-Registry la aplicación ==&lt;br /&gt;
&lt;br /&gt;
Gracias a la librería [http://documentacion.siu.edu.ar/wiki/SIU-Arai/arai-cli arai-cli], se pueden registrar las aplicaciones a la plataforma SIU-Arai de forma sencilla. En la [[SIU-Arai/registry#Funcionamiento|documentación]] de Arai-Registry se describe mayores detalles al respecto.&lt;br /&gt;
&lt;br /&gt;
=== Configurar las necesidades ===&lt;br /&gt;
&lt;br /&gt;
Arai-Registry permite indicar que servicios consume y proporciona una aplicación. Para ello lo primero a realizar es crear un archivo llamado &amp;lt;code&amp;gt;arai.json&amp;lt;/code&amp;gt; que esté ubicado en la raíz del proyecto con el siguiente contenido:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;yaml&amp;quot; enclose=&amp;quot;div&amp;quot; highlight=&amp;quot;2,5&amp;quot;&amp;gt;&lt;br /&gt;
{&lt;br /&gt;
  &amp;quot;name&amp;quot;: &amp;quot;institucion/proyecto&amp;quot;,&lt;br /&gt;
  &amp;quot;description&amp;quot;: &amp;quot;UNI-Proyecto, aplicación&amp;quot;,&lt;br /&gt;
  &amp;quot;scripts&amp;quot;: {&lt;br /&gt;
    &amp;quot;hooks&amp;quot;: &amp;quot;UNI\\Proyecto\\AraiRegistryHooks&amp;quot;&lt;br /&gt;
  },&lt;br /&gt;
&lt;br /&gt;
  &amp;quot;consume&amp;quot;: [&lt;br /&gt;
    {&lt;br /&gt;
      &amp;quot;name&amp;quot;: &amp;quot;service:siu/sso-saml-idp&amp;quot;,&lt;br /&gt;
      &amp;quot;version&amp;quot;: &amp;quot;&amp;gt;=0.1.0&amp;quot;&lt;br /&gt;
    },&lt;br /&gt;
    {&lt;br /&gt;
      &amp;quot;name&amp;quot;: &amp;quot;api:siu/arai-usuarios&amp;quot;,&lt;br /&gt;
      &amp;quot;version&amp;quot;: &amp;quot;&amp;gt;=0.1.0&amp;quot;,&lt;br /&gt;
      &amp;quot;options&amp;quot;: {&lt;br /&gt;
        &amp;quot;toba-rest&amp;quot;: [&lt;br /&gt;
          { &amp;quot;proyecto&amp;quot;: &amp;quot;toba_usuarios&amp;quot;, &amp;quot;rest-id&amp;quot;: &amp;quot;rest_arai_usuarios&amp;quot; }&lt;br /&gt;
        ]&lt;br /&gt;
      }&lt;br /&gt;
    }&lt;br /&gt;
  ]&lt;br /&gt;
}&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Es muy relevante establecer el atributo '''name''' y '''description''' con los valores deseados. Para el atributo '''hooks''', se debe completar con la ruta o ''namespace'' del proyecto hasta la clase php. Esta se crea en el siguiente paso.  &lt;br /&gt;
&lt;br /&gt;
=== Hook de auto-configuración ===&lt;br /&gt;
&lt;br /&gt;
El hook de configuración es una clase php que implementa la interfaz [https://hub.siu.edu.ar/siu-arai/arai-cli/blob/master/src/SIU/AraiCli/Services/Registry/HooksInterface.php HooksInterface]. Este archivo tiene una nomenclatura estándar, siempre se denomina ''AraiRegistryHooks'' y para proyectos SIU-Toba, extienden de ''RegistryHooksProyectoToba''. Se deberá crear dicha clase dentro del directorio /src del proyecto, o en algún punto que esté configurado con el autoloader de composer. Suponiendo en este ejemplo, el archivo sería &amp;lt;code&amp;gt;/src/UNI/Proyecto/AraiRegistryHooks.php&amp;lt;/code&amp;gt;:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;php&amp;quot; enclose=&amp;quot;div&amp;quot; highlight=&amp;quot;2&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;?php&lt;br /&gt;
namespace UNI\Proyecto;&lt;br /&gt;
&lt;br /&gt;
use SIUToba\Framework\Arai\RegistryHooksProyectoToba;&lt;br /&gt;
&lt;br /&gt;
class AraiRegistryHooks extends RegistryHooksProyectoToba&lt;br /&gt;
{&lt;br /&gt;
&lt;br /&gt;
}&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&amp;lt;blockquote&amp;gt;Recordar que la clase tiene que poder ser cargada por el autoloader de Composer. Ver [http://foro.comunidad.siu.edu.ar/index.php?topic=14708.msg63975#msg63975 ejemplo].&amp;lt;/blockquote&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Generar las claves para encriptar ===&lt;br /&gt;
Llegado a este punto, durante la instalación del proyecto y por única vez, será necesario como '''pre-requisito''' generar y configurar la clave  ''para encriptar la sincronización de api REST con Araí'' . Para hacerlo, se debe correr el siguiente comando:&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot; highlight=&amp;quot;4&amp;quot;&amp;gt;&lt;br /&gt;
./bin/arai-cli arai:generar-key --destino=/ruta/donde/guardar/arai-sync.key&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;También será necesario configurar en el archivo &amp;lt;code&amp;gt;instalacion.ini&amp;lt;/code&amp;gt; del proyecto, la entrada  &amp;lt;code&amp;gt;arai_sync_key_file&amp;lt;/code&amp;gt; con la ruta donde se aloja la clave previamente creada.&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot; highlight=&amp;quot;4&amp;quot;&amp;gt;&lt;br /&gt;
...&lt;br /&gt;
arai_sync_key_file=/ruta/donde/guardar/arai-sync.key&lt;br /&gt;
&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&amp;lt;blockquote&amp;gt;Estos pasos pueden ser opcionales implementando el instalador de proyectos SIU.&amp;lt;/blockquote&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Registrar el proyecto ===&lt;br /&gt;
&lt;br /&gt;
Si todo está en orden, por única vez, el proceso de registración a la plataforma SIU-Arai de la aplicación se concreta haciendo uso de la librería previamente  con el siguiente comando:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot; highlight=&amp;quot;4&amp;quot;&amp;gt;&lt;br /&gt;
./bin/arai-cli registry:add  \&lt;br /&gt;
    --maintainer nombre-encargado-admin \&lt;br /&gt;
    --maintainer-email email-encargado-admin@uni.edu.ar \&lt;br /&gt;
    http://url-arai-registry/arai-registry&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;blockquote&amp;gt;&lt;br /&gt;
Se debe proporcionar la url válida del servicio Arai-Registry, junto con los datos del administrador.&lt;br /&gt;
&amp;lt;/blockquote&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Siempre que registremos alguna aplicación a Araí-Registry, es necesario realizar un &amp;lt;code&amp;gt;registr:sync&amp;lt;/code&amp;gt; para que nuestra aplicación localmente tenga los datos más actualizados acerca de los diferentes servicios, aplicaciones y/o apis que querramos consumir. Además, si nuestra aplicación localmente agregó una nueva característica (ej. una [http://toba.siu.edu.ar/trac/toba/wiki/Referencia/Rest api REST]), este comando informará a Arai-Registry la ''buena nueva''.&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/arai-cli registry:sync&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;blockquote&amp;gt;&lt;br /&gt;
Este paso es necesario realizarlo también en Arai-Usuarios, para que este sistema se entere de la presencia de una nueva aplicación.&lt;br /&gt;
&amp;lt;/blockquote&amp;gt;&lt;br /&gt;
&lt;br /&gt;
A partir de este momento, al ingresar al proyecto, este debiera de redirigirnos a la página de login centralizado de la plataforma SIU-Araí. Una vez el usuario ha ingresado, nos redirige nuevamente hacia la aplicación. La misma debiera de contar además con el menú de aplicaciones integrado.&lt;/div&gt;</summary>
		<author><name>Ablanco</name></author>	</entry>

	<entry>
		<id>https://documentacion.siu.edu.ar/wiki/index.php?title=IT/Sodium&amp;diff=41950</id>
		<title>IT/Sodium</title>
		<link rel="alternate" type="text/html" href="https://documentacion.siu.edu.ar/wiki/index.php?title=IT/Sodium&amp;diff=41950"/>
				<updated>2018-05-23T18:50:51Z</updated>
		
		<summary type="html">&lt;p&gt;Ablanco: /* Debian 8 Jessie */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;[[Archivo:siu-arai_iso.png|derecha|link=IT]]&lt;br /&gt;
&amp;lt;br&amp;gt;&lt;br /&gt;
= Sodium: librería para encriptación =&lt;br /&gt;
[https://libsodium.org Sodium] es una librería de software moderna, fácil de usar, para la encriptación, desencriptación, signatures, password hashing y más.  Al ser una librería estándar que se ha ganado su reconocimiento, se han implementado bindings en múchos lenguajes incluído para [https://github.com/jedisct1/libsodium-php PHP]. &lt;br /&gt;
&lt;br /&gt;
De esta forma, las soluciones SIU hacen uso de Sodium mediante la librería [https://paragonie.com/project/halite Paragonie/Halite] que facilita llevar adelante la implementación de [[SIU-Arai/Arquitectura|diversas funciones]].&lt;br /&gt;
&lt;br /&gt;
== Organización ==&lt;br /&gt;
Hay que comprender de forma precisa la organización de los componentes que nos permiten utilizar dicha librería, pues están muy correlacionados entre sí.&lt;br /&gt;
* Sodium existe a nivel sistema operativo u S.O., es una librería en C que implementa todas las funciones de criptoanálisis&lt;br /&gt;
* Sodium como extensión en PHP, permite acceder a la librería del S.O y hacer uso de las funciones de criptoanálisis&lt;br /&gt;
*# existe una variante como extensión PECL&lt;br /&gt;
*# existe como extensión ya embebida en el core de PHP&lt;br /&gt;
* Paragonie/Halite, la librería hecha en PHP e integrada a los proyectos SIU. Es la que facilita el uso de diversos mecanismos de encriptación y protección, todos basados en Sodium&lt;br /&gt;
&lt;br /&gt;
== Versiones ==&lt;br /&gt;
&lt;br /&gt;
A continuación se detalla la correlación entre las versiones de cada uno de los componentes, tanto con la versión de PHP como con la versión de la plataforma SIU-Araí. Los componentes principales de SIU-Araí lo validan explícitamente.&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
!&lt;br /&gt;
!PHP&lt;br /&gt;
!libsodium en PHP&lt;br /&gt;
!sodium en S.O.&lt;br /&gt;
!SIU-Araí&lt;br /&gt;
|-&lt;br /&gt;
|Paragonie/Halite 1.6&lt;br /&gt;
|5.6 - 7.0 - 7.1&lt;br /&gt;
|1.0.6 a 1.0.7&lt;br /&gt;
|1.0.6 o superior&lt;br /&gt;
|2.0.0&lt;br /&gt;
|-&lt;br /&gt;
|Paragonie/Halite 3.x&lt;br /&gt;
|7.0 - 7.1 - 7.2&lt;br /&gt;
|2.0.4 a 2.0.10&lt;br /&gt;
|1.0.9 o superior&lt;br /&gt;
|x&lt;br /&gt;
|-&lt;br /&gt;
|Paragonie/Halite 4.x&lt;br /&gt;
|7.2&lt;br /&gt;
| -&lt;br /&gt;
|1.0.13 o superior&lt;br /&gt;
|x&lt;br /&gt;
|}&lt;br /&gt;
Leyendas:&lt;br /&gt;
&lt;br /&gt;
( x.x.x ) se ha probado su integración en dicha versión&lt;br /&gt;
&lt;br /&gt;
( - )         integrada al [http://php.net/manual/en/book.sodium.php core] de PHP en la versión [http://php.net/manual/en/book.sodium.php 7.2]&lt;br /&gt;
&lt;br /&gt;
( x )        no se ha hecho integración con la plataforma&lt;br /&gt;
&lt;br /&gt;
== Instalación ==&lt;br /&gt;
&lt;br /&gt;
La instalación de todas las librerías requeridas varía de sistema operativo a sistema operativo. A continuación se expone algunos ejemplos habituales de instalación en sistemas Linux reconocidos.&lt;br /&gt;
&lt;br /&gt;
=== Debian Linux ===&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
!&lt;br /&gt;
!sodium en S.O.&lt;br /&gt;
!PHP&lt;br /&gt;
!libsodium en PHP&lt;br /&gt;
|-&lt;br /&gt;
|Debian 8&lt;br /&gt;
|1.0.11&lt;br /&gt;
|(0)&lt;br /&gt;
|(0) (1)&lt;br /&gt;
|-&lt;br /&gt;
|Debian 9&lt;br /&gt;
|''1.0.11''&lt;br /&gt;
|''7.0''&lt;br /&gt;
|''1.0.6''&lt;br /&gt;
|-&lt;br /&gt;
|Debian 10&lt;br /&gt;
|?&lt;br /&gt;
|?&lt;br /&gt;
|?&lt;br /&gt;
|}&lt;br /&gt;
Leyendas:&lt;br /&gt;
&lt;br /&gt;
( x.x.x ) se ha probado su integración en dicha versión con los paquetes nativos&lt;br /&gt;
&lt;br /&gt;
( ? )        versión desconocida, no liberado aún&lt;br /&gt;
&lt;br /&gt;
( 0 )       es posible instalarlo vía [https://deb.sury.org/ deb.sury.org], repositorio externo de paquetes PHP  para Debian &lt;br /&gt;
&lt;br /&gt;
( 1 )       es posible instalarlo vía PEAR, repositorio de extensiones PHP&lt;br /&gt;
&lt;br /&gt;
=== Debian 8 Jessie ===&lt;br /&gt;
Para esta versión de ''Debian'', no existen todos los paquetes oficialmente. Se han de recurrir a la configuración de repositorios externos, tales como [https://packages.sury.org/php/README.txt deb.sury.org] y a los [https://backports.debian.org/Instructions/ backports] del mismo Debian.&lt;br /&gt;
&lt;br /&gt;
Primero, agregar backports&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
echo &amp;quot;deb http://ftp.debian.org/debian jessie-backports main&amp;quot; &amp;gt;&amp;gt; /etc/apt/sources.list.d/backports.list&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Actualizar base de paquetes de apt&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
apt update&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Siguiente, se debe instalar la versión de Sodium del S.O. desde backports:&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
apt -t jessie-backports install libsodium18 libsodium-dev&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Luego, instalar la extensión para PHP de libsodium desde el repositorio PEAR:&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
pecl install -f libsodium-1.0.6&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Para finalizar, hay que asegurarse de que la extensión libsodium está cargada en PHP (la entrada '''extension=libsodium.so''' debe estar presente en el .ini)&lt;br /&gt;
&lt;br /&gt;
=== Debian 9 Strech ===&lt;br /&gt;
Para esta versión de ''Debian'', la instalación es directamente de los paquetes oficiales disponibles en su repositorio.&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
apt install libsodium18 php-libsodium&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&amp;lt;blockquote&amp;gt;Nota: esta versión, es la actualmente recomendada para la instalación de la plataforma '''SIU-Araí''', versión 2.0.&amp;lt;/blockquote&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Debian 10 Buster ===&lt;br /&gt;
Esta versión de ''Debian'' es actualmente la versión testing y no soportada oficialmente. &lt;br /&gt;
&lt;br /&gt;
[[IT|&amp;lt; Volver]]&lt;/div&gt;</summary>
		<author><name>Ablanco</name></author>	</entry>

	<entry>
		<id>https://documentacion.siu.edu.ar/wiki/index.php?title=IT/Sodium&amp;diff=41948</id>
		<title>IT/Sodium</title>
		<link rel="alternate" type="text/html" href="https://documentacion.siu.edu.ar/wiki/index.php?title=IT/Sodium&amp;diff=41948"/>
				<updated>2018-05-23T18:32:37Z</updated>
		
		<summary type="html">&lt;p&gt;Ablanco: /* Debian 8 Jessie */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;[[Archivo:siu-arai_iso.png|derecha|link=IT]]&lt;br /&gt;
&amp;lt;br&amp;gt;&lt;br /&gt;
= Sodium: librería para encriptación =&lt;br /&gt;
[https://libsodium.org Sodium] es una librería de software moderna, fácil de usar, para la encriptación, desencriptación, signatures, password hashing y más.  Al ser una librería estándar que se ha ganado su reconocimiento, se han implementado bindings en múchos lenguajes incluído para [https://github.com/jedisct1/libsodium-php PHP]. &lt;br /&gt;
&lt;br /&gt;
De esta forma, las soluciones SIU hacen uso de Sodium mediante la librería [https://paragonie.com/project/halite Paragonie/Halite] que facilita llevar adelante la implementación de [[SIU-Arai/Arquitectura|diversas funciones]].&lt;br /&gt;
&lt;br /&gt;
== Organización ==&lt;br /&gt;
Hay que comprender de forma precisa la organización de los componentes que nos permiten utilizar dicha librería, pues están muy correlacionados entre sí.&lt;br /&gt;
* Sodium existe a nivel sistema operativo u S.O., es una librería en C que implementa todas las funciones de criptoanálisis&lt;br /&gt;
* Sodium como extensión en PHP, permite acceder a la librería del S.O y hacer uso de las funciones de criptoanálisis&lt;br /&gt;
*# existe una variante como extensión PECL&lt;br /&gt;
*# existe como extensión ya embebida en el core de PHP&lt;br /&gt;
* Paragonie/Halite, la librería hecha en PHP e integrada a los proyectos SIU. Es la que facilita el uso de diversos mecanismos de encriptación y protección, todos basados en Sodium&lt;br /&gt;
&lt;br /&gt;
== Versiones ==&lt;br /&gt;
&lt;br /&gt;
A continuación se detalla la correlación entre las versiones de cada uno de los componentes, tanto con la versión de PHP como con la versión de la plataforma SIU-Araí. Los componentes principales de SIU-Araí lo validan explícitamente.&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
!&lt;br /&gt;
!PHP&lt;br /&gt;
!libsodium en PHP&lt;br /&gt;
!sodium en S.O.&lt;br /&gt;
!SIU-Araí&lt;br /&gt;
|-&lt;br /&gt;
|Paragonie/Halite 1.6&lt;br /&gt;
|5.6 - 7.0 - 7.1&lt;br /&gt;
|1.0.6 a 1.0.7&lt;br /&gt;
|1.0.6 o superior&lt;br /&gt;
|2.0.0&lt;br /&gt;
|-&lt;br /&gt;
|Paragonie/Halite 3.x&lt;br /&gt;
|7.0 - 7.1 - 7.2&lt;br /&gt;
|2.0.4 a 2.0.10&lt;br /&gt;
|1.0.9 o superior&lt;br /&gt;
|x&lt;br /&gt;
|-&lt;br /&gt;
|Paragonie/Halite 4.x&lt;br /&gt;
|7.2&lt;br /&gt;
| -&lt;br /&gt;
|1.0.13 o superior&lt;br /&gt;
|x&lt;br /&gt;
|}&lt;br /&gt;
Leyendas:&lt;br /&gt;
&lt;br /&gt;
( x.x.x ) se ha probado su integración en dicha versión&lt;br /&gt;
&lt;br /&gt;
( - )         integrada al [http://php.net/manual/en/book.sodium.php core] de PHP en la versión [http://php.net/manual/en/book.sodium.php 7.2]&lt;br /&gt;
&lt;br /&gt;
( x )        no se ha hecho integración con la plataforma&lt;br /&gt;
&lt;br /&gt;
== Instalación ==&lt;br /&gt;
&lt;br /&gt;
La instalación de todas las librerías requeridas varía de sistema operativo a sistema operativo. A continuación se expone algunos ejemplos habituales de instalación en sistemas Linux reconocidos.&lt;br /&gt;
&lt;br /&gt;
=== Debian Linux ===&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
!&lt;br /&gt;
!sodium en S.O.&lt;br /&gt;
!PHP&lt;br /&gt;
!libsodium en PHP&lt;br /&gt;
|-&lt;br /&gt;
|Debian 8&lt;br /&gt;
|1.0.11&lt;br /&gt;
|(0)&lt;br /&gt;
|(0) (1)&lt;br /&gt;
|-&lt;br /&gt;
|Debian 9&lt;br /&gt;
|''1.0.11''&lt;br /&gt;
|''7.0''&lt;br /&gt;
|''1.0.6''&lt;br /&gt;
|-&lt;br /&gt;
|Debian 10&lt;br /&gt;
|?&lt;br /&gt;
|?&lt;br /&gt;
|?&lt;br /&gt;
|}&lt;br /&gt;
Leyendas:&lt;br /&gt;
&lt;br /&gt;
( x.x.x ) se ha probado su integración en dicha versión con los paquetes nativos&lt;br /&gt;
&lt;br /&gt;
( ? )        versión desconocida, no liberado aún&lt;br /&gt;
&lt;br /&gt;
( 0 )       es posible instalarlo vía [https://deb.sury.org/ deb.sury.org], repositorio externo de paquetes PHP  para Debian &lt;br /&gt;
&lt;br /&gt;
( 1 )       es posible instalarlo vía PEAR, repositorio de extensiones PHP&lt;br /&gt;
&lt;br /&gt;
=== Debian 8 Jessie ===&lt;br /&gt;
Para esta versión de ''Debian'', no existen todos los paquetes oficialmente. Se han de recurrir a la configuración de repositorios externos, tales como [https://packages.sury.org/php/README.txt deb.sury.org] y a los [https://backports.debian.org/Instructions/ backports] del mismo Debian.&lt;br /&gt;
&lt;br /&gt;
Primero, agregar backports&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
echo &amp;quot;deb http://ftp.debian.org/debian jessie-backports main&amp;quot; &amp;gt;&amp;gt; /etc/apt/sources.list.d/backports.list&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Actualizar base de paquetes de apt&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
apt update&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Siguiente, se debe instalar la versión de Sodium del S.O. desde backports:&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
apt -t jessie-backports install libsodium18&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Luego, instalar la extensión para PHP de libsodium desde el repositorio PEAR:&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
pecl install -f libsodium-1.0.6&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Para finalizar, hay que asegurarse de que la extensión libsodium está cargada en PHP (la entrada '''extension=libsodium.so''' debe estar presente en el .ini)&lt;br /&gt;
&lt;br /&gt;
=== Debian 9 Strech ===&lt;br /&gt;
Para esta versión de ''Debian'', la instalación es directamente de los paquetes oficiales disponibles en su repositorio.&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
apt install libsodium18 php-libsodium&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&amp;lt;blockquote&amp;gt;Nota: esta versión, es la actualmente recomendada para la instalación de la plataforma '''SIU-Araí''', versión 2.0.&amp;lt;/blockquote&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Debian 10 Buster ===&lt;br /&gt;
Esta versión de ''Debian'' es actualmente la versión testing y no soportada oficialmente. &lt;br /&gt;
&lt;br /&gt;
[[IT|&amp;lt; Volver]]&lt;/div&gt;</summary>
		<author><name>Ablanco</name></author>	</entry>

	<entry>
		<id>https://documentacion.siu.edu.ar/wiki/index.php?title=IT/Sodium&amp;diff=41947</id>
		<title>IT/Sodium</title>
		<link rel="alternate" type="text/html" href="https://documentacion.siu.edu.ar/wiki/index.php?title=IT/Sodium&amp;diff=41947"/>
				<updated>2018-05-23T18:31:50Z</updated>
		
		<summary type="html">&lt;p&gt;Ablanco: /* Debian 8 Jessie */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;[[Archivo:siu-arai_iso.png|derecha|link=IT]]&lt;br /&gt;
&amp;lt;br&amp;gt;&lt;br /&gt;
= Sodium: librería para encriptación =&lt;br /&gt;
[https://libsodium.org Sodium] es una librería de software moderna, fácil de usar, para la encriptación, desencriptación, signatures, password hashing y más.  Al ser una librería estándar que se ha ganado su reconocimiento, se han implementado bindings en múchos lenguajes incluído para [https://github.com/jedisct1/libsodium-php PHP]. &lt;br /&gt;
&lt;br /&gt;
De esta forma, las soluciones SIU hacen uso de Sodium mediante la librería [https://paragonie.com/project/halite Paragonie/Halite] que facilita llevar adelante la implementación de [[SIU-Arai/Arquitectura|diversas funciones]].&lt;br /&gt;
&lt;br /&gt;
== Organización ==&lt;br /&gt;
Hay que comprender de forma precisa la organización de los componentes que nos permiten utilizar dicha librería, pues están muy correlacionados entre sí.&lt;br /&gt;
* Sodium existe a nivel sistema operativo u S.O., es una librería en C que implementa todas las funciones de criptoanálisis&lt;br /&gt;
* Sodium como extensión en PHP, permite acceder a la librería del S.O y hacer uso de las funciones de criptoanálisis&lt;br /&gt;
*# existe una variante como extensión PECL&lt;br /&gt;
*# existe como extensión ya embebida en el core de PHP&lt;br /&gt;
* Paragonie/Halite, la librería hecha en PHP e integrada a los proyectos SIU. Es la que facilita el uso de diversos mecanismos de encriptación y protección, todos basados en Sodium&lt;br /&gt;
&lt;br /&gt;
== Versiones ==&lt;br /&gt;
&lt;br /&gt;
A continuación se detalla la correlación entre las versiones de cada uno de los componentes, tanto con la versión de PHP como con la versión de la plataforma SIU-Araí. Los componentes principales de SIU-Araí lo validan explícitamente.&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
!&lt;br /&gt;
!PHP&lt;br /&gt;
!libsodium en PHP&lt;br /&gt;
!sodium en S.O.&lt;br /&gt;
!SIU-Araí&lt;br /&gt;
|-&lt;br /&gt;
|Paragonie/Halite 1.6&lt;br /&gt;
|5.6 - 7.0 - 7.1&lt;br /&gt;
|1.0.6 a 1.0.7&lt;br /&gt;
|1.0.6 o superior&lt;br /&gt;
|2.0.0&lt;br /&gt;
|-&lt;br /&gt;
|Paragonie/Halite 3.x&lt;br /&gt;
|7.0 - 7.1 - 7.2&lt;br /&gt;
|2.0.4 a 2.0.10&lt;br /&gt;
|1.0.9 o superior&lt;br /&gt;
|x&lt;br /&gt;
|-&lt;br /&gt;
|Paragonie/Halite 4.x&lt;br /&gt;
|7.2&lt;br /&gt;
| -&lt;br /&gt;
|1.0.13 o superior&lt;br /&gt;
|x&lt;br /&gt;
|}&lt;br /&gt;
Leyendas:&lt;br /&gt;
&lt;br /&gt;
( x.x.x ) se ha probado su integración en dicha versión&lt;br /&gt;
&lt;br /&gt;
( - )         integrada al [http://php.net/manual/en/book.sodium.php core] de PHP en la versión [http://php.net/manual/en/book.sodium.php 7.2]&lt;br /&gt;
&lt;br /&gt;
( x )        no se ha hecho integración con la plataforma&lt;br /&gt;
&lt;br /&gt;
== Instalación ==&lt;br /&gt;
&lt;br /&gt;
La instalación de todas las librerías requeridas varía de sistema operativo a sistema operativo. A continuación se expone algunos ejemplos habituales de instalación en sistemas Linux reconocidos.&lt;br /&gt;
&lt;br /&gt;
=== Debian Linux ===&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
!&lt;br /&gt;
!sodium en S.O.&lt;br /&gt;
!PHP&lt;br /&gt;
!libsodium en PHP&lt;br /&gt;
|-&lt;br /&gt;
|Debian 8&lt;br /&gt;
|1.0.11&lt;br /&gt;
|(0)&lt;br /&gt;
|(0) (1)&lt;br /&gt;
|-&lt;br /&gt;
|Debian 9&lt;br /&gt;
|''1.0.11''&lt;br /&gt;
|''7.0''&lt;br /&gt;
|''1.0.6''&lt;br /&gt;
|-&lt;br /&gt;
|Debian 10&lt;br /&gt;
|?&lt;br /&gt;
|?&lt;br /&gt;
|?&lt;br /&gt;
|}&lt;br /&gt;
Leyendas:&lt;br /&gt;
&lt;br /&gt;
( x.x.x ) se ha probado su integración en dicha versión con los paquetes nativos&lt;br /&gt;
&lt;br /&gt;
( ? )        versión desconocida, no liberado aún&lt;br /&gt;
&lt;br /&gt;
( 0 )       es posible instalarlo vía [https://deb.sury.org/ deb.sury.org], repositorio externo de paquetes PHP  para Debian &lt;br /&gt;
&lt;br /&gt;
( 1 )       es posible instalarlo vía PEAR, repositorio de extensiones PHP&lt;br /&gt;
&lt;br /&gt;
=== Debian 8 Jessie ===&lt;br /&gt;
Para esta versión de ''Debian'', no existen todos los paquetes oficialmente. Se han de recurrir a la configuración de repositorios externos, tales como [https://packages.sury.org/php/README.txt deb.sury.org] y a los [https://backports.debian.org/Instructions/ backports] del mismo Debian.&lt;br /&gt;
&lt;br /&gt;
Primero, agregar backports&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
echo &amp;quot;deb http://ftp.debian.org/debian jessie-backports main&amp;quot; &amp;gt;&amp;gt; /etc/apt/sources.list.d/backports.list&lt;br /&gt;
&lt;br /&gt;
apt update&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Siguiente, se debe instalar la versión de Sodium del S.O. desde backports:&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
apt -t jessie-backports install libsodium18&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Luego, instalar la extensión para PHP de libsodium desde el repositorio PEAR:&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
pecl install -f libsodium-1.0.6&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Para finalizar, hay que asegurarse de que la extensión libsodium está cargada en PHP (la entrada '''extension=libsodium.so''' debe estar presente en el .ini)&lt;br /&gt;
&lt;br /&gt;
=== Debian 9 Strech ===&lt;br /&gt;
Para esta versión de ''Debian'', la instalación es directamente de los paquetes oficiales disponibles en su repositorio.&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
apt install libsodium18 php-libsodium&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&amp;lt;blockquote&amp;gt;Nota: esta versión, es la actualmente recomendada para la instalación de la plataforma '''SIU-Araí''', versión 2.0.&amp;lt;/blockquote&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Debian 10 Buster ===&lt;br /&gt;
Esta versión de ''Debian'' es actualmente la versión testing y no soportada oficialmente. &lt;br /&gt;
&lt;br /&gt;
[[IT|&amp;lt; Volver]]&lt;/div&gt;</summary>
		<author><name>Ablanco</name></author>	</entry>

	<entry>
		<id>https://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Arai/Instalacion&amp;diff=40711</id>
		<title>SIU-Arai/Instalacion</title>
		<link rel="alternate" type="text/html" href="https://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Arai/Instalacion&amp;diff=40711"/>
				<updated>2018-04-16T20:37:13Z</updated>
		
		<summary type="html">&lt;p&gt;Ablanco: /* Ejemplos completos */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;[[Archivo:siu-arai.png|derecha|link=]]&lt;br /&gt;
&amp;lt;br&amp;gt;&lt;br /&gt;
=Instalando la plataforma=&lt;br /&gt;
El proceso de instalación y configuración de la plataforma implica realizar la tarea de forma individual en cada uno de los componentes.&lt;br /&gt;
#[http://documentacion.siu.edu.ar/wiki/SIU-Arai/Prerequisitos Antes de instalar]: requerimientos que hay que tener en cuenta&lt;br /&gt;
#Componentes&lt;br /&gt;
#*'''&amp;lt;u&amp;gt;SIU-Arai: Registry&amp;lt;/u&amp;gt;''', [https://hub.siu.edu.ar/siu-arai/arai-registry/blob/master/doc/INSTALACION_MANUAL.md documentación] de la versión actual&lt;br /&gt;
#*&amp;lt;u&amp;gt;'''SIU-Arai: Usuarios'''&amp;lt;/u&amp;gt;, [https://hub.siu.edu.ar/siu-arai/arai-usuarios/blob/master/doc/INSTALACION_MANUAL.md documentación] de la versión actual&lt;br /&gt;
#*'''&amp;lt;u&amp;gt;SIU-Huarpe&amp;lt;/u&amp;gt;''', [https://hub.siu.edu.ar/siu-arai/huarpe-core/blob/master/doc/INSTALACION_MANUAL.md documentación] de la versión actual&lt;br /&gt;
&amp;lt;blockquote&amp;gt;Nota: la documentación está estructurada de acuerdo a la organización descrita en la sección [[SIU-Arai/Trabajo|Forma de trabajo]].&amp;lt;/blockquote&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== Ejemplos completos ==&lt;br /&gt;
A continuación se presentan guías de ejemplo acerca de como realizar el despliegue de la plataforma en distintos ambientes y situaciones. Estos tutoriales ''son realizados  para demostrar las características y funciones, no siendo exhaustivos en las consideraciones para su despliegue en ambientes de producción''. &lt;br /&gt;
#[http://documentacion.siu.edu.ar/wiki/SIU-Arai/arai2ejemplo Ejemplo completo] para despliegue de la versión 2.0&lt;br /&gt;
#Despliegue en ambientes de contenedores (Docker, Kubernetes, etc.)&lt;br /&gt;
# [http://documentacion.siu.edu.ar/wiki/SIU-Arai/ejemploPasoAPaso Ejemplo completo] para despliegue de la versión 1.x.x (basada en '''ssl client''')&lt;br /&gt;
&lt;br /&gt;
[[SIU-Arai|&amp;lt; Volver]]&lt;/div&gt;</summary>
		<author><name>Ablanco</name></author>	</entry>

	<entry>
		<id>https://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Arai/arai2ejemplo&amp;diff=40710</id>
		<title>SIU-Arai/arai2ejemplo</title>
		<link rel="alternate" type="text/html" href="https://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Arai/arai2ejemplo&amp;diff=40710"/>
				<updated>2018-04-16T20:34:52Z</updated>
		
		<summary type="html">&lt;p&gt;Ablanco: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;[[Archivo:siu-arai_iso.png|derecha|link=SIU-Arai]]&lt;br /&gt;
&lt;br /&gt;
= Ejemplo paso a paso =&lt;br /&gt;
Para este caso voy a usar una instalación de Debian Jessie&lt;br /&gt;
&lt;br /&gt;
El objetivo es tener una instalación funcionando de la paltaforma SIU-Arai que luego sirva para integrar otros sistemas toba.&lt;br /&gt;
&lt;br /&gt;
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í&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable zebra&amp;quot;&lt;br /&gt;
! colspan=&amp;quot;2&amp;quot; |URLs&lt;br /&gt;
|-&lt;br /&gt;
|Araí-Registry&lt;br /&gt;
|http://registry.local.siu&lt;br /&gt;
|-&lt;br /&gt;
|Araí-Usuarios&lt;br /&gt;
|http://usuarios.local.siu&lt;br /&gt;
|-&lt;br /&gt;
|Araí-Huarpe&lt;br /&gt;
|http://huarpe.local.siu&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
== Encontrando errores ==&lt;br /&gt;
=== Instalación ===&lt;br /&gt;
Si hay problemas durante la instalación de algún paquete puede verificar el archivo '''instalador.log''' que se encuentra en la raíz de cada proyecto para obtener más información.&lt;br /&gt;
&lt;br /&gt;
=== Runtime ===&lt;br /&gt;
Durante la instalación se redirigirán todos los logs hacía el '''error_log''', así que todos los problemas de runtime aparecerán en el log de Apache.&lt;br /&gt;
&lt;br /&gt;
== Instalación Arai-Registy ==&lt;br /&gt;
Creamos la carpeta '''/home/usuario/siu''' y no posicionamos ahí&lt;br /&gt;
Clonamos el proyecto &lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
git clone -b master https://hub.siu.edu.ar/siu-arai/arai-registry.git registry&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
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.&lt;br /&gt;
&lt;br /&gt;
Dentro del directorio del proyecto encontramos el archivo &amp;quot;doc/INSTALACION MANUAL.md&amp;quot;, la idea es seguir las instrucciones que encontramos en este archivo.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
cd registry&lt;br /&gt;
composer install --no-dev&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
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.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
cp templates/arai-registry.env.dist arai-registry.env&lt;br /&gt;
nano arai-registry.env&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
'''arai-registry.env'''&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
# config de la aplicacion&lt;br /&gt;
ARAI_REGISTRY_ALIAS=&amp;quot;/arai-registry&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_USER=&amp;quot;user&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_PASS=&amp;quot;pass&amp;quot;&lt;br /&gt;
&lt;br /&gt;
# config de la base de datos&lt;br /&gt;
ARAI_REGISTRY_DB_HOST=&amp;quot;172.27.31.114&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_DB_PORT=&amp;quot;7432&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_DB_DBNAME=&amp;quot;siu_registry&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_DB_USERNAME=&amp;quot;postgres&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_DB_PASSWORD=&amp;quot;postgres&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_DB_SCHEMA=&amp;quot;registry&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_DB_ENCODING=&amp;quot;UTF8&amp;quot;&lt;br /&gt;
&lt;br /&gt;
###### CONFIG DE LOGS ######&lt;br /&gt;
ARAI_REGISTRY_LOG_HANDLER=&amp;quot;errorlog&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_LOG_LEVEL=&amp;quot;WARNING&amp;quot;&lt;br /&gt;
&lt;br /&gt;
# config del instalador&lt;br /&gt;
INSTALADOR_TIMEOUT=&amp;quot;360&amp;quot;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Una vez editado, verificamos que la configuración sea correcta&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
bin/instalador proyecto:verificar&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Si no sale ninguna alerta, procedemos a instalar. Si sale la alerta de que no existe la base de datos especificada, se puede crear agregando la opción --crear-db al siguiente comando.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
bin/instalador proyecto:instalar&lt;br /&gt;
sudo ln -s ~/registry/config/alias.conf /etc/apache2/sites-available/registry.alias.conf&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Una vez instalado, modificamos los permisos de los archivos de la instalación con el comando&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
sudo ./bin/instalador permisos:simple&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Luego configuramos Apache.&lt;br /&gt;
&lt;br /&gt;
Así me quedo el archivo '''/etc/apache/sites-enabled/registry.conf'''&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;VirtualHost *:80&amp;gt;&lt;br /&gt;
   ServerName registry.local.siu&lt;br /&gt;
   Include ../sites-available/registry.alias.conf&lt;br /&gt;
   ErrorLog ${APACHE_LOG_DIR}/error.log&lt;br /&gt;
   Custom ${APACHE_LOG_DIR}/access.log combined&lt;br /&gt;
&amp;lt;/VirtualHost&amp;gt;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Con todo esto, para verificar que todo funcione reiniciamos Apache y ejecutamos&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
curl --user user:pass http://registry.local.siu/arai-registry/rest/packages/1&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Si la salida es:&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
{&lt;br /&gt;
    &amp;quot;error&amp;quot;: 404,&lt;br /&gt;
    &amp;quot;mensaje&amp;quot;: &amp;quot;404 Not Found&amp;quot;,&lt;br /&gt;
    &amp;quot;descripcion&amp;quot;: &amp;quot;El paquete solicitado no existe&amp;quot;&lt;br /&gt;
}&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
es que la instalación funcionó correctamente.&lt;br /&gt;
&lt;br /&gt;
Con registry instalado procedemos a instalar Usuarios&lt;br /&gt;
&lt;br /&gt;
==Arai-Usuarios==&lt;br /&gt;
&lt;br /&gt;
Nos posicionamos en ~/siu y clonamos el proyecto&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
git clone -b master https://hub.siu.edu.ar/siu-arai/arai-usuarios.git usuarios&lt;br /&gt;
cd usuarios&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Para instalar seguimos la documentación del archivo '''doc/INSTALACION_MANUAL.md'''&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
composer install --no-dev&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Si no se cuenta con certificados para el IDp SAML, se pueden generar con el siguiente comando&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
bin/instalador instalacion:generar-certs-idp -d /home/usuario/siu/usuarios/config/certs_idp -n&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
Donde '''-d''' especifica el directorio donde quedarán las claves (pública y PRIVADA). Este directorio se debe agregar en las variables del Instalador llamadas '''ARAI_USUARIOS_IDP_KEY_FILE''' y '''ARAI_USUARIOS_IDP_CERT_FILE'''.&lt;br /&gt;
&lt;br /&gt;
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.&lt;br /&gt;
Para la configuración de LDAP se asume un servidor que ya está funcionando y configurado. Existen documentación específica sobre este tema en el archivo '''INSTALACION_MANUAL.md'''&lt;br /&gt;
La variable TOBA_USUARIO debe contener el mismo usuarios administrado del LDAP.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
cp templates/arai-usuarios.env.dist arai-usuarios.env&lt;br /&gt;
nano arai-usuarios.env&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
'''arai-usuarios.env.dist'''&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
###### CONFIG DEL INSTALADR ######&lt;br /&gt;
#INSTALADOR_TIMEOUT=&amp;quot;360&amp;quot;&lt;br /&gt;
ENTORNO_PRODUCCION=&amp;quot;1&amp;quot;&lt;br /&gt;
&lt;br /&gt;
###### VARIABLES GLOBALES DEL ARCHIVO ######&lt;br /&gt;
ARAI_USUARIOS_DIR=/home/usuario/siu/usuarios&lt;br /&gt;
&lt;br /&gt;
###### CONFIG DE TOBA ######&lt;br /&gt;
TOBA_URL_BASE=&amp;quot;https://usuarios.local.siu&amp;quot;&lt;br /&gt;
#TOBA_URL_PORT=&amp;quot;443&amp;quot;&lt;br /&gt;
TOBA_USUARIO=&amp;quot;admin&amp;quot;&lt;br /&gt;
TOBA_PASSWORD=&amp;quot;admin1234&amp;quot;&lt;br /&gt;
TOBA_INSTALACION_DIR=&amp;quot;${ARAI_USUARIOS_DIR}/instalacion&amp;quot;&lt;br /&gt;
TOBA_PROYECTO_DIR=&amp;quot;${ARAI_USUARIOS_DIR}/gestion&amp;quot;&lt;br /&gt;
TOBA_ALIAS_PROYECTO=&amp;quot;/gestion&amp;quot;&lt;br /&gt;
TOBA_ALIAS_NUCLEO=&amp;quot;/toba_gestion&amp;quot;&lt;br /&gt;
#TOBA_ID_DESARROLLADOR=0&lt;br /&gt;
#TOBA_SESSION_NAME=&amp;quot;ARAI_SESSID&amp;quot;&lt;br /&gt;
&lt;br /&gt;
###### CONFIG DE BASE DE DATOS DE NEGOCIO ######&lt;br /&gt;
PROYECTO_DB_HOST=&amp;quot;172.27.31.114&amp;quot;&lt;br /&gt;
PROYECTO_DB_PORT=&amp;quot;7432&amp;quot;&lt;br /&gt;
PROYECTO_DB_DBNAME=&amp;quot;siu_usuarios&amp;quot;&lt;br /&gt;
PROYECTO_DB_USERNAME=&amp;quot;postgres&amp;quot;&lt;br /&gt;
PROYECTO_DB_PASSWORD=&amp;quot;postgres&amp;quot;&lt;br /&gt;
PROYECTO_DB_SCHEMA=&amp;quot;usuarios&amp;quot;&lt;br /&gt;
PROYECTO_DB_ENCODING=&amp;quot;LATIN1&amp;quot;&lt;br /&gt;
&lt;br /&gt;
###### CONFIG DE BASE DE DATOS DE TOBA. #####&lt;br /&gt;
######## DEFINIR SI SE QUIERE UTILIZAR UNA BASE DISTINTA A LA DE NEGOCIO&lt;br /&gt;
#TOBA_DB_HOST=&amp;quot;localhost&amp;quot;&lt;br /&gt;
#TOBA_DB_PORT=&amp;quot;5432&amp;quot;&lt;br /&gt;
#TOBA_DB_DBNAME=&amp;quot;instalador&amp;quot;&lt;br /&gt;
#TOBA_DB_USERNAME=&amp;quot;postgres&amp;quot;&lt;br /&gt;
#TOBA_DB_PASSWORD=&amp;quot;postgres&amp;quot;&lt;br /&gt;
#TOBA_DB_SCHEMA=&amp;quot;public&amp;quot;&lt;br /&gt;
&lt;br /&gt;
##### CONFIG IDM #####&lt;br /&gt;
ARAI_USUARIOS_URL_IDP=http://usuarios.local.siu/idp&lt;br /&gt;
## Deberá setearse si el sistema corre detrás de un proxy reverso&lt;br /&gt;
#ARAI_USUARIOS_PROXY_URL_IDP=http://url.arai-usuarios:80/idp&lt;br /&gt;
ARAI_USUARIOS_URL_PERFIL=http://huarpe.local.siu/perfil&lt;br /&gt;
ARAI_USUARIOS_URL_INSTITUCION=http://siu.edu.ar&lt;br /&gt;
&lt;br /&gt;
ARAI_USUARIOS_SIGLA_INSTITUCION=SIGLA&lt;br /&gt;
ARAI_USUARIOS_EMAIL_SOPORTE=mail.soporte@institucion.edu.ar&lt;br /&gt;
&lt;br /&gt;
##### CONFIG SEGURIDAD ####&lt;br /&gt;
SEGURIDAD_ALGORITMO_PASS=crypt&lt;br /&gt;
SEGURIDAD_LARGO_PASS=8&lt;br /&gt;
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'&lt;br /&gt;
SEGURIDAD_DURACION_DIAS_PASS=120&lt;br /&gt;
SEGURIDAD_RECAPTCHA_SITIO=6Fd_pQwTAAAAAOEqJz6KJmkjsrXcdXrAjWQYggZf&lt;br /&gt;
SEGURIDAD_RECAPTCHA_CLAVE=6Fd_pQwTAAAAAOEqJz6KJmkjsrXcdXrAjWQYggZf&lt;br /&gt;
SEGURIDAD_INTENTOS_RECAPTCHA=3&lt;br /&gt;
&lt;br /&gt;
##### CONFIG IDP #####&lt;br /&gt;
ARAI_USUARIOS_IDP_KEY_FILE=${ARAI_USUARIOS_DIR}/config/certs_idp/certificado_idp.crt&lt;br /&gt;
ARAI_USUARIOS_IDP_CERT_FILE=${ARAI_USUARIOS_DIR}/config/certs_idp/certificado_idp.key&lt;br /&gt;
#ARAI_USUARIOS_IDP_LOG_LEVEL='WARNING'&lt;br /&gt;
#ARAI_USUARIOS_IDP_LOG_HANDLER='errorlog'&lt;br /&gt;
&lt;br /&gt;
##### CONFIG MAIL RECOVERY ####&lt;br /&gt;
MAIL_RECOVERY_SUBJECT='Recuperar contraseña SIU-Arai'&lt;br /&gt;
MAIL_RECOVERY_FROM='noreply@institucion.edu.ar'&lt;br /&gt;
MAIL_RECOVERY_REPLYTO='noreply@institucion.edu.ar'&lt;br /&gt;
MAIL_RECOVERY_FROMNAME='Institución'&lt;br /&gt;
&lt;br /&gt;
##### CONFIG LDAP #####&lt;br /&gt;
ARAI_USUARIOS_LDAP_HOST=172.27.31.114&lt;br /&gt;
ARAI_USUARIOS_LDAP_PORT=7389&lt;br /&gt;
ARAI_USUARIOS_LDAP_TLS=0&lt;br /&gt;
ARAI_USUARIOS_LDAP_METHOD=user&lt;br /&gt;
ARAI_USUARIOS_LDAP_BINDUSER=&amp;quot;cn=admin,dc=siu,dc=cin,dc=edu&amp;quot;&lt;br /&gt;
ARAI_USUARIOS_LDAP_BINDPASS=admin&lt;br /&gt;
ARAI_USUARIOS_LDAP_SEARCHBASE=&amp;quot;dc=siu,dc=cin,dc=edu&amp;quot;&lt;br /&gt;
&lt;br /&gt;
###### CONFIG ENVIO MAILS (SMTP) ######&lt;br /&gt;
SMTP_ENTRADA=&amp;quot;arai-usuarios&amp;quot;&lt;br /&gt;
SMTP_HELO=&amp;quot;mail.unx.edu.ar&amp;quot;&lt;br /&gt;
SMTP_HOST=&amp;quot;smtp.googlemail.com&amp;quot;&lt;br /&gt;
SMTP_PORT=587&lt;br /&gt;
SMTP_FROM =&amp;quot;yo@midominio.com&amp;quot;&lt;br /&gt;
SMTP_SEGURIDAD =&amp;quot;ssl|tls&amp;quot;&lt;br /&gt;
SMTP_AUTH =&amp;quot;1&amp;quot;&lt;br /&gt;
SMTP_USUARIO =&amp;quot;usuario&amp;quot;&lt;br /&gt;
SMTP_CLAVE =&amp;quot;pass&amp;quot;&lt;br /&gt;
&lt;br /&gt;
##### CONFIG API REST #####&lt;br /&gt;
REST_SERVIDOR_AUTH=basic&lt;br /&gt;
&lt;br /&gt;
##### CONFIG ARAI-REGISTRY #####&lt;br /&gt;
ARAI_REGISTRY_URL=http://registry.local.siu/arai-registry&lt;br /&gt;
ARAI_REGISTRY_USER=user&lt;br /&gt;
ARAI_REGISTRY_PASS=pass&lt;br /&gt;
&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Una vez editado, verificamos que la configuración sea correcta&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
bin/instalador proyecto:verificar -n&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Si no sale ninguna alerta, procedemos a instalar.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
bin/instalador proyecto:instalar&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
Una vez instalado, modificamos los permisos de los archivos de la instalación con el comando&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
sudo bin/instalador permisos:simple&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
Cambiamos el modo mantenimiento&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
bin/instalador instalacion:modo-mantenimiento --sin-mantenimiento -n&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Luego configuramos Apache.&lt;br /&gt;
Archivo '''/etc/apache/sites-enabled/usuarios.conf'''&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;VirtualHost *:80&amp;gt;&lt;br /&gt;
    ServerName usuarios.local.siu&lt;br /&gt;
    Include /home/usuario/siu/usuarios/instalacion/toba.conf&lt;br /&gt;
    Include /home/usuario/siu/usuarios/instalacion/idp.conf&lt;br /&gt;
    ErrorLog ${APACHE_LOG_DIR}/error.log&lt;br /&gt;
    Custom ${APACHE_LOG_DIR}/access.log combined&lt;br /&gt;
&amp;lt;/VirtualHost&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Reiniciamos Apache y todo debería funcionar, para verificar entramos en la URL definida para usuarios, en mi caso http://usuarios.local.siu/gestion&lt;br /&gt;
&lt;br /&gt;
Con todo esto funcionando el siguiente paso es agregar Usuarios a Registry y sincronizarlos. &lt;br /&gt;
Según esta instalación para agregar Usuarios al entorno hacemos&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/arai-cli registry:add --maintainer-email  jpiazza@siu.edu.ar --maintainer jpiazza http://registry.local.siu/arai-registry&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
y para sincronizarlo&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/arai-cli registry:sync&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== Arai-Huarpe ==&lt;br /&gt;
&lt;br /&gt;
Es similar a las instalaciones anteriores.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
git clone -b master https://hub.siu.edu.ar/siu-arai/huarpe-core.git huarpe&lt;br /&gt;
cd huarpe&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Para instalar seguimos la documentación del archivo '''doc/INSTALACION_MANUAL.md'''&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
composer install --no-dev&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
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.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
cp templates/huarpe.env.dist huarpe.env&lt;br /&gt;
nano huarpe.env&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
'''huarpe.env'''&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
###### CONFIG DEL INSTALADR ######&lt;br /&gt;
#INSTALADOR_TIMEOUT=&amp;quot;360&amp;quot;&lt;br /&gt;
ENTORNO_PRODUCCION=1&lt;br /&gt;
&lt;br /&gt;
###### CONFIG DE SIU-HUARPE ######&lt;br /&gt;
HUARPE_PATH=/home/usuario/siu/huarpe&lt;br /&gt;
HUARPE_URL=http://huarpe.local.siu&lt;br /&gt;
HUARPE_URL_PORT=80&lt;br /&gt;
HUARPE_SESSION_NAME=huarpe&lt;br /&gt;
HUARPE_SESSION_HANDLER=&amp;quot;native_file&amp;quot;&lt;br /&gt;
#HUARPE_MEMCACHED_HOST=127.0.0.1&lt;br /&gt;
#HUARPE_MEMCACHED_PORT=11211&lt;br /&gt;
#HUARPE_TOKEN=unt0k3n-al3at0r1o-s39ur0?&lt;br /&gt;
#HUARPE_PROXY=127.0.0.1&lt;br /&gt;
HUARPE_LOG_HANDLER=&amp;quot;error_log&amp;quot;&lt;br /&gt;
HUARPE_LOG_LEVEL=&amp;quot;WARNING&amp;quot;&lt;br /&gt;
&lt;br /&gt;
### Cuando huarpe consuma servicios rest lo va a hacer con esta configuración&lt;br /&gt;
HUARPE_CLIENTE_AUTH=basic&lt;br /&gt;
HUARPE_CLIENTE_USUARIO=huarpe&lt;br /&gt;
HUARPE_CLIENTE_CLAVE=huarpe_pass&lt;br /&gt;
&lt;br /&gt;
###### CONFIG BRANDING ######&lt;br /&gt;
#HUARPE_PATH_LOGO=&amp;quot;/path/al/logo.png&amp;quot;&lt;br /&gt;
HUARPE_NOMBRE_INSTITUCION=&amp;quot;Institución&amp;quot;&lt;br /&gt;
&lt;br /&gt;
##### CONFIG ARAI-REGISTRY #####&lt;br /&gt;
ARAI_REGISTRY_URL=http://registry.local.siu/arai-registry&lt;br /&gt;
ARAI_REGISTRY_USER=user&lt;br /&gt;
ARAI_REGISTRY_PASS=pass&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Una vez editado, verificamos que la configuración sea correcta&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/instalador proyecto:verificar&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
Si no sale ninguna alerta, procedemos a instalar.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
bin/instalador proyecto:instalar&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
En Synfony es necesario dumpear los estilos y los JS con el siguiente comando.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
bin/console assetic:dump --no-debug --env=prod&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
Una vez instalado, modificamos los permisos de los archivos de la instalación con el comando&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
sudo bin/instalador permisos:simple&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Configuración apache ===&lt;br /&gt;
Archivo /etc/apache/sites-enabled/huarpe.conf&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;VirtualHost *:80&amp;gt;&lt;br /&gt;
	ServerName huarpe.local.siu&lt;br /&gt;
        Include /home/usuario/siu/huarpe/app/config/alias.conf&lt;br /&gt;
        ErrorLog ${APACHE_LOG_DIR}/error.log&lt;br /&gt;
        Custom ${APACHE_LOG_DIR}/access.log combined&lt;br /&gt;
&amp;lt;/VirtualHost&amp;gt;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Reiniciamos apache, antes de verificar la instalación, debemos sincronizar con Registry.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
bin/arai-cli registry:add --maintainer-email  jpiazza@siu.edu.ar --maintainer jpiazza http://registry.local.siu/arai-registry&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
Luego sincronizar&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
bin/arai-cli registry:sync&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Hay que limpiar la cache y actualizar los permisos&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
sudo bin/console cache:clear --env=prod&lt;br /&gt;
sudo bin/instalador permisos:simple -n&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
En Usuarios resincronizar para que se actualice con la nueva instalación&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
cd /usr/local/siu/usuarios&lt;br /&gt;
./bin/arai-cli registry:sync&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Para verificar que la instalación se realizo con éxito de debe ingresar en http://huarpe.local.siu/&lt;br /&gt;
&lt;br /&gt;
Si todo salio bien, tenemos instalada la plataforma ARAI lista para ser usada en nuestro servidor.&lt;/div&gt;</summary>
		<author><name>Ablanco</name></author>	</entry>

	<entry>
		<id>https://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Arai/arai2ejemplo&amp;diff=40709</id>
		<title>SIU-Arai/arai2ejemplo</title>
		<link rel="alternate" type="text/html" href="https://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Arai/arai2ejemplo&amp;diff=40709"/>
				<updated>2018-04-16T20:32:40Z</updated>
		
		<summary type="html">&lt;p&gt;Ablanco: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;[[Archivo:siu-arai_iso.png|derecha|link=SIU-Arai]]&lt;br /&gt;
&lt;br /&gt;
= Ejemplo paso a paso =&lt;br /&gt;
Para este caso voy a usar una instalación de Debian Jessie&lt;br /&gt;
&lt;br /&gt;
El objetivo es tener una instalación funcionando de la paltaforma SIU-Arai que luego sirva para integrar otros sistemas toba.&lt;br /&gt;
&lt;br /&gt;
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í&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable zebra&amp;quot;&lt;br /&gt;
! colspan=&amp;quot;2&amp;quot; |URLs&lt;br /&gt;
|-&lt;br /&gt;
|Araí-Registry&lt;br /&gt;
|http://registry.local.siu&lt;br /&gt;
|-&lt;br /&gt;
|Araí-Usuarios&lt;br /&gt;
|http://usuarios.local.siu&lt;br /&gt;
|-&lt;br /&gt;
|Araí-Huarpe&lt;br /&gt;
|http://huarpe.local.siu&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
== Instalación Arai-Registy ==&lt;br /&gt;
Creamos la carpeta '''/home/usuario/siu''' y no posicionamos ahí&lt;br /&gt;
Clonamos el proyecto &lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
git clone -b master https://hub.siu.edu.ar/siu-arai/arai-registry.git registry&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
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.&lt;br /&gt;
&lt;br /&gt;
Dentro del directorio del proyecto encontramos el archivo &amp;quot;doc/INSTALACION MANUAL.md&amp;quot;, la idea es seguir las instrucciones que encontramos en este archivo.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
cd registry&lt;br /&gt;
composer install --no-dev&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
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.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
cp templates/arai-registry.env.dist arai-registry.env&lt;br /&gt;
nano arai-registry.env&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
'''arai-registry.env'''&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
# config de la aplicacion&lt;br /&gt;
ARAI_REGISTRY_ALIAS=&amp;quot;/arai-registry&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_USER=&amp;quot;user&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_PASS=&amp;quot;pass&amp;quot;&lt;br /&gt;
&lt;br /&gt;
# config de la base de datos&lt;br /&gt;
ARAI_REGISTRY_DB_HOST=&amp;quot;172.27.31.114&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_DB_PORT=&amp;quot;7432&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_DB_DBNAME=&amp;quot;siu_registry&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_DB_USERNAME=&amp;quot;postgres&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_DB_PASSWORD=&amp;quot;postgres&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_DB_SCHEMA=&amp;quot;registry&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_DB_ENCODING=&amp;quot;UTF8&amp;quot;&lt;br /&gt;
&lt;br /&gt;
###### CONFIG DE LOGS ######&lt;br /&gt;
ARAI_REGISTRY_LOG_HANDLER=&amp;quot;errorlog&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_LOG_LEVEL=&amp;quot;WARNING&amp;quot;&lt;br /&gt;
&lt;br /&gt;
# config del instalador&lt;br /&gt;
INSTALADOR_TIMEOUT=&amp;quot;360&amp;quot;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Una vez editado, verificamos que la configuración sea correcta&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
bin/instalador proyecto:verificar&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Si no sale ninguna alerta, procedemos a instalar. Si sale la alerta de que no existe la base de datos especificada, se puede crear agregando la opción --crear-db al siguiente comando.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
bin/instalador proyecto:instalar&lt;br /&gt;
sudo ln -s ~/registry/config/alias.conf /etc/apache2/sites-available/registry.alias.conf&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Una vez instalado, modificamos los permisos de los archivos de la instalación con el comando&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
sudo ./bin/instalador permisos:simple&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Luego configuramos Apache.&lt;br /&gt;
&lt;br /&gt;
Así me quedo el archivo '''/etc/apache/sites-enabled/registry.conf'''&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;VirtualHost *:80&amp;gt;&lt;br /&gt;
   ServerName registry.local.siu&lt;br /&gt;
   Include ../sites-available/registry.alias.conf&lt;br /&gt;
   ErrorLog ${APACHE_LOG_DIR}/error.log&lt;br /&gt;
   Custom ${APACHE_LOG_DIR}/access.log combined&lt;br /&gt;
&amp;lt;/VirtualHost&amp;gt;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Con todo esto, para verificar que todo funcione reiniciamos Apache y ejecutamos&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
curl --user user:pass http://registry.local.siu/arai-registry/rest/packages/1&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Si la salida es:&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
{&lt;br /&gt;
    &amp;quot;error&amp;quot;: 404,&lt;br /&gt;
    &amp;quot;mensaje&amp;quot;: &amp;quot;404 Not Found&amp;quot;,&lt;br /&gt;
    &amp;quot;descripcion&amp;quot;: &amp;quot;El paquete solicitado no existe&amp;quot;&lt;br /&gt;
}&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
es que la instalación funcionó correctamente.&lt;br /&gt;
&lt;br /&gt;
Con registry instalado procedemos a instalar Usuarios&lt;br /&gt;
&lt;br /&gt;
==Arai-Usuarios==&lt;br /&gt;
&lt;br /&gt;
Nos posicionamos en ~/siu y clonamos el proyecto&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
git clone -b master https://hub.siu.edu.ar/siu-arai/arai-usuarios.git usuarios&lt;br /&gt;
cd usuarios&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Para instalar seguimos la documentación del archivo '''doc/INSTALACION_MANUAL.md'''&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
composer install --no-dev&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Si no se cuenta con certificados para el IDp SAML, se pueden generar con el siguiente comando&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
bin/instalador instalacion:generar-certs-idp -d /home/usuario/siu/usuarios/config/certs_idp -n&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
Donde '''-d''' especifica el directorio donde quedarán las claves (pública y PRIVADA). Este directorio se debe agregar en las variables del Instalador llamadas '''ARAI_USUARIOS_IDP_KEY_FILE''' y '''ARAI_USUARIOS_IDP_CERT_FILE'''.&lt;br /&gt;
&lt;br /&gt;
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.&lt;br /&gt;
Para la configuración de LDAP se asume un servidor que ya está funcionando y configurado. Existen documentación específica sobre este tema en el archivo '''INSTALACION_MANUAL.md'''&lt;br /&gt;
La variable TOBA_USUARIO debe contener el mismo usuarios administrado del LDAP.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
cp templates/arai-usuarios.env.dist arai-usuarios.env&lt;br /&gt;
nano arai-usuarios.env&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
'''arai-usuarios.env.dist'''&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
###### CONFIG DEL INSTALADR ######&lt;br /&gt;
#INSTALADOR_TIMEOUT=&amp;quot;360&amp;quot;&lt;br /&gt;
ENTORNO_PRODUCCION=&amp;quot;1&amp;quot;&lt;br /&gt;
&lt;br /&gt;
###### VARIABLES GLOBALES DEL ARCHIVO ######&lt;br /&gt;
ARAI_USUARIOS_DIR=/home/usuario/siu/usuarios&lt;br /&gt;
&lt;br /&gt;
###### CONFIG DE TOBA ######&lt;br /&gt;
TOBA_URL_BASE=&amp;quot;https://usuarios.local.siu&amp;quot;&lt;br /&gt;
#TOBA_URL_PORT=&amp;quot;443&amp;quot;&lt;br /&gt;
TOBA_USUARIO=&amp;quot;admin&amp;quot;&lt;br /&gt;
TOBA_PASSWORD=&amp;quot;admin1234&amp;quot;&lt;br /&gt;
TOBA_INSTALACION_DIR=&amp;quot;${ARAI_USUARIOS_DIR}/instalacion&amp;quot;&lt;br /&gt;
TOBA_PROYECTO_DIR=&amp;quot;${ARAI_USUARIOS_DIR}/gestion&amp;quot;&lt;br /&gt;
TOBA_ALIAS_PROYECTO=&amp;quot;/gestion&amp;quot;&lt;br /&gt;
TOBA_ALIAS_NUCLEO=&amp;quot;/toba_gestion&amp;quot;&lt;br /&gt;
#TOBA_ID_DESARROLLADOR=0&lt;br /&gt;
#TOBA_SESSION_NAME=&amp;quot;ARAI_SESSID&amp;quot;&lt;br /&gt;
&lt;br /&gt;
###### CONFIG DE BASE DE DATOS DE NEGOCIO ######&lt;br /&gt;
PROYECTO_DB_HOST=&amp;quot;172.27.31.114&amp;quot;&lt;br /&gt;
PROYECTO_DB_PORT=&amp;quot;7432&amp;quot;&lt;br /&gt;
PROYECTO_DB_DBNAME=&amp;quot;siu_usuarios&amp;quot;&lt;br /&gt;
PROYECTO_DB_USERNAME=&amp;quot;postgres&amp;quot;&lt;br /&gt;
PROYECTO_DB_PASSWORD=&amp;quot;postgres&amp;quot;&lt;br /&gt;
PROYECTO_DB_SCHEMA=&amp;quot;usuarios&amp;quot;&lt;br /&gt;
PROYECTO_DB_ENCODING=&amp;quot;LATIN1&amp;quot;&lt;br /&gt;
&lt;br /&gt;
###### CONFIG DE BASE DE DATOS DE TOBA. #####&lt;br /&gt;
######## DEFINIR SI SE QUIERE UTILIZAR UNA BASE DISTINTA A LA DE NEGOCIO&lt;br /&gt;
#TOBA_DB_HOST=&amp;quot;localhost&amp;quot;&lt;br /&gt;
#TOBA_DB_PORT=&amp;quot;5432&amp;quot;&lt;br /&gt;
#TOBA_DB_DBNAME=&amp;quot;instalador&amp;quot;&lt;br /&gt;
#TOBA_DB_USERNAME=&amp;quot;postgres&amp;quot;&lt;br /&gt;
#TOBA_DB_PASSWORD=&amp;quot;postgres&amp;quot;&lt;br /&gt;
#TOBA_DB_SCHEMA=&amp;quot;public&amp;quot;&lt;br /&gt;
&lt;br /&gt;
##### CONFIG IDM #####&lt;br /&gt;
ARAI_USUARIOS_URL_IDP=http://usuarios.local.siu/idp&lt;br /&gt;
## Deberá setearse si el sistema corre detrás de un proxy reverso&lt;br /&gt;
#ARAI_USUARIOS_PROXY_URL_IDP=http://url.arai-usuarios:80/idp&lt;br /&gt;
ARAI_USUARIOS_URL_PERFIL=http://huarpe.local.siu/perfil&lt;br /&gt;
ARAI_USUARIOS_URL_INSTITUCION=http://siu.edu.ar&lt;br /&gt;
&lt;br /&gt;
ARAI_USUARIOS_SIGLA_INSTITUCION=SIGLA&lt;br /&gt;
ARAI_USUARIOS_EMAIL_SOPORTE=mail.soporte@institucion.edu.ar&lt;br /&gt;
&lt;br /&gt;
##### CONFIG SEGURIDAD ####&lt;br /&gt;
SEGURIDAD_ALGORITMO_PASS=crypt&lt;br /&gt;
SEGURIDAD_LARGO_PASS=8&lt;br /&gt;
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'&lt;br /&gt;
SEGURIDAD_DURACION_DIAS_PASS=120&lt;br /&gt;
SEGURIDAD_RECAPTCHA_SITIO=6Fd_pQwTAAAAAOEqJz6KJmkjsrXcdXrAjWQYggZf&lt;br /&gt;
SEGURIDAD_RECAPTCHA_CLAVE=6Fd_pQwTAAAAAOEqJz6KJmkjsrXcdXrAjWQYggZf&lt;br /&gt;
SEGURIDAD_INTENTOS_RECAPTCHA=3&lt;br /&gt;
&lt;br /&gt;
##### CONFIG IDP #####&lt;br /&gt;
ARAI_USUARIOS_IDP_KEY_FILE=${ARAI_USUARIOS_DIR}/config/certs_idp/certificado_idp.crt&lt;br /&gt;
ARAI_USUARIOS_IDP_CERT_FILE=${ARAI_USUARIOS_DIR}/config/certs_idp/certificado_idp.key&lt;br /&gt;
#ARAI_USUARIOS_IDP_LOG_LEVEL='WARNING'&lt;br /&gt;
#ARAI_USUARIOS_IDP_LOG_HANDLER='errorlog'&lt;br /&gt;
&lt;br /&gt;
##### CONFIG MAIL RECOVERY ####&lt;br /&gt;
MAIL_RECOVERY_SUBJECT='Recuperar contraseña SIU-Arai'&lt;br /&gt;
MAIL_RECOVERY_FROM='noreply@institucion.edu.ar'&lt;br /&gt;
MAIL_RECOVERY_REPLYTO='noreply@institucion.edu.ar'&lt;br /&gt;
MAIL_RECOVERY_FROMNAME='Institución'&lt;br /&gt;
&lt;br /&gt;
##### CONFIG LDAP #####&lt;br /&gt;
ARAI_USUARIOS_LDAP_HOST=172.27.31.114&lt;br /&gt;
ARAI_USUARIOS_LDAP_PORT=7389&lt;br /&gt;
ARAI_USUARIOS_LDAP_TLS=0&lt;br /&gt;
ARAI_USUARIOS_LDAP_METHOD=user&lt;br /&gt;
ARAI_USUARIOS_LDAP_BINDUSER=&amp;quot;cn=admin,dc=siu,dc=cin,dc=edu&amp;quot;&lt;br /&gt;
ARAI_USUARIOS_LDAP_BINDPASS=admin&lt;br /&gt;
ARAI_USUARIOS_LDAP_SEARCHBASE=&amp;quot;dc=siu,dc=cin,dc=edu&amp;quot;&lt;br /&gt;
&lt;br /&gt;
###### CONFIG ENVIO MAILS (SMTP) ######&lt;br /&gt;
SMTP_ENTRADA=&amp;quot;arai-usuarios&amp;quot;&lt;br /&gt;
SMTP_HELO=&amp;quot;mail.unx.edu.ar&amp;quot;&lt;br /&gt;
SMTP_HOST=&amp;quot;smtp.googlemail.com&amp;quot;&lt;br /&gt;
SMTP_PORT=587&lt;br /&gt;
SMTP_FROM =&amp;quot;yo@midominio.com&amp;quot;&lt;br /&gt;
SMTP_SEGURIDAD =&amp;quot;ssl|tls&amp;quot;&lt;br /&gt;
SMTP_AUTH =&amp;quot;1&amp;quot;&lt;br /&gt;
SMTP_USUARIO =&amp;quot;usuario&amp;quot;&lt;br /&gt;
SMTP_CLAVE =&amp;quot;pass&amp;quot;&lt;br /&gt;
&lt;br /&gt;
##### CONFIG API REST #####&lt;br /&gt;
REST_SERVIDOR_AUTH=basic&lt;br /&gt;
&lt;br /&gt;
##### CONFIG ARAI-REGISTRY #####&lt;br /&gt;
ARAI_REGISTRY_URL=http://registry.local.siu/arai-registry&lt;br /&gt;
ARAI_REGISTRY_USER=user&lt;br /&gt;
ARAI_REGISTRY_PASS=pass&lt;br /&gt;
&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Una vez editado, verificamos que la configuración sea correcta&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
bin/instalador proyecto:verificar -n&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Si no sale ninguna alerta, procedemos a instalar.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
bin/instalador proyecto:instalar&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
Una vez instalado, modificamos los permisos de los archivos de la instalación con el comando&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
sudo bin/instalador permisos:simple&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
Cambiamos el modo mantenimiento&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
bin/instalador instalacion:modo-mantenimiento --sin-mantenimiento -n&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Luego configuramos Apache.&lt;br /&gt;
Archivo '''/etc/apache/sites-enabled/usuarios.conf'''&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;VirtualHost *:80&amp;gt;&lt;br /&gt;
    ServerName usuarios.local.siu&lt;br /&gt;
    Include /home/usuario/siu/usuarios/instalacion/toba.conf&lt;br /&gt;
    Include /home/usuario/siu/usuarios/instalacion/idp.conf&lt;br /&gt;
    ErrorLog ${APACHE_LOG_DIR}/error.log&lt;br /&gt;
    Custom ${APACHE_LOG_DIR}/access.log combined&lt;br /&gt;
&amp;lt;/VirtualHost&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Reiniciamos Apache y todo debería funcionar, para verificar entramos en la URL definida para usuarios, en mi caso http://usuarios.local.siu/gestion&lt;br /&gt;
&lt;br /&gt;
Con todo esto funcionando el siguiente paso es agregar Usuarios a Registry y sincronizarlos. &lt;br /&gt;
Según esta instalación para agregar Usuarios al entorno hacemos&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/arai-cli registry:add --maintainer-email  jpiazza@siu.edu.ar --maintainer jpiazza http://registry.local.siu/arai-registry&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
y para sincronizarlo&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/arai-cli registry:sync&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== Arai-Huarpe ==&lt;br /&gt;
&lt;br /&gt;
Es similar a las instalaciones anteriores.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
git clone -b master https://hub.siu.edu.ar/siu-arai/huarpe-core.git huarpe&lt;br /&gt;
cd huarpe&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Para instalar seguimos la documentación del archivo '''doc/INSTALACION_MANUAL.md'''&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
composer install --no-dev&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
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.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
cp templates/huarpe.env.dist huarpe.env&lt;br /&gt;
nano huarpe.env&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
'''huarpe.env'''&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
###### CONFIG DEL INSTALADR ######&lt;br /&gt;
#INSTALADOR_TIMEOUT=&amp;quot;360&amp;quot;&lt;br /&gt;
ENTORNO_PRODUCCION=1&lt;br /&gt;
&lt;br /&gt;
###### CONFIG DE SIU-HUARPE ######&lt;br /&gt;
HUARPE_PATH=/home/usuario/siu/huarpe&lt;br /&gt;
HUARPE_URL=http://huarpe.local.siu&lt;br /&gt;
HUARPE_URL_PORT=80&lt;br /&gt;
HUARPE_SESSION_NAME=huarpe&lt;br /&gt;
HUARPE_SESSION_HANDLER=&amp;quot;native_file&amp;quot;&lt;br /&gt;
#HUARPE_MEMCACHED_HOST=127.0.0.1&lt;br /&gt;
#HUARPE_MEMCACHED_PORT=11211&lt;br /&gt;
#HUARPE_TOKEN=unt0k3n-al3at0r1o-s39ur0?&lt;br /&gt;
#HUARPE_PROXY=127.0.0.1&lt;br /&gt;
HUARPE_LOG_HANDLER=&amp;quot;error_log&amp;quot;&lt;br /&gt;
HUARPE_LOG_LEVEL=&amp;quot;WARNING&amp;quot;&lt;br /&gt;
&lt;br /&gt;
### Cuando huarpe consuma servicios rest lo va a hacer con esta configuración&lt;br /&gt;
HUARPE_CLIENTE_AUTH=basic&lt;br /&gt;
HUARPE_CLIENTE_USUARIO=huarpe&lt;br /&gt;
HUARPE_CLIENTE_CLAVE=huarpe_pass&lt;br /&gt;
&lt;br /&gt;
###### CONFIG BRANDING ######&lt;br /&gt;
#HUARPE_PATH_LOGO=&amp;quot;/path/al/logo.png&amp;quot;&lt;br /&gt;
HUARPE_NOMBRE_INSTITUCION=&amp;quot;Institución&amp;quot;&lt;br /&gt;
&lt;br /&gt;
##### CONFIG ARAI-REGISTRY #####&lt;br /&gt;
ARAI_REGISTRY_URL=http://registry.local.siu/arai-registry&lt;br /&gt;
ARAI_REGISTRY_USER=user&lt;br /&gt;
ARAI_REGISTRY_PASS=pass&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Una vez editado, verificamos que la configuración sea correcta&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/instalador proyecto:verificar&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
Si no sale ninguna alerta, procedemos a instalar.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
bin/instalador proyecto:instalar&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
En Synfony es necesario dumpear los estilos y los JS con el siguiente comando.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
bin/console assetic:dump --no-debug --env=prod&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
Una vez instalado, modificamos los permisos de los archivos de la instalación con el comando&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
sudo bin/instalador permisos:simple&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Configuración apache ===&lt;br /&gt;
Archivo /etc/apache/sites-enabled/huarpe.conf&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;VirtualHost *:80&amp;gt;&lt;br /&gt;
	ServerName huarpe.local.siu&lt;br /&gt;
        Include /home/usuario/siu/huarpe/app/config/alias.conf&lt;br /&gt;
        ErrorLog ${APACHE_LOG_DIR}/error.log&lt;br /&gt;
        Custom ${APACHE_LOG_DIR}/access.log combined&lt;br /&gt;
&amp;lt;/VirtualHost&amp;gt;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Reiniciamos apache, antes de verificar la instalación, debemos sincronizar con Registry.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
bin/arai-cli registry:add --maintainer-email  jpiazza@siu.edu.ar --maintainer jpiazza http://registry.local.siu/arai-registry&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
Luego sincronizar&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
bin/arai-cli registry:sync&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Hay que limpiar la cache y actualizar los permisos&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
sudo bin/console cache:clear --env=prod&lt;br /&gt;
sudo bin/instalador permisos:simple -n&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
En Usuarios resincronizar para que se actualice con la nueva instalación&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
cd /usr/local/siu/usuarios&lt;br /&gt;
./bin/arai-cli registry:sync&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Para verificar que la instalación se realizo con éxito de debe ingresar en http://huarpe.local.siu/&lt;br /&gt;
&lt;br /&gt;
Si todo salio bien, tenemos instalada la plataforma ARAI lista para ser usada en nuestro servidor.&lt;/div&gt;</summary>
		<author><name>Ablanco</name></author>	</entry>

	<entry>
		<id>https://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Arai/arai2ejemplo&amp;diff=40706</id>
		<title>SIU-Arai/arai2ejemplo</title>
		<link rel="alternate" type="text/html" href="https://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Arai/arai2ejemplo&amp;diff=40706"/>
				<updated>2018-04-16T20:05:15Z</updated>
		
		<summary type="html">&lt;p&gt;Ablanco: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;[[Archivo:siu-arai_iso.png|derecha|link=SIU-Arai]]&lt;br /&gt;
&lt;br /&gt;
= Ejemplo paso a paso =&lt;br /&gt;
Para este caso voy a usar una instalación de Debian Jessie&lt;br /&gt;
&lt;br /&gt;
El objetivo es tener una instalación funcionando de la paltaforma SIU-Arai que luego sirva para integrar otros sistemas toba.&lt;br /&gt;
&lt;br /&gt;
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í&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable zebra&amp;quot;&lt;br /&gt;
! colspan=&amp;quot;2&amp;quot; |URLs&lt;br /&gt;
|-&lt;br /&gt;
|Araí-Registry&lt;br /&gt;
|http://registry.local.siu&lt;br /&gt;
|-&lt;br /&gt;
|Araí-Usuarios&lt;br /&gt;
|http://usuarios.local.siu&lt;br /&gt;
|-&lt;br /&gt;
|Araí-Huarpe&lt;br /&gt;
|http://huarpe.local.siu&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
== Instalación Arai-Registy ==&lt;br /&gt;
Creamos la carpeta '''/home/usuario/siu''' y no posicionamos ahí&lt;br /&gt;
Clonamos el proyecto &lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
git clone -b master https://hub.siu.edu.ar/siu-arai/arai-registry.git registry&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
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.&lt;br /&gt;
&lt;br /&gt;
Dentro del directorio del proyecto encontramos el archivo &amp;quot;doc/INSTALACION MANUAL.md&amp;quot;, la idea es seguir las instrucciones que encontramos en este archivo.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
cd registry&lt;br /&gt;
composer install --no-dev&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
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.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
cp templates/arai-registry.env.dist arai-registry.env&lt;br /&gt;
nano arai-registry.env&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
'''arai-registry.env'''&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
# config de la aplicacion&lt;br /&gt;
ARAI_REGISTRY_ALIAS=&amp;quot;/arai-registry&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_USER=&amp;quot;user&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_PASS=&amp;quot;pass&amp;quot;&lt;br /&gt;
&lt;br /&gt;
# config de la base de datos&lt;br /&gt;
ARAI_REGISTRY_DB_HOST=&amp;quot;172.27.31.114&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_DB_PORT=&amp;quot;7432&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_DB_DBNAME=&amp;quot;siu_registry&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_DB_USERNAME=&amp;quot;postgres&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_DB_PASSWORD=&amp;quot;postgres&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_DB_SCHEMA=&amp;quot;registry&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_DB_ENCODING=&amp;quot;UTF8&amp;quot;&lt;br /&gt;
&lt;br /&gt;
###### CONFIG DE LOGS ######&lt;br /&gt;
ARAI_REGISTRY_LOG_HANDLER=&amp;quot;errorlog&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_LOG_LEVEL=&amp;quot;WARNING&amp;quot;&lt;br /&gt;
&lt;br /&gt;
# config del instalador&lt;br /&gt;
INSTALADOR_TIMEOUT=&amp;quot;360&amp;quot;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Una vez editado, verificamos que la configuración sea correcta&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
bin/instalador proyecto:verificar&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Si no sale ninguna alerta, procedemos a instalar. Si sale la alerta de que no existe la base de datos especificada, se puede crear agregando la opción --crear-db al siguiente comando.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
bin/instalador proyecto:instalar&lt;br /&gt;
sudo ln -s ~/registry/config/alias.conf /etc/apache2/sites-available/registry.alias.conf&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Una vez instalado, modificamos los permisos de los archivos de la instalación con el comando&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
sudo ./bin/instalador permisos:simple&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Luego configuramos Apache.&lt;br /&gt;
&lt;br /&gt;
Así me quedo el archivo '''/etc/apache/sites-enabled/registry.conf'''&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;VirtualHost *:80&amp;gt;&lt;br /&gt;
ServerName registry.local.siu&lt;br /&gt;
Include ../sites-available/registry.alias.conf&lt;br /&gt;
&amp;lt;/VirtualHost&amp;gt;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Con todo esto, para verificar que todo funcione reiniciamos Apache y ejecutamos&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
curl --user user:pass http://registry.local.siu/arai-registry/rest/packages/1&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Si la salida es:&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
{&lt;br /&gt;
    &amp;quot;error&amp;quot;: 404,&lt;br /&gt;
    &amp;quot;mensaje&amp;quot;: &amp;quot;404 Not Found&amp;quot;,&lt;br /&gt;
    &amp;quot;descripcion&amp;quot;: &amp;quot;El paquete solicitado no existe&amp;quot;&lt;br /&gt;
}&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
es que la instalación funcionó correctamente.&lt;br /&gt;
&lt;br /&gt;
Con registry instalado procedemos a instalar Usuarios&lt;br /&gt;
&lt;br /&gt;
==Arai-Usuarios==&lt;br /&gt;
&lt;br /&gt;
Nos posicionamos en ~/siu y clonamos el proyecto&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
git clone -b master https://hub.siu.edu.ar/siu-arai/arai-usuarios.git usuarios&lt;br /&gt;
cd usuarios&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Para instalar seguimos la documentación del archivo '''doc/INSTALACION_MANUAL.md'''&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
composer install --no-dev&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Si no se cuenta con certificados para el IDp SAML, se pueden generar con el siguiente comando&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
bin/instalador instalacion:generar-certs-idp -d /home/usuario/siu/usuarios/config/certs_idp -n&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
Donde '''-d''' especifica el directorio donde quedarán las claves (pública y PRIVADA). Este directorio se debe agregar en las variables del Instalador llamadas '''ARAI_USUARIOS_IDP_KEY_FILE''' y '''ARAI_USUARIOS_IDP_CERT_FILE'''.&lt;br /&gt;
&lt;br /&gt;
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.&lt;br /&gt;
Para la configuración de LDAP se asume un servidor que ya está funcionando y configurado. Existen documentación específica sobre este tema en el archivo '''INSTALACION_MANUAL.md'''&lt;br /&gt;
La variable TOBA_USUARIO debe contener el mismo usuarios administrado del LDAP.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
cp templates/arai-usuarios.env.dist arai-usuarios.env&lt;br /&gt;
nano arai-usuarios.env&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
'''arai-usuarios.env.dist'''&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
###### CONFIG DEL INSTALADR ######&lt;br /&gt;
#INSTALADOR_TIMEOUT=&amp;quot;360&amp;quot;&lt;br /&gt;
ENTORNO_PRODUCCION=&amp;quot;1&amp;quot;&lt;br /&gt;
&lt;br /&gt;
###### VARIABLES GLOBALES DEL ARCHIVO ######&lt;br /&gt;
ARAI_USUARIOS_DIR=/home/usuario/siu/usuarios&lt;br /&gt;
&lt;br /&gt;
###### CONFIG DE TOBA ######&lt;br /&gt;
TOBA_URL_BASE=&amp;quot;https://usuarios.local.siu&amp;quot;&lt;br /&gt;
#TOBA_URL_PORT=&amp;quot;443&amp;quot;&lt;br /&gt;
TOBA_USUARIO=&amp;quot;admin&amp;quot;&lt;br /&gt;
TOBA_PASSWORD=&amp;quot;admin1234&amp;quot;&lt;br /&gt;
TOBA_INSTALACION_DIR=&amp;quot;${ARAI_USUARIOS_DIR}/instalacion&amp;quot;&lt;br /&gt;
TOBA_PROYECTO_DIR=&amp;quot;${ARAI_USUARIOS_DIR}/gestion&amp;quot;&lt;br /&gt;
TOBA_ALIAS_PROYECTO=&amp;quot;/gestion&amp;quot;&lt;br /&gt;
TOBA_ALIAS_NUCLEO=&amp;quot;/toba_gestion&amp;quot;&lt;br /&gt;
#TOBA_ID_DESARROLLADOR=0&lt;br /&gt;
#TOBA_SESSION_NAME=&amp;quot;ARAI_SESSID&amp;quot;&lt;br /&gt;
&lt;br /&gt;
###### CONFIG DE BASE DE DATOS DE NEGOCIO ######&lt;br /&gt;
PROYECTO_DB_HOST=&amp;quot;172.27.31.114&amp;quot;&lt;br /&gt;
PROYECTO_DB_PORT=&amp;quot;7432&amp;quot;&lt;br /&gt;
PROYECTO_DB_DBNAME=&amp;quot;siu_usuarios&amp;quot;&lt;br /&gt;
PROYECTO_DB_USERNAME=&amp;quot;postgres&amp;quot;&lt;br /&gt;
PROYECTO_DB_PASSWORD=&amp;quot;postgres&amp;quot;&lt;br /&gt;
PROYECTO_DB_SCHEMA=&amp;quot;usuarios&amp;quot;&lt;br /&gt;
PROYECTO_DB_ENCODING=&amp;quot;LATIN1&amp;quot;&lt;br /&gt;
&lt;br /&gt;
###### CONFIG DE BASE DE DATOS DE TOBA. #####&lt;br /&gt;
######## DEFINIR SI SE QUIERE UTILIZAR UNA BASE DISTINTA A LA DE NEGOCIO&lt;br /&gt;
#TOBA_DB_HOST=&amp;quot;localhost&amp;quot;&lt;br /&gt;
#TOBA_DB_PORT=&amp;quot;5432&amp;quot;&lt;br /&gt;
#TOBA_DB_DBNAME=&amp;quot;instalador&amp;quot;&lt;br /&gt;
#TOBA_DB_USERNAME=&amp;quot;postgres&amp;quot;&lt;br /&gt;
#TOBA_DB_PASSWORD=&amp;quot;postgres&amp;quot;&lt;br /&gt;
#TOBA_DB_SCHEMA=&amp;quot;public&amp;quot;&lt;br /&gt;
&lt;br /&gt;
##### CONFIG IDM #####&lt;br /&gt;
ARAI_USUARIOS_URL_IDP=http://usuarios.local.siu/idp&lt;br /&gt;
## Deberá setearse si el sistema corre detrás de un proxy reverso&lt;br /&gt;
#ARAI_USUARIOS_PROXY_URL_IDP=http://url.arai-usuarios:80/idp&lt;br /&gt;
ARAI_USUARIOS_URL_PERFIL=http://huarpe.local.siu/perfil&lt;br /&gt;
ARAI_USUARIOS_URL_INSTITUCION=http://siu.edu.ar&lt;br /&gt;
&lt;br /&gt;
ARAI_USUARIOS_SIGLA_INSTITUCION=SIGLA&lt;br /&gt;
ARAI_USUARIOS_EMAIL_SOPORTE=mail.soporte@institucion.edu.ar&lt;br /&gt;
&lt;br /&gt;
##### CONFIG SEGURIDAD ####&lt;br /&gt;
SEGURIDAD_ALGORITMO_PASS=crypt&lt;br /&gt;
SEGURIDAD_LARGO_PASS=8&lt;br /&gt;
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'&lt;br /&gt;
SEGURIDAD_DURACION_DIAS_PASS=120&lt;br /&gt;
SEGURIDAD_RECAPTCHA_SITIO=6Fd_pQwTAAAAAOEqJz6KJmkjsrXcdXrAjWQYggZf&lt;br /&gt;
SEGURIDAD_RECAPTCHA_CLAVE=6Fd_pQwTAAAAAOEqJz6KJmkjsrXcdXrAjWQYggZf&lt;br /&gt;
SEGURIDAD_INTENTOS_RECAPTCHA=3&lt;br /&gt;
&lt;br /&gt;
##### CONFIG IDP #####&lt;br /&gt;
ARAI_USUARIOS_IDP_KEY_FILE=${ARAI_USUARIOS_DIR}/config/certs_idp/certificado_idp.crt&lt;br /&gt;
ARAI_USUARIOS_IDP_CERT_FILE=${ARAI_USUARIOS_DIR}/config/certs_idp/certificado_idp.key&lt;br /&gt;
#ARAI_USUARIOS_IDP_LOG_LEVEL='WARNING'&lt;br /&gt;
#ARAI_USUARIOS_IDP_LOG_HANDLER='errorlog'&lt;br /&gt;
&lt;br /&gt;
##### CONFIG MAIL RECOVERY ####&lt;br /&gt;
MAIL_RECOVERY_SUBJECT='Recuperar contraseña SIU-Arai'&lt;br /&gt;
MAIL_RECOVERY_FROM='noreply@institucion.edu.ar'&lt;br /&gt;
MAIL_RECOVERY_REPLYTO='noreply@institucion.edu.ar'&lt;br /&gt;
MAIL_RECOVERY_FROMNAME='Institución'&lt;br /&gt;
&lt;br /&gt;
##### CONFIG LDAP #####&lt;br /&gt;
ARAI_USUARIOS_LDAP_HOST=172.27.31.114&lt;br /&gt;
ARAI_USUARIOS_LDAP_PORT=7389&lt;br /&gt;
ARAI_USUARIOS_LDAP_TLS=0&lt;br /&gt;
ARAI_USUARIOS_LDAP_METHOD=user&lt;br /&gt;
ARAI_USUARIOS_LDAP_BINDUSER=&amp;quot;cn=admin,dc=siu,dc=cin,dc=edu&amp;quot;&lt;br /&gt;
ARAI_USUARIOS_LDAP_BINDPASS=admin&lt;br /&gt;
ARAI_USUARIOS_LDAP_SEARCHBASE=&amp;quot;dc=siu,dc=cin,dc=edu&amp;quot;&lt;br /&gt;
&lt;br /&gt;
###### CONFIG ENVIO MAILS (SMTP) ######&lt;br /&gt;
SMTP_ENTRADA=&amp;quot;arai-usuarios&amp;quot;&lt;br /&gt;
SMTP_HELO=&amp;quot;mail.unx.edu.ar&amp;quot;&lt;br /&gt;
SMTP_HOST=&amp;quot;smtp.googlemail.com&amp;quot;&lt;br /&gt;
SMTP_PORT=587&lt;br /&gt;
SMTP_FROM =&amp;quot;yo@midominio.com&amp;quot;&lt;br /&gt;
SMTP_SEGURIDAD =&amp;quot;ssl|tls&amp;quot;&lt;br /&gt;
SMTP_AUTH =&amp;quot;1&amp;quot;&lt;br /&gt;
SMTP_USUARIO =&amp;quot;usuario&amp;quot;&lt;br /&gt;
SMTP_CLAVE =&amp;quot;pass&amp;quot;&lt;br /&gt;
&lt;br /&gt;
##### CONFIG API REST #####&lt;br /&gt;
REST_SERVIDOR_AUTH=basic&lt;br /&gt;
&lt;br /&gt;
##### CONFIG ARAI-REGISTRY #####&lt;br /&gt;
ARAI_REGISTRY_URL=http://registry.local.siu/arai-registry&lt;br /&gt;
ARAI_REGISTRY_USER=user&lt;br /&gt;
ARAI_REGISTRY_PASS=pass&lt;br /&gt;
&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Una vez editado, verificamos que la configuración sea correcta&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
bin/instalador proyecto:verificar -n&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Si no sale ninguna alerta, procedemos a instalar.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
bin/instalador proyecto:instalar&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
Una vez instalado, modificamos los permisos de los archivos de la instalación con el comando&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
sudo bin/instalador permisos:simple&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
Cambiamos el modo mantenimiento&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
bin/instalador instalacion:modo-mantenimiento --sin-mantenimiento -n&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Luego configuramos Apache.&lt;br /&gt;
Archivo '''/etc/apache/sites-enabled/usuarios.conf'''&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;VirtualHost *:80&amp;gt;&lt;br /&gt;
    ServerName usuarios.local.siu&lt;br /&gt;
    Include /home/usuario/siu/usuarios/instalacion/toba.conf&lt;br /&gt;
    Include /home/usuario/siu/usuarios/instalacion/idp.conf&lt;br /&gt;
&amp;lt;/VirtualHost&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Reiniciamos Apache y todo debería funcionar, para verificar entramos en la URL definida para usuarios, en mi caso http://usuarios.local.siu/gestion&lt;br /&gt;
&lt;br /&gt;
Con todo esto funcionando el siguiente paso es agregar Usuarios a Registry y sincronizarlos. &lt;br /&gt;
Según esta instalación para agregar Usuarios al entorno hacemos&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/arai-cli registry:add --maintainer-email  jpiazza@siu.edu.ar --maintainer jpiazza http://registry.local.siu/arai-registry&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
y para sincronizarlo&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/arai-cli registry:sync&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== HASTA ACA ==&lt;br /&gt;
&lt;br /&gt;
== Arai-Huarpe ==&lt;br /&gt;
&lt;br /&gt;
Es similar a las instalaciones anteriores.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
cd /usr/local/siu&lt;br /&gt;
git clone -b master https://hub.siu.edu.ar/siu-arai/huarpe-core.git huarpe&lt;br /&gt;
cd huarpe&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Para instalar seguimos la documentación del archivo '''doc/INSTALACION_MANUAL.md'''&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
composer install --no-dev&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
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.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
cp templates/huarpe.env.dist huarpe.env&lt;br /&gt;
nano huarpe.env&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
'''huarpe.env'''&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
###### CONFIG DEL INSTALADR ######&lt;br /&gt;
#INSTALADOR_TIMEOUT=&amp;quot;360&amp;quot;&lt;br /&gt;
ENTORNO_PRODUCCION=1&lt;br /&gt;
&lt;br /&gt;
###### CONFIG DE SIU-HUARPE ######&lt;br /&gt;
HUARPE_PATH=/usr/local/siu/huarpe&lt;br /&gt;
HUARPE_URL=https://huarpe.local.siu&lt;br /&gt;
HUARPE_URL_PORT=443&lt;br /&gt;
HUARPE_SESSION_NAME=huarpe&lt;br /&gt;
HUARPE_SESSION_HANDLER=&amp;quot;native_file&amp;quot;&lt;br /&gt;
#HUARPE_MEMCACHED_HOST=127.0.0.1&lt;br /&gt;
#HUARPE_MEMCACHED_PORT=11211&lt;br /&gt;
HUARPE_CERT_FILE=/certs/huarpe-cli.cert.pem&lt;br /&gt;
HUARPE_KEY_FILE=/certs/huarpe-cli.key.pem&lt;br /&gt;
#HUARPE_TOKEN=unt0k3n-al3at0r1o-s39ur0?&lt;br /&gt;
#HUARPE_PROXY=127.0.0.1&lt;br /&gt;
HUARPE_LOG_HANDLER=&amp;quot;error_log&amp;quot;&lt;br /&gt;
HUARPE_LOG_LEVEL=&amp;quot;WARNING&amp;quot;&lt;br /&gt;
&lt;br /&gt;
###### CONFIG BRANDING ######&lt;br /&gt;
#HUARPE_PATH_LOGO=&amp;quot;/path/al/logo.png&amp;quot;&lt;br /&gt;
HUARPE_NOMBRE_INSTITUCION=&amp;quot;Institución&amp;quot;&lt;br /&gt;
&lt;br /&gt;
###### CONFIG DE SIU-ARAI: REGISTRY ######&lt;br /&gt;
ARAI_REGISTRY_URL=http://registry.local.siu/arai-registry&lt;br /&gt;
ARAI_REGISTRY_USER=user&lt;br /&gt;
ARAI_REGISTRY_PASS=pass&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Una vez editado, verificamos que la configuración sea correcta&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/instalador proyecto:verificar&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
Si no sale ninguna alerta, procedemos a instalar.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
sudo ./bin/instalador proyecto:instalar&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
En Synfony es necesario dumpear los estilos y los JS con el siguiente comando.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/console assetic:dump --no-debug --env=prod&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
Una vez instalado, modificamos los permisos de los archivos de la instalación con el comando&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
sudo ./bin/instalador permisos:simple&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Configuración apache ===&lt;br /&gt;
Lo mismo que con Registry o Usuarios, como tengo toda la plataforma instalada en un mismo servidor, debo usar el '''ServerName huarpe.local.siu'''.&lt;br /&gt;
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&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;VirtualHost *:80&amp;gt;&lt;br /&gt;
	ServerName huarpe.local.siu&lt;br /&gt;
	Redirect permanent / https://huarpe.local.siu:443/&lt;br /&gt;
&amp;lt;/VirtualHost&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;VirtualHost *:443&amp;gt;&lt;br /&gt;
&lt;br /&gt;
ServerName huarpe.local.siu&lt;br /&gt;
SSLEngine on&lt;br /&gt;
SSLCertificateFile /certs/huarpe.local.siu.cert.pem&lt;br /&gt;
SSLCertificateKeyFile /certs/huarpe.local.siu.key.pem&lt;br /&gt;
&lt;br /&gt;
Include /usr/local/siu/huarpe/app/config/alias.conf&lt;br /&gt;
&lt;br /&gt;
&amp;lt;/VirtualHost&amp;gt;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Reiniciamos apache, antes de verificar la instalación, debemos sincronizar con Registry.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/arai-cli registry:add --maintainer-email  jpiazza@siu.edu.ar --maintainer jpiazza http://registry.local.siu/arai-registry&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
Luego sincronizar&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/arai-cli registry:sync&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Hay que limpiar la cache y actualizar los permisos&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/console cache:clear --env=prod&lt;br /&gt;
sudo ./bin/instalador permisos:simple &lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
En Usuarios resincronizar para que se actualice con la nueva instalación&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
cd /usr/local/siu/usuarios&lt;br /&gt;
./bin/arai-cli registry:sync&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Para verificar que la instalación se realizo con éxito de debe ingresar en https://huarpe.local.siu/&lt;br /&gt;
&lt;br /&gt;
Si todo salio bien, tenemos instalada la plataforma ARAI lista para ser usada en nuestro servidor.&lt;/div&gt;</summary>
		<author><name>Ablanco</name></author>	</entry>

	<entry>
		<id>https://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Arai/arai2ejemplo&amp;diff=40702</id>
		<title>SIU-Arai/arai2ejemplo</title>
		<link rel="alternate" type="text/html" href="https://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Arai/arai2ejemplo&amp;diff=40702"/>
				<updated>2018-04-16T19:47:19Z</updated>
		
		<summary type="html">&lt;p&gt;Ablanco: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;[[Archivo:siu-arai_iso.png|derecha|link=SIU-Arai]]&lt;br /&gt;
&lt;br /&gt;
= Ejemplo paso a paso =&lt;br /&gt;
Para este caso voy a usar una instalación de Debian Jessie&lt;br /&gt;
&lt;br /&gt;
El objetivo es tener una instalación funcionando de la paltaforma SIU-Arai que luego sirva para integrar otros sistemas toba.&lt;br /&gt;
&lt;br /&gt;
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í&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable zebra&amp;quot;&lt;br /&gt;
! colspan=&amp;quot;2&amp;quot; |URLs&lt;br /&gt;
|-&lt;br /&gt;
|Araí-Registry&lt;br /&gt;
|http://registry.local.siu&lt;br /&gt;
|-&lt;br /&gt;
|Araí-Usuarios&lt;br /&gt;
|http://usuarios.local.siu&lt;br /&gt;
|-&lt;br /&gt;
|Araí-Huarpe&lt;br /&gt;
|http://huarpe.local.siu&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
== Instalación Arai-Registy ==&lt;br /&gt;
Creamos la carpeta '''/home/usuario/siu''' y no posicionamos ahí&lt;br /&gt;
Clonamos el proyecto &lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
git clone -b master https://hub.siu.edu.ar/siu-arai/arai-registry.git registry&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
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.&lt;br /&gt;
&lt;br /&gt;
Dentro del directorio del proyecto encontramos el archivo &amp;quot;doc/INSTALACION MANUAL.md&amp;quot;, la idea es seguir las instrucciones que encontramos en este archivo.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
cd registry&lt;br /&gt;
composer install --no-dev&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
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.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
cp templates/arai-registry.env.dist arai-registry.env&lt;br /&gt;
nano arai-registry.env&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
'''arai-registry.env'''&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
# config de la aplicacion&lt;br /&gt;
ARAI_REGISTRY_ALIAS=&amp;quot;/arai-registry&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_USER=&amp;quot;user&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_PASS=&amp;quot;pass&amp;quot;&lt;br /&gt;
&lt;br /&gt;
# config de la base de datos&lt;br /&gt;
ARAI_REGISTRY_DB_HOST=&amp;quot;172.27.31.114&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_DB_PORT=&amp;quot;7432&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_DB_DBNAME=&amp;quot;siu_registry&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_DB_USERNAME=&amp;quot;postgres&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_DB_PASSWORD=&amp;quot;postgres&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_DB_SCHEMA=&amp;quot;registry&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_DB_ENCODING=&amp;quot;UTF8&amp;quot;&lt;br /&gt;
&lt;br /&gt;
###### CONFIG DE LOGS ######&lt;br /&gt;
ARAI_REGISTRY_LOG_HANDLER=&amp;quot;errorlog&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_LOG_LEVEL=&amp;quot;WARNING&amp;quot;&lt;br /&gt;
&lt;br /&gt;
# config del instalador&lt;br /&gt;
INSTALADOR_TIMEOUT=&amp;quot;360&amp;quot;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Una vez editado, verificamos que la configuración sea correcta&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
bin/instalador proyecto:verificar&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Si no sale ninguna alerta, procedemos a instalar. Si sale la alerta de que no existe la base de datos especificada, se puede crear agregando la opción --crear-db al siguiente comando.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
bin/instalador proyecto:instalar&lt;br /&gt;
sudo ln -s ~/registry/config/alias.conf /etc/apache2/sites-available/registry.alias.conf&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Una vez instalado, modificamos los permisos de los archivos de la instalación con el comando&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
sudo ./bin/instalador permisos:simple&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Luego configuramos Apache.&lt;br /&gt;
&lt;br /&gt;
Así me quedo el archivo '''/etc/apache/sites-enabled/registry.conf'''&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;VirtualHost *:80&amp;gt;&lt;br /&gt;
ServerName registry.local.siu&lt;br /&gt;
Include ../sites-available/registry.alias.conf&lt;br /&gt;
&amp;lt;/VirtualHost&amp;gt;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Con todo esto, para verificar que todo funcione reiniciamos Apache y ejecutamos&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
curl --user user:pass http://registry.local.siu/arai-registry/rest/packages/1&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Si la salida es:&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
{&lt;br /&gt;
    &amp;quot;error&amp;quot;: 404,&lt;br /&gt;
    &amp;quot;mensaje&amp;quot;: &amp;quot;404 Not Found&amp;quot;,&lt;br /&gt;
    &amp;quot;descripcion&amp;quot;: &amp;quot;El paquete solicitado no existe&amp;quot;&lt;br /&gt;
}&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
es que la instalación funcionó correctamente.&lt;br /&gt;
&lt;br /&gt;
Con registry instalado procedemos a instalar Usuarios&lt;br /&gt;
&lt;br /&gt;
==Arai-Usuarios==&lt;br /&gt;
&lt;br /&gt;
Nos posicionamos en ~/siu y clonamos el proyecto&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
git clone -b master https://hub.siu.edu.ar/siu-arai/arai-usuarios.git usuarios&lt;br /&gt;
cd usuarios&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Para instalar seguimos la documentación del archivo '''doc/INSTALACION_MANUAL.md'''&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
composer install --no-dev&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Si no se cuenta con certificados para el IDp SAML, se pueden generar con el siguiente comando&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
bin/instalador instalacion:generar-certs-idp -d /home/usuario/siu/usuarios/config/certs_idp -n&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
Donde '''-d''' especifica el directorio donde quedarán las claves (pública y PRIVADA). Este directorio se debe agregar en las variables del Instalador llamadas '''ARAI_USUARIOS_IDP_KEY_FILE''' y '''ARAI_USUARIOS_IDP_CERT_FILE'''.&lt;br /&gt;
&lt;br /&gt;
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.&lt;br /&gt;
Para la configuración de LDAP se asume un servidor que ya está funcionando y configurado. Existen documentación específica sobre este tema en el archivo '''INSTALACION_MANUAL.md'''&lt;br /&gt;
La variable TOBA_USUARIO debe contener el mismo usuarios administrado del LDAP.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
cp templates/arai-usuarios.env.dist arai-usuarios.env&lt;br /&gt;
nano arai-usuarios.env&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
'''arai-usuarios.env.dist'''&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
###### CONFIG DEL INSTALADR ######&lt;br /&gt;
#INSTALADOR_TIMEOUT=&amp;quot;360&amp;quot;&lt;br /&gt;
ENTORNO_PRODUCCION=&amp;quot;1&amp;quot;&lt;br /&gt;
&lt;br /&gt;
###### VARIABLES GLOBALES DEL ARCHIVO ######&lt;br /&gt;
ARAI_USUARIOS_DIR=/home/usuario/siu/usuarios&lt;br /&gt;
&lt;br /&gt;
###### CONFIG DE TOBA ######&lt;br /&gt;
TOBA_URL_BASE=&amp;quot;https://usuarios.local.siu&amp;quot;&lt;br /&gt;
#TOBA_URL_PORT=&amp;quot;443&amp;quot;&lt;br /&gt;
TOBA_USUARIO=&amp;quot;admin&amp;quot;&lt;br /&gt;
TOBA_PASSWORD=&amp;quot;admin1234&amp;quot;&lt;br /&gt;
TOBA_INSTALACION_DIR=&amp;quot;${ARAI_USUARIOS_DIR}/instalacion&amp;quot;&lt;br /&gt;
TOBA_PROYECTO_DIR=&amp;quot;${ARAI_USUARIOS_DIR}/gestion&amp;quot;&lt;br /&gt;
TOBA_ALIAS_PROYECTO=&amp;quot;/gestion&amp;quot;&lt;br /&gt;
TOBA_ALIAS_NUCLEO=&amp;quot;/toba_gestion&amp;quot;&lt;br /&gt;
#TOBA_ID_DESARROLLADOR=0&lt;br /&gt;
#TOBA_SESSION_NAME=&amp;quot;ARAI_SESSID&amp;quot;&lt;br /&gt;
&lt;br /&gt;
###### CONFIG DE BASE DE DATOS DE NEGOCIO ######&lt;br /&gt;
PROYECTO_DB_HOST=&amp;quot;172.27.31.114&amp;quot;&lt;br /&gt;
PROYECTO_DB_PORT=&amp;quot;7432&amp;quot;&lt;br /&gt;
PROYECTO_DB_DBNAME=&amp;quot;siu_usuarios&amp;quot;&lt;br /&gt;
PROYECTO_DB_USERNAME=&amp;quot;postgres&amp;quot;&lt;br /&gt;
PROYECTO_DB_PASSWORD=&amp;quot;postgres&amp;quot;&lt;br /&gt;
PROYECTO_DB_SCHEMA=&amp;quot;usuarios&amp;quot;&lt;br /&gt;
PROYECTO_DB_ENCODING=&amp;quot;LATIN1&amp;quot;&lt;br /&gt;
&lt;br /&gt;
###### CONFIG DE BASE DE DATOS DE TOBA. #####&lt;br /&gt;
######## DEFINIR SI SE QUIERE UTILIZAR UNA BASE DISTINTA A LA DE NEGOCIO&lt;br /&gt;
#TOBA_DB_HOST=&amp;quot;localhost&amp;quot;&lt;br /&gt;
#TOBA_DB_PORT=&amp;quot;5432&amp;quot;&lt;br /&gt;
#TOBA_DB_DBNAME=&amp;quot;instalador&amp;quot;&lt;br /&gt;
#TOBA_DB_USERNAME=&amp;quot;postgres&amp;quot;&lt;br /&gt;
#TOBA_DB_PASSWORD=&amp;quot;postgres&amp;quot;&lt;br /&gt;
#TOBA_DB_SCHEMA=&amp;quot;public&amp;quot;&lt;br /&gt;
&lt;br /&gt;
##### CONFIG IDM #####&lt;br /&gt;
ARAI_USUARIOS_URL_IDP=https://usuarios.local.siu/idp&lt;br /&gt;
## Deberá setearse si el sistema corre detrás de un proxy reverso&lt;br /&gt;
#ARAI_USUARIOS_PROXY_URL_IDP=http://url.arai-usuarios:80/idp&lt;br /&gt;
ARAI_USUARIOS_URL_PERFIL=https://huarpe.local.siu/perfil&lt;br /&gt;
ARAI_USUARIOS_URL_INSTITUCION=http://siu.edu.ar&lt;br /&gt;
&lt;br /&gt;
ARAI_USUARIOS_SIGLA_INSTITUCION=SIGLA&lt;br /&gt;
ARAI_USUARIOS_EMAIL_SOPORTE=mail.soporte@institucion.edu.ar&lt;br /&gt;
&lt;br /&gt;
##### CONFIG SEGURIDAD ####&lt;br /&gt;
SEGURIDAD_ALGORITMO_PASS=crypt&lt;br /&gt;
SEGURIDAD_LARGO_PASS=8&lt;br /&gt;
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'&lt;br /&gt;
SEGURIDAD_DURACION_DIAS_PASS=120&lt;br /&gt;
SEGURIDAD_RECAPTCHA_SITIO=6Fd_pQwTAAAAAOEqJz6KJmkjsrXcdXrAjWQYggZf&lt;br /&gt;
SEGURIDAD_RECAPTCHA_CLAVE=6Fd_pQwTAAAAAOEqJz6KJmkjsrXcdXrAjWQYggZf&lt;br /&gt;
SEGURIDAD_INTENTOS_RECAPTCHA=3&lt;br /&gt;
&lt;br /&gt;
##### CONFIG IDP #####&lt;br /&gt;
ARAI_USUARIOS_IDP_KEY_FILE=${ARAI_USUARIOS_DIR}/config/certs_idp/certificado_idp.crt&lt;br /&gt;
ARAI_USUARIOS_IDP_CERT_FILE=${ARAI_USUARIOS_DIR}/config/certs_idp/certificado_idp.key&lt;br /&gt;
#ARAI_USUARIOS_IDP_LOG_LEVEL='WARNING'&lt;br /&gt;
#ARAI_USUARIOS_IDP_LOG_HANDLER='errorlog'&lt;br /&gt;
&lt;br /&gt;
##### CONFIG MAIL RECOVERY ####&lt;br /&gt;
MAIL_RECOVERY_SUBJECT='Recuperar contraseña SIU-Arai'&lt;br /&gt;
MAIL_RECOVERY_FROM='noreply@institucion.edu.ar'&lt;br /&gt;
MAIL_RECOVERY_REPLYTO='noreply@institucion.edu.ar'&lt;br /&gt;
MAIL_RECOVERY_FROMNAME='Institución'&lt;br /&gt;
&lt;br /&gt;
##### CONFIG LDAP #####&lt;br /&gt;
ARAI_USUARIOS_LDAP_HOST=172.27.31.114&lt;br /&gt;
ARAI_USUARIOS_LDAP_PORT=7389&lt;br /&gt;
ARAI_USUARIOS_LDAP_TLS=0&lt;br /&gt;
ARAI_USUARIOS_LDAP_METHOD=user&lt;br /&gt;
ARAI_USUARIOS_LDAP_BINDUSER=&amp;quot;cn=admin,dc=siu,dc=cin,dc=edu&amp;quot;&lt;br /&gt;
ARAI_USUARIOS_LDAP_BINDPASS=admin&lt;br /&gt;
ARAI_USUARIOS_LDAP_SEARCHBASE=&amp;quot;dc=siu,dc=cin,dc=edu&amp;quot;&lt;br /&gt;
&lt;br /&gt;
###### CONFIG ENVIO MAILS (SMTP) ######&lt;br /&gt;
SMTP_ENTRADA=&amp;quot;arai-usuarios&amp;quot;&lt;br /&gt;
SMTP_HELO=&amp;quot;mail.unx.edu.ar&amp;quot;&lt;br /&gt;
SMTP_HOST=&amp;quot;smtp.googlemail.com&amp;quot;&lt;br /&gt;
SMTP_PORT=587&lt;br /&gt;
SMTP_FROM =&amp;quot;yo@midominio.com&amp;quot;&lt;br /&gt;
SMTP_SEGURIDAD =&amp;quot;ssl|tls&amp;quot;&lt;br /&gt;
SMTP_AUTH =&amp;quot;1&amp;quot;&lt;br /&gt;
SMTP_USUARIO =&amp;quot;usuario&amp;quot;&lt;br /&gt;
SMTP_CLAVE =&amp;quot;pass&amp;quot;&lt;br /&gt;
&lt;br /&gt;
##### CONFIG API REST #####&lt;br /&gt;
REST_SERVIDOR_AUTH=basic&lt;br /&gt;
&lt;br /&gt;
##### CONFIG ARAI-REGISTRY #####&lt;br /&gt;
ARAI_REGISTRY_URL=http://registry.local.siu/arai-registry&lt;br /&gt;
ARAI_REGISTRY_USER=user&lt;br /&gt;
ARAI_REGISTRY_PASS=pass&lt;br /&gt;
&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Una vez editado, verificamos que la configuración sea correcta&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
bin/instalador proyecto:verificar -n&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== HASTA ACA ==&lt;br /&gt;
&lt;br /&gt;
Si no sale ninguna alerta, procedemos a instalar.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/instalador proyecto:instalar&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
Una vez instalado, modificamos los permisos de los archivos de la instalación con el comando&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
sudo ./bin/instalador permisos:simple&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
Cambiamos el modo mantenimiento&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/instalador instalacion:modo-mantenimiento --sin-mantenimiento -n&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Luego configuramos Apache.&lt;br /&gt;
Lo mismo que con registry, como tengo toda la plataforma instalada en un mismo servidor, debo usar el '''ServerName &amp;quot;usuarios.local.siu&amp;quot;'''&lt;br /&gt;
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'''&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;VirtualHost *:80&amp;gt;&lt;br /&gt;
    ServerName usuarios.local.siu&lt;br /&gt;
    Redirect permanent / https://usuarios.local.siu/&lt;br /&gt;
&amp;lt;/VirtualHost&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;VirtualHost *:443&amp;gt;&lt;br /&gt;
&lt;br /&gt;
ServerName usuarios.local.siu&lt;br /&gt;
&lt;br /&gt;
SSLEngine on&lt;br /&gt;
SSLCertificateFile /certs/usuarios.local.siu.cert.pem&lt;br /&gt;
SSLCertificateKeyFile /certs/usuarios.local.siu.key.pem&lt;br /&gt;
&lt;br /&gt;
SSLCACertificateFile /certs/ca-chain.cert.pem&lt;br /&gt;
&lt;br /&gt;
SSLVerifyClient optional_no_ca&lt;br /&gt;
SSLVerifyDepth 2&lt;br /&gt;
SSLProtocol all -SSLv2 -SSLv3&lt;br /&gt;
SSLOptions +StdEnvVars +ExportCertData&lt;br /&gt;
BrowserMatch &amp;quot;MSIE [2-6]&amp;quot; \&lt;br /&gt;
        nokeepalive ssl-unclean-shutdown \&lt;br /&gt;
        downgrade-1.0 force-response-1.0&lt;br /&gt;
        # MSIE 7 and newer should be able to use keepalive&lt;br /&gt;
BrowserMatch &amp;quot;MSIE [17-9]&amp;quot; ssl-unclean-shutdown&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Include /usr/local/siu/usuarios/instalacion/toba.conf&lt;br /&gt;
&lt;br /&gt;
Include /usr/local/siu/usuarios/instalacion/idp.conf&lt;br /&gt;
&lt;br /&gt;
&amp;lt;/VirtualHost&amp;gt;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Luego hay que hacer que nuestra CA autofirmada sea válida en el SO y así permitir que Apache verifique los certificados de clientes:&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
sudo cp /certs/ca.cert.pem /usr/share/ca-certificates/ca_propia.crt&lt;br /&gt;
sudo vim /etc/ca-certificates.conf&lt;br /&gt;
# agregar ca_propia.crt al final del archivo&lt;br /&gt;
update-ca-certificates --fresh&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Reiniciamos Apache y todo debería funcionar, para verificar entramos en la URL definida para usuarios, en mi caso https://usuarios.local.siu/gestion&lt;br /&gt;
&lt;br /&gt;
Con todo esto funcionando el siguiente paso es agregar Usuarios a Registry y sincronizarlos. &lt;br /&gt;
Según esta instalación para agregar Usuarios al entorno hacemos&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/arai-cli registry:add --maintainer-email  jpiazza@siu.edu.ar --maintainer jpiazza http://registry.local.siu/arai-registry&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
y para sincronizarlo&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/arai-cli registry:sync&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== Arai-Huarpe ==&lt;br /&gt;
&lt;br /&gt;
Es similar a las instalaciones anteriores.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
cd /usr/local/siu&lt;br /&gt;
git clone -b master https://hub.siu.edu.ar/siu-arai/huarpe-core.git huarpe&lt;br /&gt;
cd huarpe&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Para instalar seguimos la documentación del archivo '''doc/INSTALACION_MANUAL.md'''&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
composer install --no-dev&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
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.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
cp templates/huarpe.env.dist huarpe.env&lt;br /&gt;
nano huarpe.env&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
'''huarpe.env'''&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
###### CONFIG DEL INSTALADR ######&lt;br /&gt;
#INSTALADOR_TIMEOUT=&amp;quot;360&amp;quot;&lt;br /&gt;
ENTORNO_PRODUCCION=1&lt;br /&gt;
&lt;br /&gt;
###### CONFIG DE SIU-HUARPE ######&lt;br /&gt;
HUARPE_PATH=/usr/local/siu/huarpe&lt;br /&gt;
HUARPE_URL=https://huarpe.local.siu&lt;br /&gt;
HUARPE_URL_PORT=443&lt;br /&gt;
HUARPE_SESSION_NAME=huarpe&lt;br /&gt;
HUARPE_SESSION_HANDLER=&amp;quot;native_file&amp;quot;&lt;br /&gt;
#HUARPE_MEMCACHED_HOST=127.0.0.1&lt;br /&gt;
#HUARPE_MEMCACHED_PORT=11211&lt;br /&gt;
HUARPE_CERT_FILE=/certs/huarpe-cli.cert.pem&lt;br /&gt;
HUARPE_KEY_FILE=/certs/huarpe-cli.key.pem&lt;br /&gt;
#HUARPE_TOKEN=unt0k3n-al3at0r1o-s39ur0?&lt;br /&gt;
#HUARPE_PROXY=127.0.0.1&lt;br /&gt;
HUARPE_LOG_HANDLER=&amp;quot;error_log&amp;quot;&lt;br /&gt;
HUARPE_LOG_LEVEL=&amp;quot;WARNING&amp;quot;&lt;br /&gt;
&lt;br /&gt;
###### CONFIG BRANDING ######&lt;br /&gt;
#HUARPE_PATH_LOGO=&amp;quot;/path/al/logo.png&amp;quot;&lt;br /&gt;
HUARPE_NOMBRE_INSTITUCION=&amp;quot;Institución&amp;quot;&lt;br /&gt;
&lt;br /&gt;
###### CONFIG DE SIU-ARAI: REGISTRY ######&lt;br /&gt;
ARAI_REGISTRY_URL=http://registry.local.siu/arai-registry&lt;br /&gt;
ARAI_REGISTRY_USER=user&lt;br /&gt;
ARAI_REGISTRY_PASS=pass&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Una vez editado, verificamos que la configuración sea correcta&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/instalador proyecto:verificar&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
Si no sale ninguna alerta, procedemos a instalar.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
sudo ./bin/instalador proyecto:instalar&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
En Synfony es necesario dumpear los estilos y los JS con el siguiente comando.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/console assetic:dump --no-debug --env=prod&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
Una vez instalado, modificamos los permisos de los archivos de la instalación con el comando&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
sudo ./bin/instalador permisos:simple&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Configuración apache ===&lt;br /&gt;
Lo mismo que con Registry o Usuarios, como tengo toda la plataforma instalada en un mismo servidor, debo usar el '''ServerName huarpe.local.siu'''.&lt;br /&gt;
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&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;VirtualHost *:80&amp;gt;&lt;br /&gt;
	ServerName huarpe.local.siu&lt;br /&gt;
	Redirect permanent / https://huarpe.local.siu:443/&lt;br /&gt;
&amp;lt;/VirtualHost&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;VirtualHost *:443&amp;gt;&lt;br /&gt;
&lt;br /&gt;
ServerName huarpe.local.siu&lt;br /&gt;
SSLEngine on&lt;br /&gt;
SSLCertificateFile /certs/huarpe.local.siu.cert.pem&lt;br /&gt;
SSLCertificateKeyFile /certs/huarpe.local.siu.key.pem&lt;br /&gt;
&lt;br /&gt;
Include /usr/local/siu/huarpe/app/config/alias.conf&lt;br /&gt;
&lt;br /&gt;
&amp;lt;/VirtualHost&amp;gt;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Reiniciamos apache, antes de verificar la instalación, debemos sincronizar con Registry.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/arai-cli registry:add --maintainer-email  jpiazza@siu.edu.ar --maintainer jpiazza http://registry.local.siu/arai-registry&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
Luego sincronizar&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/arai-cli registry:sync&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Hay que limpiar la cache y actualizar los permisos&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/console cache:clear --env=prod&lt;br /&gt;
sudo ./bin/instalador permisos:simple &lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
En Usuarios resincronizar para que se actualice con la nueva instalación&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
cd /usr/local/siu/usuarios&lt;br /&gt;
./bin/arai-cli registry:sync&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Para verificar que la instalación se realizo con éxito de debe ingresar en https://huarpe.local.siu/&lt;br /&gt;
&lt;br /&gt;
Si todo salio bien, tenemos instalada la plataforma ARAI lista para ser usada en nuestro servidor.&lt;/div&gt;</summary>
		<author><name>Ablanco</name></author>	</entry>

	<entry>
		<id>https://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Arai/arai2ejemplo&amp;diff=40697</id>
		<title>SIU-Arai/arai2ejemplo</title>
		<link rel="alternate" type="text/html" href="https://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Arai/arai2ejemplo&amp;diff=40697"/>
				<updated>2018-04-16T18:46:25Z</updated>
		
		<summary type="html">&lt;p&gt;Ablanco: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;[[Archivo:siu-arai_iso.png|derecha|link=SIU-Arai]]&lt;br /&gt;
&lt;br /&gt;
= Ejemplo paso a paso =&lt;br /&gt;
Para este caso voy a usar una instalación de Debian Jessie&lt;br /&gt;
&lt;br /&gt;
El objetivo es tener una instalación funcionando de la paltaforma SIU-Arai que luego sirva para integrar otros sistemas toba.&lt;br /&gt;
&lt;br /&gt;
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í&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable zebra&amp;quot;&lt;br /&gt;
! colspan=&amp;quot;2&amp;quot; |URLs&lt;br /&gt;
|-&lt;br /&gt;
|Araí-Registry&lt;br /&gt;
|http://registry.local.siu&lt;br /&gt;
|-&lt;br /&gt;
|Araí-Usuarios&lt;br /&gt;
|http://usuarios.local.siu&lt;br /&gt;
|-&lt;br /&gt;
|Araí-Huarpe&lt;br /&gt;
|http://huarpe.local.siu&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
== Instalación Arai-Registy ==&lt;br /&gt;
Creamos la carpeta '''/home/usuario/siu''' y no posicionamos ahí&lt;br /&gt;
Clonamos el proyecto &lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
git clone -b master https://hub.siu.edu.ar/siu-arai/arai-registry.git registry&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
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.&lt;br /&gt;
&lt;br /&gt;
Dentro del directorio del proyecto encontramos el archivo &amp;quot;doc/INSTALACION MANUAL.md&amp;quot;, la idea es seguir las instrucciones que encontramos en este archivo.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
cd registry&lt;br /&gt;
composer install --no-dev&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
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.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
cp templates/arai-registry.env.dist arai-registry.env&lt;br /&gt;
nano arai-registry.env&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
'''arai-registry.env'''&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
# config de la aplicacion&lt;br /&gt;
ARAI_REGISTRY_ALIAS=&amp;quot;/arai-registry&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_USER=&amp;quot;user&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_PASS=&amp;quot;pass&amp;quot;&lt;br /&gt;
&lt;br /&gt;
# config de la base de datos&lt;br /&gt;
ARAI_REGISTRY_DB_HOST=&amp;quot;172.27.31.114&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_DB_PORT=&amp;quot;7432&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_DB_DBNAME=&amp;quot;siu_registry&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_DB_USERNAME=&amp;quot;postgres&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_DB_PASSWORD=&amp;quot;postgres&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_DB_SCHEMA=&amp;quot;registry&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_DB_ENCODING=&amp;quot;UTF8&amp;quot;&lt;br /&gt;
&lt;br /&gt;
###### CONFIG DE LOGS ######&lt;br /&gt;
ARAI_REGISTRY_LOG_HANDLER=&amp;quot;errorlog&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_LOG_LEVEL=&amp;quot;WARNING&amp;quot;&lt;br /&gt;
&lt;br /&gt;
# config del instalador&lt;br /&gt;
INSTALADOR_TIMEOUT=&amp;quot;360&amp;quot;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Una vez editado, verificamos que la configuración sea correcta&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
bin/instalador proyecto:verificar&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Si no sale ninguna alerta, procedemos a instalar. Si sale la alerta de que no existe la base de datos especificada, se puede crear agregando la opción --crear-db al siguiente comando.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
bin/instalador proyecto:instalar&lt;br /&gt;
sudo ln -s ~/registry/config/alias.conf /etc/apache2/sites-available/registry.alias.conf&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Una vez instalado, modificamos los permisos de los archivos de la instalación con el comando&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
sudo ./bin/instalador permisos:simple&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Luego configuramos Apache.&lt;br /&gt;
&lt;br /&gt;
Así me quedo el archivo '''/etc/apache/sites-enabled/registry.conf'''&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;VirtualHost *:80&amp;gt;&lt;br /&gt;
ServerName registry.local.siu&lt;br /&gt;
Include ../sites-available/registry.alias.conf&lt;br /&gt;
&amp;lt;/VirtualHost&amp;gt;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Con todo esto, para verificar que todo funcione reiniciamos Apache y ejecutamos&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
curl --user user:pass http://registry.local.siu/arai-registry/rest/packages/1&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Si la salida es:&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
{&lt;br /&gt;
    &amp;quot;error&amp;quot;: 404,&lt;br /&gt;
    &amp;quot;mensaje&amp;quot;: &amp;quot;404 Not Found&amp;quot;,&lt;br /&gt;
    &amp;quot;descripcion&amp;quot;: &amp;quot;El paquete solicitado no existe&amp;quot;&lt;br /&gt;
}&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
es que la instalación funcionó correctamente.&lt;br /&gt;
&lt;br /&gt;
Con registry instalado procedemos a instalar Usuarios&lt;br /&gt;
&lt;br /&gt;
############################################## FALTA DE ACÁ PARA ABAJO&lt;br /&gt;
==Arai-Usuarios==&lt;br /&gt;
&lt;br /&gt;
Nos posicionamos en /usr/local/siu y clonamos el proyecto&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
cd /usr/local/siu&lt;br /&gt;
git clone -b master https://hub.siu.edu.ar/siu-arai/arai-usuarios.git usuarios&lt;br /&gt;
cd usuarios&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Para instalar seguimos la documentación del archivo '''doc/INSTALACION_MANUAL.md'''&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
composer install --no-dev&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
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.&lt;br /&gt;
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.&lt;br /&gt;
La variable TOBA_USUARIO debe contener el mismo usuarios administrado del LDAP.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
cp templates/arai-usuarios.env.dist arai-usuarios.env&lt;br /&gt;
nano arai-usuarios.env&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
'''arai-usuarios.env.dist'''&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
###### CONFIG DEL INSTALADR ######&lt;br /&gt;
#INSTALADOR_TIMEOUT=&amp;quot;360&amp;quot;&lt;br /&gt;
ENTORNO_PRODUCCION=&amp;quot;1&amp;quot;&lt;br /&gt;
&lt;br /&gt;
###### VARIABLES GLOBALES DEL ARCHIVO ######&lt;br /&gt;
ARAI_USUARIOS_DIR=/usr/local/siu/usuarios&lt;br /&gt;
&lt;br /&gt;
###### CONFIG DE TOBA ######&lt;br /&gt;
TOBA_URL_BASE=&amp;quot;https://usuarios.local.siu&amp;quot;&lt;br /&gt;
#TOBA_URL_PORT=&amp;quot;443&amp;quot;&lt;br /&gt;
TOBA_USUARIO=&amp;quot;admin&amp;quot;&lt;br /&gt;
TOBA_PASSWORD=&amp;quot;admin1234&amp;quot;&lt;br /&gt;
TOBA_INSTALACION_DIR=&amp;quot;${ARAI_USUARIOS_DIR}/instalacion&amp;quot;&lt;br /&gt;
TOBA_PROYECTO_DIR=&amp;quot;${ARAI_USUARIOS_DIR}/gestion&amp;quot;&lt;br /&gt;
TOBA_INSTALAR_USUARIOS=false&lt;br /&gt;
TOBA_INSTALAR_EDITOR=false&lt;br /&gt;
TOBA_INSTALAR_REFERENCIA=false&lt;br /&gt;
TOBA_ALIAS_PROYECTO=&amp;quot;/gestion&amp;quot;&lt;br /&gt;
TOBA_ALIAS_NUCLEO=&amp;quot;/toba_gestion&amp;quot;&lt;br /&gt;
#TOBA_ID_DESARROLLADOR=0&lt;br /&gt;
#TOBA_SESSION_NAME=&amp;quot;ARAI_SESSID&amp;quot;&lt;br /&gt;
&lt;br /&gt;
###### CONFIG DE BASE DE DATOS DE NEGOCIO ######&lt;br /&gt;
PROYECTO_DB_HOST=&amp;quot;172.27.31.114&amp;quot;&lt;br /&gt;
PROYECTO_DB_PORT=&amp;quot;7432&amp;quot;&lt;br /&gt;
PROYECTO_DB_DBNAME=&amp;quot;siu_usuarios&amp;quot;&lt;br /&gt;
PROYECTO_DB_USERNAME=&amp;quot;postgres&amp;quot;&lt;br /&gt;
PROYECTO_DB_PASSWORD=&amp;quot;postgres&amp;quot;&lt;br /&gt;
PROYECTO_DB_SCHEMA=&amp;quot;usuarios&amp;quot;&lt;br /&gt;
PROYECTO_DB_ENCODING=&amp;quot;LATIN1&amp;quot;&lt;br /&gt;
&lt;br /&gt;
###### CONFIG DE BASE DE DATOS DE TOBA. #####&lt;br /&gt;
######## DEFINIR SI SE QUIERE UTILIZAR UNA BASE DISTINTA A LA DE NEGOCIO&lt;br /&gt;
#TOBA_DB_HOST=&amp;quot;localhost&amp;quot;&lt;br /&gt;
#TOBA_DB_PORT=&amp;quot;5432&amp;quot;&lt;br /&gt;
#TOBA_DB_DBNAME=&amp;quot;instalador&amp;quot;&lt;br /&gt;
#TOBA_DB_USERNAME=&amp;quot;postgres&amp;quot;&lt;br /&gt;
#TOBA_DB_PASSWORD=&amp;quot;postgres&amp;quot;&lt;br /&gt;
#TOBA_DB_SCHEMA=&amp;quot;public&amp;quot;&lt;br /&gt;
&lt;br /&gt;
##### CONFIG IDM #####&lt;br /&gt;
ARAI_USUARIOS_URL_IDP=https://usuarios.local.siu/idp&lt;br /&gt;
## Deberá setearse si el sistema corre detrás de un proxy reverso&lt;br /&gt;
#ARAI_USUARIOS_PROXY_URL_IDP=http://url.arai-usuarios:80/idp&lt;br /&gt;
ARAI_USUARIOS_URL_PORTAL=https://huarpe.local.siu/portal&lt;br /&gt;
ARAI_USUARIOS_URL_PERFIL=https://huarpe.local.siu/perfil&lt;br /&gt;
ARAI_USUARIOS_URL_INSTITUCION=http://siu.edu.ar&lt;br /&gt;
&lt;br /&gt;
ARAI_USUARIOS_SIGLA_INSTITUCION=SIGLA&lt;br /&gt;
ARAI_USUARIOS_EMAIL_SOPORTE=mail.soporte@institucion.edu.ar&lt;br /&gt;
&lt;br /&gt;
##### CONFIG SEGURIDAD ####&lt;br /&gt;
SEGURIDAD_ALGORITMO_PASS=crypt&lt;br /&gt;
SEGURIDAD_LARGO_PASS=8&lt;br /&gt;
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'&lt;br /&gt;
SEGURIDAD_DURACION_DIAS_PASS=120&lt;br /&gt;
SEGURIDAD_RECAPTCHA_SITIO=6Fd_pQwTAAAAAOEqJz6KJmkjsrXcdXrAjWQYggZf&lt;br /&gt;
SEGURIDAD_RECAPTCHA_CLAVE=6Fd_pQwTAAAAAOEqJz6KJmkjsrXcdXrAjWQYggZf&lt;br /&gt;
SEGURIDAD_INTENTOS_RECAPTCHA=3&lt;br /&gt;
&lt;br /&gt;
##### CONFIG IDP #####&lt;br /&gt;
ARAI_USUARIOS_IDP_KEY_FILE=/certs/idp/certificado_idp.pem&lt;br /&gt;
ARAI_USUARIOS_IDP_CERT_FILE=/certs/idp/certificado_idp.crt&lt;br /&gt;
#ARAI_USUARIOS_IDP_LOG_LEVEL='WARNING'&lt;br /&gt;
#ARAI_USUARIOS_IDP_LOG_HANDLER='errorlog'&lt;br /&gt;
&lt;br /&gt;
##### CONFIG MAIL RECOVERY ####&lt;br /&gt;
MAIL_RECOVERY_SUBJECT='Recuperar contraseña SIU-Arai'&lt;br /&gt;
MAIL_RECOVERY_FROM='noreply@institucion.edu.ar'&lt;br /&gt;
MAIL_RECOVERY_REPLYTO='noreply@institucion.edu.ar'&lt;br /&gt;
MAIL_RECOVERY_FROMNAME='Institución'&lt;br /&gt;
&lt;br /&gt;
##### CONFIG LDAP #####&lt;br /&gt;
ARAI_USUARIOS_LDAP_HOST=172.27.31.114&lt;br /&gt;
ARAI_USUARIOS_LDAP_PORT=7389&lt;br /&gt;
ARAI_USUARIOS_LDAP_TLS=0&lt;br /&gt;
ARAI_USUARIOS_LDAP_METHOD=user&lt;br /&gt;
ARAI_USUARIOS_LDAP_BINDUSER=&amp;quot;cn=admin,dc=siu,dc=cin,dc=edu&amp;quot;&lt;br /&gt;
ARAI_USUARIOS_LDAP_BINDPASS=admin&lt;br /&gt;
ARAI_USUARIOS_LDAP_SEARCHBASE=&amp;quot;dc=siu,dc=cin,dc=edu&amp;quot;&lt;br /&gt;
&lt;br /&gt;
##### CONFIG ARAI-REGISTRY #####&lt;br /&gt;
ARAI_REGISTRY_URL=http://registry.local.siu/arai-registry&lt;br /&gt;
ARAI_REGISTRY_USER=user&lt;br /&gt;
ARAI_REGISTRY_PASS=pass&lt;br /&gt;
&lt;br /&gt;
###### CONFIG ENVIO MAILS (SMTP) ######&lt;br /&gt;
SMTP_ENTRADA=&amp;quot;arai-usuarios&amp;quot;&lt;br /&gt;
SMTP_HELO=&amp;quot;mail.unx.edu.ar&amp;quot;&lt;br /&gt;
SMTP_HOST=&amp;quot;smtp.googlemail.com&amp;quot;&lt;br /&gt;
SMTP_PORT=587&lt;br /&gt;
SMTP_FROM =&amp;quot;yo@midominio.com&amp;quot;&lt;br /&gt;
SMTP_SEGURIDAD =&amp;quot;ssl|tls&amp;quot;&lt;br /&gt;
SMTP_AUTH =&amp;quot;1&amp;quot;&lt;br /&gt;
SMTP_USUARIO =&amp;quot;usuario&amp;quot;&lt;br /&gt;
SMTP_CLAVE =&amp;quot;pass&amp;quot;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Una vez editado, verificamos que la configuración sea correcta&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/instalador proyecto:verificar -n&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Si no sale ninguna alerta, procedemos a instalar.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/instalador proyecto:instalar&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
Una vez instalado, modificamos los permisos de los archivos de la instalación con el comando&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
sudo ./bin/instalador permisos:simple&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
Cambiamos el modo mantenimiento&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/instalador instalacion:modo-mantenimiento --sin-mantenimiento -n&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Luego configuramos Apache.&lt;br /&gt;
Lo mismo que con registry, como tengo toda la plataforma instalada en un mismo servidor, debo usar el '''ServerName &amp;quot;usuarios.local.siu&amp;quot;'''&lt;br /&gt;
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'''&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;VirtualHost *:80&amp;gt;&lt;br /&gt;
    ServerName usuarios.local.siu&lt;br /&gt;
    Redirect permanent / https://usuarios.local.siu/&lt;br /&gt;
&amp;lt;/VirtualHost&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;VirtualHost *:443&amp;gt;&lt;br /&gt;
&lt;br /&gt;
ServerName usuarios.local.siu&lt;br /&gt;
&lt;br /&gt;
SSLEngine on&lt;br /&gt;
SSLCertificateFile /certs/usuarios.local.siu.cert.pem&lt;br /&gt;
SSLCertificateKeyFile /certs/usuarios.local.siu.key.pem&lt;br /&gt;
&lt;br /&gt;
SSLCACertificateFile /certs/ca-chain.cert.pem&lt;br /&gt;
&lt;br /&gt;
SSLVerifyClient optional_no_ca&lt;br /&gt;
SSLVerifyDepth 2&lt;br /&gt;
SSLProtocol all -SSLv2 -SSLv3&lt;br /&gt;
SSLOptions +StdEnvVars +ExportCertData&lt;br /&gt;
BrowserMatch &amp;quot;MSIE [2-6]&amp;quot; \&lt;br /&gt;
        nokeepalive ssl-unclean-shutdown \&lt;br /&gt;
        downgrade-1.0 force-response-1.0&lt;br /&gt;
        # MSIE 7 and newer should be able to use keepalive&lt;br /&gt;
BrowserMatch &amp;quot;MSIE [17-9]&amp;quot; ssl-unclean-shutdown&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Include /usr/local/siu/usuarios/instalacion/toba.conf&lt;br /&gt;
&lt;br /&gt;
Include /usr/local/siu/usuarios/instalacion/idp.conf&lt;br /&gt;
&lt;br /&gt;
&amp;lt;/VirtualHost&amp;gt;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Luego hay que hacer que nuestra CA autofirmada sea válida en el SO y así permitir que Apache verifique los certificados de clientes:&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
sudo cp /certs/ca.cert.pem /usr/share/ca-certificates/ca_propia.crt&lt;br /&gt;
sudo vim /etc/ca-certificates.conf&lt;br /&gt;
# agregar ca_propia.crt al final del archivo&lt;br /&gt;
update-ca-certificates --fresh&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Reiniciamos Apache y todo debería funcionar, para verificar entramos en la URL definida para usuarios, en mi caso https://usuarios.local.siu/gestion&lt;br /&gt;
&lt;br /&gt;
Con todo esto funcionando el siguiente paso es agregar Usuarios a Registry y sincronizarlos. &lt;br /&gt;
Según esta instalación para agregar Usuarios al entorno hacemos&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/arai-cli registry:add --maintainer-email  jpiazza@siu.edu.ar --maintainer jpiazza http://registry.local.siu/arai-registry&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
y para sincronizarlo&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/arai-cli registry:sync&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== Arai-Huarpe ==&lt;br /&gt;
&lt;br /&gt;
Es similar a las instalaciones anteriores.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
cd /usr/local/siu&lt;br /&gt;
git clone -b master https://hub.siu.edu.ar/siu-arai/huarpe-core.git huarpe&lt;br /&gt;
cd huarpe&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Para instalar seguimos la documentación del archivo '''doc/INSTALACION_MANUAL.md'''&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
composer install --no-dev&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
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.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
cp templates/huarpe.env.dist huarpe.env&lt;br /&gt;
nano huarpe.env&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
'''huarpe.env'''&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
###### CONFIG DEL INSTALADR ######&lt;br /&gt;
#INSTALADOR_TIMEOUT=&amp;quot;360&amp;quot;&lt;br /&gt;
ENTORNO_PRODUCCION=1&lt;br /&gt;
&lt;br /&gt;
###### CONFIG DE SIU-HUARPE ######&lt;br /&gt;
HUARPE_PATH=/usr/local/siu/huarpe&lt;br /&gt;
HUARPE_URL=https://huarpe.local.siu&lt;br /&gt;
HUARPE_URL_PORT=443&lt;br /&gt;
HUARPE_SESSION_NAME=huarpe&lt;br /&gt;
HUARPE_SESSION_HANDLER=&amp;quot;native_file&amp;quot;&lt;br /&gt;
#HUARPE_MEMCACHED_HOST=127.0.0.1&lt;br /&gt;
#HUARPE_MEMCACHED_PORT=11211&lt;br /&gt;
HUARPE_CERT_FILE=/certs/huarpe-cli.cert.pem&lt;br /&gt;
HUARPE_KEY_FILE=/certs/huarpe-cli.key.pem&lt;br /&gt;
#HUARPE_TOKEN=unt0k3n-al3at0r1o-s39ur0?&lt;br /&gt;
#HUARPE_PROXY=127.0.0.1&lt;br /&gt;
HUARPE_LOG_HANDLER=&amp;quot;error_log&amp;quot;&lt;br /&gt;
HUARPE_LOG_LEVEL=&amp;quot;WARNING&amp;quot;&lt;br /&gt;
&lt;br /&gt;
###### CONFIG BRANDING ######&lt;br /&gt;
#HUARPE_PATH_LOGO=&amp;quot;/path/al/logo.png&amp;quot;&lt;br /&gt;
HUARPE_NOMBRE_INSTITUCION=&amp;quot;Institución&amp;quot;&lt;br /&gt;
&lt;br /&gt;
###### CONFIG DE SIU-ARAI: REGISTRY ######&lt;br /&gt;
ARAI_REGISTRY_URL=http://registry.local.siu/arai-registry&lt;br /&gt;
ARAI_REGISTRY_USER=user&lt;br /&gt;
ARAI_REGISTRY_PASS=pass&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Una vez editado, verificamos que la configuración sea correcta&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/instalador proyecto:verificar&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
Si no sale ninguna alerta, procedemos a instalar.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
sudo ./bin/instalador proyecto:instalar&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
En Synfony es necesario dumpear los estilos y los JS con el siguiente comando.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/console assetic:dump --no-debug --env=prod&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
Una vez instalado, modificamos los permisos de los archivos de la instalación con el comando&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
sudo ./bin/instalador permisos:simple&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Configuración apache ===&lt;br /&gt;
Lo mismo que con Registry o Usuarios, como tengo toda la plataforma instalada en un mismo servidor, debo usar el '''ServerName huarpe.local.siu'''.&lt;br /&gt;
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&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;VirtualHost *:80&amp;gt;&lt;br /&gt;
	ServerName huarpe.local.siu&lt;br /&gt;
	Redirect permanent / https://huarpe.local.siu:443/&lt;br /&gt;
&amp;lt;/VirtualHost&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;VirtualHost *:443&amp;gt;&lt;br /&gt;
&lt;br /&gt;
ServerName huarpe.local.siu&lt;br /&gt;
SSLEngine on&lt;br /&gt;
SSLCertificateFile /certs/huarpe.local.siu.cert.pem&lt;br /&gt;
SSLCertificateKeyFile /certs/huarpe.local.siu.key.pem&lt;br /&gt;
&lt;br /&gt;
Include /usr/local/siu/huarpe/app/config/alias.conf&lt;br /&gt;
&lt;br /&gt;
&amp;lt;/VirtualHost&amp;gt;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Reiniciamos apache, antes de verificar la instalación, debemos sincronizar con Registry.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/arai-cli registry:add --maintainer-email  jpiazza@siu.edu.ar --maintainer jpiazza http://registry.local.siu/arai-registry&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
Luego sincronizar&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/arai-cli registry:sync&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Hay que limpiar la cache y actualizar los permisos&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/console cache:clear --env=prod&lt;br /&gt;
sudo ./bin/instalador permisos:simple &lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
En Usuarios resincronizar para que se actualice con la nueva instalación&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
cd /usr/local/siu/usuarios&lt;br /&gt;
./bin/arai-cli registry:sync&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Para verificar que la instalación se realizo con éxito de debe ingresar en https://huarpe.local.siu/&lt;br /&gt;
&lt;br /&gt;
Si todo salio bien, tenemos instalada la plataforma ARAI lista para ser usada en nuestro servidor.&lt;/div&gt;</summary>
		<author><name>Ablanco</name></author>	</entry>

	<entry>
		<id>https://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Arai/arai2ejemplo&amp;diff=40694</id>
		<title>SIU-Arai/arai2ejemplo</title>
		<link rel="alternate" type="text/html" href="https://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Arai/arai2ejemplo&amp;diff=40694"/>
				<updated>2018-04-16T17:41:31Z</updated>
		
		<summary type="html">&lt;p&gt;Ablanco: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;[[Archivo:siu-arai_iso.png|derecha|link=SIU-Arai]]&lt;br /&gt;
&lt;br /&gt;
= Ejemplo paso a paso =&lt;br /&gt;
Para este caso voy a usar una instalación de Debian Jessie&lt;br /&gt;
&lt;br /&gt;
El objetivo es tener una instalación funcionando de la paltaforma SIU-Arai que luego sirva para integrar otros sistemas toba.&lt;br /&gt;
&lt;br /&gt;
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í&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable zebra&amp;quot;&lt;br /&gt;
! colspan=&amp;quot;2&amp;quot; |URLs&lt;br /&gt;
|-&lt;br /&gt;
|Araí-Registry&lt;br /&gt;
|http://registry.local.siu&lt;br /&gt;
|-&lt;br /&gt;
|Araí-Usuarios&lt;br /&gt;
|https://usuarios.local.siu&lt;br /&gt;
|-&lt;br /&gt;
|Araí-Huarpe&lt;br /&gt;
|https://huarpe.local.siu&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
== Instalación Arai-Registy ==&lt;br /&gt;
Creamos la carpeta '''/usr/local/siu''' y no posicionamos ahí&lt;br /&gt;
Clonamos el proyecto &lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
git clone -b master https://hub.siu.edu.ar/siu-arai/arai-registry.git registry&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
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.&lt;br /&gt;
&lt;br /&gt;
Dentro del directorio del proyecto encontramos el archivo &amp;quot;doc/INSTALACION MANUAL.md&amp;quot;, la idea es seguir las instrucciones que encontramos en este archivo.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
cd registry&lt;br /&gt;
composer install --no-dev&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
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.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
cp templates/arai-registry.env.dist arai-registry.env&lt;br /&gt;
nano arai-registry.env&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
'''arai-registry.env'''&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
# config de la aplicacion&lt;br /&gt;
ARAI_REGISTRY_ALIAS=&amp;quot;/arai-registry&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_USER=&amp;quot;user&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_PASS=&amp;quot;pass&amp;quot;&lt;br /&gt;
&lt;br /&gt;
# config de la base de datos&lt;br /&gt;
ARAI_REGISTRY_DB_HOST=&amp;quot;172.27.31.114&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_DB_PORT=&amp;quot;7432&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_DB_DBNAME=&amp;quot;siu_registry&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_DB_USERNAME=&amp;quot;postgres&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_DB_PASSWORD=&amp;quot;postgres&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_DB_SCHEMA=&amp;quot;registry&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_DB_ENCODING=&amp;quot;UTF8&amp;quot;&lt;br /&gt;
&lt;br /&gt;
###### CONFIG DE LOGS ######&lt;br /&gt;
ARAI_REGISTRY_LOG_HANDLER=&amp;quot;errorlog&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_LOG_LEVEL=&amp;quot;WARNING&amp;quot;&lt;br /&gt;
&lt;br /&gt;
# config del instalador&lt;br /&gt;
INSTALADOR_TIMEOUT=&amp;quot;360&amp;quot;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Una vez editado, verificamos que la configuración sea correcta&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
sudo ./bin/instalador proyecto:verificar&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Si no sale ninguna alerta, procedemos a instalar.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/instalador proyecto:instalar&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
Una vez instalado, modificamos los permisos de los archivos de la instalación con el comando&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
sudo ./bin/instalador permisos:simple&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Luego configuramos apache.&lt;br /&gt;
En mi caso, como tengo toda la plataforma instalada en un mismo servidor, debo usar el '''ServerName &amp;quot;registry.local.siu&amp;quot;'''&lt;br /&gt;
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'''&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;VirtualHost *:80&amp;gt;&lt;br /&gt;
ServerName registry.local.siu&lt;br /&gt;
Include /usr/local/siu/registry/config/alias.conf&lt;br /&gt;
&amp;lt;/VirtualHost&amp;gt;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Con todo esto, para verificar que todo funcione reiniciamos Apache y ejecutamos&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
curl --user user:pass http://registry.local.siu/arai-registry/rest/packages/1&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Si la salida es:&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
{&lt;br /&gt;
    &amp;quot;error&amp;quot;: 404,&lt;br /&gt;
    &amp;quot;mensaje&amp;quot;: &amp;quot;404 Not Found&amp;quot;,&lt;br /&gt;
    &amp;quot;descripcion&amp;quot;: &amp;quot;El paquete solicitado no existe&amp;quot;&lt;br /&gt;
}&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
es que la instalación funcionó correctamente.&lt;br /&gt;
&lt;br /&gt;
Con registry instalado procedemos a instalar Usuarios&lt;br /&gt;
&lt;br /&gt;
==Arai-Usuarios==&lt;br /&gt;
&lt;br /&gt;
Nos posicionamos en /usr/local/siu y clonamos el proyecto&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
cd /usr/local/siu&lt;br /&gt;
git clone -b master https://hub.siu.edu.ar/siu-arai/arai-usuarios.git usuarios&lt;br /&gt;
cd usuarios&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Para instalar seguimos la documentación del archivo '''doc/INSTALACION_MANUAL.md'''&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
composer install --no-dev&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
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.&lt;br /&gt;
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.&lt;br /&gt;
La variable TOBA_USUARIO debe contener el mismo usuarios administrado del LDAP.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
cp templates/arai-usuarios.env.dist arai-usuarios.env&lt;br /&gt;
nano arai-usuarios.env&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
'''arai-usuarios.env.dist'''&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
###### CONFIG DEL INSTALADR ######&lt;br /&gt;
#INSTALADOR_TIMEOUT=&amp;quot;360&amp;quot;&lt;br /&gt;
ENTORNO_PRODUCCION=&amp;quot;1&amp;quot;&lt;br /&gt;
&lt;br /&gt;
###### VARIABLES GLOBALES DEL ARCHIVO ######&lt;br /&gt;
ARAI_USUARIOS_DIR=/usr/local/siu/usuarios&lt;br /&gt;
&lt;br /&gt;
###### CONFIG DE TOBA ######&lt;br /&gt;
TOBA_URL_BASE=&amp;quot;https://usuarios.local.siu&amp;quot;&lt;br /&gt;
#TOBA_URL_PORT=&amp;quot;443&amp;quot;&lt;br /&gt;
TOBA_USUARIO=&amp;quot;admin&amp;quot;&lt;br /&gt;
TOBA_PASSWORD=&amp;quot;admin1234&amp;quot;&lt;br /&gt;
TOBA_INSTALACION_DIR=&amp;quot;${ARAI_USUARIOS_DIR}/instalacion&amp;quot;&lt;br /&gt;
TOBA_PROYECTO_DIR=&amp;quot;${ARAI_USUARIOS_DIR}/gestion&amp;quot;&lt;br /&gt;
TOBA_INSTALAR_USUARIOS=false&lt;br /&gt;
TOBA_INSTALAR_EDITOR=false&lt;br /&gt;
TOBA_INSTALAR_REFERENCIA=false&lt;br /&gt;
TOBA_ALIAS_PROYECTO=&amp;quot;/gestion&amp;quot;&lt;br /&gt;
TOBA_ALIAS_NUCLEO=&amp;quot;/toba_gestion&amp;quot;&lt;br /&gt;
#TOBA_ID_DESARROLLADOR=0&lt;br /&gt;
#TOBA_SESSION_NAME=&amp;quot;ARAI_SESSID&amp;quot;&lt;br /&gt;
&lt;br /&gt;
###### CONFIG DE BASE DE DATOS DE NEGOCIO ######&lt;br /&gt;
PROYECTO_DB_HOST=&amp;quot;172.27.31.114&amp;quot;&lt;br /&gt;
PROYECTO_DB_PORT=&amp;quot;7432&amp;quot;&lt;br /&gt;
PROYECTO_DB_DBNAME=&amp;quot;siu_usuarios&amp;quot;&lt;br /&gt;
PROYECTO_DB_USERNAME=&amp;quot;postgres&amp;quot;&lt;br /&gt;
PROYECTO_DB_PASSWORD=&amp;quot;postgres&amp;quot;&lt;br /&gt;
PROYECTO_DB_SCHEMA=&amp;quot;usuarios&amp;quot;&lt;br /&gt;
PROYECTO_DB_ENCODING=&amp;quot;LATIN1&amp;quot;&lt;br /&gt;
&lt;br /&gt;
###### CONFIG DE BASE DE DATOS DE TOBA. #####&lt;br /&gt;
######## DEFINIR SI SE QUIERE UTILIZAR UNA BASE DISTINTA A LA DE NEGOCIO&lt;br /&gt;
#TOBA_DB_HOST=&amp;quot;localhost&amp;quot;&lt;br /&gt;
#TOBA_DB_PORT=&amp;quot;5432&amp;quot;&lt;br /&gt;
#TOBA_DB_DBNAME=&amp;quot;instalador&amp;quot;&lt;br /&gt;
#TOBA_DB_USERNAME=&amp;quot;postgres&amp;quot;&lt;br /&gt;
#TOBA_DB_PASSWORD=&amp;quot;postgres&amp;quot;&lt;br /&gt;
#TOBA_DB_SCHEMA=&amp;quot;public&amp;quot;&lt;br /&gt;
&lt;br /&gt;
##### CONFIG IDM #####&lt;br /&gt;
ARAI_USUARIOS_URL_IDP=https://usuarios.local.siu/idp&lt;br /&gt;
## Deberá setearse si el sistema corre detrás de un proxy reverso&lt;br /&gt;
#ARAI_USUARIOS_PROXY_URL_IDP=http://url.arai-usuarios:80/idp&lt;br /&gt;
ARAI_USUARIOS_URL_PORTAL=https://huarpe.local.siu/portal&lt;br /&gt;
ARAI_USUARIOS_URL_PERFIL=https://huarpe.local.siu/perfil&lt;br /&gt;
ARAI_USUARIOS_URL_INSTITUCION=http://siu.edu.ar&lt;br /&gt;
&lt;br /&gt;
ARAI_USUARIOS_SIGLA_INSTITUCION=SIGLA&lt;br /&gt;
ARAI_USUARIOS_EMAIL_SOPORTE=mail.soporte@institucion.edu.ar&lt;br /&gt;
&lt;br /&gt;
##### CONFIG SEGURIDAD ####&lt;br /&gt;
SEGURIDAD_ALGORITMO_PASS=crypt&lt;br /&gt;
SEGURIDAD_LARGO_PASS=8&lt;br /&gt;
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'&lt;br /&gt;
SEGURIDAD_DURACION_DIAS_PASS=120&lt;br /&gt;
SEGURIDAD_RECAPTCHA_SITIO=6Fd_pQwTAAAAAOEqJz6KJmkjsrXcdXrAjWQYggZf&lt;br /&gt;
SEGURIDAD_RECAPTCHA_CLAVE=6Fd_pQwTAAAAAOEqJz6KJmkjsrXcdXrAjWQYggZf&lt;br /&gt;
SEGURIDAD_INTENTOS_RECAPTCHA=3&lt;br /&gt;
&lt;br /&gt;
##### CONFIG IDP #####&lt;br /&gt;
ARAI_USUARIOS_IDP_KEY_FILE=/certs/idp/certificado_idp.pem&lt;br /&gt;
ARAI_USUARIOS_IDP_CERT_FILE=/certs/idp/certificado_idp.crt&lt;br /&gt;
#ARAI_USUARIOS_IDP_LOG_LEVEL='WARNING'&lt;br /&gt;
#ARAI_USUARIOS_IDP_LOG_HANDLER='errorlog'&lt;br /&gt;
&lt;br /&gt;
##### CONFIG MAIL RECOVERY ####&lt;br /&gt;
MAIL_RECOVERY_SUBJECT='Recuperar contraseña SIU-Arai'&lt;br /&gt;
MAIL_RECOVERY_FROM='noreply@institucion.edu.ar'&lt;br /&gt;
MAIL_RECOVERY_REPLYTO='noreply@institucion.edu.ar'&lt;br /&gt;
MAIL_RECOVERY_FROMNAME='Institución'&lt;br /&gt;
&lt;br /&gt;
##### CONFIG LDAP #####&lt;br /&gt;
ARAI_USUARIOS_LDAP_HOST=172.27.31.114&lt;br /&gt;
ARAI_USUARIOS_LDAP_PORT=7389&lt;br /&gt;
ARAI_USUARIOS_LDAP_TLS=0&lt;br /&gt;
ARAI_USUARIOS_LDAP_METHOD=user&lt;br /&gt;
ARAI_USUARIOS_LDAP_BINDUSER=&amp;quot;cn=admin,dc=siu,dc=cin,dc=edu&amp;quot;&lt;br /&gt;
ARAI_USUARIOS_LDAP_BINDPASS=admin&lt;br /&gt;
ARAI_USUARIOS_LDAP_SEARCHBASE=&amp;quot;dc=siu,dc=cin,dc=edu&amp;quot;&lt;br /&gt;
&lt;br /&gt;
##### CONFIG ARAI-REGISTRY #####&lt;br /&gt;
ARAI_REGISTRY_URL=http://registry.local.siu/arai-registry&lt;br /&gt;
ARAI_REGISTRY_USER=user&lt;br /&gt;
ARAI_REGISTRY_PASS=pass&lt;br /&gt;
&lt;br /&gt;
###### CONFIG ENVIO MAILS (SMTP) ######&lt;br /&gt;
SMTP_ENTRADA=&amp;quot;arai-usuarios&amp;quot;&lt;br /&gt;
SMTP_HELO=&amp;quot;mail.unx.edu.ar&amp;quot;&lt;br /&gt;
SMTP_HOST=&amp;quot;smtp.googlemail.com&amp;quot;&lt;br /&gt;
SMTP_PORT=587&lt;br /&gt;
SMTP_FROM =&amp;quot;yo@midominio.com&amp;quot;&lt;br /&gt;
SMTP_SEGURIDAD =&amp;quot;ssl|tls&amp;quot;&lt;br /&gt;
SMTP_AUTH =&amp;quot;1&amp;quot;&lt;br /&gt;
SMTP_USUARIO =&amp;quot;usuario&amp;quot;&lt;br /&gt;
SMTP_CLAVE =&amp;quot;pass&amp;quot;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Una vez editado, verificamos que la configuración sea correcta&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/instalador proyecto:verificar -n&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Si no sale ninguna alerta, procedemos a instalar.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/instalador proyecto:instalar&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
Una vez instalado, modificamos los permisos de los archivos de la instalación con el comando&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
sudo ./bin/instalador permisos:simple&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
Cambiamos el modo mantenimiento&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/instalador instalacion:modo-mantenimiento --sin-mantenimiento -n&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Luego configuramos Apache.&lt;br /&gt;
Lo mismo que con registry, como tengo toda la plataforma instalada en un mismo servidor, debo usar el '''ServerName &amp;quot;usuarios.local.siu&amp;quot;'''&lt;br /&gt;
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'''&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;VirtualHost *:80&amp;gt;&lt;br /&gt;
    ServerName usuarios.local.siu&lt;br /&gt;
    Redirect permanent / https://usuarios.local.siu/&lt;br /&gt;
&amp;lt;/VirtualHost&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;VirtualHost *:443&amp;gt;&lt;br /&gt;
&lt;br /&gt;
ServerName usuarios.local.siu&lt;br /&gt;
&lt;br /&gt;
SSLEngine on&lt;br /&gt;
SSLCertificateFile /certs/usuarios.local.siu.cert.pem&lt;br /&gt;
SSLCertificateKeyFile /certs/usuarios.local.siu.key.pem&lt;br /&gt;
&lt;br /&gt;
SSLCACertificateFile /certs/ca-chain.cert.pem&lt;br /&gt;
&lt;br /&gt;
SSLVerifyClient optional_no_ca&lt;br /&gt;
SSLVerifyDepth 2&lt;br /&gt;
SSLProtocol all -SSLv2 -SSLv3&lt;br /&gt;
SSLOptions +StdEnvVars +ExportCertData&lt;br /&gt;
BrowserMatch &amp;quot;MSIE [2-6]&amp;quot; \&lt;br /&gt;
        nokeepalive ssl-unclean-shutdown \&lt;br /&gt;
        downgrade-1.0 force-response-1.0&lt;br /&gt;
        # MSIE 7 and newer should be able to use keepalive&lt;br /&gt;
BrowserMatch &amp;quot;MSIE [17-9]&amp;quot; ssl-unclean-shutdown&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Include /usr/local/siu/usuarios/instalacion/toba.conf&lt;br /&gt;
&lt;br /&gt;
Include /usr/local/siu/usuarios/instalacion/idp.conf&lt;br /&gt;
&lt;br /&gt;
&amp;lt;/VirtualHost&amp;gt;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Luego hay que hacer que nuestra CA autofirmada sea válida en el SO y así permitir que Apache verifique los certificados de clientes:&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
sudo cp /certs/ca.cert.pem /usr/share/ca-certificates/ca_propia.crt&lt;br /&gt;
sudo vim /etc/ca-certificates.conf&lt;br /&gt;
# agregar ca_propia.crt al final del archivo&lt;br /&gt;
update-ca-certificates --fresh&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Reiniciamos Apache y todo debería funcionar, para verificar entramos en la URL definida para usuarios, en mi caso https://usuarios.local.siu/gestion&lt;br /&gt;
&lt;br /&gt;
Con todo esto funcionando el siguiente paso es agregar Usuarios a Registry y sincronizarlos. &lt;br /&gt;
Según esta instalación para agregar Usuarios al entorno hacemos&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/arai-cli registry:add --maintainer-email  jpiazza@siu.edu.ar --maintainer jpiazza http://registry.local.siu/arai-registry&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
y para sincronizarlo&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/arai-cli registry:sync&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== Arai-Huarpe ==&lt;br /&gt;
&lt;br /&gt;
Es similar a las instalaciones anteriores.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
cd /usr/local/siu&lt;br /&gt;
git clone -b master https://hub.siu.edu.ar/siu-arai/huarpe-core.git huarpe&lt;br /&gt;
cd huarpe&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Para instalar seguimos la documentación del archivo '''doc/INSTALACION_MANUAL.md'''&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
composer install --no-dev&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
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.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
cp templates/huarpe.env.dist huarpe.env&lt;br /&gt;
nano huarpe.env&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
'''huarpe.env'''&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
###### CONFIG DEL INSTALADR ######&lt;br /&gt;
#INSTALADOR_TIMEOUT=&amp;quot;360&amp;quot;&lt;br /&gt;
ENTORNO_PRODUCCION=1&lt;br /&gt;
&lt;br /&gt;
###### CONFIG DE SIU-HUARPE ######&lt;br /&gt;
HUARPE_PATH=/usr/local/siu/huarpe&lt;br /&gt;
HUARPE_URL=https://huarpe.local.siu&lt;br /&gt;
HUARPE_URL_PORT=443&lt;br /&gt;
HUARPE_SESSION_NAME=huarpe&lt;br /&gt;
HUARPE_SESSION_HANDLER=&amp;quot;native_file&amp;quot;&lt;br /&gt;
#HUARPE_MEMCACHED_HOST=127.0.0.1&lt;br /&gt;
#HUARPE_MEMCACHED_PORT=11211&lt;br /&gt;
HUARPE_CERT_FILE=/certs/huarpe-cli.cert.pem&lt;br /&gt;
HUARPE_KEY_FILE=/certs/huarpe-cli.key.pem&lt;br /&gt;
#HUARPE_TOKEN=unt0k3n-al3at0r1o-s39ur0?&lt;br /&gt;
#HUARPE_PROXY=127.0.0.1&lt;br /&gt;
HUARPE_LOG_HANDLER=&amp;quot;error_log&amp;quot;&lt;br /&gt;
HUARPE_LOG_LEVEL=&amp;quot;WARNING&amp;quot;&lt;br /&gt;
&lt;br /&gt;
###### CONFIG BRANDING ######&lt;br /&gt;
#HUARPE_PATH_LOGO=&amp;quot;/path/al/logo.png&amp;quot;&lt;br /&gt;
HUARPE_NOMBRE_INSTITUCION=&amp;quot;Institución&amp;quot;&lt;br /&gt;
&lt;br /&gt;
###### CONFIG DE SIU-ARAI: REGISTRY ######&lt;br /&gt;
ARAI_REGISTRY_URL=http://registry.local.siu/arai-registry&lt;br /&gt;
ARAI_REGISTRY_USER=user&lt;br /&gt;
ARAI_REGISTRY_PASS=pass&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Una vez editado, verificamos que la configuración sea correcta&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/instalador proyecto:verificar&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
Si no sale ninguna alerta, procedemos a instalar.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
sudo ./bin/instalador proyecto:instalar&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
En Synfony es necesario dumpear los estilos y los JS con el siguiente comando.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/console assetic:dump --no-debug --env=prod&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
Una vez instalado, modificamos los permisos de los archivos de la instalación con el comando&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
sudo ./bin/instalador permisos:simple&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Configuración apache ===&lt;br /&gt;
Lo mismo que con Registry o Usuarios, como tengo toda la plataforma instalada en un mismo servidor, debo usar el '''ServerName huarpe.local.siu'''.&lt;br /&gt;
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&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;VirtualHost *:80&amp;gt;&lt;br /&gt;
	ServerName huarpe.local.siu&lt;br /&gt;
	Redirect permanent / https://huarpe.local.siu:443/&lt;br /&gt;
&amp;lt;/VirtualHost&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;VirtualHost *:443&amp;gt;&lt;br /&gt;
&lt;br /&gt;
ServerName huarpe.local.siu&lt;br /&gt;
SSLEngine on&lt;br /&gt;
SSLCertificateFile /certs/huarpe.local.siu.cert.pem&lt;br /&gt;
SSLCertificateKeyFile /certs/huarpe.local.siu.key.pem&lt;br /&gt;
&lt;br /&gt;
Include /usr/local/siu/huarpe/app/config/alias.conf&lt;br /&gt;
&lt;br /&gt;
&amp;lt;/VirtualHost&amp;gt;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Reiniciamos apache, antes de verificar la instalación, debemos sincronizar con Registry.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/arai-cli registry:add --maintainer-email  jpiazza@siu.edu.ar --maintainer jpiazza http://registry.local.siu/arai-registry&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
Luego sincronizar&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/arai-cli registry:sync&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Hay que limpiar la cache y actualizar los permisos&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/console cache:clear --env=prod&lt;br /&gt;
sudo ./bin/instalador permisos:simple &lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
En Usuarios resincronizar para que se actualice con la nueva instalación&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
cd /usr/local/siu/usuarios&lt;br /&gt;
./bin/arai-cli registry:sync&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Para verificar que la instalación se realizo con éxito de debe ingresar en https://huarpe.local.siu/&lt;br /&gt;
&lt;br /&gt;
Si todo salio bien, tenemos instalada la plataforma ARAI lista para ser usada en nuestro servidor.&lt;/div&gt;</summary>
		<author><name>Ablanco</name></author>	</entry>

	<entry>
		<id>https://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Arai/arai2ejemplo&amp;diff=40691</id>
		<title>SIU-Arai/arai2ejemplo</title>
		<link rel="alternate" type="text/html" href="https://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Arai/arai2ejemplo&amp;diff=40691"/>
				<updated>2018-04-16T17:39:19Z</updated>
		
		<summary type="html">&lt;p&gt;Ablanco: Página creada con «link=SIU-Arai  = Ejemplo paso a paso = &amp;lt;blockquote&amp;gt;Nota: esta guía esta realizada con la versión anterior a la 2.0.0 de la plataforma...»&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;[[Archivo:siu-arai_iso.png|derecha|link=SIU-Arai]]&lt;br /&gt;
&lt;br /&gt;
= Ejemplo paso a paso =&lt;br /&gt;
&amp;lt;blockquote&amp;gt;Nota: esta guía esta realizada con la versión anterior a la 2.0.0 de la plataforma SIU-Araí. &amp;lt;/blockquote&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Para este caso voy a usar una instalación de Debian Jessie&lt;br /&gt;
&lt;br /&gt;
El objetivo es tener una instalación funcionando de la paltaforma SIU-Arai que luego sirva para integrar otros sistemas toba.&lt;br /&gt;
&lt;br /&gt;
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í&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable zebra&amp;quot;&lt;br /&gt;
! colspan=&amp;quot;2&amp;quot; |URLs&lt;br /&gt;
|-&lt;br /&gt;
|Araí-Registry&lt;br /&gt;
|http://registry.local.siu&lt;br /&gt;
|-&lt;br /&gt;
|Araí-Usuarios&lt;br /&gt;
|https://usuarios.local.siu&lt;br /&gt;
|-&lt;br /&gt;
|Araí-Huarpe&lt;br /&gt;
|https://huarpe.local.siu&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
== Creación de certificados ==&lt;br /&gt;
Hay que tener en cuenta que voy a usar conexión segura, por lo que tanto voy a necesitar certificados.&lt;br /&gt;
Para crear los certificados uso el tutorial que se encuentra en http://documentacion.siu.edu.ar/wiki/SIU-Arai/certificados. &lt;br /&gt;
Ese artículo asume &lt;br /&gt;
* Docker instalado (https://docs.docker.com/engine/installation/linux/docker-ce/debian/#install-using-the-repository). &lt;br /&gt;
* Docker Compose instalado (https://github.com/docker/compose/releases). &lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
git clone https://hub.siu.edu.ar/siu/instaladores.git dockerCerts&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Editamos el archivo docker-compose según nuestras necesidades.&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
cd dockerCerts/certs&lt;br /&gt;
nano docker-compose.yml&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
En mi caso quedo así:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt; &lt;br /&gt;
certificados:&lt;br /&gt;
  image: siutoba/docker-certs&lt;br /&gt;
  container_name: docker-certs&lt;br /&gt;
  #env_file: docker.env&lt;br /&gt;
  environment:&lt;br /&gt;
    DOCKER_NAME: certs&lt;br /&gt;
    CA_PWD: pass&lt;br /&gt;
    CA_INT_PWD: pass&lt;br /&gt;
    LISTA_SERVER: huarpe.local.siu usuarios.local.siu&lt;br /&gt;
    LISTA_CLIENTES: usuarios-cli huarpe-cli&lt;br /&gt;
  volumes:&lt;br /&gt;
    - ./data/certificados:/CAs/intermediate&lt;br /&gt;
    - ./data/root:/CAs/rootCA&lt;br /&gt;
&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Guardamos y generamos el container.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
docker-compose up&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Una vez generado el container copiamos los certificados creados en la carpeta que nos sea mas cómodo, en mi caso /certs&lt;br /&gt;
Sin cambiar de directorio hacemos:&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
sudo mkdir /certs&lt;br /&gt;
sudo find data -name &amp;quot;*.pem&amp;quot; -exec cp {} /certs \;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Luego generamos los certificados para el IDP:&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
mkdir /certs/idp&lt;br /&gt;
cd /certs/idp&lt;br /&gt;
openssl req -newkey rsa:2048 -new -x509 -days 3652 -nodes -out certificado_idp.crt -keyout certificado_idp.pem&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Listo, con las URL definidas y los certificados creados se puede proceder a instalar la plataforma.&lt;br /&gt;
&lt;br /&gt;
== Instalación Arai-Registy ==&lt;br /&gt;
Creamos la carpeta '''/usr/local/siu''' y no posicionamos ahí&lt;br /&gt;
Clonamos el proyecto &lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
git clone -b master https://hub.siu.edu.ar/siu-arai/arai-registry.git registry&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
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.&lt;br /&gt;
&lt;br /&gt;
Dentro del directorio del proyecto encontramos el archivo &amp;quot;doc/INSTALACION MANUAL.md&amp;quot;, la idea es seguir las instrucciones que encontramos en este archivo.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
cd registry&lt;br /&gt;
composer install --no-dev&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
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.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
cp templates/arai-registry.env.dist arai-registry.env&lt;br /&gt;
nano arai-registry.env&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
'''arai-registry.env'''&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
# config de la aplicacion&lt;br /&gt;
ARAI_REGISTRY_ALIAS=&amp;quot;/arai-registry&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_USER=&amp;quot;user&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_PASS=&amp;quot;pass&amp;quot;&lt;br /&gt;
&lt;br /&gt;
# config de la base de datos&lt;br /&gt;
ARAI_REGISTRY_DB_HOST=&amp;quot;172.27.31.114&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_DB_PORT=&amp;quot;7432&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_DB_DBNAME=&amp;quot;siu_registry&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_DB_USERNAME=&amp;quot;postgres&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_DB_PASSWORD=&amp;quot;postgres&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_DB_SCHEMA=&amp;quot;registry&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_DB_ENCODING=&amp;quot;UTF8&amp;quot;&lt;br /&gt;
&lt;br /&gt;
###### CONFIG DE LOGS ######&lt;br /&gt;
ARAI_REGISTRY_LOG_HANDLER=&amp;quot;errorlog&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_LOG_LEVEL=&amp;quot;WARNING&amp;quot;&lt;br /&gt;
&lt;br /&gt;
# config del instalador&lt;br /&gt;
INSTALADOR_TIMEOUT=&amp;quot;360&amp;quot;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Una vez editado, verificamos que la configuración sea correcta&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
sudo ./bin/instalador proyecto:verificar&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Si no sale ninguna alerta, procedemos a instalar.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/instalador proyecto:instalar&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
Una vez instalado, modificamos los permisos de los archivos de la instalación con el comando&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
sudo ./bin/instalador permisos:simple&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Luego configuramos apache.&lt;br /&gt;
En mi caso, como tengo toda la plataforma instalada en un mismo servidor, debo usar el '''ServerName &amp;quot;registry.local.siu&amp;quot;'''&lt;br /&gt;
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'''&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;VirtualHost *:80&amp;gt;&lt;br /&gt;
ServerName registry.local.siu&lt;br /&gt;
Include /usr/local/siu/registry/config/alias.conf&lt;br /&gt;
&amp;lt;/VirtualHost&amp;gt;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Con todo esto, para verificar que todo funcione reiniciamos Apache y ejecutamos&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
curl --user user:pass http://registry.local.siu/arai-registry/rest/packages/1&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Si la salida es:&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
{&lt;br /&gt;
    &amp;quot;error&amp;quot;: 404,&lt;br /&gt;
    &amp;quot;mensaje&amp;quot;: &amp;quot;404 Not Found&amp;quot;,&lt;br /&gt;
    &amp;quot;descripcion&amp;quot;: &amp;quot;El paquete solicitado no existe&amp;quot;&lt;br /&gt;
}&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
es que la instalación funcionó correctamente.&lt;br /&gt;
&lt;br /&gt;
Con registry instalado procedemos a instalar Usuarios&lt;br /&gt;
&lt;br /&gt;
==Arai-Usuarios==&lt;br /&gt;
&lt;br /&gt;
Nos posicionamos en /usr/local/siu y clonamos el proyecto&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
cd /usr/local/siu&lt;br /&gt;
git clone -b master https://hub.siu.edu.ar/siu-arai/arai-usuarios.git usuarios&lt;br /&gt;
cd usuarios&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Para instalar seguimos la documentación del archivo '''doc/INSTALACION_MANUAL.md'''&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
composer install --no-dev&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
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.&lt;br /&gt;
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.&lt;br /&gt;
La variable TOBA_USUARIO debe contener el mismo usuarios administrado del LDAP.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
cp templates/arai-usuarios.env.dist arai-usuarios.env&lt;br /&gt;
nano arai-usuarios.env&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
'''arai-usuarios.env.dist'''&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
###### CONFIG DEL INSTALADR ######&lt;br /&gt;
#INSTALADOR_TIMEOUT=&amp;quot;360&amp;quot;&lt;br /&gt;
ENTORNO_PRODUCCION=&amp;quot;1&amp;quot;&lt;br /&gt;
&lt;br /&gt;
###### VARIABLES GLOBALES DEL ARCHIVO ######&lt;br /&gt;
ARAI_USUARIOS_DIR=/usr/local/siu/usuarios&lt;br /&gt;
&lt;br /&gt;
###### CONFIG DE TOBA ######&lt;br /&gt;
TOBA_URL_BASE=&amp;quot;https://usuarios.local.siu&amp;quot;&lt;br /&gt;
#TOBA_URL_PORT=&amp;quot;443&amp;quot;&lt;br /&gt;
TOBA_USUARIO=&amp;quot;admin&amp;quot;&lt;br /&gt;
TOBA_PASSWORD=&amp;quot;admin1234&amp;quot;&lt;br /&gt;
TOBA_INSTALACION_DIR=&amp;quot;${ARAI_USUARIOS_DIR}/instalacion&amp;quot;&lt;br /&gt;
TOBA_PROYECTO_DIR=&amp;quot;${ARAI_USUARIOS_DIR}/gestion&amp;quot;&lt;br /&gt;
TOBA_INSTALAR_USUARIOS=false&lt;br /&gt;
TOBA_INSTALAR_EDITOR=false&lt;br /&gt;
TOBA_INSTALAR_REFERENCIA=false&lt;br /&gt;
TOBA_ALIAS_PROYECTO=&amp;quot;/gestion&amp;quot;&lt;br /&gt;
TOBA_ALIAS_NUCLEO=&amp;quot;/toba_gestion&amp;quot;&lt;br /&gt;
#TOBA_ID_DESARROLLADOR=0&lt;br /&gt;
#TOBA_SESSION_NAME=&amp;quot;ARAI_SESSID&amp;quot;&lt;br /&gt;
&lt;br /&gt;
###### CONFIG DE BASE DE DATOS DE NEGOCIO ######&lt;br /&gt;
PROYECTO_DB_HOST=&amp;quot;172.27.31.114&amp;quot;&lt;br /&gt;
PROYECTO_DB_PORT=&amp;quot;7432&amp;quot;&lt;br /&gt;
PROYECTO_DB_DBNAME=&amp;quot;siu_usuarios&amp;quot;&lt;br /&gt;
PROYECTO_DB_USERNAME=&amp;quot;postgres&amp;quot;&lt;br /&gt;
PROYECTO_DB_PASSWORD=&amp;quot;postgres&amp;quot;&lt;br /&gt;
PROYECTO_DB_SCHEMA=&amp;quot;usuarios&amp;quot;&lt;br /&gt;
PROYECTO_DB_ENCODING=&amp;quot;LATIN1&amp;quot;&lt;br /&gt;
&lt;br /&gt;
###### CONFIG DE BASE DE DATOS DE TOBA. #####&lt;br /&gt;
######## DEFINIR SI SE QUIERE UTILIZAR UNA BASE DISTINTA A LA DE NEGOCIO&lt;br /&gt;
#TOBA_DB_HOST=&amp;quot;localhost&amp;quot;&lt;br /&gt;
#TOBA_DB_PORT=&amp;quot;5432&amp;quot;&lt;br /&gt;
#TOBA_DB_DBNAME=&amp;quot;instalador&amp;quot;&lt;br /&gt;
#TOBA_DB_USERNAME=&amp;quot;postgres&amp;quot;&lt;br /&gt;
#TOBA_DB_PASSWORD=&amp;quot;postgres&amp;quot;&lt;br /&gt;
#TOBA_DB_SCHEMA=&amp;quot;public&amp;quot;&lt;br /&gt;
&lt;br /&gt;
##### CONFIG IDM #####&lt;br /&gt;
ARAI_USUARIOS_URL_IDP=https://usuarios.local.siu/idp&lt;br /&gt;
## Deberá setearse si el sistema corre detrás de un proxy reverso&lt;br /&gt;
#ARAI_USUARIOS_PROXY_URL_IDP=http://url.arai-usuarios:80/idp&lt;br /&gt;
ARAI_USUARIOS_URL_PORTAL=https://huarpe.local.siu/portal&lt;br /&gt;
ARAI_USUARIOS_URL_PERFIL=https://huarpe.local.siu/perfil&lt;br /&gt;
ARAI_USUARIOS_URL_INSTITUCION=http://siu.edu.ar&lt;br /&gt;
&lt;br /&gt;
ARAI_USUARIOS_SIGLA_INSTITUCION=SIGLA&lt;br /&gt;
ARAI_USUARIOS_EMAIL_SOPORTE=mail.soporte@institucion.edu.ar&lt;br /&gt;
&lt;br /&gt;
##### CONFIG SEGURIDAD ####&lt;br /&gt;
SEGURIDAD_ALGORITMO_PASS=crypt&lt;br /&gt;
SEGURIDAD_LARGO_PASS=8&lt;br /&gt;
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'&lt;br /&gt;
SEGURIDAD_DURACION_DIAS_PASS=120&lt;br /&gt;
SEGURIDAD_RECAPTCHA_SITIO=6Fd_pQwTAAAAAOEqJz6KJmkjsrXcdXrAjWQYggZf&lt;br /&gt;
SEGURIDAD_RECAPTCHA_CLAVE=6Fd_pQwTAAAAAOEqJz6KJmkjsrXcdXrAjWQYggZf&lt;br /&gt;
SEGURIDAD_INTENTOS_RECAPTCHA=3&lt;br /&gt;
&lt;br /&gt;
##### CONFIG IDP #####&lt;br /&gt;
ARAI_USUARIOS_IDP_KEY_FILE=/certs/idp/certificado_idp.pem&lt;br /&gt;
ARAI_USUARIOS_IDP_CERT_FILE=/certs/idp/certificado_idp.crt&lt;br /&gt;
#ARAI_USUARIOS_IDP_LOG_LEVEL='WARNING'&lt;br /&gt;
#ARAI_USUARIOS_IDP_LOG_HANDLER='errorlog'&lt;br /&gt;
&lt;br /&gt;
##### CONFIG MAIL RECOVERY ####&lt;br /&gt;
MAIL_RECOVERY_SUBJECT='Recuperar contraseña SIU-Arai'&lt;br /&gt;
MAIL_RECOVERY_FROM='noreply@institucion.edu.ar'&lt;br /&gt;
MAIL_RECOVERY_REPLYTO='noreply@institucion.edu.ar'&lt;br /&gt;
MAIL_RECOVERY_FROMNAME='Institución'&lt;br /&gt;
&lt;br /&gt;
##### CONFIG LDAP #####&lt;br /&gt;
ARAI_USUARIOS_LDAP_HOST=172.27.31.114&lt;br /&gt;
ARAI_USUARIOS_LDAP_PORT=7389&lt;br /&gt;
ARAI_USUARIOS_LDAP_TLS=0&lt;br /&gt;
ARAI_USUARIOS_LDAP_METHOD=user&lt;br /&gt;
ARAI_USUARIOS_LDAP_BINDUSER=&amp;quot;cn=admin,dc=siu,dc=cin,dc=edu&amp;quot;&lt;br /&gt;
ARAI_USUARIOS_LDAP_BINDPASS=admin&lt;br /&gt;
ARAI_USUARIOS_LDAP_SEARCHBASE=&amp;quot;dc=siu,dc=cin,dc=edu&amp;quot;&lt;br /&gt;
&lt;br /&gt;
##### CONFIG ARAI-REGISTRY #####&lt;br /&gt;
ARAI_REGISTRY_URL=http://registry.local.siu/arai-registry&lt;br /&gt;
ARAI_REGISTRY_USER=user&lt;br /&gt;
ARAI_REGISTRY_PASS=pass&lt;br /&gt;
&lt;br /&gt;
###### CONFIG ENVIO MAILS (SMTP) ######&lt;br /&gt;
SMTP_ENTRADA=&amp;quot;arai-usuarios&amp;quot;&lt;br /&gt;
SMTP_HELO=&amp;quot;mail.unx.edu.ar&amp;quot;&lt;br /&gt;
SMTP_HOST=&amp;quot;smtp.googlemail.com&amp;quot;&lt;br /&gt;
SMTP_PORT=587&lt;br /&gt;
SMTP_FROM =&amp;quot;yo@midominio.com&amp;quot;&lt;br /&gt;
SMTP_SEGURIDAD =&amp;quot;ssl|tls&amp;quot;&lt;br /&gt;
SMTP_AUTH =&amp;quot;1&amp;quot;&lt;br /&gt;
SMTP_USUARIO =&amp;quot;usuario&amp;quot;&lt;br /&gt;
SMTP_CLAVE =&amp;quot;pass&amp;quot;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Una vez editado, verificamos que la configuración sea correcta&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/instalador proyecto:verificar -n&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Si no sale ninguna alerta, procedemos a instalar.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/instalador proyecto:instalar&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
Una vez instalado, modificamos los permisos de los archivos de la instalación con el comando&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
sudo ./bin/instalador permisos:simple&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
Cambiamos el modo mantenimiento&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/instalador instalacion:modo-mantenimiento --sin-mantenimiento -n&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Luego configuramos Apache.&lt;br /&gt;
Lo mismo que con registry, como tengo toda la plataforma instalada en un mismo servidor, debo usar el '''ServerName &amp;quot;usuarios.local.siu&amp;quot;'''&lt;br /&gt;
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'''&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;VirtualHost *:80&amp;gt;&lt;br /&gt;
    ServerName usuarios.local.siu&lt;br /&gt;
    Redirect permanent / https://usuarios.local.siu/&lt;br /&gt;
&amp;lt;/VirtualHost&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;VirtualHost *:443&amp;gt;&lt;br /&gt;
&lt;br /&gt;
ServerName usuarios.local.siu&lt;br /&gt;
&lt;br /&gt;
SSLEngine on&lt;br /&gt;
SSLCertificateFile /certs/usuarios.local.siu.cert.pem&lt;br /&gt;
SSLCertificateKeyFile /certs/usuarios.local.siu.key.pem&lt;br /&gt;
&lt;br /&gt;
SSLCACertificateFile /certs/ca-chain.cert.pem&lt;br /&gt;
&lt;br /&gt;
SSLVerifyClient optional_no_ca&lt;br /&gt;
SSLVerifyDepth 2&lt;br /&gt;
SSLProtocol all -SSLv2 -SSLv3&lt;br /&gt;
SSLOptions +StdEnvVars +ExportCertData&lt;br /&gt;
BrowserMatch &amp;quot;MSIE [2-6]&amp;quot; \&lt;br /&gt;
        nokeepalive ssl-unclean-shutdown \&lt;br /&gt;
        downgrade-1.0 force-response-1.0&lt;br /&gt;
        # MSIE 7 and newer should be able to use keepalive&lt;br /&gt;
BrowserMatch &amp;quot;MSIE [17-9]&amp;quot; ssl-unclean-shutdown&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Include /usr/local/siu/usuarios/instalacion/toba.conf&lt;br /&gt;
&lt;br /&gt;
Include /usr/local/siu/usuarios/instalacion/idp.conf&lt;br /&gt;
&lt;br /&gt;
&amp;lt;/VirtualHost&amp;gt;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Luego hay que hacer que nuestra CA autofirmada sea válida en el SO y así permitir que Apache verifique los certificados de clientes:&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
sudo cp /certs/ca.cert.pem /usr/share/ca-certificates/ca_propia.crt&lt;br /&gt;
sudo vim /etc/ca-certificates.conf&lt;br /&gt;
# agregar ca_propia.crt al final del archivo&lt;br /&gt;
update-ca-certificates --fresh&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Reiniciamos Apache y todo debería funcionar, para verificar entramos en la URL definida para usuarios, en mi caso https://usuarios.local.siu/gestion&lt;br /&gt;
&lt;br /&gt;
Con todo esto funcionando el siguiente paso es agregar Usuarios a Registry y sincronizarlos. &lt;br /&gt;
Según esta instalación para agregar Usuarios al entorno hacemos&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/arai-cli registry:add --maintainer-email  jpiazza@siu.edu.ar --maintainer jpiazza http://registry.local.siu/arai-registry&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
y para sincronizarlo&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/arai-cli registry:sync&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== Arai-Huarpe ==&lt;br /&gt;
&lt;br /&gt;
Es similar a las instalaciones anteriores.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
cd /usr/local/siu&lt;br /&gt;
git clone -b master https://hub.siu.edu.ar/siu-arai/huarpe-core.git huarpe&lt;br /&gt;
cd huarpe&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Para instalar seguimos la documentación del archivo '''doc/INSTALACION_MANUAL.md'''&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
composer install --no-dev&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
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.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
cp templates/huarpe.env.dist huarpe.env&lt;br /&gt;
nano huarpe.env&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
'''huarpe.env'''&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
###### CONFIG DEL INSTALADR ######&lt;br /&gt;
#INSTALADOR_TIMEOUT=&amp;quot;360&amp;quot;&lt;br /&gt;
ENTORNO_PRODUCCION=1&lt;br /&gt;
&lt;br /&gt;
###### CONFIG DE SIU-HUARPE ######&lt;br /&gt;
HUARPE_PATH=/usr/local/siu/huarpe&lt;br /&gt;
HUARPE_URL=https://huarpe.local.siu&lt;br /&gt;
HUARPE_URL_PORT=443&lt;br /&gt;
HUARPE_SESSION_NAME=huarpe&lt;br /&gt;
HUARPE_SESSION_HANDLER=&amp;quot;native_file&amp;quot;&lt;br /&gt;
#HUARPE_MEMCACHED_HOST=127.0.0.1&lt;br /&gt;
#HUARPE_MEMCACHED_PORT=11211&lt;br /&gt;
HUARPE_CERT_FILE=/certs/huarpe-cli.cert.pem&lt;br /&gt;
HUARPE_KEY_FILE=/certs/huarpe-cli.key.pem&lt;br /&gt;
#HUARPE_TOKEN=unt0k3n-al3at0r1o-s39ur0?&lt;br /&gt;
#HUARPE_PROXY=127.0.0.1&lt;br /&gt;
HUARPE_LOG_HANDLER=&amp;quot;error_log&amp;quot;&lt;br /&gt;
HUARPE_LOG_LEVEL=&amp;quot;WARNING&amp;quot;&lt;br /&gt;
&lt;br /&gt;
###### CONFIG BRANDING ######&lt;br /&gt;
#HUARPE_PATH_LOGO=&amp;quot;/path/al/logo.png&amp;quot;&lt;br /&gt;
HUARPE_NOMBRE_INSTITUCION=&amp;quot;Institución&amp;quot;&lt;br /&gt;
&lt;br /&gt;
###### CONFIG DE SIU-ARAI: REGISTRY ######&lt;br /&gt;
ARAI_REGISTRY_URL=http://registry.local.siu/arai-registry&lt;br /&gt;
ARAI_REGISTRY_USER=user&lt;br /&gt;
ARAI_REGISTRY_PASS=pass&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Una vez editado, verificamos que la configuración sea correcta&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/instalador proyecto:verificar&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
Si no sale ninguna alerta, procedemos a instalar.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
sudo ./bin/instalador proyecto:instalar&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
En Synfony es necesario dumpear los estilos y los JS con el siguiente comando.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/console assetic:dump --no-debug --env=prod&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
Una vez instalado, modificamos los permisos de los archivos de la instalación con el comando&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
sudo ./bin/instalador permisos:simple&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Configuración apache ===&lt;br /&gt;
Lo mismo que con Registry o Usuarios, como tengo toda la plataforma instalada en un mismo servidor, debo usar el '''ServerName huarpe.local.siu'''.&lt;br /&gt;
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&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;VirtualHost *:80&amp;gt;&lt;br /&gt;
	ServerName huarpe.local.siu&lt;br /&gt;
	Redirect permanent / https://huarpe.local.siu:443/&lt;br /&gt;
&amp;lt;/VirtualHost&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;VirtualHost *:443&amp;gt;&lt;br /&gt;
&lt;br /&gt;
ServerName huarpe.local.siu&lt;br /&gt;
SSLEngine on&lt;br /&gt;
SSLCertificateFile /certs/huarpe.local.siu.cert.pem&lt;br /&gt;
SSLCertificateKeyFile /certs/huarpe.local.siu.key.pem&lt;br /&gt;
&lt;br /&gt;
Include /usr/local/siu/huarpe/app/config/alias.conf&lt;br /&gt;
&lt;br /&gt;
&amp;lt;/VirtualHost&amp;gt;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Reiniciamos apache, antes de verificar la instalación, debemos sincronizar con Registry.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/arai-cli registry:add --maintainer-email  jpiazza@siu.edu.ar --maintainer jpiazza http://registry.local.siu/arai-registry&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
Luego sincronizar&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/arai-cli registry:sync&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Hay que limpiar la cache y actualizar los permisos&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/console cache:clear --env=prod&lt;br /&gt;
sudo ./bin/instalador permisos:simple &lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
En Usuarios resincronizar para que se actualice con la nueva instalación&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
cd /usr/local/siu/usuarios&lt;br /&gt;
./bin/arai-cli registry:sync&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Para verificar que la instalación se realizo con éxito de debe ingresar en https://huarpe.local.siu/&lt;br /&gt;
&lt;br /&gt;
Si todo salio bien, tenemos instalada la plataforma ARAI lista para ser usada en nuestro servidor.&lt;/div&gt;</summary>
		<author><name>Ablanco</name></author>	</entry>

	<entry>
		<id>https://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Arai/ejemploPasoAPaso&amp;diff=28934</id>
		<title>SIU-Arai/ejemploPasoAPaso</title>
		<link rel="alternate" type="text/html" href="https://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Arai/ejemploPasoAPaso&amp;diff=28934"/>
				<updated>2017-08-31T20:31:58Z</updated>
		
		<summary type="html">&lt;p&gt;Ablanco: /* Arai-Huarpe */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;[[Archivo:siu-arai_iso.png|derecha|link=SIU-Arai]]&lt;br /&gt;
&lt;br /&gt;
= Ejemplo paso a paso =&lt;br /&gt;
&lt;br /&gt;
Para este caso voy a usar una instalación de Debian Jessie&lt;br /&gt;
&lt;br /&gt;
El objetivo es tener una instalación funcionando de la paltaforma SIU-Arai que luego sirva para integrar otros sistemas toba.&lt;br /&gt;
&lt;br /&gt;
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í&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable zebra&amp;quot;&lt;br /&gt;
!colspan=&amp;quot;2&amp;quot;|URLs&lt;br /&gt;
|-&lt;br /&gt;
|Araí-Registry&lt;br /&gt;
|http://registry.local.siu&lt;br /&gt;
|-&lt;br /&gt;
|Araí-Usuarios&lt;br /&gt;
|https://usuarios.local.siu&lt;br /&gt;
|-&lt;br /&gt;
|Araí-Huarpe&lt;br /&gt;
|https://huarpe.local.siu&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
== Creación de certificados ==&lt;br /&gt;
Hay que tener en cuenta que voy a usar conexión segura, por lo que tanto voy a necesitar certificados.&lt;br /&gt;
Para crear los certificados uso el tutorial que se encuentra en http://documentacion.siu.edu.ar/wiki/SIU-Arai/certificados. &lt;br /&gt;
Ese artículo asume &lt;br /&gt;
* Docker instalado (https://docs.docker.com/engine/installation/linux/docker-ce/debian/#install-using-the-repository). &lt;br /&gt;
* Docker Compose instalado (https://github.com/docker/compose/releases). &lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
git clone https://hub.siu.edu.ar/siu/instaladores.git dockerCerts&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Editamos el archivo docker-compose según nuestras necesidades.&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
cd dockerCerts/certs&lt;br /&gt;
nano docker-compose.yml&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
En mi caso quedo así:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt; &lt;br /&gt;
certificados:&lt;br /&gt;
  image: siutoba/docker-certs&lt;br /&gt;
  container_name: docker-certs&lt;br /&gt;
  #env_file: docker.env&lt;br /&gt;
  environment:&lt;br /&gt;
    DOCKER_NAME: certs&lt;br /&gt;
    CA_PWD: pass&lt;br /&gt;
    CA_INT_PWD: pass&lt;br /&gt;
    LISTA_SERVER: huarpe.local.siu usuarios.local.siu&lt;br /&gt;
    LISTA_CLIENTES: usuarios-cli huarpe-cli&lt;br /&gt;
  volumes:&lt;br /&gt;
    - ./data/certificados:/CAs/intermediate&lt;br /&gt;
    - ./data/root:/CAs/rootCA&lt;br /&gt;
&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Guardamos y generamos el container.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
docker-compose up&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Una vez generado el container copiamos los certificados creados en la carpeta que nos sea mas cómodo, en mi caso /certs&lt;br /&gt;
Sin cambiar de directorio hacemos:&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
sudo mkdir /certs&lt;br /&gt;
sudo find data -name &amp;quot;*.pem&amp;quot; -exec cp {} /certs \;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Luego generamos los certificados para el IDP:&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
mkdir /certs/idp&lt;br /&gt;
cd /certs/idp&lt;br /&gt;
openssl req -newkey rsa:2048 -new -x509 -days 3652 -nodes -out certificado_idp.crt -keyout certificado_idp.pem&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Listo, con las URL definidas y los certificados creados se puede proceder a instalar la plataforma.&lt;br /&gt;
&lt;br /&gt;
== Instalación Arai-Registy ==&lt;br /&gt;
Creamos la carpeta '''/usr/local/siu''' y no posicionamos ahí&lt;br /&gt;
Clonamos el proyecto &lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
git clone --branch v1.1.0 https://hub.siu.edu.ar/siu-arai/arai-registry.git registry&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
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.&lt;br /&gt;
&lt;br /&gt;
Dentro del directorio del proyecto encontramos el archivo &amp;quot;doc/INSTALACION MANUAL.md&amp;quot;, la idea es seguir las instrucciones que encontramos en este archivo.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
cd registry&lt;br /&gt;
composer install --no-dev&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
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.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
cp templates/arai-registry.env.dist arai-registry.env&lt;br /&gt;
nano arai-registry.env&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
'''arai-registry.env'''&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
# config de la aplicacion&lt;br /&gt;
ARAI_REGISTRY_ALIAS=&amp;quot;/arai-registry&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_USER=&amp;quot;user&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_PASS=&amp;quot;pass&amp;quot;&lt;br /&gt;
&lt;br /&gt;
# config de la base de datos&lt;br /&gt;
ARAI_REGISTRY_DB_HOST=&amp;quot;172.27.31.114&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_DB_PORT=&amp;quot;7432&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_DB_DBNAME=&amp;quot;siu_registry&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_DB_USERNAME=&amp;quot;postgres&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_DB_PASSWORD=&amp;quot;postgres&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_DB_SCHEMA=&amp;quot;registry&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_DB_ENCODING=&amp;quot;UTF8&amp;quot;&lt;br /&gt;
&lt;br /&gt;
###### CONFIG DE LOGS ######&lt;br /&gt;
ARAI_REGISTRY_LOG_HANDLER=&amp;quot;errorlog&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_LOG_LEVEL=&amp;quot;WARNING&amp;quot;&lt;br /&gt;
&lt;br /&gt;
# config del instalador&lt;br /&gt;
INSTALADOR_TIMEOUT=&amp;quot;360&amp;quot;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Una vez editado, verificamos que la configuración sea correcta&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
sudo ./bin/instalador proyecto:verificar&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Si no sale ninguna alerta, procedemos a instalar.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/instalador proyecto:instalar&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
Una vez instalado, modificamos los permisos de los archivos de la instalación con el comando&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
sudo ./bin/instalador permisos:simple&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Luego configuramos apache.&lt;br /&gt;
En mi caso, como tengo toda la plataforma instalada en un mismo servidor, debo usar el '''ServerName &amp;quot;registry.local.siu&amp;quot;'''&lt;br /&gt;
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'''&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;VirtualHost *:80&amp;gt;&lt;br /&gt;
ServerName registry.local.siu&lt;br /&gt;
Include /usr/local/siu/registry/config/alias.conf&lt;br /&gt;
&amp;lt;/VirtualHost&amp;gt;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Con todo esto, para verificar que todo funcione reiniciamos Apache y ejecutamos&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
curl --user registry:registry http://registry.local.siu/arai-registry/rest/packages/1&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Si la salida es:&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
{&lt;br /&gt;
    &amp;quot;error&amp;quot;: 404,&lt;br /&gt;
    &amp;quot;mensaje&amp;quot;: &amp;quot;404 Not Found&amp;quot;,&lt;br /&gt;
    &amp;quot;descripcion&amp;quot;: &amp;quot;El paquete solicitado no existe&amp;quot;&lt;br /&gt;
}&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
es que la instalación funcionó correctamente.&lt;br /&gt;
&lt;br /&gt;
Con registry instalado procedemos a instalar Usuarios&lt;br /&gt;
&lt;br /&gt;
==Arai-Usuarios==&lt;br /&gt;
&lt;br /&gt;
Nos posicionamos en /usr/local/siu y clonamos el proyecto&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
cd /usr/local/siu&lt;br /&gt;
git clone --branch v1.2.0 https://hub.siu.edu.ar/siu-arai/arai-usuarios.git usuarios&lt;br /&gt;
cd usuarios&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Para instalar seguimos la documentación del archivo '''doc/INSTALACION_MANUAL.md'''&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
composer install --no-dev&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
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.&lt;br /&gt;
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.&lt;br /&gt;
La variable TOBA_USUARIO debe contener el mismo usuarios administrado del LDAP.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
cp templates/arai-usuarios.env.dist arai-usuarios.env&lt;br /&gt;
nano arai-usuarios.env&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
'''arai-usuarios.env.dist'''&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
###### CONFIG DEL INSTALADR ######&lt;br /&gt;
#INSTALADOR_TIMEOUT=&amp;quot;360&amp;quot;&lt;br /&gt;
ENTORNO_PRODUCCION=&amp;quot;1&amp;quot;&lt;br /&gt;
&lt;br /&gt;
###### VARIABLES GLOBALES DEL ARCHIVO ######&lt;br /&gt;
ARAI_USUARIOS_DIR=/usr/local/siu/usuarios&lt;br /&gt;
&lt;br /&gt;
###### CONFIG DE TOBA ######&lt;br /&gt;
TOBA_URL_BASE=&amp;quot;https://usuarios.local.siu&amp;quot;&lt;br /&gt;
#TOBA_URL_PORT=&amp;quot;443&amp;quot;&lt;br /&gt;
TOBA_USUARIO=&amp;quot;admin&amp;quot;&lt;br /&gt;
TOBA_PASSWORD=&amp;quot;admin1234&amp;quot;&lt;br /&gt;
TOBA_INSTALACION_DIR=&amp;quot;${ARAI_USUARIOS_DIR}/instalacion&amp;quot;&lt;br /&gt;
TOBA_PROYECTO_DIR=&amp;quot;${ARAI_USUARIOS_DIR}/gestion&amp;quot;&lt;br /&gt;
TOBA_INSTALAR_USUARIOS=false&lt;br /&gt;
TOBA_INSTALAR_EDITOR=false&lt;br /&gt;
TOBA_INSTALAR_REFERENCIA=false&lt;br /&gt;
TOBA_ALIAS_PROYECTO=&amp;quot;/gestion&amp;quot;&lt;br /&gt;
TOBA_ALIAS_NUCLEO=&amp;quot;/toba_gestion&amp;quot;&lt;br /&gt;
#TOBA_ID_DESARROLLADOR=0&lt;br /&gt;
#TOBA_SESSION_NAME=&amp;quot;ARAI_SESSID&amp;quot;&lt;br /&gt;
&lt;br /&gt;
###### CONFIG DE BASE DE DATOS DE NEGOCIO ######&lt;br /&gt;
PROYECTO_DB_HOST=&amp;quot;172.27.31.114&amp;quot;&lt;br /&gt;
PROYECTO_DB_PORT=&amp;quot;7432&amp;quot;&lt;br /&gt;
PROYECTO_DB_DBNAME=&amp;quot;siu_usuarios&amp;quot;&lt;br /&gt;
PROYECTO_DB_USERNAME=&amp;quot;postgres&amp;quot;&lt;br /&gt;
PROYECTO_DB_PASSWORD=&amp;quot;postgres&amp;quot;&lt;br /&gt;
PROYECTO_DB_SCHEMA=&amp;quot;usuarios&amp;quot;&lt;br /&gt;
PROYECTO_DB_ENCODING=&amp;quot;LATIN1&amp;quot;&lt;br /&gt;
&lt;br /&gt;
###### CONFIG DE BASE DE DATOS DE TOBA. #####&lt;br /&gt;
######## DEFINIR SI SE QUIERE UTILIZAR UNA BASE DISTINTA A LA DE NEGOCIO&lt;br /&gt;
#TOBA_DB_HOST=&amp;quot;localhost&amp;quot;&lt;br /&gt;
#TOBA_DB_PORT=&amp;quot;5432&amp;quot;&lt;br /&gt;
#TOBA_DB_DBNAME=&amp;quot;instalador&amp;quot;&lt;br /&gt;
#TOBA_DB_USERNAME=&amp;quot;postgres&amp;quot;&lt;br /&gt;
#TOBA_DB_PASSWORD=&amp;quot;postgres&amp;quot;&lt;br /&gt;
#TOBA_DB_SCHEMA=&amp;quot;public&amp;quot;&lt;br /&gt;
&lt;br /&gt;
##### CONFIG IDM #####&lt;br /&gt;
ARAI_USUARIOS_URL_IDP=https://usuarios.local.siu/idp&lt;br /&gt;
## Deberá setearse si el sistema corre detrás de un proxy reverso&lt;br /&gt;
#ARAI_USUARIOS_PROXY_URL_IDP=http://url.arai-usuarios:80/idp&lt;br /&gt;
ARAI_USUARIOS_URL_PORTAL=https://huarpe.local.siu/portal&lt;br /&gt;
ARAI_USUARIOS_URL_PERFIL=https://huarpe.local.siu/perfil&lt;br /&gt;
ARAI_USUARIOS_URL_INSTITUCION=http://siu.edu.ar&lt;br /&gt;
&lt;br /&gt;
ARAI_USUARIOS_SIGLA_INSTITUCION=SIGLA&lt;br /&gt;
ARAI_USUARIOS_EMAIL_SOPORTE=mail.soporte@institucion.edu.ar&lt;br /&gt;
&lt;br /&gt;
##### CONFIG SEGURIDAD ####&lt;br /&gt;
SEGURIDAD_ALGORITMO_PASS=crypt&lt;br /&gt;
SEGURIDAD_LARGO_PASS=8&lt;br /&gt;
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'&lt;br /&gt;
SEGURIDAD_DURACION_DIAS_PASS=120&lt;br /&gt;
SEGURIDAD_RECAPTCHA_SITIO=6Fd_pQwTAAAAAOEqJz6KJmkjsrXcdXrAjWQYggZf&lt;br /&gt;
SEGURIDAD_RECAPTCHA_CLAVE=6Fd_pQwTAAAAAOEqJz6KJmkjsrXcdXrAjWQYggZf&lt;br /&gt;
SEGURIDAD_INTENTOS_RECAPTCHA=3&lt;br /&gt;
&lt;br /&gt;
##### CONFIG IDP #####&lt;br /&gt;
ARAI_USUARIOS_IDP_KEY_FILE=/certs/idp/certificado_idp.pem&lt;br /&gt;
ARAI_USUARIOS_IDP_CERT_FILE=/certs/idp/certificado_idp.crt&lt;br /&gt;
#ARAI_USUARIOS_IDP_LOG_LEVEL='WARNING'&lt;br /&gt;
#ARAI_USUARIOS_IDP_LOG_HANDLER='errorlog'&lt;br /&gt;
&lt;br /&gt;
##### CONFIG MAIL RECOVERY ####&lt;br /&gt;
MAIL_RECOVERY_SUBJECT='Recuperar contraseña SIU-Arai'&lt;br /&gt;
MAIL_RECOVERY_FROM='noreply@institucion.edu.ar'&lt;br /&gt;
MAIL_RECOVERY_REPLYTO='noreply@institucion.edu.ar'&lt;br /&gt;
MAIL_RECOVERY_FROMNAME='Institución'&lt;br /&gt;
&lt;br /&gt;
##### CONFIG LDAP #####&lt;br /&gt;
ARAI_USUARIOS_LDAP_HOST=172.27.31.114&lt;br /&gt;
ARAI_USUARIOS_LDAP_PORT=7389&lt;br /&gt;
ARAI_USUARIOS_LDAP_TLS=0&lt;br /&gt;
ARAI_USUARIOS_LDAP_METHOD=user&lt;br /&gt;
ARAI_USUARIOS_LDAP_BINDUSER=&amp;quot;cn=admin,dc=siu,dc=cin,dc=edu&amp;quot;&lt;br /&gt;
ARAI_USUARIOS_LDAP_BINDPASS=admin&lt;br /&gt;
ARAI_USUARIOS_LDAP_SEARCHBASE=&amp;quot;dc=siu,dc=cin,dc=edu&amp;quot;&lt;br /&gt;
&lt;br /&gt;
##### CONFIG ARAI-REGISTRY #####&lt;br /&gt;
ARAI_REGISTRY_URL=http://registry.local.siu/arai-registry&lt;br /&gt;
ARAI_REGISTRY_USER=user&lt;br /&gt;
ARAI_REGISTRY_PASS=pass&lt;br /&gt;
&lt;br /&gt;
###### CONFIG ENVIO MAILS (SMTP) ######&lt;br /&gt;
SMTP_ENTRADA=&amp;quot;arai-usuarios&amp;quot;&lt;br /&gt;
SMTP_HELO=&amp;quot;mail.unx.edu.ar&amp;quot;&lt;br /&gt;
SMTP_HOST=&amp;quot;smtp.googlemail.com&amp;quot;&lt;br /&gt;
SMTP_PORT=587&lt;br /&gt;
SMTP_FROM =&amp;quot;yo@midominio.com&amp;quot;&lt;br /&gt;
SMTP_SEGURIDAD =&amp;quot;ssl|tls&amp;quot;&lt;br /&gt;
SMTP_AUTH =&amp;quot;1&amp;quot;&lt;br /&gt;
SMTP_USUARIO =&amp;quot;usuario&amp;quot;&lt;br /&gt;
SMTP_CLAVE =&amp;quot;pass&amp;quot;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Una vez editado, verificamos que la configuración sea correcta&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/instalador proyecto:verificar -n&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Si no sale ninguna alerta, procedemos a instalar.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/instalador proyecto:instalar&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
Una vez instalado, modificamos los permisos de los archivos de la instalación con el comando&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
sudo ./bin/instalador permisos:simple&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
Cambiamos el modo mantenimiento&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/instalador instalacion:modo-mantenimiento --sin-mantenimiento -n&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Luego configuramos Apache.&lt;br /&gt;
Lo mismo que con registry, como tengo toda la plataforma instalada en un mismo servidor, debo usar el '''ServerName &amp;quot;usuarios.local.siu&amp;quot;'''&lt;br /&gt;
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'''&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;VirtualHost *:80&amp;gt;&lt;br /&gt;
    ServerName usuarios.local.siu&lt;br /&gt;
    Redirect permanent / https://usuarios.local.siu/&lt;br /&gt;
&amp;lt;/VirtualHost&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;VirtualHost *:443&amp;gt;&lt;br /&gt;
&lt;br /&gt;
ServerName usuarios.local.siu&lt;br /&gt;
&lt;br /&gt;
SSLEngine on&lt;br /&gt;
SSLCertificateFile /certs/usuarios.local.siu.cert.pem&lt;br /&gt;
SSLCertificateKeyFile /certs/usuarios.local.siu.key.pem&lt;br /&gt;
&lt;br /&gt;
SSLCACertificateFile /certs/ca-chain.cert.pem&lt;br /&gt;
&lt;br /&gt;
SSLVerifyClient optional_no_ca&lt;br /&gt;
SSLVerifyDepth 2&lt;br /&gt;
SSLProtocol all -SSLv2 -SSLv3&lt;br /&gt;
SSLOptions +StdEnvVars +ExportCertData&lt;br /&gt;
BrowserMatch &amp;quot;MSIE [2-6]&amp;quot; \&lt;br /&gt;
        nokeepalive ssl-unclean-shutdown \&lt;br /&gt;
        downgrade-1.0 force-response-1.0&lt;br /&gt;
        # MSIE 7 and newer should be able to use keepalive&lt;br /&gt;
BrowserMatch &amp;quot;MSIE [17-9]&amp;quot; ssl-unclean-shutdown&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Include /usr/local/siu/usuarios/instalacion/toba.conf&lt;br /&gt;
&lt;br /&gt;
Include /usr/local/siu/usuarios/instalacion/idp.conf&lt;br /&gt;
&lt;br /&gt;
&amp;lt;/VirtualHost&amp;gt;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Luego hay que hacer que nuestra CA autofirmada sea válida en el SO y así permitir que Apache verifique los certificados de clientes:&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
sudo cp /certs/ca.cert.pem /usr/share/ca-certificates/ca_propia.crt&lt;br /&gt;
sudo vim /etc/ca-certificates.conf&lt;br /&gt;
# agregar ca_propia.crt al final del archivo&lt;br /&gt;
update-ca-certificates --fresh&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Reiniciamos Apache y todo debería funcionar, para verificar entramos en la URL definida para usuarios, en mi caso https://usuarios.local.siu/gestion&lt;br /&gt;
&lt;br /&gt;
Con todo esto funcionando el siguiente paso es agregar Usuarios a Registry y sincronizarlos. &lt;br /&gt;
Según esta instalación para agregar Usuarios al entorno hacemos&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/arai-cli registry:add --maintainer-email  jpiazza@siu.edu.ar --maintainer jpiazza http://registry.local.siu/arai-registry&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
y para sincronizarlo&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/arai-cli registry:sync&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== Arai-Huarpe ==&lt;br /&gt;
&lt;br /&gt;
Es similar a las instalaciones anteriores.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
cd /usr/local/siu&lt;br /&gt;
git clone --branch v1.1.0 https://hub.siu.edu.ar/siu-arai/huarpe-core.git huarpe&lt;br /&gt;
cd huarpe&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Para instalar seguimos la documentación del archivo '''doc/INSTALACION_MANUAL.md'''&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
composer install --no-dev&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
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.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
cp templates/huarpe.env.dist huarpe.env&lt;br /&gt;
nano huarpe.env&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
'''huarpe.env'''&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
###### CONFIG DEL INSTALADR ######&lt;br /&gt;
#INSTALADOR_TIMEOUT=&amp;quot;360&amp;quot;&lt;br /&gt;
ENTORNO_PRODUCCION=1&lt;br /&gt;
&lt;br /&gt;
###### CONFIG DE SIU-HUARPE ######&lt;br /&gt;
HUARPE_PATH=/usr/local/siu/huarpe&lt;br /&gt;
HUARPE_URL=https://huarpe.local.siu&lt;br /&gt;
HUARPE_URL_PORT=443&lt;br /&gt;
HUARPE_SESSION_NAME=huarpe&lt;br /&gt;
HUARPE_SESSION_HANDLER=&amp;quot;native_file&amp;quot;&lt;br /&gt;
#HUARPE_MEMCACHED_HOST=127.0.0.1&lt;br /&gt;
#HUARPE_MEMCACHED_PORT=11211&lt;br /&gt;
HUARPE_CERT_FILE=/certs/huarpe-cli.cert.pem&lt;br /&gt;
HUARPE_KEY_FILE=/certs/huarpe-cli.key.pem&lt;br /&gt;
#HUARPE_TOKEN=unt0k3n-al3at0r1o-s39ur0?&lt;br /&gt;
#HUARPE_PROXY=127.0.0.1&lt;br /&gt;
HUARPE_LOG_HANDLER=&amp;quot;error_log&amp;quot;&lt;br /&gt;
HUARPE_LOG_LEVEL=&amp;quot;WARNING&amp;quot;&lt;br /&gt;
&lt;br /&gt;
###### CONFIG DE SIU-ARAI: REGISTRY ######&lt;br /&gt;
ARAI_REGISTRY_URL=http://registry.local.siu/arai-registry&lt;br /&gt;
ARAI_REGISTRY_USER=user&lt;br /&gt;
ARAI_REGISTRY_PASS=pass&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Una vez editado, verificamos que la configuración sea correcta&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/instalador proyecto:verificar&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
Si no sale ninguna alerta, procedemos a instalar.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
sudo ./bin/instalador proyecto:instalar&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
En Synfony es necesario dumpear los estilos y los JS con el siguiente comando.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/console assetic:dump --no-debug --env=prod&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
Una vez instalado, modificamos los permisos de los archivos de la instalación con el comando&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
sudo ./bin/instalador permisos:simple&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Configuración apache ===&lt;br /&gt;
Lo mismo que con Registry o Usuarios, como tengo toda la plataforma instalada en un mismo servidor, debo usar el '''ServerName huarpe.local.siu'''.&lt;br /&gt;
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&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;VirtualHost *:80&amp;gt;&lt;br /&gt;
	ServerName huarpe.local.siu&lt;br /&gt;
	Redirect permanent / https://huarpe.local.siu:443/&lt;br /&gt;
&amp;lt;/VirtualHost&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;VirtualHost *:443&amp;gt;&lt;br /&gt;
&lt;br /&gt;
ServerName huarpe.local.siu&lt;br /&gt;
SSLEngine on&lt;br /&gt;
SSLCertificateFile /certs/huarpe.local.siu.cert.pem&lt;br /&gt;
SSLCertificateKeyFile /certs/huarpe.local.siu.key.pem&lt;br /&gt;
&lt;br /&gt;
Include /usr/local/siu/huarpe/app/config/alias.conf&lt;br /&gt;
&lt;br /&gt;
&amp;lt;/VirtualHost&amp;gt;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Reiniciamos apache, antes de verificar la instalación, debemos sincronizar con Registry.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/arai-cli registry:add --maintainer-email  jpiazza@siu.edu.ar --maintainer jpiazza http://registry.local.siu/arai-registry&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
Luego sincronizar&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/arai-cli registry:sync&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Hay que limpiar la cache y actualizar los permisos&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/console cache:clear --env=prod&lt;br /&gt;
sudo ./bin/instalador permisos:simple &lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
En Usuarios resincronizar para que se actualice con la nueva instalación&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
cd /usr/local/siu/usuarios&lt;br /&gt;
./bin/arai-cli registry:sync&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Para verificar que la instalación se realizo con éxito de debe ingresar en https://huarpe.local.siu/&lt;br /&gt;
&lt;br /&gt;
Si todo salio bien, tenemos instalada la plataforma ARAI lista para ser usada en nuestro servidor.&lt;/div&gt;</summary>
		<author><name>Ablanco</name></author>	</entry>

	<entry>
		<id>https://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Arai/ejemploPasoAPaso&amp;diff=27632</id>
		<title>SIU-Arai/ejemploPasoAPaso</title>
		<link rel="alternate" type="text/html" href="https://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Arai/ejemploPasoAPaso&amp;diff=27632"/>
				<updated>2017-08-03T14:33:45Z</updated>
		
		<summary type="html">&lt;p&gt;Ablanco: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;[[Archivo:siu-arai_iso.png|derecha|link=SIU-Arai]]&lt;br /&gt;
&lt;br /&gt;
= Ejemplo paso a paso =&lt;br /&gt;
&lt;br /&gt;
Para este caso voy a usar una instalación de Debian Jessie&lt;br /&gt;
&lt;br /&gt;
El objetivo es tener una instalación funcionando de la paltaforma SIU-Arai que luego sirva para integrar otros sistemas toba.&lt;br /&gt;
&lt;br /&gt;
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í&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable zebra&amp;quot;&lt;br /&gt;
!colspan=&amp;quot;2&amp;quot;|URLs&lt;br /&gt;
|-&lt;br /&gt;
|Araí-Registry&lt;br /&gt;
|http://registry.local.siu&lt;br /&gt;
|-&lt;br /&gt;
|Araí-Usuarios&lt;br /&gt;
|https://usuarios.local.siu&lt;br /&gt;
|-&lt;br /&gt;
|Araí-Huarpe&lt;br /&gt;
|https://huarpe.local.siu&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
== Creación de certificados ==&lt;br /&gt;
Hay que tener en cuenta que voy a usar conexión segura, por lo que tanto voy a necesitar certificados.&lt;br /&gt;
Para crear los certificados uso el tutorial que se encuentra en http://documentacion.siu.edu.ar/wiki/SIU-Arai/certificados. &lt;br /&gt;
Ese artículo asume &lt;br /&gt;
* Docker instalado (https://docs.docker.com/engine/installation/linux/docker-ce/debian/#install-using-the-repository). &lt;br /&gt;
* Docker Compose instalado (https://github.com/docker/compose/releases). &lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
git clone https://hub.siu.edu.ar/siu/instaladores.git dockerCerts&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Editamos el archivo docker-compose según nuestras necesidades.&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
cd dockerCerts/certs&lt;br /&gt;
nano docker-compose.yml&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
En mi caso quedo así:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt; &lt;br /&gt;
certificados:&lt;br /&gt;
  image: siutoba/docker-certs&lt;br /&gt;
  container_name: docker-certs&lt;br /&gt;
  #env_file: docker.env&lt;br /&gt;
  environment:&lt;br /&gt;
    DOCKER_NAME: certs&lt;br /&gt;
    CA_PWD: pass&lt;br /&gt;
    CA_INT_PWD: pass&lt;br /&gt;
    LISTA_SERVER: huarpe.local.siu usuarios.local.siu&lt;br /&gt;
    LISTA_CLIENTES: usuarios-cli huarpe-cli&lt;br /&gt;
  volumes:&lt;br /&gt;
    - ./data/certificados:/CAs/intermediate&lt;br /&gt;
    - ./data/root:/CAs/rootCA&lt;br /&gt;
&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Guardamos y generamos el container.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
docker-compose up&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Una vez generado el container copiamos los certificados creados en la carpeta que nos sea mas cómodo, en mi caso /certs&lt;br /&gt;
Sin cambiar de directorio hacemos:&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
sudo mkdir /certs&lt;br /&gt;
sudo find data -name &amp;quot;*.pem&amp;quot; -exec cp {} /certs \;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Luego generamos los certificados para el IDP:&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
mkdir /certs/idp&lt;br /&gt;
cd /certs/idp&lt;br /&gt;
openssl req -newkey rsa:2048 -new -x509 -days 3652 -nodes -out certificado_idp.crt -keyout certificado_idp.pem&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Listo, con las URL definidas y los certificados creados se puede proceder a instalar la plataforma.&lt;br /&gt;
&lt;br /&gt;
== Instalación Arai-Registy ==&lt;br /&gt;
Creamos la carpeta '''/usr/local/siu''' y no posicionamos ahí&lt;br /&gt;
Clonamos el proyecto &lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
git clone --branch v1.1.0 https://hub.siu.edu.ar/siu-arai/arai-registry.git registry&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
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.&lt;br /&gt;
&lt;br /&gt;
Dentro del directorio del proyecto encontramos el archivo &amp;quot;doc/INSTALACION MANUAL.md&amp;quot;, la idea es seguir las instrucciones que encontramos en este archivo.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
cd registry&lt;br /&gt;
composer install --no-dev&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
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.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
cp templates/arai-registry.env.dist arai-registry.env&lt;br /&gt;
nano arai-registry.env&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
'''arai-registry.env'''&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
# config de la aplicacion&lt;br /&gt;
ARAI_REGISTRY_ALIAS=&amp;quot;/arai-registry&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_USER=&amp;quot;user&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_PASS=&amp;quot;pass&amp;quot;&lt;br /&gt;
&lt;br /&gt;
# config de la base de datos&lt;br /&gt;
ARAI_REGISTRY_DB_HOST=&amp;quot;172.27.31.114&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_DB_PORT=&amp;quot;7432&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_DB_DBNAME=&amp;quot;siu_registry&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_DB_USERNAME=&amp;quot;postgres&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_DB_PASSWORD=&amp;quot;postgres&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_DB_SCHEMA=&amp;quot;registry&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_DB_ENCODING=&amp;quot;UTF8&amp;quot;&lt;br /&gt;
&lt;br /&gt;
###### CONFIG DE LOGS ######&lt;br /&gt;
ARAI_REGISTRY_LOG_HANDLER=&amp;quot;errorlog&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_LOG_LEVEL=&amp;quot;WARNING&amp;quot;&lt;br /&gt;
&lt;br /&gt;
# config del instalador&lt;br /&gt;
INSTALADOR_TIMEOUT=&amp;quot;360&amp;quot;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Una vez editado, verificamos que la configuración sea correcta&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/instalador proyecto:verificar&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Si no sale ninguna alerta, procedemos a instalar.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/instalador proyecto:instalar&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
Una vez instalado, modificamos los permisos de los archivos de la instalación con el comando&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
sudo ./bin/instalador permisos:simple&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Luego configuramos apache.&lt;br /&gt;
En mi caso, como tengo toda la plataforma instalada en un mismo servidor, debo usar el '''ServerName &amp;quot;registry.local.siu&amp;quot;'''&lt;br /&gt;
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'''&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;VirtualHost *:80&amp;gt;&lt;br /&gt;
ServerName registry.local.siu&lt;br /&gt;
Include /usr/local/siu/registry/config/alias.conf&lt;br /&gt;
&amp;lt;/VirtualHost&amp;gt;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Con todo esto, para verificar que todo funcione reiniciamos Apache y ejecutamos&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
curl --user registry:registry http://registry.local.siu/arai-registry/rest/packages/1&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Si la salida es:&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
{&lt;br /&gt;
    &amp;quot;error&amp;quot;: 404,&lt;br /&gt;
    &amp;quot;mensaje&amp;quot;: &amp;quot;404 Not Found&amp;quot;,&lt;br /&gt;
    &amp;quot;descripcion&amp;quot;: &amp;quot;El paquete solicitado no existe&amp;quot;&lt;br /&gt;
}&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
es que la instalación funcionó correctamente.&lt;br /&gt;
&lt;br /&gt;
Con registry instalado procedemos a instalar Usuarios&lt;br /&gt;
&lt;br /&gt;
==Arai-Usuarios==&lt;br /&gt;
&lt;br /&gt;
Nos posicionamos en /usr/local/siu y clonamos el proyecto&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
cd /usr/local/siu&lt;br /&gt;
git clone --branch v1.2.0 https://hub.siu.edu.ar/siu-arai/arai-usuarios.git usuarios&lt;br /&gt;
cd usuarios&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Para instalar seguimos la documentación del archivo '''doc/INSTALACION_MANUAL.md'''&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
composer install --no-dev&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
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.&lt;br /&gt;
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.&lt;br /&gt;
La variable TOBA_USUARIO debe contener el mismo usuarios administrado del LDAP.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
cp templates/arai-usuarios.env.dist arai-usuarios.env&lt;br /&gt;
nano arai-usuarios.env&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
'''arai-usuarios.env.dist'''&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
###### CONFIG DEL INSTALADR ######&lt;br /&gt;
#INSTALADOR_TIMEOUT=&amp;quot;360&amp;quot;&lt;br /&gt;
ENTORNO_PRODUCCION=&amp;quot;1&amp;quot;&lt;br /&gt;
&lt;br /&gt;
###### VARIABLES GLOBALES DEL ARCHIVO ######&lt;br /&gt;
ARAI_USUARIOS_DIR=/usr/local/siu/usuarios&lt;br /&gt;
&lt;br /&gt;
###### CONFIG DE TOBA ######&lt;br /&gt;
TOBA_URL_BASE=&amp;quot;https://usuarios.local.siu&amp;quot;&lt;br /&gt;
#TOBA_URL_PORT=&amp;quot;443&amp;quot;&lt;br /&gt;
TOBA_USUARIO=&amp;quot;admin&amp;quot;&lt;br /&gt;
TOBA_PASSWORD=&amp;quot;admin1234&amp;quot;&lt;br /&gt;
TOBA_INSTALACION_DIR=&amp;quot;${ARAI_USUARIOS_DIR}/instalacion&amp;quot;&lt;br /&gt;
TOBA_PROYECTO_DIR=&amp;quot;${ARAI_USUARIOS_DIR}/gestion&amp;quot;&lt;br /&gt;
TOBA_INSTALAR_USUARIOS=false&lt;br /&gt;
TOBA_INSTALAR_EDITOR=false&lt;br /&gt;
TOBA_INSTALAR_REFERENCIA=false&lt;br /&gt;
TOBA_ALIAS_PROYECTO=&amp;quot;/gestion&amp;quot;&lt;br /&gt;
TOBA_ALIAS_NUCLEO=&amp;quot;/toba_gestion&amp;quot;&lt;br /&gt;
#TOBA_ID_DESARROLLADOR=0&lt;br /&gt;
#TOBA_SESSION_NAME=&amp;quot;ARAI_SESSID&amp;quot;&lt;br /&gt;
&lt;br /&gt;
###### CONFIG DE BASE DE DATOS DE NEGOCIO ######&lt;br /&gt;
PROYECTO_DB_HOST=&amp;quot;172.27.31.114&amp;quot;&lt;br /&gt;
PROYECTO_DB_PORT=&amp;quot;7432&amp;quot;&lt;br /&gt;
PROYECTO_DB_DBNAME=&amp;quot;siu_usuarios&amp;quot;&lt;br /&gt;
PROYECTO_DB_USERNAME=&amp;quot;postgres&amp;quot;&lt;br /&gt;
PROYECTO_DB_PASSWORD=&amp;quot;postgres&amp;quot;&lt;br /&gt;
PROYECTO_DB_SCHEMA=&amp;quot;usuarios&amp;quot;&lt;br /&gt;
PROYECTO_DB_ENCODING=&amp;quot;LATIN1&amp;quot;&lt;br /&gt;
&lt;br /&gt;
###### CONFIG DE BASE DE DATOS DE TOBA. #####&lt;br /&gt;
######## DEFINIR SI SE QUIERE UTILIZAR UNA BASE DISTINTA A LA DE NEGOCIO&lt;br /&gt;
#TOBA_DB_HOST=&amp;quot;localhost&amp;quot;&lt;br /&gt;
#TOBA_DB_PORT=&amp;quot;5432&amp;quot;&lt;br /&gt;
#TOBA_DB_DBNAME=&amp;quot;instalador&amp;quot;&lt;br /&gt;
#TOBA_DB_USERNAME=&amp;quot;postgres&amp;quot;&lt;br /&gt;
#TOBA_DB_PASSWORD=&amp;quot;postgres&amp;quot;&lt;br /&gt;
#TOBA_DB_SCHEMA=&amp;quot;public&amp;quot;&lt;br /&gt;
&lt;br /&gt;
##### CONFIG IDM #####&lt;br /&gt;
ARAI_USUARIOS_URL_IDP=https://usuarios.local.siu/idp&lt;br /&gt;
## Deberá setearse si el sistema corre detrás de un proxy reverso&lt;br /&gt;
#ARAI_USUARIOS_PROXY_URL_IDP=http://url.arai-usuarios:80/idp&lt;br /&gt;
ARAI_USUARIOS_URL_PORTAL=https://huarpe.local.siu/portal&lt;br /&gt;
ARAI_USUARIOS_URL_PERFIL=https://huarpe.local.siu/perfil&lt;br /&gt;
ARAI_USUARIOS_URL_INSTITUCION=http://siu.edu.ar&lt;br /&gt;
&lt;br /&gt;
ARAI_USUARIOS_SIGLA_INSTITUCION=SIGLA&lt;br /&gt;
ARAI_USUARIOS_EMAIL_SOPORTE=mail.soporte@institucion.edu.ar&lt;br /&gt;
&lt;br /&gt;
##### CONFIG SEGURIDAD ####&lt;br /&gt;
SEGURIDAD_ALGORITMO_PASS=crypt&lt;br /&gt;
SEGURIDAD_LARGO_PASS=8&lt;br /&gt;
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'&lt;br /&gt;
SEGURIDAD_DURACION_DIAS_PASS=120&lt;br /&gt;
SEGURIDAD_RECAPTCHA_SITIO=6Fd_pQwTAAAAAOEqJz6KJmkjsrXcdXrAjWQYggZf&lt;br /&gt;
SEGURIDAD_RECAPTCHA_CLAVE=6Fd_pQwTAAAAAOEqJz6KJmkjsrXcdXrAjWQYggZf&lt;br /&gt;
SEGURIDAD_INTENTOS_RECAPTCHA=3&lt;br /&gt;
&lt;br /&gt;
##### CONFIG IDP #####&lt;br /&gt;
ARAI_USUARIOS_IDP_KEY_FILE=/certs/idp/certificado_idp.pem&lt;br /&gt;
ARAI_USUARIOS_IDP_CERT_FILE=/certs/idp/certificado_idp.crt&lt;br /&gt;
#ARAI_USUARIOS_IDP_LOG_LEVEL='WARNING'&lt;br /&gt;
#ARAI_USUARIOS_IDP_LOG_HANDLER='errorlog'&lt;br /&gt;
&lt;br /&gt;
##### CONFIG MAIL RECOVERY ####&lt;br /&gt;
MAIL_RECOVERY_SUBJECT='Recuperar contraseña SIU-Arai'&lt;br /&gt;
MAIL_RECOVERY_FROM='noreply@institucion.edu.ar'&lt;br /&gt;
MAIL_RECOVERY_REPLYTO='noreply@institucion.edu.ar'&lt;br /&gt;
MAIL_RECOVERY_FROMNAME='Institución'&lt;br /&gt;
&lt;br /&gt;
##### CONFIG LDAP #####&lt;br /&gt;
ARAI_USUARIOS_LDAP_HOST=172.27.31.114&lt;br /&gt;
ARAI_USUARIOS_LDAP_PORT=7389&lt;br /&gt;
ARAI_USUARIOS_LDAP_TLS=0&lt;br /&gt;
ARAI_USUARIOS_LDAP_METHOD=user&lt;br /&gt;
ARAI_USUARIOS_LDAP_BINDUSER=&amp;quot;cn=admin,dc=siu,dc=cin,dc=edu&amp;quot;&lt;br /&gt;
ARAI_USUARIOS_LDAP_BINDPASS=admin&lt;br /&gt;
ARAI_USUARIOS_LDAP_SEARCHBASE=&amp;quot;dc=siu,dc=cin,dc=edu&amp;quot;&lt;br /&gt;
&lt;br /&gt;
##### CONFIG ARAI-REGISTRY #####&lt;br /&gt;
ARAI_REGISTRY_URL=http://registry.local.siu/arai-registry&lt;br /&gt;
ARAI_REGISTRY_USER=user&lt;br /&gt;
ARAI_REGISTRY_PASS=pass&lt;br /&gt;
&lt;br /&gt;
###### CONFIG ENVIO MAILS (SMTP) ######&lt;br /&gt;
SMTP_ENTRADA=&amp;quot;arai-usuarios&amp;quot;&lt;br /&gt;
SMTP_HELO=&amp;quot;mail.unx.edu.ar&amp;quot;&lt;br /&gt;
SMTP_HOST=&amp;quot;smtp.googlemail.com&amp;quot;&lt;br /&gt;
SMTP_PORT=587&lt;br /&gt;
SMTP_FROM =&amp;quot;yo@midominio.com&amp;quot;&lt;br /&gt;
SMTP_SEGURIDAD =&amp;quot;ssl|tls&amp;quot;&lt;br /&gt;
SMTP_AUTH =&amp;quot;1&amp;quot;&lt;br /&gt;
SMTP_USUARIO =&amp;quot;usuario&amp;quot;&lt;br /&gt;
SMTP_CLAVE =&amp;quot;pass&amp;quot;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Una vez editado, verificamos que la configuración sea correcta&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/instalador proyecto:verificar -n&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Si no sale ninguna alerta, procedemos a instalar.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/instalador proyecto:instalar&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
Una vez instalado, modificamos los permisos de los archivos de la instalación con el comando&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
sudo ./bin/instalador permisos:simple&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
Cambiamos el modo mantenimiento&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/instalador instalacion:modo-mantenimiento --sin-mantenimiento -n&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Luego configuramos Apache.&lt;br /&gt;
Lo mismo que con registry, como tengo toda la plataforma instalada en un mismo servidor, debo usar el '''ServerName &amp;quot;usuarios.local.siu&amp;quot;'''&lt;br /&gt;
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'''&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;VirtualHost *:80&amp;gt;&lt;br /&gt;
    ServerName usuarios.local.siu&lt;br /&gt;
    Redirect permanent / https://usuarios.local.siu/&lt;br /&gt;
&amp;lt;/VirtualHost&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;VirtualHost *:443&amp;gt;&lt;br /&gt;
&lt;br /&gt;
ServerName usuarios.local.siu&lt;br /&gt;
&lt;br /&gt;
SSLEngine on&lt;br /&gt;
SSLCertificateFile /certs/usuarios.local.siu.cert.pem&lt;br /&gt;
SSLCertificateKeyFile /certs/usuarios.local.siu.key.pem&lt;br /&gt;
&lt;br /&gt;
SSLCACertificateFile /certs/ca-chain.cert.pem&lt;br /&gt;
&lt;br /&gt;
SSLVerifyClient optional_no_ca&lt;br /&gt;
SSLVerifyDepth 2&lt;br /&gt;
SSLProtocol all -SSLv2 -SSLv3&lt;br /&gt;
SSLOptions +StdEnvVars +ExportCertData&lt;br /&gt;
BrowserMatch &amp;quot;MSIE [2-6]&amp;quot; \&lt;br /&gt;
        nokeepalive ssl-unclean-shutdown \&lt;br /&gt;
        downgrade-1.0 force-response-1.0&lt;br /&gt;
        # MSIE 7 and newer should be able to use keepalive&lt;br /&gt;
BrowserMatch &amp;quot;MSIE [17-9]&amp;quot; ssl-unclean-shutdown&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Include /usr/local/siu/usuarios/instalacion/toba.conf&lt;br /&gt;
&lt;br /&gt;
Include /usr/local/siu/usuarios/instalacion/idp.conf&lt;br /&gt;
&lt;br /&gt;
&amp;lt;/VirtualHost&amp;gt;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Luego hay que hacer que nuestra CA autofirmada sea válida en el SO y así permitir que Apache verifique los certificados de clientes:&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
sudo cp /certs/ca.cert.pem /usr/share/ca-certificates/ca_propia.crt&lt;br /&gt;
sudo vim /etc/ca-certificates.conf&lt;br /&gt;
# agregar ca_propia.crt al final del archivo&lt;br /&gt;
update-ca-certificates --fresh&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Reiniciamos Apache y todo debería funcionar, para verificar entramos en la URL definida para usuarios, en mi caso https://usuarios.local.siu/gestion&lt;br /&gt;
&lt;br /&gt;
Con todo esto funcionando el siguiente paso es agregar Usuarios a Registry y sincronizarlos. &lt;br /&gt;
Según esta instalación para agregar Usuarios al entorno hacemos&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/arai-cli registry:add --maintainer-email  jpiazza@siu.edu.ar --maintainer jpiazza http://registry.local.siu/arai-registry&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
y para sincronizarlo&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/arai-cli registry:sync&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== Arai-Huarpe ==&lt;br /&gt;
&lt;br /&gt;
Es similar a las instalaciones anteriores.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
cd /usr/local/siu&lt;br /&gt;
git clone --branch v1.1.0 https://hub.siu.edu.ar/siu-arai/huarpe-core.git huarpe&lt;br /&gt;
cd huarpe&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Para instalar seguimos la documentación del archivo '''doc/INSTALACION_MANUAL.md'''&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
composer install --no-dev&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
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.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
cp templates/huarpe.env.dist huarpe.env&lt;br /&gt;
nano huarpe.env&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
'''huarpe.env'''&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
###### CONFIG DEL INSTALADR ######&lt;br /&gt;
#INSTALADOR_TIMEOUT=&amp;quot;360&amp;quot;&lt;br /&gt;
ENTORNO_PRODUCCION=1&lt;br /&gt;
&lt;br /&gt;
###### CONFIG DE SIU-HUARPE ######&lt;br /&gt;
HUARPE_PATH=/usr/local/siu/huarpe&lt;br /&gt;
HUARPE_URL=https://huarpe.local.siu&lt;br /&gt;
HUARPE_URL_PORT=443&lt;br /&gt;
HUARPE_SESSION_NAME=huarpe&lt;br /&gt;
HUARPE_SESSION_HANDLER=&amp;quot;native_file&amp;quot;&lt;br /&gt;
#HUARPE_MEMCACHED_HOST=127.0.0.1&lt;br /&gt;
#HUARPE_MEMCACHED_PORT=11211&lt;br /&gt;
HUARPE_CERT_FILE=/certs/huarpe-cli.cert.pem&lt;br /&gt;
HUARPE_KEY_FILE=/certs/huarpe-cli.key.pem&lt;br /&gt;
#HUARPE_TOKEN=unt0k3n-al3at0r1o-s39ur0?&lt;br /&gt;
#HUARPE_PROXY=127.0.0.1&lt;br /&gt;
HUARPE_LOG_HANDLER=&amp;quot;error_log&amp;quot;&lt;br /&gt;
HUARPE_LOG_LEVEL=&amp;quot;WARNING&amp;quot;&lt;br /&gt;
&lt;br /&gt;
###### CONFIG DE SIU-ARAI: REGISTRY ######&lt;br /&gt;
ARAI_REGISTRY_URL=http://registry.local.siu/arai-registry&lt;br /&gt;
ARAI_REGISTRY_USER=user&lt;br /&gt;
ARAI_REGISTRY_PASS=pass&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Una vez editado, verificamos que la configuración sea correcta&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/instalador proyecto:verificar&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
Si no sale ninguna alerta, procedemos a instalar.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
sudo ./bin/instalador proyecto:instalar&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
En Synfony es necesario dumpear los estilos y los JS con el siguiente comando.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/console assetic:dump --no-debug&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
Una vez instalado, modificamos los permisos de los archivos de la instalación con el comando&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
sudo ./bin/instalador permisos:simple&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Configuración apache ===&lt;br /&gt;
Lo mismo que con Registry o Usuarios, como tengo toda la plataforma instalada en un mismo servidor, debo usar el '''ServerName huarpe.local.siu'''.&lt;br /&gt;
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&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;VirtualHost *:80&amp;gt;&lt;br /&gt;
	ServerName huarpe.local.siu&lt;br /&gt;
	Redirect permanent / https://huarpe.local.siu:443/&lt;br /&gt;
&amp;lt;/VirtualHost&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;VirtualHost *:443&amp;gt;&lt;br /&gt;
&lt;br /&gt;
ServerName huarpe.local.siu&lt;br /&gt;
SSLEngine on&lt;br /&gt;
SSLCertificateFile /certs/huarpe.local.siu.cert.pem&lt;br /&gt;
SSLCertificateKeyFile /certs/huarpe.local.siu.key.pem&lt;br /&gt;
&lt;br /&gt;
Include /usr/local/siu/huarpe/app/config/alias.conf&lt;br /&gt;
&lt;br /&gt;
&amp;lt;/VirtualHost&amp;gt;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Reiniciamos apache, antes de verificar la instalación, debemos sincronizar con Registry.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/arai-cli registry:add --maintainer-email  jpiazza@siu.edu.ar --maintainer jpiazza http://registry.local.siu/arai-registry&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
Luego sincronizar&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/arai-cli registry:sync&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Hay que limpiar la cache y actualizar los permisos&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/console cache:clear --env=prod&lt;br /&gt;
sudo ./bin/instalador permisos:simple &lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
En Usuarios resincronizar para que se actualice con la nueva instalación&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
cd /usr/local/siu/usuarios&lt;br /&gt;
./bin/arai-cli registry:sync&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Para verificar que la instalación se realizo con éxito de debe ingresar en https://huarpe.local.siu/&lt;br /&gt;
&lt;br /&gt;
Si todo salio bien, tenemos instalada la plataforma ARAI lista para ser usada en nuestro servidor.&lt;/div&gt;</summary>
		<author><name>Ablanco</name></author>	</entry>

	<entry>
		<id>https://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Arai/ejemploPasoAPaso&amp;diff=27631</id>
		<title>SIU-Arai/ejemploPasoAPaso</title>
		<link rel="alternate" type="text/html" href="https://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Arai/ejemploPasoAPaso&amp;diff=27631"/>
				<updated>2017-08-03T14:31:47Z</updated>
		
		<summary type="html">&lt;p&gt;Ablanco: /* Creación de certificados */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;[[Archivo:siu-arai_iso.png|derecha|link=SIU-Arai]]&lt;br /&gt;
&lt;br /&gt;
= Ejemplo paso a paso =&lt;br /&gt;
&lt;br /&gt;
Para este caso voy a usar una instalación de Debian Jessie&lt;br /&gt;
&lt;br /&gt;
El objetivo es tener una instalación funcionando de la paltaforma SIU-Arai que luego sirva para integrar otros sistemas toba.&lt;br /&gt;
&lt;br /&gt;
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í&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable zebra&amp;quot;&lt;br /&gt;
!colspan=&amp;quot;2&amp;quot;|URLs&lt;br /&gt;
|-&lt;br /&gt;
|Araí-Registry&lt;br /&gt;
|http://registry.local.siu&lt;br /&gt;
|-&lt;br /&gt;
|Araí-Usuarios&lt;br /&gt;
|https://usuarios.local.siu&lt;br /&gt;
|-&lt;br /&gt;
|Araí-Huarpe&lt;br /&gt;
|https://huarpe.local.siu&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
== Creación de certificados ==&lt;br /&gt;
Hay que tener en cuenta que voy a usar conexión segura, por lo que tanto voy a necesitar certificados.&lt;br /&gt;
Para crear los certificados uso el tutorial que se encuentra en http://documentacion.siu.edu.ar/wiki/SIU-Arai/certificados. &lt;br /&gt;
Ese artículo asume &lt;br /&gt;
* Docker instalado (https://docs.docker.com/engine/installation/linux/docker-ce/debian/#install-using-the-repository). &lt;br /&gt;
* Docker Compose instalado (https://github.com/docker/compose/releases). &lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
git clone https://hub.siu.edu.ar/siu/instaladores.git dockerCerts&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Editamos el archivo docker-compose según nuestras necesidades.&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
cd dockerCerts/certs&lt;br /&gt;
nano docker-compose.yml&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
En mi caso quedo así:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt; &lt;br /&gt;
certificados:&lt;br /&gt;
  image: siutoba/docker-certs&lt;br /&gt;
  container_name: docker-certs&lt;br /&gt;
  #env_file: docker.env&lt;br /&gt;
  environment:&lt;br /&gt;
    DOCKER_NAME: certs&lt;br /&gt;
    CA_PWD: pass&lt;br /&gt;
    CA_INT_PWD: pass&lt;br /&gt;
    LISTA_SERVER: huarpe.local.siu usuarios.local.siu&lt;br /&gt;
    LISTA_CLIENTES: usuarios-cli huarpe-cli&lt;br /&gt;
  volumes:&lt;br /&gt;
    - ./data/certificados:/CAs/intermediate&lt;br /&gt;
    - ./data/root:/CAs/rootCA&lt;br /&gt;
&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Guardamos y generamos el container.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
docker-compose up&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Una vez generado el container copiamos los certificados creados en la carpeta que nos sea mas cómodo, en mi caso /certs&lt;br /&gt;
Sin cambiar de directorio hacemos:&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
sudo mkdir /certs&lt;br /&gt;
sudo find data -name &amp;quot;*.pem&amp;quot; -exec cp {} /certs \;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Luego generamos los certificados para el IDP:&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
mkdir /certs/idp&lt;br /&gt;
cd /certs/idp&lt;br /&gt;
openssl req -newkey rsa:2048 -new -x509 -days 3652 -nodes -out certificado_idp.crt -keyout certificado_idp.pem&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Listo, con las URL definidas y los certificados creados se puede proceder a instalar la plataforma.&lt;br /&gt;
&lt;br /&gt;
== Instalación Arai-Registy ==&lt;br /&gt;
Creamos la carpeta '''/usr/local/siu''' y no posicionamos ahí&lt;br /&gt;
Clonamos el proyecto &lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
git clone --branch v1.1.0 https://hub.siu.edu.ar/siu-arai/arai-registry.git registry&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
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.&lt;br /&gt;
&lt;br /&gt;
Dentro del directorio del proyecto encontramos el archivo &amp;quot;doc/INSTALACION MANUAL.md&amp;quot;, la idea es seguir las instrucciones que encontramos en este archivo.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
cd registry&lt;br /&gt;
composer install --no-dev&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
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.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
cp templates/arai-registry.env.dist arai-registry.env&lt;br /&gt;
nano arai-registry.env&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
'''arai-registry.env'''&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
# config de la aplicacion&lt;br /&gt;
ARAI_REGISTRY_ALIAS=&amp;quot;/arai-registry&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_USER=&amp;quot;user&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_PASS=&amp;quot;pass&amp;quot;&lt;br /&gt;
&lt;br /&gt;
# config de la base de datos&lt;br /&gt;
ARAI_REGISTRY_DB_HOST=&amp;quot;172.27.31.114&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_DB_PORT=&amp;quot;7432&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_DB_DBNAME=&amp;quot;siu_registry&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_DB_USERNAME=&amp;quot;postgres&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_DB_PASSWORD=&amp;quot;postgres&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_DB_SCHEMA=&amp;quot;registry&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_DB_ENCODING=&amp;quot;UTF8&amp;quot;&lt;br /&gt;
&lt;br /&gt;
###### CONFIG DE LOGS ######&lt;br /&gt;
ARAI_REGISTRY_LOG_HANDLER=&amp;quot;errorlog&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_LOG_LEVEL=&amp;quot;DEBUG&amp;quot;&lt;br /&gt;
&lt;br /&gt;
# config del instalador&lt;br /&gt;
INSTALADOR_TIMEOUT=&amp;quot;360&amp;quot;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Una vez editado, verificamos que la configuración sea correcta&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/instalador proyecto:verificar&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Si no sale ninguna alerta, procedemos a instalar.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/instalador proyecto:instalar&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
Una vez instalado, modificamos los permisos de los archivos de la instalación con el comando&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
sudo ./bin/instalador permisos:simple&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Luego configuramos apache.&lt;br /&gt;
En mi caso, como tengo toda la plataforma instalada en un mismo servidor, debo usar el '''ServerName &amp;quot;registry.local.siu&amp;quot;'''&lt;br /&gt;
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'''&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;VirtualHost *:80&amp;gt;&lt;br /&gt;
ServerName registry.local.siu&lt;br /&gt;
Include /usr/local/siu/registry/config/alias.conf&lt;br /&gt;
&amp;lt;/VirtualHost&amp;gt;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Con todo esto, para verificar que todo funcione reiniciamos Apache y ejecutamos&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
curl --user registry:registry http://registry.local.siu/arai-registry/rest/packages/1&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Si la salida es:&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
{&lt;br /&gt;
    &amp;quot;error&amp;quot;: 404,&lt;br /&gt;
    &amp;quot;mensaje&amp;quot;: &amp;quot;404 Not Found&amp;quot;,&lt;br /&gt;
    &amp;quot;descripcion&amp;quot;: &amp;quot;El paquete solicitado no existe&amp;quot;&lt;br /&gt;
}&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
es que la instalación funcionó correctamente.&lt;br /&gt;
&lt;br /&gt;
Con registry instalado procedemos a instalar Usuarios&lt;br /&gt;
&lt;br /&gt;
==Arai-Usuarios==&lt;br /&gt;
&lt;br /&gt;
Nos posicionamos en /usr/local/siu y clonamos el proyecto&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
cd /usr/local/siu&lt;br /&gt;
git clone --branch v1.2.0 https://hub.siu.edu.ar/siu-arai/arai-usuarios.git usuarios&lt;br /&gt;
cd usuarios&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Para instalar seguimos la documentación del archivo '''doc/INSTALACION_MANUAL.md'''&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
composer install --no-dev&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
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.&lt;br /&gt;
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.&lt;br /&gt;
La variable TOBA_USUARIO debe contener el mismo usuarios administrado del LDAP.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
cp templates/arai-usuarios.env.dist arai-usuarios.env&lt;br /&gt;
nano arai-usuarios.env&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
'''arai-usuarios.env.dist'''&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
###### CONFIG DEL INSTALADR ######&lt;br /&gt;
#INSTALADOR_TIMEOUT=&amp;quot;360&amp;quot;&lt;br /&gt;
ENTORNO_PRODUCCION=&amp;quot;1&amp;quot;&lt;br /&gt;
&lt;br /&gt;
###### VARIABLES GLOBALES DEL ARCHIVO ######&lt;br /&gt;
ARAI_USUARIOS_DIR=/usr/local/siu/usuarios&lt;br /&gt;
&lt;br /&gt;
###### CONFIG DE TOBA ######&lt;br /&gt;
TOBA_URL_BASE=&amp;quot;https://usuarios.local.siu&amp;quot;&lt;br /&gt;
#TOBA_URL_PORT=&amp;quot;443&amp;quot;&lt;br /&gt;
TOBA_USUARIO=&amp;quot;admin&amp;quot;&lt;br /&gt;
TOBA_PASSWORD=&amp;quot;admin1234&amp;quot;&lt;br /&gt;
TOBA_INSTALACION_DIR=&amp;quot;${ARAI_USUARIOS_DIR}/instalacion&amp;quot;&lt;br /&gt;
TOBA_PROYECTO_DIR=&amp;quot;${ARAI_USUARIOS_DIR}/gestion&amp;quot;&lt;br /&gt;
TOBA_INSTALAR_USUARIOS=false&lt;br /&gt;
TOBA_INSTALAR_EDITOR=false&lt;br /&gt;
TOBA_INSTALAR_REFERENCIA=false&lt;br /&gt;
TOBA_ALIAS_PROYECTO=&amp;quot;/gestion&amp;quot;&lt;br /&gt;
TOBA_ALIAS_NUCLEO=&amp;quot;/toba_gestion&amp;quot;&lt;br /&gt;
#TOBA_ID_DESARROLLADOR=0&lt;br /&gt;
#TOBA_SESSION_NAME=&amp;quot;ARAI_SESSID&amp;quot;&lt;br /&gt;
&lt;br /&gt;
###### CONFIG DE BASE DE DATOS DE NEGOCIO ######&lt;br /&gt;
PROYECTO_DB_HOST=&amp;quot;172.27.31.114&amp;quot;&lt;br /&gt;
PROYECTO_DB_PORT=&amp;quot;7432&amp;quot;&lt;br /&gt;
PROYECTO_DB_DBNAME=&amp;quot;siu_usuarios&amp;quot;&lt;br /&gt;
PROYECTO_DB_USERNAME=&amp;quot;postgres&amp;quot;&lt;br /&gt;
PROYECTO_DB_PASSWORD=&amp;quot;postgres&amp;quot;&lt;br /&gt;
PROYECTO_DB_SCHEMA=&amp;quot;usuarios&amp;quot;&lt;br /&gt;
PROYECTO_DB_ENCODING=&amp;quot;LATIN1&amp;quot;&lt;br /&gt;
&lt;br /&gt;
###### CONFIG DE BASE DE DATOS DE TOBA. #####&lt;br /&gt;
######## DEFINIR SI SE QUIERE UTILIZAR UNA BASE DISTINTA A LA DE NEGOCIO&lt;br /&gt;
#TOBA_DB_HOST=&amp;quot;localhost&amp;quot;&lt;br /&gt;
#TOBA_DB_PORT=&amp;quot;5432&amp;quot;&lt;br /&gt;
#TOBA_DB_DBNAME=&amp;quot;instalador&amp;quot;&lt;br /&gt;
#TOBA_DB_USERNAME=&amp;quot;postgres&amp;quot;&lt;br /&gt;
#TOBA_DB_PASSWORD=&amp;quot;postgres&amp;quot;&lt;br /&gt;
#TOBA_DB_SCHEMA=&amp;quot;public&amp;quot;&lt;br /&gt;
&lt;br /&gt;
##### CONFIG IDM #####&lt;br /&gt;
ARAI_USUARIOS_URL_IDP=https://usuarios.local.siu/idp&lt;br /&gt;
## Deberá setearse si el sistema corre detrás de un proxy reverso&lt;br /&gt;
#ARAI_USUARIOS_PROXY_URL_IDP=http://url.arai-usuarios:80/idp&lt;br /&gt;
ARAI_USUARIOS_URL_PORTAL=https://huarpe.local.siu/portal&lt;br /&gt;
ARAI_USUARIOS_URL_PERFIL=https://huarpe.local.siu/perfil&lt;br /&gt;
ARAI_USUARIOS_URL_INSTITUCION=http://siu.edu.ar&lt;br /&gt;
&lt;br /&gt;
ARAI_USUARIOS_SIGLA_INSTITUCION=SIGLA&lt;br /&gt;
ARAI_USUARIOS_EMAIL_SOPORTE=mail.soporte@institucion.edu.ar&lt;br /&gt;
&lt;br /&gt;
##### CONFIG SEGURIDAD ####&lt;br /&gt;
SEGURIDAD_ALGORITMO_PASS=crypt&lt;br /&gt;
SEGURIDAD_LARGO_PASS=8&lt;br /&gt;
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'&lt;br /&gt;
SEGURIDAD_DURACION_DIAS_PASS=120&lt;br /&gt;
SEGURIDAD_RECAPTCHA_SITIO=6Fd_pQwTAAAAAOEqJz6KJmkjsrXcdXrAjWQYggZf&lt;br /&gt;
SEGURIDAD_RECAPTCHA_CLAVE=6Fd_pQwTAAAAAOEqJz6KJmkjsrXcdXrAjWQYggZf&lt;br /&gt;
SEGURIDAD_INTENTOS_RECAPTCHA=3&lt;br /&gt;
&lt;br /&gt;
##### CONFIG IDP #####&lt;br /&gt;
ARAI_USUARIOS_IDP_KEY_FILE=/certs/idp/certificado_idp.pem&lt;br /&gt;
ARAI_USUARIOS_IDP_CERT_FILE=/certs/idp/certificado_idp.crt&lt;br /&gt;
#ARAI_USUARIOS_IDP_LOG_LEVEL='WARNING'&lt;br /&gt;
#ARAI_USUARIOS_IDP_LOG_HANDLER='errorlog'&lt;br /&gt;
&lt;br /&gt;
##### CONFIG MAIL RECOVERY ####&lt;br /&gt;
MAIL_RECOVERY_SUBJECT='Recuperar contraseña SIU-Arai'&lt;br /&gt;
MAIL_RECOVERY_FROM='noreply@institucion.edu.ar'&lt;br /&gt;
MAIL_RECOVERY_REPLYTO='noreply@institucion.edu.ar'&lt;br /&gt;
MAIL_RECOVERY_FROMNAME='Institución'&lt;br /&gt;
&lt;br /&gt;
##### CONFIG LDAP #####&lt;br /&gt;
ARAI_USUARIOS_LDAP_HOST=172.27.31.114&lt;br /&gt;
ARAI_USUARIOS_LDAP_PORT=7389&lt;br /&gt;
ARAI_USUARIOS_LDAP_TLS=0&lt;br /&gt;
ARAI_USUARIOS_LDAP_METHOD=user&lt;br /&gt;
ARAI_USUARIOS_LDAP_BINDUSER=&amp;quot;cn=admin,dc=siu,dc=cin,dc=edu&amp;quot;&lt;br /&gt;
ARAI_USUARIOS_LDAP_BINDPASS=admin&lt;br /&gt;
ARAI_USUARIOS_LDAP_SEARCHBASE=&amp;quot;dc=siu,dc=cin,dc=edu&amp;quot;&lt;br /&gt;
&lt;br /&gt;
##### CONFIG ARAI-REGISTRY #####&lt;br /&gt;
ARAI_REGISTRY_URL=http://registry.local.siu/arai-registry&lt;br /&gt;
ARAI_REGISTRY_USER=user&lt;br /&gt;
ARAI_REGISTRY_PASS=pass&lt;br /&gt;
&lt;br /&gt;
###### CONFIG ENVIO MAILS (SMTP) ######&lt;br /&gt;
SMTP_ENTRADA=&amp;quot;arai-usuarios&amp;quot;&lt;br /&gt;
SMTP_HELO=&amp;quot;mail.unx.edu.ar&amp;quot;&lt;br /&gt;
SMTP_HOST=&amp;quot;smtp.googlemail.com&amp;quot;&lt;br /&gt;
SMTP_PORT=587&lt;br /&gt;
SMTP_FROM =&amp;quot;yo@midominio.com&amp;quot;&lt;br /&gt;
SMTP_SEGURIDAD =&amp;quot;ssl|tls&amp;quot;&lt;br /&gt;
SMTP_AUTH =&amp;quot;1&amp;quot;&lt;br /&gt;
SMTP_USUARIO =&amp;quot;usuario&amp;quot;&lt;br /&gt;
SMTP_CLAVE =&amp;quot;pass&amp;quot;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Una vez editado, verificamos que la configuración sea correcta&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/instalador proyecto:verificar -n&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Si no sale ninguna alerta, procedemos a instalar.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/instalador proyecto:instalar&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
Una vez instalado, modificamos los permisos de los archivos de la instalación con el comando&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
sudo ./bin/instalador permisos:simple&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
Cambiamos el modo mantenimiento&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/instalador instalacion:modo-mantenimiento --sin-mantenimiento -n&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Luego configuramos Apache.&lt;br /&gt;
Lo mismo que con registry, como tengo toda la plataforma instalada en un mismo servidor, debo usar el '''ServerName &amp;quot;usuarios.local.siu&amp;quot;'''&lt;br /&gt;
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'''&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;VirtualHost *:80&amp;gt;&lt;br /&gt;
    ServerName usuarios.local.siu&lt;br /&gt;
    Redirect permanent / https://usuarios.local.siu/&lt;br /&gt;
&amp;lt;/VirtualHost&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;VirtualHost *:443&amp;gt;&lt;br /&gt;
&lt;br /&gt;
ServerName usuarios.local.siu&lt;br /&gt;
&lt;br /&gt;
SSLEngine on&lt;br /&gt;
SSLCertificateFile /certs/usuarios.local.siu.cert.pem&lt;br /&gt;
SSLCertificateKeyFile /certs/usuarios.local.siu.key.pem&lt;br /&gt;
&lt;br /&gt;
SSLCACertificateFile /certs/ca-chain.cert.pem&lt;br /&gt;
&lt;br /&gt;
SSLVerifyClient optional_no_ca&lt;br /&gt;
SSLVerifyDepth 2&lt;br /&gt;
SSLProtocol all -SSLv2 -SSLv3&lt;br /&gt;
SSLOptions +StdEnvVars +ExportCertData&lt;br /&gt;
BrowserMatch &amp;quot;MSIE [2-6]&amp;quot; \&lt;br /&gt;
        nokeepalive ssl-unclean-shutdown \&lt;br /&gt;
        downgrade-1.0 force-response-1.0&lt;br /&gt;
        # MSIE 7 and newer should be able to use keepalive&lt;br /&gt;
BrowserMatch &amp;quot;MSIE [17-9]&amp;quot; ssl-unclean-shutdown&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Include /usr/local/siu/usuarios/instalacion/toba.conf&lt;br /&gt;
&lt;br /&gt;
Include /usr/local/siu/usuarios/instalacion/idp.conf&lt;br /&gt;
&lt;br /&gt;
&amp;lt;/VirtualHost&amp;gt;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Luego hay que hacer que nuestra CA autofirmada sea válida en el SO y así permitir que Apache verifique los certificados de clientes:&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
sudo cp /certs/ca.cert.pem /usr/share/ca-certificates/ca_propia.crt&lt;br /&gt;
sudo vim /etc/ca-certificates.conf&lt;br /&gt;
# agregar ca_propia.crt al final del archivo&lt;br /&gt;
update-ca-certificates --fresh&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Reiniciamos Apache y todo debería funcionar, para verificar entramos en la URL definida para usuarios, en mi caso https://usuarios.local.siu/gestion&lt;br /&gt;
&lt;br /&gt;
Con todo esto funcionando el siguiente paso es agregar Usuarios a Registry y sincronizarlos. &lt;br /&gt;
Según esta instalación para agregar Usuarios al entorno hacemos&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/arai-cli registry:add --maintainer-email  jpiazza@siu.edu.ar --maintainer jpiazza http://registry.local.siu/arai-registry&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
y para sincronizarlo&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/arai-cli registry:sync&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== Arai-Huarpe ==&lt;br /&gt;
&lt;br /&gt;
Es similar a las instalaciones anteriores.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
cd /usr/local/siu&lt;br /&gt;
git clone --branch v1.1.0 https://hub.siu.edu.ar/siu-arai/huarpe-core.git huarpe&lt;br /&gt;
cd huarpe&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Para instalar seguimos la documentación del archivo '''doc/INSTALACION_MANUAL.md'''&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
composer install --no-dev&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
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.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
cp templates/huarpe.env.dist huarpe.env&lt;br /&gt;
nano huarpe.env&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
'''huarpe.env'''&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
###### CONFIG DEL INSTALADR ######&lt;br /&gt;
#INSTALADOR_TIMEOUT=&amp;quot;360&amp;quot;&lt;br /&gt;
ENTORNO_PRODUCCION=1&lt;br /&gt;
&lt;br /&gt;
###### CONFIG DE SIU-HUARPE ######&lt;br /&gt;
HUARPE_PATH=/usr/local/siu/huarpe&lt;br /&gt;
HUARPE_URL=https://huarpe.local.siu&lt;br /&gt;
HUARPE_URL_PORT=443&lt;br /&gt;
HUARPE_SESSION_NAME=huarpe&lt;br /&gt;
HUARPE_SESSION_HANDLER=&amp;quot;native_file&amp;quot;&lt;br /&gt;
#HUARPE_MEMCACHED_HOST=127.0.0.1&lt;br /&gt;
#HUARPE_MEMCACHED_PORT=11211&lt;br /&gt;
HUARPE_CERT_FILE=/certs/huarpe-cli.cert.pem&lt;br /&gt;
HUARPE_KEY_FILE=/certs/huarpe-cli.key.pem&lt;br /&gt;
#HUARPE_TOKEN=unt0k3n-al3at0r1o-s39ur0?&lt;br /&gt;
#HUARPE_PROXY=127.0.0.1&lt;br /&gt;
HUARPE_LOG_HANDLER=&amp;quot;error_log&amp;quot;&lt;br /&gt;
HUARPE_LOG_LEVEL=&amp;quot;DEBUG&amp;quot;&lt;br /&gt;
&lt;br /&gt;
###### CONFIG DE SIU-ARAI: REGISTRY ######&lt;br /&gt;
ARAI_REGISTRY_URL=http://registry.local.siu/arai-registry&lt;br /&gt;
ARAI_REGISTRY_USER=user&lt;br /&gt;
ARAI_REGISTRY_PASS=pass&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Una vez editado, verificamos que la configuración sea correcta&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/instalador proyecto:verificar&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
Si no sale ninguna alerta, procedemos a instalar.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
sudo ./bin/instalador proyecto:instalar&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
En Synfony es necesario dumpear los estilos y los JS con el siguiente comando.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/console assetic:dump --no-debug&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
Una vez instalado, modificamos los permisos de los archivos de la instalación con el comando&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
sudo ./bin/instalador permisos:simple&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Configuración apache ===&lt;br /&gt;
Lo mismo que con Registry o Usuarios, como tengo toda la plataforma instalada en un mismo servidor, debo usar el '''ServerName huarpe.local.siu'''.&lt;br /&gt;
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&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;VirtualHost *:80&amp;gt;&lt;br /&gt;
	ServerName huarpe.local.siu&lt;br /&gt;
	Redirect permanent / https://huarpe.local.siu:443/&lt;br /&gt;
&amp;lt;/VirtualHost&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;VirtualHost *:443&amp;gt;&lt;br /&gt;
&lt;br /&gt;
ServerName huarpe.local.siu&lt;br /&gt;
SSLEngine on&lt;br /&gt;
SSLCertificateFile /certs/huarpe.local.siu.cert.pem&lt;br /&gt;
SSLCertificateKeyFile /certs/huarpe.local.siu.key.pem&lt;br /&gt;
&lt;br /&gt;
Include /usr/local/siu/huarpe/app/config/alias.conf&lt;br /&gt;
&lt;br /&gt;
&amp;lt;/VirtualHost&amp;gt;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Reiniciamos apache, antes de verificar la instalación, debemos sincronizar con Registry.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/arai-cli registry:add --maintainer-email  jpiazza@siu.edu.ar --maintainer jpiazza http://registry.local.siu/arai-registry&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
Luego sincronizar&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/arai-cli registry:sync&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Hay que limpiar la cache y actualizar los permisos&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/console cache:clear --env=prod&lt;br /&gt;
sudo ./bin/instalador permisos:simple &lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
En Usuarios resincronizar para que se actualice con la nueva instalación&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
cd /usr/local/siu/usuarios&lt;br /&gt;
./bin/arai-cli registry:sync&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Para verificar que la instalación se realizo con éxito de debe ingresar en https://huarpe.local.siu/&lt;br /&gt;
&lt;br /&gt;
Si todo salio bien, tenemos instalada la plataforma ARAI lista para ser usada en nuestro servidor.&lt;/div&gt;</summary>
		<author><name>Ablanco</name></author>	</entry>

	<entry>
		<id>https://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Arai/ejemploPasoAPaso&amp;diff=27630</id>
		<title>SIU-Arai/ejemploPasoAPaso</title>
		<link rel="alternate" type="text/html" href="https://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Arai/ejemploPasoAPaso&amp;diff=27630"/>
				<updated>2017-08-03T14:24:28Z</updated>
		
		<summary type="html">&lt;p&gt;Ablanco: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;[[Archivo:siu-arai_iso.png|derecha|link=SIU-Arai]]&lt;br /&gt;
&lt;br /&gt;
= Ejemplo paso a paso =&lt;br /&gt;
&lt;br /&gt;
Para este caso voy a usar una instalación de Debian Jessie&lt;br /&gt;
&lt;br /&gt;
El objetivo es tener una instalación funcionando de la paltaforma SIU-Arai que luego sirva para integrar otros sistemas toba.&lt;br /&gt;
&lt;br /&gt;
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í&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable zebra&amp;quot;&lt;br /&gt;
!colspan=&amp;quot;2&amp;quot;|URLs&lt;br /&gt;
|-&lt;br /&gt;
|Araí-Registry&lt;br /&gt;
|http://registry.local.siu&lt;br /&gt;
|-&lt;br /&gt;
|Araí-Usuarios&lt;br /&gt;
|https://usuarios.local.siu&lt;br /&gt;
|-&lt;br /&gt;
|Araí-Huarpe&lt;br /&gt;
|https://huarpe.local.siu&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
== Creación de certificados ==&lt;br /&gt;
Hay que tener en cuenta que voy a usar conexión segura, por lo que tanto voy a necesitar certificados.&lt;br /&gt;
Para crear los certificados uso el tutorial que se encuentra en http://documentacion.siu.edu.ar/wiki/SIU-Arai/certificados. &lt;br /&gt;
Ese artículo asume &lt;br /&gt;
* Docker instalado (https://docs.docker.com/engine/installation/linux/docker-ce/debian/#install-using-the-repository). &lt;br /&gt;
* Docker Compose instalado (https://github.com/docker/compose/releases). &lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
git clone https://hub.siu.edu.ar/siu/instaladores.git dockerCerts&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Editamos el archivo docker-compose según nuestras necesidades.&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
cd dockerCerts/certs&lt;br /&gt;
nano docker-compose.yml&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
En mi caso quedo así:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt; &lt;br /&gt;
certificados:&lt;br /&gt;
  image: siutoba/docker-certs&lt;br /&gt;
  container_name: docker-certs&amp;lt;br/&amp;gt;&lt;br /&gt;
  #env_file: docker.env&amp;lt;br/&amp;gt;&lt;br /&gt;
  environment:&amp;lt;br/&amp;gt;&lt;br /&gt;
    DOCKER_NAME: certs&amp;lt;br/&amp;gt;&lt;br /&gt;
    CA_PWD: pass&amp;lt;br/&amp;gt;&lt;br /&gt;
    CA_INT_PWD: pass&amp;lt;br/&amp;gt;&lt;br /&gt;
    LISTA_SERVER: huarpe.local.siu usuarios.local.siu&amp;lt;br/&amp;gt;&lt;br /&gt;
    LISTA_CLIENTES: usuarios-cli huarpe-cli&amp;lt;br/&amp;gt;&lt;br /&gt;
  volumes:&amp;lt;br/&amp;gt;&lt;br /&gt;
    - ./data/certificados:/CAs/intermediate&amp;lt;br/&amp;gt;&lt;br /&gt;
    - ./data/root:/CAs/rootCA&amp;lt;br/&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Guardamos y generamos el container.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
docker-compose up&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Una vez generado el container copiamos los certificados creados en la carpeta que nos sea mas cómodo, en mi caso /certs&lt;br /&gt;
Sin cambiar de directorio hacemos:&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
sudo mkdir /certs&lt;br /&gt;
sudo find data -name &amp;quot;*.pem&amp;quot; -exec cp {} /certs \;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Luego generamos los certificados para el IDP:&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
mkdir /certs/idp&lt;br /&gt;
cd /certs/idp&lt;br /&gt;
openssl req -newkey rsa:2048 -new -x509 -days 3652 -nodes -out certificado_idp.crt -keyout certificado_idp.pem&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Listo, con las URL definidas y los certificados creados se puede proceder a instalar la plataforma.&lt;br /&gt;
&lt;br /&gt;
== Instalación Arai-Registy ==&lt;br /&gt;
Creamos la carpeta '''/usr/local/siu''' y no posicionamos ahí&lt;br /&gt;
Clonamos el proyecto &lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
git clone --branch v1.1.0 https://hub.siu.edu.ar/siu-arai/arai-registry.git registry&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
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.&lt;br /&gt;
&lt;br /&gt;
Dentro del directorio del proyecto encontramos el archivo &amp;quot;doc/INSTALACION MANUAL.md&amp;quot;, la idea es seguir las instrucciones que encontramos en este archivo.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
cd registry&lt;br /&gt;
composer install --no-dev&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
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.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
cp templates/arai-registry.env.dist arai-registry.env&lt;br /&gt;
nano arai-registry.env&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
'''arai-registry.env'''&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
# config de la aplicacion&lt;br /&gt;
ARAI_REGISTRY_ALIAS=&amp;quot;/arai-registry&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_USER=&amp;quot;user&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_PASS=&amp;quot;pass&amp;quot;&lt;br /&gt;
&lt;br /&gt;
# config de la base de datos&lt;br /&gt;
ARAI_REGISTRY_DB_HOST=&amp;quot;172.27.31.114&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_DB_PORT=&amp;quot;7432&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_DB_DBNAME=&amp;quot;siu_registry&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_DB_USERNAME=&amp;quot;postgres&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_DB_PASSWORD=&amp;quot;postgres&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_DB_SCHEMA=&amp;quot;registry&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_DB_ENCODING=&amp;quot;UTF8&amp;quot;&lt;br /&gt;
&lt;br /&gt;
###### CONFIG DE LOGS ######&lt;br /&gt;
ARAI_REGISTRY_LOG_HANDLER=&amp;quot;errorlog&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_LOG_LEVEL=&amp;quot;DEBUG&amp;quot;&lt;br /&gt;
&lt;br /&gt;
# config del instalador&lt;br /&gt;
INSTALADOR_TIMEOUT=&amp;quot;360&amp;quot;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Una vez editado, verificamos que la configuración sea correcta&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/instalador proyecto:verificar&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Si no sale ninguna alerta, procedemos a instalar.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/instalador proyecto:instalar&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
Una vez instalado, modificamos los permisos de los archivos de la instalación con el comando&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
sudo ./bin/instalador permisos:simple&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Luego configuramos apache.&lt;br /&gt;
En mi caso, como tengo toda la plataforma instalada en un mismo servidor, debo usar el '''ServerName &amp;quot;registry.local.siu&amp;quot;'''&lt;br /&gt;
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'''&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;VirtualHost *:80&amp;gt;&lt;br /&gt;
ServerName registry.local.siu&lt;br /&gt;
Include /usr/local/siu/registry/config/alias.conf&lt;br /&gt;
&amp;lt;/VirtualHost&amp;gt;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Con todo esto, para verificar que todo funcione reiniciamos Apache y ejecutamos&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
curl --user registry:registry http://registry.local.siu/arai-registry/rest/packages/1&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Si la salida es:&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
{&lt;br /&gt;
    &amp;quot;error&amp;quot;: 404,&lt;br /&gt;
    &amp;quot;mensaje&amp;quot;: &amp;quot;404 Not Found&amp;quot;,&lt;br /&gt;
    &amp;quot;descripcion&amp;quot;: &amp;quot;El paquete solicitado no existe&amp;quot;&lt;br /&gt;
}&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
es que la instalación funcionó correctamente.&lt;br /&gt;
&lt;br /&gt;
Con registry instalado procedemos a instalar Usuarios&lt;br /&gt;
&lt;br /&gt;
==Arai-Usuarios==&lt;br /&gt;
&lt;br /&gt;
Nos posicionamos en /usr/local/siu y clonamos el proyecto&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
cd /usr/local/siu&lt;br /&gt;
git clone --branch v1.2.0 https://hub.siu.edu.ar/siu-arai/arai-usuarios.git usuarios&lt;br /&gt;
cd usuarios&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Para instalar seguimos la documentación del archivo '''doc/INSTALACION_MANUAL.md'''&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
composer install --no-dev&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
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.&lt;br /&gt;
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.&lt;br /&gt;
La variable TOBA_USUARIO debe contener el mismo usuarios administrado del LDAP.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
cp templates/arai-usuarios.env.dist arai-usuarios.env&lt;br /&gt;
nano arai-usuarios.env&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
'''arai-usuarios.env.dist'''&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
###### CONFIG DEL INSTALADR ######&lt;br /&gt;
#INSTALADOR_TIMEOUT=&amp;quot;360&amp;quot;&lt;br /&gt;
ENTORNO_PRODUCCION=&amp;quot;1&amp;quot;&lt;br /&gt;
&lt;br /&gt;
###### VARIABLES GLOBALES DEL ARCHIVO ######&lt;br /&gt;
ARAI_USUARIOS_DIR=/usr/local/siu/usuarios&lt;br /&gt;
&lt;br /&gt;
###### CONFIG DE TOBA ######&lt;br /&gt;
TOBA_URL_BASE=&amp;quot;https://usuarios.local.siu&amp;quot;&lt;br /&gt;
#TOBA_URL_PORT=&amp;quot;443&amp;quot;&lt;br /&gt;
TOBA_USUARIO=&amp;quot;admin&amp;quot;&lt;br /&gt;
TOBA_PASSWORD=&amp;quot;admin1234&amp;quot;&lt;br /&gt;
TOBA_INSTALACION_DIR=&amp;quot;${ARAI_USUARIOS_DIR}/instalacion&amp;quot;&lt;br /&gt;
TOBA_PROYECTO_DIR=&amp;quot;${ARAI_USUARIOS_DIR}/gestion&amp;quot;&lt;br /&gt;
TOBA_INSTALAR_USUARIOS=false&lt;br /&gt;
TOBA_INSTALAR_EDITOR=false&lt;br /&gt;
TOBA_INSTALAR_REFERENCIA=false&lt;br /&gt;
TOBA_ALIAS_PROYECTO=&amp;quot;/gestion&amp;quot;&lt;br /&gt;
TOBA_ALIAS_NUCLEO=&amp;quot;/toba_gestion&amp;quot;&lt;br /&gt;
#TOBA_ID_DESARROLLADOR=0&lt;br /&gt;
#TOBA_SESSION_NAME=&amp;quot;ARAI_SESSID&amp;quot;&lt;br /&gt;
&lt;br /&gt;
###### CONFIG DE BASE DE DATOS DE NEGOCIO ######&lt;br /&gt;
PROYECTO_DB_HOST=&amp;quot;172.27.31.114&amp;quot;&lt;br /&gt;
PROYECTO_DB_PORT=&amp;quot;7432&amp;quot;&lt;br /&gt;
PROYECTO_DB_DBNAME=&amp;quot;siu_usuarios&amp;quot;&lt;br /&gt;
PROYECTO_DB_USERNAME=&amp;quot;postgres&amp;quot;&lt;br /&gt;
PROYECTO_DB_PASSWORD=&amp;quot;postgres&amp;quot;&lt;br /&gt;
PROYECTO_DB_SCHEMA=&amp;quot;usuarios&amp;quot;&lt;br /&gt;
PROYECTO_DB_ENCODING=&amp;quot;LATIN1&amp;quot;&lt;br /&gt;
&lt;br /&gt;
###### CONFIG DE BASE DE DATOS DE TOBA. #####&lt;br /&gt;
######## DEFINIR SI SE QUIERE UTILIZAR UNA BASE DISTINTA A LA DE NEGOCIO&lt;br /&gt;
#TOBA_DB_HOST=&amp;quot;localhost&amp;quot;&lt;br /&gt;
#TOBA_DB_PORT=&amp;quot;5432&amp;quot;&lt;br /&gt;
#TOBA_DB_DBNAME=&amp;quot;instalador&amp;quot;&lt;br /&gt;
#TOBA_DB_USERNAME=&amp;quot;postgres&amp;quot;&lt;br /&gt;
#TOBA_DB_PASSWORD=&amp;quot;postgres&amp;quot;&lt;br /&gt;
#TOBA_DB_SCHEMA=&amp;quot;public&amp;quot;&lt;br /&gt;
&lt;br /&gt;
##### CONFIG IDM #####&lt;br /&gt;
ARAI_USUARIOS_URL_IDP=https://usuarios.local.siu/idp&lt;br /&gt;
## Deberá setearse si el sistema corre detrás de un proxy reverso&lt;br /&gt;
#ARAI_USUARIOS_PROXY_URL_IDP=http://url.arai-usuarios:80/idp&lt;br /&gt;
ARAI_USUARIOS_URL_PORTAL=https://huarpe.local.siu/portal&lt;br /&gt;
ARAI_USUARIOS_URL_PERFIL=https://huarpe.local.siu/perfil&lt;br /&gt;
ARAI_USUARIOS_URL_INSTITUCION=http://siu.edu.ar&lt;br /&gt;
&lt;br /&gt;
ARAI_USUARIOS_SIGLA_INSTITUCION=SIGLA&lt;br /&gt;
ARAI_USUARIOS_EMAIL_SOPORTE=mail.soporte@institucion.edu.ar&lt;br /&gt;
&lt;br /&gt;
##### CONFIG SEGURIDAD ####&lt;br /&gt;
SEGURIDAD_ALGORITMO_PASS=crypt&lt;br /&gt;
SEGURIDAD_LARGO_PASS=8&lt;br /&gt;
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'&lt;br /&gt;
SEGURIDAD_DURACION_DIAS_PASS=120&lt;br /&gt;
SEGURIDAD_RECAPTCHA_SITIO=6Fd_pQwTAAAAAOEqJz6KJmkjsrXcdXrAjWQYggZf&lt;br /&gt;
SEGURIDAD_RECAPTCHA_CLAVE=6Fd_pQwTAAAAAOEqJz6KJmkjsrXcdXrAjWQYggZf&lt;br /&gt;
SEGURIDAD_INTENTOS_RECAPTCHA=3&lt;br /&gt;
&lt;br /&gt;
##### CONFIG IDP #####&lt;br /&gt;
ARAI_USUARIOS_IDP_KEY_FILE=/certs/idp/certificado_idp.pem&lt;br /&gt;
ARAI_USUARIOS_IDP_CERT_FILE=/certs/idp/certificado_idp.crt&lt;br /&gt;
#ARAI_USUARIOS_IDP_LOG_LEVEL='WARNING'&lt;br /&gt;
#ARAI_USUARIOS_IDP_LOG_HANDLER='errorlog'&lt;br /&gt;
&lt;br /&gt;
##### CONFIG MAIL RECOVERY ####&lt;br /&gt;
MAIL_RECOVERY_SUBJECT='Recuperar contraseña SIU-Arai'&lt;br /&gt;
MAIL_RECOVERY_FROM='noreply@institucion.edu.ar'&lt;br /&gt;
MAIL_RECOVERY_REPLYTO='noreply@institucion.edu.ar'&lt;br /&gt;
MAIL_RECOVERY_FROMNAME='Institución'&lt;br /&gt;
&lt;br /&gt;
##### CONFIG LDAP #####&lt;br /&gt;
ARAI_USUARIOS_LDAP_HOST=172.27.31.114&lt;br /&gt;
ARAI_USUARIOS_LDAP_PORT=7389&lt;br /&gt;
ARAI_USUARIOS_LDAP_TLS=0&lt;br /&gt;
ARAI_USUARIOS_LDAP_METHOD=user&lt;br /&gt;
ARAI_USUARIOS_LDAP_BINDUSER=&amp;quot;cn=admin,dc=siu,dc=cin,dc=edu&amp;quot;&lt;br /&gt;
ARAI_USUARIOS_LDAP_BINDPASS=admin&lt;br /&gt;
ARAI_USUARIOS_LDAP_SEARCHBASE=&amp;quot;dc=siu,dc=cin,dc=edu&amp;quot;&lt;br /&gt;
&lt;br /&gt;
##### CONFIG ARAI-REGISTRY #####&lt;br /&gt;
ARAI_REGISTRY_URL=http://registry.local.siu/arai-registry&lt;br /&gt;
ARAI_REGISTRY_USER=user&lt;br /&gt;
ARAI_REGISTRY_PASS=pass&lt;br /&gt;
&lt;br /&gt;
###### CONFIG ENVIO MAILS (SMTP) ######&lt;br /&gt;
SMTP_ENTRADA=&amp;quot;arai-usuarios&amp;quot;&lt;br /&gt;
SMTP_HELO=&amp;quot;mail.unx.edu.ar&amp;quot;&lt;br /&gt;
SMTP_HOST=&amp;quot;smtp.googlemail.com&amp;quot;&lt;br /&gt;
SMTP_PORT=587&lt;br /&gt;
SMTP_FROM =&amp;quot;yo@midominio.com&amp;quot;&lt;br /&gt;
SMTP_SEGURIDAD =&amp;quot;ssl|tls&amp;quot;&lt;br /&gt;
SMTP_AUTH =&amp;quot;1&amp;quot;&lt;br /&gt;
SMTP_USUARIO =&amp;quot;usuario&amp;quot;&lt;br /&gt;
SMTP_CLAVE =&amp;quot;pass&amp;quot;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Una vez editado, verificamos que la configuración sea correcta&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/instalador proyecto:verificar -n&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Si no sale ninguna alerta, procedemos a instalar.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/instalador proyecto:instalar&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
Una vez instalado, modificamos los permisos de los archivos de la instalación con el comando&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
sudo ./bin/instalador permisos:simple&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
Cambiamos el modo mantenimiento&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/instalador instalacion:modo-mantenimiento --sin-mantenimiento -n&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Luego configuramos Apache.&lt;br /&gt;
Lo mismo que con registry, como tengo toda la plataforma instalada en un mismo servidor, debo usar el '''ServerName &amp;quot;usuarios.local.siu&amp;quot;'''&lt;br /&gt;
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'''&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;VirtualHost *:80&amp;gt;&lt;br /&gt;
    ServerName usuarios.local.siu&lt;br /&gt;
    Redirect permanent / https://usuarios.local.siu/&lt;br /&gt;
&amp;lt;/VirtualHost&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;VirtualHost *:443&amp;gt;&lt;br /&gt;
&lt;br /&gt;
ServerName usuarios.local.siu&lt;br /&gt;
&lt;br /&gt;
SSLEngine on&lt;br /&gt;
SSLCertificateFile /certs/usuarios.local.siu.cert.pem&lt;br /&gt;
SSLCertificateKeyFile /certs/usuarios.local.siu.key.pem&lt;br /&gt;
&lt;br /&gt;
SSLCACertificateFile /certs/ca-chain.cert.pem&lt;br /&gt;
&lt;br /&gt;
SSLVerifyClient optional_no_ca&lt;br /&gt;
SSLVerifyDepth 2&lt;br /&gt;
SSLProtocol all -SSLv2 -SSLv3&lt;br /&gt;
SSLOptions +StdEnvVars +ExportCertData&lt;br /&gt;
BrowserMatch &amp;quot;MSIE [2-6]&amp;quot; \&lt;br /&gt;
        nokeepalive ssl-unclean-shutdown \&lt;br /&gt;
        downgrade-1.0 force-response-1.0&lt;br /&gt;
        # MSIE 7 and newer should be able to use keepalive&lt;br /&gt;
BrowserMatch &amp;quot;MSIE [17-9]&amp;quot; ssl-unclean-shutdown&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Include /usr/local/siu/usuarios/instalacion/toba.conf&lt;br /&gt;
&lt;br /&gt;
Include /usr/local/siu/usuarios/instalacion/idp.conf&lt;br /&gt;
&lt;br /&gt;
&amp;lt;/VirtualHost&amp;gt;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Luego hay que hacer que nuestra CA autofirmada sea válida en el SO y así permitir que Apache verifique los certificados de clientes:&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
sudo cp /certs/ca.cert.pem /usr/share/ca-certificates/ca_propia.crt&lt;br /&gt;
sudo vim /etc/ca-certificates.conf&lt;br /&gt;
# agregar ca_propia.crt al final del archivo&lt;br /&gt;
update-ca-certificates --fresh&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Reiniciamos Apache y todo debería funcionar, para verificar entramos en la URL definida para usuarios, en mi caso https://usuarios.local.siu/gestion&lt;br /&gt;
&lt;br /&gt;
Con todo esto funcionando el siguiente paso es agregar Usuarios a Registry y sincronizarlos. &lt;br /&gt;
Según esta instalación para agregar Usuarios al entorno hacemos&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/arai-cli registry:add --maintainer-email  jpiazza@siu.edu.ar --maintainer jpiazza http://registry.local.siu/arai-registry&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
y para sincronizarlo&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/arai-cli registry:sync&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== Arai-Huarpe ==&lt;br /&gt;
&lt;br /&gt;
Es similar a las instalaciones anteriores.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
cd /usr/local/siu&lt;br /&gt;
git clone --branch v1.1.0 https://hub.siu.edu.ar/siu-arai/huarpe-core.git huarpe&lt;br /&gt;
cd huarpe&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Para instalar seguimos la documentación del archivo '''doc/INSTALACION_MANUAL.md'''&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
composer install --no-dev&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
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.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
cp templates/huarpe.env.dist huarpe.env&lt;br /&gt;
nano huarpe.env&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
'''huarpe.env'''&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
###### CONFIG DEL INSTALADR ######&lt;br /&gt;
#INSTALADOR_TIMEOUT=&amp;quot;360&amp;quot;&lt;br /&gt;
ENTORNO_PRODUCCION=1&lt;br /&gt;
&lt;br /&gt;
###### CONFIG DE SIU-HUARPE ######&lt;br /&gt;
HUARPE_PATH=/usr/local/siu/huarpe&lt;br /&gt;
HUARPE_URL=https://huarpe.local.siu&lt;br /&gt;
HUARPE_URL_PORT=443&lt;br /&gt;
HUARPE_SESSION_NAME=huarpe&lt;br /&gt;
HUARPE_SESSION_HANDLER=&amp;quot;native_file&amp;quot;&lt;br /&gt;
#HUARPE_MEMCACHED_HOST=127.0.0.1&lt;br /&gt;
#HUARPE_MEMCACHED_PORT=11211&lt;br /&gt;
HUARPE_CERT_FILE=/certs/huarpe-cli.cert.pem&lt;br /&gt;
HUARPE_KEY_FILE=/certs/huarpe-cli.key.pem&lt;br /&gt;
#HUARPE_TOKEN=unt0k3n-al3at0r1o-s39ur0?&lt;br /&gt;
#HUARPE_PROXY=127.0.0.1&lt;br /&gt;
HUARPE_LOG_HANDLER=&amp;quot;error_log&amp;quot;&lt;br /&gt;
HUARPE_LOG_LEVEL=&amp;quot;DEBUG&amp;quot;&lt;br /&gt;
&lt;br /&gt;
###### CONFIG DE SIU-ARAI: REGISTRY ######&lt;br /&gt;
ARAI_REGISTRY_URL=http://registry.local.siu/arai-registry&lt;br /&gt;
ARAI_REGISTRY_USER=user&lt;br /&gt;
ARAI_REGISTRY_PASS=pass&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Una vez editado, verificamos que la configuración sea correcta&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/instalador proyecto:verificar&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
Si no sale ninguna alerta, procedemos a instalar.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
sudo ./bin/instalador proyecto:instalar&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
En Synfony es necesario dumpear los estilos y los JS con el siguiente comando.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/console assetic:dump --no-debug&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
Una vez instalado, modificamos los permisos de los archivos de la instalación con el comando&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
sudo ./bin/instalador permisos:simple&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Configuración apache ===&lt;br /&gt;
Lo mismo que con Registry o Usuarios, como tengo toda la plataforma instalada en un mismo servidor, debo usar el '''ServerName huarpe.local.siu'''.&lt;br /&gt;
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&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;VirtualHost *:80&amp;gt;&lt;br /&gt;
	ServerName huarpe.local.siu&lt;br /&gt;
	Redirect permanent / https://huarpe.local.siu:443/&lt;br /&gt;
&amp;lt;/VirtualHost&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;VirtualHost *:443&amp;gt;&lt;br /&gt;
&lt;br /&gt;
ServerName huarpe.local.siu&lt;br /&gt;
SSLEngine on&lt;br /&gt;
SSLCertificateFile /certs/huarpe.local.siu.cert.pem&lt;br /&gt;
SSLCertificateKeyFile /certs/huarpe.local.siu.key.pem&lt;br /&gt;
&lt;br /&gt;
Include /usr/local/siu/huarpe/app/config/alias.conf&lt;br /&gt;
&lt;br /&gt;
&amp;lt;/VirtualHost&amp;gt;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Reiniciamos apache, antes de verificar la instalación, debemos sincronizar con Registry.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/arai-cli registry:add --maintainer-email  jpiazza@siu.edu.ar --maintainer jpiazza http://registry.local.siu/arai-registry&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
Luego sincronizar&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/arai-cli registry:sync&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Hay que limpiar la cache y actualizar los permisos&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/console cache:clear --env=prod&lt;br /&gt;
sudo ./bin/instalador permisos:simple &lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
En Usuarios resincronizar para que se actualice con la nueva instalación&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
cd /usr/local/siu/usuarios&lt;br /&gt;
./bin/arai-cli registry:sync&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Para verificar que la instalación se realizo con éxito de debe ingresar en https://huarpe.local.siu/&lt;br /&gt;
&lt;br /&gt;
Si todo salio bien, tenemos instalada la plataforma ARAI lista para ser usada en nuestro servidor.&lt;/div&gt;</summary>
		<author><name>Ablanco</name></author>	</entry>

	<entry>
		<id>https://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Arai/ejemploPasoAPaso&amp;diff=27612</id>
		<title>SIU-Arai/ejemploPasoAPaso</title>
		<link rel="alternate" type="text/html" href="https://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Arai/ejemploPasoAPaso&amp;diff=27612"/>
				<updated>2017-08-02T19:37:42Z</updated>
		
		<summary type="html">&lt;p&gt;Ablanco: /* Instalación Arai-Registy */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;= Ejemplo paso a paso =&lt;br /&gt;
&lt;br /&gt;
Para este caso voy a usar una instalación de Debian Jessie&lt;br /&gt;
&lt;br /&gt;
El objetivo es tener una instalación funcionando de la paltaforma SIU-Arai que luego sirva para integrar otros sistemas toba.&lt;br /&gt;
&lt;br /&gt;
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í&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable zebra&amp;quot;&lt;br /&gt;
!colspan=&amp;quot;2&amp;quot;|URLs&lt;br /&gt;
|-&lt;br /&gt;
|Araí-Registry&lt;br /&gt;
|http://registry.local.siu&lt;br /&gt;
|-&lt;br /&gt;
|Araí-Usuarios&lt;br /&gt;
|https://usuarios.local.siu&lt;br /&gt;
|-&lt;br /&gt;
|Araí-Huarpe&lt;br /&gt;
|https://huarpe.local.siu&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
== Creación de certificados ==&lt;br /&gt;
Hay que tener en cuenta que voy a usar conexión segura, por lo que tanto voy a necesitar certificados.&lt;br /&gt;
Para crear los certificados uso el tutorial que se encuentra en http://documentacion.siu.edu.ar/wiki/SIU-Arai/certificados. &lt;br /&gt;
Ese artículo asume &lt;br /&gt;
* Docker instalado (https://docs.docker.com/engine/installation/linux/docker-ce/debian/#install-using-the-repository). &lt;br /&gt;
* Docker Compose instalado (https://github.com/docker/compose/releases). &lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
git clone https://hub.siu.edu.ar/siu/instaladores.git dockerCerts&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Editamos el archivo docker-compose según nuestras necesidades.&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
cd dockerCerts/certs&lt;br /&gt;
nano docker-compose.yml&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
En mi caso quedo así:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt; &lt;br /&gt;
certificados:&lt;br /&gt;
  image: siutoba/docker-certs&lt;br /&gt;
  container_name: docker-certs&amp;lt;br/&amp;gt;&lt;br /&gt;
  #env_file: docker.env&amp;lt;br/&amp;gt;&lt;br /&gt;
  environment:&amp;lt;br/&amp;gt;&lt;br /&gt;
    DOCKER_NAME: certs&amp;lt;br/&amp;gt;&lt;br /&gt;
    CA_PWD: pass&amp;lt;br/&amp;gt;&lt;br /&gt;
    CA_INT_PWD: pass&amp;lt;br/&amp;gt;&lt;br /&gt;
    LISTA_SERVER: huarpe.local.siu usuarios.local.siu&amp;lt;br/&amp;gt;&lt;br /&gt;
    LISTA_CLIENTES: usuarios-cli huarpe-cli&amp;lt;br/&amp;gt;&lt;br /&gt;
  volumes:&amp;lt;br/&amp;gt;&lt;br /&gt;
    - ./data/certificados:/CAs/intermediate&amp;lt;br/&amp;gt;&lt;br /&gt;
    - ./data/root:/CAs/rootCA&amp;lt;br/&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Guardamos y generamos el container.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
docker-compose up&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Una vez generado el container copiamos los certificados creados en la carpeta que nos sea mas cómodo, en mi caso /certs&lt;br /&gt;
Sin cambiar de directorio hacemos:&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
sudo mkdir /certs&lt;br /&gt;
sudo find data -name &amp;quot;*.pem&amp;quot; -exec cp {} /certs \;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Luego generamos los certificados para el IDP:&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
mkdir /certs/idp&lt;br /&gt;
cd /certs/idp&lt;br /&gt;
openssl req -newkey rsa:2048 -new -x509 -days 3652 -nodes -out certificado_idp.crt -keyout certificado_idp.pem&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Listo, con las URL definidas y los certificados creados se puede proceder a instalar la plataforma.&lt;br /&gt;
&lt;br /&gt;
== Instalación Arai-Registy ==&lt;br /&gt;
Creamos la carpeta '''/usr/local/siu''' y no posicionamos ahí&lt;br /&gt;
Clonamos el proyecto &lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
git clone --branch v1.1.0 https://hub.siu.edu.ar/siu-arai/arai-registry.git registry&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
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.&lt;br /&gt;
&lt;br /&gt;
Dentro del directorio del proyecto encontramos el archivo &amp;quot;doc/INSTALACION MANUAL.md&amp;quot;, la idea es seguir las instrucciones que encontramos en este archivo.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
cd registry&lt;br /&gt;
composer install --no-dev&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
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.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
cp templates/arai-registry.env.dist arai-registry.env&lt;br /&gt;
nano arai-registry.env&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
'''arai-registry.env'''&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
# config de la aplicacion&lt;br /&gt;
ARAI_REGISTRY_ALIAS=&amp;quot;/arai-registry&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_USER=&amp;quot;user&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_PASS=&amp;quot;pass&amp;quot;&lt;br /&gt;
&lt;br /&gt;
# config de la base de datos&lt;br /&gt;
ARAI_REGISTRY_DB_HOST=&amp;quot;172.27.31.114&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_DB_PORT=&amp;quot;7432&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_DB_DBNAME=&amp;quot;siu_registry&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_DB_USERNAME=&amp;quot;postgres&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_DB_PASSWORD=&amp;quot;postgres&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_DB_SCHEMA=&amp;quot;registry&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_DB_ENCODING=&amp;quot;UTF8&amp;quot;&lt;br /&gt;
&lt;br /&gt;
###### CONFIG DE LOGS ######&lt;br /&gt;
ARAI_REGISTRY_LOG_HANDLER=&amp;quot;errorlog&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_LOG_LEVEL=&amp;quot;DEBUG&amp;quot;&lt;br /&gt;
&lt;br /&gt;
# config del instalador&lt;br /&gt;
INSTALADOR_TIMEOUT=&amp;quot;360&amp;quot;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Una vez editado, verificamos que la configuración sea correcta&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/instalador proyecto:verificar&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Si no sale ninguna alerta, procedemos a instalar.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/instalador proyecto:instalar&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
Una vez instalado, modificamos los permisos de los archivos de la instalación con el comando&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
sudo ./bin/instalador permisos:simple&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Luego configuramos apache.&lt;br /&gt;
En mi caso, como tengo toda la plataforma instalada en un mismo servidor, debo usar el '''ServerName &amp;quot;registry.local.siu&amp;quot;'''&lt;br /&gt;
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'''&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;VirtualHost *:80&amp;gt;&lt;br /&gt;
ServerName registry.local.siu&lt;br /&gt;
Include /usr/local/siu/registry/config/alias.conf&lt;br /&gt;
&amp;lt;/VirtualHost&amp;gt;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Con todo esto, para verificar que todo funcione reiniciamos Apache y ejecutamos&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
curl --user registry:registry http://registry.local.siu/arai-registry/rest/packages/1&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Si la salida es:&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
{&lt;br /&gt;
    &amp;quot;error&amp;quot;: 404,&lt;br /&gt;
    &amp;quot;mensaje&amp;quot;: &amp;quot;404 Not Found&amp;quot;,&lt;br /&gt;
    &amp;quot;descripcion&amp;quot;: &amp;quot;El paquete solicitado no existe&amp;quot;&lt;br /&gt;
}&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
es que la instalación funcionó correctamente.&lt;br /&gt;
&lt;br /&gt;
Con registry instalado procedemos a instalar Usuarios&lt;br /&gt;
&lt;br /&gt;
==Arai-Usuarios==&lt;br /&gt;
&lt;br /&gt;
Nos posicionamos en /usr/local/siu y clonamos el proyecto&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
cd /usr/local/siu&lt;br /&gt;
git clone --branch v1.2.0 https://hub.siu.edu.ar/siu-arai/arai-usuarios.git usuarios&lt;br /&gt;
cd usuarios&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Para instalar seguimos la documentación del archivo '''doc/INSTALACION_MANUAL.md'''&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
composer install --no-dev&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
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.&lt;br /&gt;
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.&lt;br /&gt;
La variable TOBA_USUARIO debe contener el mismo usuarios administrado del LDAP.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
cp templates/arai-usuarios.env.dist arai-usuarios.env&lt;br /&gt;
nano arai-usuarios.env&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
'''arai-usuarios.env.dist'''&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
###### CONFIG DEL INSTALADR ######&lt;br /&gt;
#INSTALADOR_TIMEOUT=&amp;quot;360&amp;quot;&lt;br /&gt;
ENTORNO_PRODUCCION=&amp;quot;1&amp;quot;&lt;br /&gt;
&lt;br /&gt;
###### VARIABLES GLOBALES DEL ARCHIVO ######&lt;br /&gt;
ARAI_USUARIOS_DIR=/usr/local/siu/usuarios&lt;br /&gt;
&lt;br /&gt;
###### CONFIG DE TOBA ######&lt;br /&gt;
TOBA_URL_BASE=&amp;quot;https://usuarios.local.siu&amp;quot;&lt;br /&gt;
#TOBA_URL_PORT=&amp;quot;443&amp;quot;&lt;br /&gt;
TOBA_USUARIO=&amp;quot;admin&amp;quot;&lt;br /&gt;
TOBA_PASSWORD=&amp;quot;admin1234&amp;quot;&lt;br /&gt;
TOBA_INSTALACION_DIR=&amp;quot;${ARAI_USUARIOS_DIR}/instalacion&amp;quot;&lt;br /&gt;
TOBA_PROYECTO_DIR=&amp;quot;${ARAI_USUARIOS_DIR}/gestion&amp;quot;&lt;br /&gt;
TOBA_INSTALAR_USUARIOS=false&lt;br /&gt;
TOBA_INSTALAR_EDITOR=false&lt;br /&gt;
TOBA_INSTALAR_REFERENCIA=false&lt;br /&gt;
TOBA_ALIAS_PROYECTO=&amp;quot;/gestion&amp;quot;&lt;br /&gt;
TOBA_ALIAS_NUCLEO=&amp;quot;/toba_gestion&amp;quot;&lt;br /&gt;
#TOBA_ID_DESARROLLADOR=0&lt;br /&gt;
#TOBA_SESSION_NAME=&amp;quot;ARAI_SESSID&amp;quot;&lt;br /&gt;
&lt;br /&gt;
###### CONFIG DE BASE DE DATOS DE NEGOCIO ######&lt;br /&gt;
PROYECTO_DB_HOST=&amp;quot;172.27.31.114&amp;quot;&lt;br /&gt;
PROYECTO_DB_PORT=&amp;quot;7432&amp;quot;&lt;br /&gt;
PROYECTO_DB_DBNAME=&amp;quot;siu_usuarios&amp;quot;&lt;br /&gt;
PROYECTO_DB_USERNAME=&amp;quot;postgres&amp;quot;&lt;br /&gt;
PROYECTO_DB_PASSWORD=&amp;quot;postgres&amp;quot;&lt;br /&gt;
PROYECTO_DB_SCHEMA=&amp;quot;usuarios&amp;quot;&lt;br /&gt;
PROYECTO_DB_ENCODING=&amp;quot;LATIN1&amp;quot;&lt;br /&gt;
&lt;br /&gt;
###### CONFIG DE BASE DE DATOS DE TOBA. #####&lt;br /&gt;
######## DEFINIR SI SE QUIERE UTILIZAR UNA BASE DISTINTA A LA DE NEGOCIO&lt;br /&gt;
#TOBA_DB_HOST=&amp;quot;localhost&amp;quot;&lt;br /&gt;
#TOBA_DB_PORT=&amp;quot;5432&amp;quot;&lt;br /&gt;
#TOBA_DB_DBNAME=&amp;quot;instalador&amp;quot;&lt;br /&gt;
#TOBA_DB_USERNAME=&amp;quot;postgres&amp;quot;&lt;br /&gt;
#TOBA_DB_PASSWORD=&amp;quot;postgres&amp;quot;&lt;br /&gt;
#TOBA_DB_SCHEMA=&amp;quot;public&amp;quot;&lt;br /&gt;
&lt;br /&gt;
##### CONFIG IDM #####&lt;br /&gt;
ARAI_USUARIOS_URL_IDP=https://usuarios.local.siu/idp&lt;br /&gt;
## Deberá setearse si el sistema corre detrás de un proxy reverso&lt;br /&gt;
#ARAI_USUARIOS_PROXY_URL_IDP=http://url.arai-usuarios:80/idp&lt;br /&gt;
ARAI_USUARIOS_URL_PORTAL=https://huarpe.local.siu/portal&lt;br /&gt;
ARAI_USUARIOS_URL_PERFIL=https://huarpe.local.siu/perfil&lt;br /&gt;
ARAI_USUARIOS_URL_INSTITUCION=http://siu.edu.ar&lt;br /&gt;
&lt;br /&gt;
ARAI_USUARIOS_SIGLA_INSTITUCION=SIGLA&lt;br /&gt;
ARAI_USUARIOS_EMAIL_SOPORTE=mail.soporte@institucion.edu.ar&lt;br /&gt;
&lt;br /&gt;
##### CONFIG SEGURIDAD ####&lt;br /&gt;
SEGURIDAD_ALGORITMO_PASS=crypt&lt;br /&gt;
SEGURIDAD_LARGO_PASS=8&lt;br /&gt;
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'&lt;br /&gt;
SEGURIDAD_DURACION_DIAS_PASS=120&lt;br /&gt;
SEGURIDAD_RECAPTCHA_SITIO=6Fd_pQwTAAAAAOEqJz6KJmkjsrXcdXrAjWQYggZf&lt;br /&gt;
SEGURIDAD_RECAPTCHA_CLAVE=6Fd_pQwTAAAAAOEqJz6KJmkjsrXcdXrAjWQYggZf&lt;br /&gt;
SEGURIDAD_INTENTOS_RECAPTCHA=3&lt;br /&gt;
&lt;br /&gt;
##### CONFIG IDP #####&lt;br /&gt;
ARAI_USUARIOS_IDP_KEY_FILE=/certs/idp/certificado_idp.pem&lt;br /&gt;
ARAI_USUARIOS_IDP_CERT_FILE=/certs/idp/certificado_idp.crt&lt;br /&gt;
#ARAI_USUARIOS_IDP_LOG_LEVEL='WARNING'&lt;br /&gt;
#ARAI_USUARIOS_IDP_LOG_HANDLER='errorlog'&lt;br /&gt;
&lt;br /&gt;
##### CONFIG MAIL RECOVERY ####&lt;br /&gt;
MAIL_RECOVERY_SUBJECT='Recuperar contraseña SIU-Arai'&lt;br /&gt;
MAIL_RECOVERY_FROM='noreply@institucion.edu.ar'&lt;br /&gt;
MAIL_RECOVERY_REPLYTO='noreply@institucion.edu.ar'&lt;br /&gt;
MAIL_RECOVERY_FROMNAME='Institución'&lt;br /&gt;
&lt;br /&gt;
##### CONFIG LDAP #####&lt;br /&gt;
ARAI_USUARIOS_LDAP_HOST=172.27.31.114&lt;br /&gt;
ARAI_USUARIOS_LDAP_PORT=7389&lt;br /&gt;
ARAI_USUARIOS_LDAP_TLS=0&lt;br /&gt;
ARAI_USUARIOS_LDAP_METHOD=user&lt;br /&gt;
ARAI_USUARIOS_LDAP_BINDUSER=&amp;quot;cn=admin,dc=siu,dc=cin,dc=edu&amp;quot;&lt;br /&gt;
ARAI_USUARIOS_LDAP_BINDPASS=admin&lt;br /&gt;
ARAI_USUARIOS_LDAP_SEARCHBASE=&amp;quot;dc=siu,dc=cin,dc=edu&amp;quot;&lt;br /&gt;
&lt;br /&gt;
##### CONFIG ARAI-REGISTRY #####&lt;br /&gt;
ARAI_REGISTRY_URL=http://registry.local.siu/arai-registry&lt;br /&gt;
ARAI_REGISTRY_USER=user&lt;br /&gt;
ARAI_REGISTRY_PASS=pass&lt;br /&gt;
&lt;br /&gt;
###### CONFIG ENVIO MAILS (SMTP) ######&lt;br /&gt;
SMTP_ENTRADA=&amp;quot;arai-usuarios&amp;quot;&lt;br /&gt;
SMTP_HELO=&amp;quot;mail.unx.edu.ar&amp;quot;&lt;br /&gt;
SMTP_HOST=&amp;quot;smtp.googlemail.com&amp;quot;&lt;br /&gt;
SMTP_PORT=587&lt;br /&gt;
SMTP_FROM =&amp;quot;yo@midominio.com&amp;quot;&lt;br /&gt;
SMTP_SEGURIDAD =&amp;quot;ssl|tls&amp;quot;&lt;br /&gt;
SMTP_AUTH =&amp;quot;1&amp;quot;&lt;br /&gt;
SMTP_USUARIO =&amp;quot;usuario&amp;quot;&lt;br /&gt;
SMTP_CLAVE =&amp;quot;pass&amp;quot;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Una vez editado, verificamos que la configuración sea correcta&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/instalador proyecto:verificar -n&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Si no sale ninguna alerta, procedemos a instalar.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/instalador proyecto:instalar&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
Una vez instalado, modificamos los permisos de los archivos de la instalación con el comando&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
sudo ./bin/instalador permisos:simple&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
Cambiamos el modo mantenimiento&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/instalador instalacion:modo-mantenimiento --sin-mantenimiento -n&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Luego configuramos Apache.&lt;br /&gt;
Lo mismo que con registry, como tengo toda la plataforma instalada en un mismo servidor, debo usar el '''ServerName &amp;quot;usuarios.local.siu&amp;quot;'''&lt;br /&gt;
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'''&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;VirtualHost *:80&amp;gt;&lt;br /&gt;
    ServerName usuarios.local.siu&lt;br /&gt;
    Redirect permanent / https://usuarios.local.siu/&lt;br /&gt;
&amp;lt;/VirtualHost&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;VirtualHost *:443&amp;gt;&lt;br /&gt;
&lt;br /&gt;
ServerName usuarios.local.siu&lt;br /&gt;
&lt;br /&gt;
SSLEngine on&lt;br /&gt;
SSLCertificateFile /certs/usuarios.local.siu.cert.pem&lt;br /&gt;
SSLCertificateKeyFile /certs/usuarios.local.siu.key.pem&lt;br /&gt;
&lt;br /&gt;
SSLCACertificateFile /certs/ca-chain.cert.pem&lt;br /&gt;
&lt;br /&gt;
SSLVerifyClient optional_no_ca&lt;br /&gt;
SSLVerifyDepth 2&lt;br /&gt;
SSLProtocol all -SSLv2 -SSLv3&lt;br /&gt;
SSLOptions +StdEnvVars +ExportCertData&lt;br /&gt;
BrowserMatch &amp;quot;MSIE [2-6]&amp;quot; \&lt;br /&gt;
        nokeepalive ssl-unclean-shutdown \&lt;br /&gt;
        downgrade-1.0 force-response-1.0&lt;br /&gt;
        # MSIE 7 and newer should be able to use keepalive&lt;br /&gt;
BrowserMatch &amp;quot;MSIE [17-9]&amp;quot; ssl-unclean-shutdown&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Include /usr/local/siu/usuarios/instalacion/toba.conf&lt;br /&gt;
&lt;br /&gt;
Include /usr/local/siu/usuarios/instalacion/idp.conf&lt;br /&gt;
&lt;br /&gt;
&amp;lt;/VirtualHost&amp;gt;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Luego hay que hacer que nuestra CA autofirmada sea válida en el SO y así permitir que Apache verifique los certificados de clientes:&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
sudo cp /certs/ca.cert.pem /usr/share/ca-certificates/ca_propia.crt&lt;br /&gt;
sudo vim /etc/ca-certificates.conf&lt;br /&gt;
# agregar ca_propia.crt al final del archivo&lt;br /&gt;
update-ca-certificates --fresh&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Reiniciamos Apache y todo debería funcionar, para verificar entramos en la URL definida para usuarios, en mi caso https://usuarios.local.siu/gestion&lt;br /&gt;
&lt;br /&gt;
Con todo esto funcionando el siguiente paso es agregar Usuarios a Registry y sincronizarlos. &lt;br /&gt;
Según esta instalación para agregar Usuarios al entorno hacemos&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/arai-cli registry:add --maintainer-email  jpiazza@siu.edu.ar --maintainer jpiazza http://registry.local.siu/arai-registry&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
y para sincronizarlo&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/arai-cli registry:sync&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== Arai-Huarpe ==&lt;br /&gt;
&lt;br /&gt;
Es similar a las instalaciones anteriores.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
cd /usr/local/siu&lt;br /&gt;
git clone --branch v1.1.0 https://hub.siu.edu.ar/siu-arai/huarpe-core.git huarpe&lt;br /&gt;
cd huarpe&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Para instalar seguimos la documentación del archivo '''doc/INSTALACION_MANUAL.md'''&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
composer install --no-dev&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
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.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
cp templates/huarpe.env.dist huarpe.env&lt;br /&gt;
nano huarpe.env&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
'''huarpe.env'''&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
###### CONFIG DEL INSTALADR ######&lt;br /&gt;
#INSTALADOR_TIMEOUT=&amp;quot;360&amp;quot;&lt;br /&gt;
ENTORNO_PRODUCCION=1&lt;br /&gt;
&lt;br /&gt;
###### CONFIG DE SIU-HUARPE ######&lt;br /&gt;
HUARPE_PATH=/usr/local/siu/huarpe&lt;br /&gt;
HUARPE_URL=https://huarpe.local.siu&lt;br /&gt;
HUARPE_URL_PORT=443&lt;br /&gt;
HUARPE_SESSION_NAME=huarpe&lt;br /&gt;
HUARPE_SESSION_HANDLER=&amp;quot;native_file&amp;quot;&lt;br /&gt;
#HUARPE_MEMCACHED_HOST=127.0.0.1&lt;br /&gt;
#HUARPE_MEMCACHED_PORT=11211&lt;br /&gt;
HUARPE_CERT_FILE=/certs/huarpe-cli.cert.pem&lt;br /&gt;
HUARPE_KEY_FILE=/certs/huarpe-cli.key.pem&lt;br /&gt;
#HUARPE_TOKEN=unt0k3n-al3at0r1o-s39ur0?&lt;br /&gt;
#HUARPE_PROXY=127.0.0.1&lt;br /&gt;
HUARPE_LOG_HANDLER=&amp;quot;error_log&amp;quot;&lt;br /&gt;
HUARPE_LOG_LEVEL=&amp;quot;DEBUG&amp;quot;&lt;br /&gt;
&lt;br /&gt;
###### CONFIG DE SIU-ARAI: REGISTRY ######&lt;br /&gt;
ARAI_REGISTRY_URL=http://registry.local.siu/arai-registry&lt;br /&gt;
ARAI_REGISTRY_USER=user&lt;br /&gt;
ARAI_REGISTRY_PASS=pass&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Una vez editado, verificamos que la configuración sea correcta&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/instalador proyecto:verificar&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
Si no sale ninguna alerta, procedemos a instalar.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
sudo ./bin/instalador proyecto:instalar&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
En Synfony es necesario dumpear los estilos y los JS con el siguiente comando.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/console assetic:dump --no-debug&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
Una vez instalado, modificamos los permisos de los archivos de la instalación con el comando&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
sudo ./bin/instalador permisos:simple&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Configuración apache ===&lt;br /&gt;
Lo mismo que con Registry o Usuarios, como tengo toda la plataforma instalada en un mismo servidor, debo usar el '''ServerName huarpe.local.siu'''.&lt;br /&gt;
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&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;VirtualHost *:80&amp;gt;&lt;br /&gt;
	ServerName huarpe.local.siu&lt;br /&gt;
	Redirect permanent / https://huarpe.local.siu:443/&lt;br /&gt;
&amp;lt;/VirtualHost&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;VirtualHost *:443&amp;gt;&lt;br /&gt;
&lt;br /&gt;
ServerName huarpe.local.siu&lt;br /&gt;
SSLEngine on&lt;br /&gt;
SSLCertificateFile /certs/huarpe.local.siu.cert.pem&lt;br /&gt;
SSLCertificateKeyFile /certs/huarpe.local.siu.key.pem&lt;br /&gt;
&lt;br /&gt;
Include /usr/local/siu/huarpe/app/config/alias.conf&lt;br /&gt;
&lt;br /&gt;
&amp;lt;/VirtualHost&amp;gt;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Reiniciamos apache, antes de verificar la instalación, debemos sincronizar con Registry.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/arai-cli registry:add --maintainer-email  jpiazza@siu.edu.ar --maintainer jpiazza http://registry.local.siu/arai-registry&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
Luego sincronizar&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/arai-cli registry:sync&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Hay que limpiar la cache y actualizar los permisos&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/console cache:clear --env=prod&lt;br /&gt;
sudo ./bin/instalador permisos:simple &lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
En Usuarios resincronizar para que se actualice con la nueva instalación&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
cd /usr/local/siu/usuarios&lt;br /&gt;
./bin/arai-cli registry:sync&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Para verificar que la instalación se realizo con éxito de debe ingresar en https://huarpe.local.siu/&lt;br /&gt;
&lt;br /&gt;
Si todo salio bien, tenemos instalada la plataforma ARAI lista para ser usada en nuestro servidor.&lt;/div&gt;</summary>
		<author><name>Ablanco</name></author>	</entry>

	<entry>
		<id>https://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Arai/ejemploPasoAPaso&amp;diff=27611</id>
		<title>SIU-Arai/ejemploPasoAPaso</title>
		<link rel="alternate" type="text/html" href="https://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Arai/ejemploPasoAPaso&amp;diff=27611"/>
				<updated>2017-08-02T19:32:49Z</updated>
		
		<summary type="html">&lt;p&gt;Ablanco: /* Arai-Usuarios */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;= Ejemplo paso a paso =&lt;br /&gt;
&lt;br /&gt;
Para este caso voy a usar una instalación de Debian Jessie&lt;br /&gt;
&lt;br /&gt;
El objetivo es tener una instalación funcionando de la paltaforma SIU-Arai que luego sirva para integrar otros sistemas toba.&lt;br /&gt;
&lt;br /&gt;
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í&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable zebra&amp;quot;&lt;br /&gt;
!colspan=&amp;quot;2&amp;quot;|URLs&lt;br /&gt;
|-&lt;br /&gt;
|Araí-Registry&lt;br /&gt;
|http://registry.local.siu&lt;br /&gt;
|-&lt;br /&gt;
|Araí-Usuarios&lt;br /&gt;
|https://usuarios.local.siu&lt;br /&gt;
|-&lt;br /&gt;
|Araí-Huarpe&lt;br /&gt;
|https://huarpe.local.siu&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
== Creación de certificados ==&lt;br /&gt;
Hay que tener en cuenta que voy a usar conexión segura, por lo que tanto voy a necesitar certificados.&lt;br /&gt;
Para crear los certificados uso el tutorial que se encuentra en http://documentacion.siu.edu.ar/wiki/SIU-Arai/certificados. &lt;br /&gt;
Ese artículo asume &lt;br /&gt;
* Docker instalado (https://docs.docker.com/engine/installation/linux/docker-ce/debian/#install-using-the-repository). &lt;br /&gt;
* Docker Compose instalado (https://github.com/docker/compose/releases). &lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
git clone https://hub.siu.edu.ar/siu/instaladores.git dockerCerts&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Editamos el archivo docker-compose según nuestras necesidades.&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
cd dockerCerts/certs&lt;br /&gt;
nano docker-compose.yml&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
En mi caso quedo así:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt; &lt;br /&gt;
certificados:&lt;br /&gt;
  image: siutoba/docker-certs&lt;br /&gt;
  container_name: docker-certs&amp;lt;br/&amp;gt;&lt;br /&gt;
  #env_file: docker.env&amp;lt;br/&amp;gt;&lt;br /&gt;
  environment:&amp;lt;br/&amp;gt;&lt;br /&gt;
    DOCKER_NAME: certs&amp;lt;br/&amp;gt;&lt;br /&gt;
    CA_PWD: pass&amp;lt;br/&amp;gt;&lt;br /&gt;
    CA_INT_PWD: pass&amp;lt;br/&amp;gt;&lt;br /&gt;
    LISTA_SERVER: huarpe.local.siu usuarios.local.siu&amp;lt;br/&amp;gt;&lt;br /&gt;
    LISTA_CLIENTES: usuarios-cli huarpe-cli&amp;lt;br/&amp;gt;&lt;br /&gt;
  volumes:&amp;lt;br/&amp;gt;&lt;br /&gt;
    - ./data/certificados:/CAs/intermediate&amp;lt;br/&amp;gt;&lt;br /&gt;
    - ./data/root:/CAs/rootCA&amp;lt;br/&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Guardamos y generamos el container.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
docker-compose up&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Una vez generado el container copiamos los certificados creados en la carpeta que nos sea mas cómodo, en mi caso /certs&lt;br /&gt;
Sin cambiar de directorio hacemos:&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
sudo mkdir /certs&lt;br /&gt;
sudo find data -name &amp;quot;*.pem&amp;quot; -exec cp {} /certs \;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Luego generamos los certificados para el IDP:&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
mkdir /certs/idp&lt;br /&gt;
cd /certs/idp&lt;br /&gt;
openssl req -newkey rsa:2048 -new -x509 -days 3652 -nodes -out certificado_idp.crt -keyout certificado_idp.pem&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Listo, con las URL definidas y los certificados creados se puede proceder a instalar la plataforma.&lt;br /&gt;
&lt;br /&gt;
== Instalación Arai-Registy ==&lt;br /&gt;
Creamos la carpeta '''/usr/local/siu''' y no posicionamos ahí&lt;br /&gt;
Clonamos el proyecto &lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
git clone https://hub.siu.edu.ar/siu-arai/arai-registry.git registry&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
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.&lt;br /&gt;
&lt;br /&gt;
Dentro del directorio del proyecto encontramos el archivo &amp;quot;doc/INSTALACION MANUAL.md&amp;quot;, la idea es seguir las instrucciones que encontramos en este archivo.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
cd registry&lt;br /&gt;
composer install --no-dev&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
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.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
cp templates/arai-registry.env.dist arai-registry.env&lt;br /&gt;
nano arai-registry.env&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
'''arai-registry.env'''&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
# config de la aplicacion&lt;br /&gt;
ARAI_REGISTRY_ALIAS=&amp;quot;/arai-registry&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_USER=&amp;quot;user&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_PASS=&amp;quot;pass&amp;quot;&lt;br /&gt;
&lt;br /&gt;
# config de la base de datos&lt;br /&gt;
ARAI_REGISTRY_DB_HOST=&amp;quot;172.27.31.114&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_DB_PORT=&amp;quot;7432&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_DB_DBNAME=&amp;quot;siu_registry&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_DB_USERNAME=&amp;quot;postgres&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_DB_PASSWORD=&amp;quot;postgres&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_DB_SCHEMA=&amp;quot;registry&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_DB_ENCODING=&amp;quot;UTF8&amp;quot;&lt;br /&gt;
&lt;br /&gt;
###### CONFIG DE LOGS ######&lt;br /&gt;
ARAI_REGISTRY_LOG_HANDLER=&amp;quot;errorlog&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_LOG_LEVEL=&amp;quot;DEBUG&amp;quot;&lt;br /&gt;
&lt;br /&gt;
# config del instalador&lt;br /&gt;
INSTALADOR_TIMEOUT=&amp;quot;360&amp;quot;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Una vez editado, verificamos que la configuración sea correcta&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/instalador proyecto:verificar&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Si no sale ninguna alerta, procedemos a instalar.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/instalador proyecto:instalar&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
Una vez instalado, modificamos los permisos de los archivos de la instalación con el comando&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
sudo ./bin/instalador permisos:simple&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Luego configuramos apache.&lt;br /&gt;
En mi caso, como tengo toda la plataforma instalada en un mismo servidor, debo usar el '''ServerName &amp;quot;registry.local.siu&amp;quot;'''&lt;br /&gt;
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'''&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;VirtualHost *:80&amp;gt;&lt;br /&gt;
ServerName registry.local.siu&lt;br /&gt;
Include /usr/local/siu/registry/config/alias.conf&lt;br /&gt;
&amp;lt;/VirtualHost&amp;gt;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Con todo esto, para verificar que todo funcione reiniciamos Apache y ejecutamos&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
curl --user registry:registry http://registry.local.siu/arai-registry/rest/packages/1&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Si la salida es:&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
{&lt;br /&gt;
    &amp;quot;error&amp;quot;: 404,&lt;br /&gt;
    &amp;quot;mensaje&amp;quot;: &amp;quot;404 Not Found&amp;quot;,&lt;br /&gt;
    &amp;quot;descripcion&amp;quot;: &amp;quot;El paquete solicitado no existe&amp;quot;&lt;br /&gt;
}&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
es que la instalación funcionó correctamente.&lt;br /&gt;
&lt;br /&gt;
Con registry instalado procedemos a instalar Usuarios&lt;br /&gt;
&lt;br /&gt;
==Arai-Usuarios==&lt;br /&gt;
&lt;br /&gt;
Nos posicionamos en /usr/local/siu y clonamos el proyecto&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
cd /usr/local/siu&lt;br /&gt;
git clone --branch v1.2.0 https://hub.siu.edu.ar/siu-arai/arai-usuarios.git usuarios&lt;br /&gt;
cd usuarios&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Para instalar seguimos la documentación del archivo '''doc/INSTALACION_MANUAL.md'''&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
composer install --no-dev&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
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.&lt;br /&gt;
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.&lt;br /&gt;
La variable TOBA_USUARIO debe contener el mismo usuarios administrado del LDAP.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
cp templates/arai-usuarios.env.dist arai-usuarios.env&lt;br /&gt;
nano arai-usuarios.env&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
'''arai-usuarios.env.dist'''&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
###### CONFIG DEL INSTALADR ######&lt;br /&gt;
#INSTALADOR_TIMEOUT=&amp;quot;360&amp;quot;&lt;br /&gt;
ENTORNO_PRODUCCION=&amp;quot;1&amp;quot;&lt;br /&gt;
&lt;br /&gt;
###### VARIABLES GLOBALES DEL ARCHIVO ######&lt;br /&gt;
ARAI_USUARIOS_DIR=/usr/local/siu/usuarios&lt;br /&gt;
&lt;br /&gt;
###### CONFIG DE TOBA ######&lt;br /&gt;
TOBA_URL_BASE=&amp;quot;https://usuarios.local.siu&amp;quot;&lt;br /&gt;
#TOBA_URL_PORT=&amp;quot;443&amp;quot;&lt;br /&gt;
TOBA_USUARIO=&amp;quot;admin&amp;quot;&lt;br /&gt;
TOBA_PASSWORD=&amp;quot;admin1234&amp;quot;&lt;br /&gt;
TOBA_INSTALACION_DIR=&amp;quot;${ARAI_USUARIOS_DIR}/instalacion&amp;quot;&lt;br /&gt;
TOBA_PROYECTO_DIR=&amp;quot;${ARAI_USUARIOS_DIR}/gestion&amp;quot;&lt;br /&gt;
TOBA_INSTALAR_USUARIOS=false&lt;br /&gt;
TOBA_INSTALAR_EDITOR=false&lt;br /&gt;
TOBA_INSTALAR_REFERENCIA=false&lt;br /&gt;
TOBA_ALIAS_PROYECTO=&amp;quot;/gestion&amp;quot;&lt;br /&gt;
TOBA_ALIAS_NUCLEO=&amp;quot;/toba_gestion&amp;quot;&lt;br /&gt;
#TOBA_ID_DESARROLLADOR=0&lt;br /&gt;
#TOBA_SESSION_NAME=&amp;quot;ARAI_SESSID&amp;quot;&lt;br /&gt;
&lt;br /&gt;
###### CONFIG DE BASE DE DATOS DE NEGOCIO ######&lt;br /&gt;
PROYECTO_DB_HOST=&amp;quot;172.27.31.114&amp;quot;&lt;br /&gt;
PROYECTO_DB_PORT=&amp;quot;7432&amp;quot;&lt;br /&gt;
PROYECTO_DB_DBNAME=&amp;quot;siu_usuarios&amp;quot;&lt;br /&gt;
PROYECTO_DB_USERNAME=&amp;quot;postgres&amp;quot;&lt;br /&gt;
PROYECTO_DB_PASSWORD=&amp;quot;postgres&amp;quot;&lt;br /&gt;
PROYECTO_DB_SCHEMA=&amp;quot;usuarios&amp;quot;&lt;br /&gt;
PROYECTO_DB_ENCODING=&amp;quot;LATIN1&amp;quot;&lt;br /&gt;
&lt;br /&gt;
###### CONFIG DE BASE DE DATOS DE TOBA. #####&lt;br /&gt;
######## DEFINIR SI SE QUIERE UTILIZAR UNA BASE DISTINTA A LA DE NEGOCIO&lt;br /&gt;
#TOBA_DB_HOST=&amp;quot;localhost&amp;quot;&lt;br /&gt;
#TOBA_DB_PORT=&amp;quot;5432&amp;quot;&lt;br /&gt;
#TOBA_DB_DBNAME=&amp;quot;instalador&amp;quot;&lt;br /&gt;
#TOBA_DB_USERNAME=&amp;quot;postgres&amp;quot;&lt;br /&gt;
#TOBA_DB_PASSWORD=&amp;quot;postgres&amp;quot;&lt;br /&gt;
#TOBA_DB_SCHEMA=&amp;quot;public&amp;quot;&lt;br /&gt;
&lt;br /&gt;
##### CONFIG IDM #####&lt;br /&gt;
ARAI_USUARIOS_URL_IDP=https://usuarios.local.siu/idp&lt;br /&gt;
## Deberá setearse si el sistema corre detrás de un proxy reverso&lt;br /&gt;
#ARAI_USUARIOS_PROXY_URL_IDP=http://url.arai-usuarios:80/idp&lt;br /&gt;
ARAI_USUARIOS_URL_PORTAL=https://huarpe.local.siu/portal&lt;br /&gt;
ARAI_USUARIOS_URL_PERFIL=https://huarpe.local.siu/perfil&lt;br /&gt;
ARAI_USUARIOS_URL_INSTITUCION=http://siu.edu.ar&lt;br /&gt;
&lt;br /&gt;
ARAI_USUARIOS_SIGLA_INSTITUCION=SIGLA&lt;br /&gt;
ARAI_USUARIOS_EMAIL_SOPORTE=mail.soporte@institucion.edu.ar&lt;br /&gt;
&lt;br /&gt;
##### CONFIG SEGURIDAD ####&lt;br /&gt;
SEGURIDAD_ALGORITMO_PASS=crypt&lt;br /&gt;
SEGURIDAD_LARGO_PASS=8&lt;br /&gt;
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'&lt;br /&gt;
SEGURIDAD_DURACION_DIAS_PASS=120&lt;br /&gt;
SEGURIDAD_RECAPTCHA_SITIO=6Fd_pQwTAAAAAOEqJz6KJmkjsrXcdXrAjWQYggZf&lt;br /&gt;
SEGURIDAD_RECAPTCHA_CLAVE=6Fd_pQwTAAAAAOEqJz6KJmkjsrXcdXrAjWQYggZf&lt;br /&gt;
SEGURIDAD_INTENTOS_RECAPTCHA=3&lt;br /&gt;
&lt;br /&gt;
##### CONFIG IDP #####&lt;br /&gt;
ARAI_USUARIOS_IDP_KEY_FILE=/certs/idp/certificado_idp.pem&lt;br /&gt;
ARAI_USUARIOS_IDP_CERT_FILE=/certs/idp/certificado_idp.crt&lt;br /&gt;
#ARAI_USUARIOS_IDP_LOG_LEVEL='WARNING'&lt;br /&gt;
#ARAI_USUARIOS_IDP_LOG_HANDLER='errorlog'&lt;br /&gt;
&lt;br /&gt;
##### CONFIG MAIL RECOVERY ####&lt;br /&gt;
MAIL_RECOVERY_SUBJECT='Recuperar contraseña SIU-Arai'&lt;br /&gt;
MAIL_RECOVERY_FROM='noreply@institucion.edu.ar'&lt;br /&gt;
MAIL_RECOVERY_REPLYTO='noreply@institucion.edu.ar'&lt;br /&gt;
MAIL_RECOVERY_FROMNAME='Institución'&lt;br /&gt;
&lt;br /&gt;
##### CONFIG LDAP #####&lt;br /&gt;
ARAI_USUARIOS_LDAP_HOST=172.27.31.114&lt;br /&gt;
ARAI_USUARIOS_LDAP_PORT=7389&lt;br /&gt;
ARAI_USUARIOS_LDAP_TLS=0&lt;br /&gt;
ARAI_USUARIOS_LDAP_METHOD=user&lt;br /&gt;
ARAI_USUARIOS_LDAP_BINDUSER=&amp;quot;cn=admin,dc=siu,dc=cin,dc=edu&amp;quot;&lt;br /&gt;
ARAI_USUARIOS_LDAP_BINDPASS=admin&lt;br /&gt;
ARAI_USUARIOS_LDAP_SEARCHBASE=&amp;quot;dc=siu,dc=cin,dc=edu&amp;quot;&lt;br /&gt;
&lt;br /&gt;
##### CONFIG ARAI-REGISTRY #####&lt;br /&gt;
ARAI_REGISTRY_URL=http://registry.local.siu/arai-registry&lt;br /&gt;
ARAI_REGISTRY_USER=user&lt;br /&gt;
ARAI_REGISTRY_PASS=pass&lt;br /&gt;
&lt;br /&gt;
###### CONFIG ENVIO MAILS (SMTP) ######&lt;br /&gt;
SMTP_ENTRADA=&amp;quot;arai-usuarios&amp;quot;&lt;br /&gt;
SMTP_HELO=&amp;quot;mail.unx.edu.ar&amp;quot;&lt;br /&gt;
SMTP_HOST=&amp;quot;smtp.googlemail.com&amp;quot;&lt;br /&gt;
SMTP_PORT=587&lt;br /&gt;
SMTP_FROM =&amp;quot;yo@midominio.com&amp;quot;&lt;br /&gt;
SMTP_SEGURIDAD =&amp;quot;ssl|tls&amp;quot;&lt;br /&gt;
SMTP_AUTH =&amp;quot;1&amp;quot;&lt;br /&gt;
SMTP_USUARIO =&amp;quot;usuario&amp;quot;&lt;br /&gt;
SMTP_CLAVE =&amp;quot;pass&amp;quot;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Una vez editado, verificamos que la configuración sea correcta&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/instalador proyecto:verificar -n&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Si no sale ninguna alerta, procedemos a instalar.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/instalador proyecto:instalar&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
Una vez instalado, modificamos los permisos de los archivos de la instalación con el comando&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
sudo ./bin/instalador permisos:simple&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
Cambiamos el modo mantenimiento&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/instalador instalacion:modo-mantenimiento --sin-mantenimiento -n&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Luego configuramos Apache.&lt;br /&gt;
Lo mismo que con registry, como tengo toda la plataforma instalada en un mismo servidor, debo usar el '''ServerName &amp;quot;usuarios.local.siu&amp;quot;'''&lt;br /&gt;
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'''&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;VirtualHost *:80&amp;gt;&lt;br /&gt;
    ServerName usuarios.local.siu&lt;br /&gt;
    Redirect permanent / https://usuarios.local.siu/&lt;br /&gt;
&amp;lt;/VirtualHost&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;VirtualHost *:443&amp;gt;&lt;br /&gt;
&lt;br /&gt;
ServerName usuarios.local.siu&lt;br /&gt;
&lt;br /&gt;
SSLEngine on&lt;br /&gt;
SSLCertificateFile /certs/usuarios.local.siu.cert.pem&lt;br /&gt;
SSLCertificateKeyFile /certs/usuarios.local.siu.key.pem&lt;br /&gt;
&lt;br /&gt;
SSLCACertificateFile /certs/ca-chain.cert.pem&lt;br /&gt;
&lt;br /&gt;
SSLVerifyClient optional_no_ca&lt;br /&gt;
SSLVerifyDepth 2&lt;br /&gt;
SSLProtocol all -SSLv2 -SSLv3&lt;br /&gt;
SSLOptions +StdEnvVars +ExportCertData&lt;br /&gt;
BrowserMatch &amp;quot;MSIE [2-6]&amp;quot; \&lt;br /&gt;
        nokeepalive ssl-unclean-shutdown \&lt;br /&gt;
        downgrade-1.0 force-response-1.0&lt;br /&gt;
        # MSIE 7 and newer should be able to use keepalive&lt;br /&gt;
BrowserMatch &amp;quot;MSIE [17-9]&amp;quot; ssl-unclean-shutdown&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Include /usr/local/siu/usuarios/instalacion/toba.conf&lt;br /&gt;
&lt;br /&gt;
Include /usr/local/siu/usuarios/instalacion/idp.conf&lt;br /&gt;
&lt;br /&gt;
&amp;lt;/VirtualHost&amp;gt;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Luego hay que hacer que nuestra CA autofirmada sea válida en el SO y así permitir que Apache verifique los certificados de clientes:&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
sudo cp /certs/ca.cert.pem /usr/share/ca-certificates/ca_propia.crt&lt;br /&gt;
sudo vim /etc/ca-certificates.conf&lt;br /&gt;
# agregar ca_propia.crt al final del archivo&lt;br /&gt;
update-ca-certificates --fresh&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Reiniciamos Apache y todo debería funcionar, para verificar entramos en la URL definida para usuarios, en mi caso https://usuarios.local.siu/gestion&lt;br /&gt;
&lt;br /&gt;
Con todo esto funcionando el siguiente paso es agregar Usuarios a Registry y sincronizarlos. &lt;br /&gt;
Según esta instalación para agregar Usuarios al entorno hacemos&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/arai-cli registry:add --maintainer-email  jpiazza@siu.edu.ar --maintainer jpiazza http://registry.local.siu/arai-registry&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
y para sincronizarlo&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/arai-cli registry:sync&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== Arai-Huarpe ==&lt;br /&gt;
&lt;br /&gt;
Es similar a las instalaciones anteriores.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
cd /usr/local/siu&lt;br /&gt;
git clone --branch v1.1.0 https://hub.siu.edu.ar/siu-arai/huarpe-core.git huarpe&lt;br /&gt;
cd huarpe&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Para instalar seguimos la documentación del archivo '''doc/INSTALACION_MANUAL.md'''&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
composer install --no-dev&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
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.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
cp templates/huarpe.env.dist huarpe.env&lt;br /&gt;
nano huarpe.env&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
'''huarpe.env'''&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
###### CONFIG DEL INSTALADR ######&lt;br /&gt;
#INSTALADOR_TIMEOUT=&amp;quot;360&amp;quot;&lt;br /&gt;
ENTORNO_PRODUCCION=1&lt;br /&gt;
&lt;br /&gt;
###### CONFIG DE SIU-HUARPE ######&lt;br /&gt;
HUARPE_PATH=/usr/local/siu/huarpe&lt;br /&gt;
HUARPE_URL=https://huarpe.local.siu&lt;br /&gt;
HUARPE_URL_PORT=443&lt;br /&gt;
HUARPE_SESSION_NAME=huarpe&lt;br /&gt;
HUARPE_SESSION_HANDLER=&amp;quot;native_file&amp;quot;&lt;br /&gt;
#HUARPE_MEMCACHED_HOST=127.0.0.1&lt;br /&gt;
#HUARPE_MEMCACHED_PORT=11211&lt;br /&gt;
HUARPE_CERT_FILE=/certs/huarpe-cli.cert.pem&lt;br /&gt;
HUARPE_KEY_FILE=/certs/huarpe-cli.key.pem&lt;br /&gt;
#HUARPE_TOKEN=unt0k3n-al3at0r1o-s39ur0?&lt;br /&gt;
#HUARPE_PROXY=127.0.0.1&lt;br /&gt;
HUARPE_LOG_HANDLER=&amp;quot;error_log&amp;quot;&lt;br /&gt;
HUARPE_LOG_LEVEL=&amp;quot;DEBUG&amp;quot;&lt;br /&gt;
&lt;br /&gt;
###### CONFIG DE SIU-ARAI: REGISTRY ######&lt;br /&gt;
ARAI_REGISTRY_URL=http://registry.local.siu/arai-registry&lt;br /&gt;
ARAI_REGISTRY_USER=user&lt;br /&gt;
ARAI_REGISTRY_PASS=pass&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Una vez editado, verificamos que la configuración sea correcta&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/instalador proyecto:verificar&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
Si no sale ninguna alerta, procedemos a instalar.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
sudo ./bin/instalador proyecto:instalar&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
En Synfony es necesario dumpear los estilos y los JS con el siguiente comando.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/console assetic:dump --no-debug&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
Una vez instalado, modificamos los permisos de los archivos de la instalación con el comando&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
sudo ./bin/instalador permisos:simple&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Configuración apache ===&lt;br /&gt;
Lo mismo que con Registry o Usuarios, como tengo toda la plataforma instalada en un mismo servidor, debo usar el '''ServerName huarpe.local.siu'''.&lt;br /&gt;
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&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;VirtualHost *:80&amp;gt;&lt;br /&gt;
	ServerName huarpe.local.siu&lt;br /&gt;
	Redirect permanent / https://huarpe.local.siu:443/&lt;br /&gt;
&amp;lt;/VirtualHost&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;VirtualHost *:443&amp;gt;&lt;br /&gt;
&lt;br /&gt;
ServerName huarpe.local.siu&lt;br /&gt;
SSLEngine on&lt;br /&gt;
SSLCertificateFile /certs/huarpe.local.siu.cert.pem&lt;br /&gt;
SSLCertificateKeyFile /certs/huarpe.local.siu.key.pem&lt;br /&gt;
&lt;br /&gt;
Include /usr/local/siu/huarpe/app/config/alias.conf&lt;br /&gt;
&lt;br /&gt;
&amp;lt;/VirtualHost&amp;gt;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Reiniciamos apache, antes de verificar la instalación, debemos sincronizar con Registry.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/arai-cli registry:add --maintainer-email  jpiazza@siu.edu.ar --maintainer jpiazza http://registry.local.siu/arai-registry&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
Luego sincronizar&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/arai-cli registry:sync&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Hay que limpiar la cache y actualizar los permisos&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/console cache:clear --env=prod&lt;br /&gt;
sudo ./bin/instalador permisos:simple &lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
En Usuarios resincronizar para que se actualice con la nueva instalación&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
cd /usr/local/siu/usuarios&lt;br /&gt;
./bin/arai-cli registry:sync&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Para verificar que la instalación se realizo con éxito de debe ingresar en https://huarpe.local.siu/&lt;br /&gt;
&lt;br /&gt;
Si todo salio bien, tenemos instalada la plataforma ARAI lista para ser usada en nuestro servidor.&lt;/div&gt;</summary>
		<author><name>Ablanco</name></author>	</entry>

	<entry>
		<id>https://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Arai/ejemploPasoAPaso&amp;diff=27610</id>
		<title>SIU-Arai/ejemploPasoAPaso</title>
		<link rel="alternate" type="text/html" href="https://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Arai/ejemploPasoAPaso&amp;diff=27610"/>
				<updated>2017-08-02T19:21:20Z</updated>
		
		<summary type="html">&lt;p&gt;Ablanco: /* Creación de certificados */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;= Ejemplo paso a paso =&lt;br /&gt;
&lt;br /&gt;
Para este caso voy a usar una instalación de Debian Jessie&lt;br /&gt;
&lt;br /&gt;
El objetivo es tener una instalación funcionando de la paltaforma SIU-Arai que luego sirva para integrar otros sistemas toba.&lt;br /&gt;
&lt;br /&gt;
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í&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable zebra&amp;quot;&lt;br /&gt;
!colspan=&amp;quot;2&amp;quot;|URLs&lt;br /&gt;
|-&lt;br /&gt;
|Araí-Registry&lt;br /&gt;
|http://registry.local.siu&lt;br /&gt;
|-&lt;br /&gt;
|Araí-Usuarios&lt;br /&gt;
|https://usuarios.local.siu&lt;br /&gt;
|-&lt;br /&gt;
|Araí-Huarpe&lt;br /&gt;
|https://huarpe.local.siu&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
== Creación de certificados ==&lt;br /&gt;
Hay que tener en cuenta que voy a usar conexión segura, por lo que tanto voy a necesitar certificados.&lt;br /&gt;
Para crear los certificados uso el tutorial que se encuentra en http://documentacion.siu.edu.ar/wiki/SIU-Arai/certificados. &lt;br /&gt;
Ese artículo asume &lt;br /&gt;
* Docker instalado (https://docs.docker.com/engine/installation/linux/docker-ce/debian/#install-using-the-repository). &lt;br /&gt;
* Docker Compose instalado (https://github.com/docker/compose/releases). &lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
git clone https://hub.siu.edu.ar/siu/instaladores.git dockerCerts&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Editamos el archivo docker-compose según nuestras necesidades.&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
cd dockerCerts/certs&lt;br /&gt;
nano docker-compose.yml&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
En mi caso quedo así:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt; &lt;br /&gt;
certificados:&lt;br /&gt;
  image: siutoba/docker-certs&lt;br /&gt;
  container_name: docker-certs&amp;lt;br/&amp;gt;&lt;br /&gt;
  #env_file: docker.env&amp;lt;br/&amp;gt;&lt;br /&gt;
  environment:&amp;lt;br/&amp;gt;&lt;br /&gt;
    DOCKER_NAME: certs&amp;lt;br/&amp;gt;&lt;br /&gt;
    CA_PWD: pass&amp;lt;br/&amp;gt;&lt;br /&gt;
    CA_INT_PWD: pass&amp;lt;br/&amp;gt;&lt;br /&gt;
    LISTA_SERVER: huarpe.local.siu usuarios.local.siu&amp;lt;br/&amp;gt;&lt;br /&gt;
    LISTA_CLIENTES: usuarios-cli huarpe-cli&amp;lt;br/&amp;gt;&lt;br /&gt;
  volumes:&amp;lt;br/&amp;gt;&lt;br /&gt;
    - ./data/certificados:/CAs/intermediate&amp;lt;br/&amp;gt;&lt;br /&gt;
    - ./data/root:/CAs/rootCA&amp;lt;br/&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Guardamos y generamos el container.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
docker-compose up&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Una vez generado el container copiamos los certificados creados en la carpeta que nos sea mas cómodo, en mi caso /certs&lt;br /&gt;
Sin cambiar de directorio hacemos:&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
sudo mkdir /certs&lt;br /&gt;
sudo find data -name &amp;quot;*.pem&amp;quot; -exec cp {} /certs \;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Luego generamos los certificados para el IDP:&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
mkdir /certs/idp&lt;br /&gt;
cd /certs/idp&lt;br /&gt;
openssl req -newkey rsa:2048 -new -x509 -days 3652 -nodes -out certificado_idp.crt -keyout certificado_idp.pem&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Listo, con las URL definidas y los certificados creados se puede proceder a instalar la plataforma.&lt;br /&gt;
&lt;br /&gt;
== Instalación Arai-Registy ==&lt;br /&gt;
Creamos la carpeta '''/usr/local/siu''' y no posicionamos ahí&lt;br /&gt;
Clonamos el proyecto &lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
git clone https://hub.siu.edu.ar/siu-arai/arai-registry.git registry&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
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.&lt;br /&gt;
&lt;br /&gt;
Dentro del directorio del proyecto encontramos el archivo &amp;quot;doc/INSTALACION MANUAL.md&amp;quot;, la idea es seguir las instrucciones que encontramos en este archivo.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
cd registry&lt;br /&gt;
composer install --no-dev&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
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.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
cp templates/arai-registry.env.dist arai-registry.env&lt;br /&gt;
nano arai-registry.env&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
'''arai-registry.env'''&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
# config de la aplicacion&lt;br /&gt;
ARAI_REGISTRY_ALIAS=&amp;quot;/arai-registry&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_USER=&amp;quot;user&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_PASS=&amp;quot;pass&amp;quot;&lt;br /&gt;
&lt;br /&gt;
# config de la base de datos&lt;br /&gt;
ARAI_REGISTRY_DB_HOST=&amp;quot;172.27.31.114&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_DB_PORT=&amp;quot;7432&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_DB_DBNAME=&amp;quot;siu_registry&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_DB_USERNAME=&amp;quot;postgres&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_DB_PASSWORD=&amp;quot;postgres&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_DB_SCHEMA=&amp;quot;registry&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_DB_ENCODING=&amp;quot;UTF8&amp;quot;&lt;br /&gt;
&lt;br /&gt;
###### CONFIG DE LOGS ######&lt;br /&gt;
ARAI_REGISTRY_LOG_HANDLER=&amp;quot;errorlog&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_LOG_LEVEL=&amp;quot;DEBUG&amp;quot;&lt;br /&gt;
&lt;br /&gt;
# config del instalador&lt;br /&gt;
INSTALADOR_TIMEOUT=&amp;quot;360&amp;quot;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Una vez editado, verificamos que la configuración sea correcta&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/instalador proyecto:verificar&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Si no sale ninguna alerta, procedemos a instalar.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/instalador proyecto:instalar&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
Una vez instalado, modificamos los permisos de los archivos de la instalación con el comando&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
sudo ./bin/instalador permisos:simple&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Luego configuramos apache.&lt;br /&gt;
En mi caso, como tengo toda la plataforma instalada en un mismo servidor, debo usar el '''ServerName &amp;quot;registry.local.siu&amp;quot;'''&lt;br /&gt;
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'''&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;VirtualHost *:80&amp;gt;&lt;br /&gt;
ServerName registry.local.siu&lt;br /&gt;
Include /usr/local/siu/registry/config/alias.conf&lt;br /&gt;
&amp;lt;/VirtualHost&amp;gt;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Con todo esto, para verificar que todo funcione reiniciamos Apache y ejecutamos&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
curl --user registry:registry http://registry.local.siu/arai-registry/rest/packages/1&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Si la salida es:&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
{&lt;br /&gt;
    &amp;quot;error&amp;quot;: 404,&lt;br /&gt;
    &amp;quot;mensaje&amp;quot;: &amp;quot;404 Not Found&amp;quot;,&lt;br /&gt;
    &amp;quot;descripcion&amp;quot;: &amp;quot;El paquete solicitado no existe&amp;quot;&lt;br /&gt;
}&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
es que la instalación funcionó correctamente.&lt;br /&gt;
&lt;br /&gt;
Con registry instalado procedemos a instalar Usuarios&lt;br /&gt;
&lt;br /&gt;
==Arai-Usuarios==&lt;br /&gt;
&lt;br /&gt;
Nos posicionamos en /usr/local/siu y clonamos el proyecto&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
cd /usr/local/siu&lt;br /&gt;
git clone --branch v1.2.0 https://hub.siu.edu.ar/siu-arai/arai-usuarios.git usuarios&lt;br /&gt;
cd usuarios&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Para instalar seguimos la documentación del archivo '''doc/INSTALACION_MANUAL.md'''&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
composer install --no-dev&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
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.&lt;br /&gt;
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.&lt;br /&gt;
La variable TOBA_USUARIO debe contener el mismo usuarios administrado del LDAP.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
cp templates/arai-usuarios.env.dist arai-usuarios.env&lt;br /&gt;
nano arai-usuarios.env&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
'''arai-usuarios.env.dist'''&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
###### CONFIG DEL INSTALADR ######&lt;br /&gt;
#INSTALADOR_TIMEOUT=&amp;quot;360&amp;quot;&lt;br /&gt;
ENTORNO_PRODUCCION=&amp;quot;1&amp;quot;&lt;br /&gt;
&lt;br /&gt;
###### VARIABLES GLOBALES DEL ARCHIVO ######&lt;br /&gt;
ARAI_USUARIOS_DIR=/usr/local/siu/usuarios&lt;br /&gt;
&lt;br /&gt;
###### CONFIG DE TOBA ######&lt;br /&gt;
TOBA_URL_BASE=&amp;quot;https://usuarios.local.siu&amp;quot;&lt;br /&gt;
#TOBA_URL_PORT=&amp;quot;443&amp;quot;&lt;br /&gt;
TOBA_USUARIO=&amp;quot;admin&amp;quot;&lt;br /&gt;
TOBA_PASSWORD=&amp;quot;admin1234&amp;quot;&lt;br /&gt;
TOBA_INSTALACION_DIR=&amp;quot;${ARAI_USUARIOS_DIR}/instalacion&amp;quot;&lt;br /&gt;
TOBA_PROYECTO_DIR=&amp;quot;${ARAI_USUARIOS_DIR}/gestion&amp;quot;&lt;br /&gt;
TOBA_INSTALAR_USUARIOS=false&lt;br /&gt;
TOBA_INSTALAR_EDITOR=false&lt;br /&gt;
TOBA_INSTALAR_REFERENCIA=false&lt;br /&gt;
TOBA_ALIAS_PROYECTO=&amp;quot;/gestion&amp;quot;&lt;br /&gt;
TOBA_ALIAS_NUCLEO=&amp;quot;/toba_gestion&amp;quot;&lt;br /&gt;
#TOBA_ID_DESARROLLADOR=0&lt;br /&gt;
#TOBA_SESSION_NAME=&amp;quot;ARAI_SESSID&amp;quot;&lt;br /&gt;
&lt;br /&gt;
###### CONFIG DE BASE DE DATOS DE NEGOCIO ######&lt;br /&gt;
PROYECTO_DB_HOST=&amp;quot;172.27.31.114&amp;quot;&lt;br /&gt;
PROYECTO_DB_PORT=&amp;quot;7432&amp;quot;&lt;br /&gt;
PROYECTO_DB_DBNAME=&amp;quot;siu_usuarios&amp;quot;&lt;br /&gt;
PROYECTO_DB_USERNAME=&amp;quot;postgres&amp;quot;&lt;br /&gt;
PROYECTO_DB_PASSWORD=&amp;quot;postgres&amp;quot;&lt;br /&gt;
PROYECTO_DB_SCHEMA=&amp;quot;usuarios&amp;quot;&lt;br /&gt;
PROYECTO_DB_ENCODING=&amp;quot;LATIN1&amp;quot;&lt;br /&gt;
&lt;br /&gt;
###### CONFIG DE BASE DE DATOS DE TOBA. #####&lt;br /&gt;
######## DEFINIR SI SE QUIERE UTILIZAR UNA BASE DISTINTA A LA DE NEGOCIO&lt;br /&gt;
#TOBA_DB_HOST=&amp;quot;localhost&amp;quot;&lt;br /&gt;
#TOBA_DB_PORT=&amp;quot;5432&amp;quot;&lt;br /&gt;
#TOBA_DB_DBNAME=&amp;quot;instalador&amp;quot;&lt;br /&gt;
#TOBA_DB_USERNAME=&amp;quot;postgres&amp;quot;&lt;br /&gt;
#TOBA_DB_PASSWORD=&amp;quot;postgres&amp;quot;&lt;br /&gt;
#TOBA_DB_SCHEMA=&amp;quot;public&amp;quot;&lt;br /&gt;
&lt;br /&gt;
##### CONFIG IDM #####&lt;br /&gt;
ARAI_USUARIOS_URL_IDP=https://usuarios.local.siu/idp&lt;br /&gt;
## Deberá setearse si el sistema corre detrás de un proxy reverso&lt;br /&gt;
#ARAI_USUARIOS_PROXY_URL_IDP=http://url.arai-usuarios:80/idp&lt;br /&gt;
ARAI_USUARIOS_URL_PORTAL=https://huarpe.local.siu/portal&lt;br /&gt;
ARAI_USUARIOS_URL_PERFIL=https://huarpe.local.siu/perfil&lt;br /&gt;
ARAI_USUARIOS_URL_INSTITUCION=http://siu.edu.ar&lt;br /&gt;
&lt;br /&gt;
ARAI_USUARIOS_SIGLA_INSTITUCION=SIGLA&lt;br /&gt;
ARAI_USUARIOS_EMAIL_SOPORTE=mail.soporte@institucion.edu.ar&lt;br /&gt;
&lt;br /&gt;
##### CONFIG SEGURIDAD ####&lt;br /&gt;
SEGURIDAD_ALGORITMO_PASS=crypt&lt;br /&gt;
SEGURIDAD_LARGO_PASS=8&lt;br /&gt;
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'&lt;br /&gt;
SEGURIDAD_DURACION_DIAS_PASS=120&lt;br /&gt;
SEGURIDAD_RECAPTCHA_SITIO=6Fd_pQwTAAAAAOEqJz6KJmkjsrXcdXrAjWQYggZf&lt;br /&gt;
SEGURIDAD_RECAPTCHA_CLAVE=6Fd_pQwTAAAAAOEqJz6KJmkjsrXcdXrAjWQYggZf&lt;br /&gt;
SEGURIDAD_INTENTOS_RECAPTCHA=3&lt;br /&gt;
&lt;br /&gt;
##### CONFIG IDP #####&lt;br /&gt;
ARAI_USUARIOS_IDP_KEY_FILE=/certs/idp/certificado_idp.pem&lt;br /&gt;
ARAI_USUARIOS_IDP_CERT_FILE=/certs/idp/certificado_idp.crt&lt;br /&gt;
#ARAI_USUARIOS_IDP_LOG_LEVEL='WARNING'&lt;br /&gt;
#ARAI_USUARIOS_IDP_LOG_HANDLER='errorlog'&lt;br /&gt;
&lt;br /&gt;
##### CONFIG MAIL RECOVERY ####&lt;br /&gt;
MAIL_RECOVERY_SUBJECT='Recuperar contraseña SIU-Arai'&lt;br /&gt;
MAIL_RECOVERY_FROM='noreply@institucion.edu.ar'&lt;br /&gt;
MAIL_RECOVERY_REPLYTO='noreply@institucion.edu.ar'&lt;br /&gt;
MAIL_RECOVERY_FROMNAME='Institución'&lt;br /&gt;
&lt;br /&gt;
##### CONFIG LDAP #####&lt;br /&gt;
ARAI_USUARIOS_LDAP_HOST=172.27.31.114&lt;br /&gt;
ARAI_USUARIOS_LDAP_PORT=7389&lt;br /&gt;
ARAI_USUARIOS_LDAP_TLS=0&lt;br /&gt;
ARAI_USUARIOS_LDAP_METHOD=user&lt;br /&gt;
ARAI_USUARIOS_LDAP_BINDUSER=&amp;quot;cn=admin,dc=siu,dc=cin,dc=edu&amp;quot;&lt;br /&gt;
ARAI_USUARIOS_LDAP_BINDPASS=admin&lt;br /&gt;
ARAI_USUARIOS_LDAP_SEARCHBASE=&amp;quot;dc=siu,dc=cin,dc=edu&amp;quot;&lt;br /&gt;
&lt;br /&gt;
##### CONFIG ARAI-REGISTRY #####&lt;br /&gt;
ARAI_REGISTRY_URL=http://registry.local.siu/arai-registry&lt;br /&gt;
ARAI_REGISTRY_USER=user&lt;br /&gt;
ARAI_REGISTRY_PASS=pass&lt;br /&gt;
&lt;br /&gt;
###### CONFIG ENVIO MAILS (SMTP) ######&lt;br /&gt;
SMTP_ENTRADA=&amp;quot;arai-usuarios&amp;quot;&lt;br /&gt;
SMTP_HELO=&amp;quot;mail.unx.edu.ar&amp;quot;&lt;br /&gt;
SMTP_HOST=&amp;quot;smtp.googlemail.com&amp;quot;&lt;br /&gt;
SMTP_PORT=587&lt;br /&gt;
SMTP_FROM =&amp;quot;yo@midominio.com&amp;quot;&lt;br /&gt;
SMTP_SEGURIDAD =&amp;quot;ssl|tls&amp;quot;&lt;br /&gt;
SMTP_AUTH =&amp;quot;1&amp;quot;&lt;br /&gt;
SMTP_USUARIO =&amp;quot;usuario&amp;quot;&lt;br /&gt;
SMTP_CLAVE =&amp;quot;pass&amp;quot;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Una vez editado, verificamos que la configuración sea correcta&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/instalador proyecto:verificar -n&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Si no sale ninguna alerta, procedemos a instalar.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/instalador proyecto:instalar&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
Una vez instalado, modificamos los permisos de los archivos de la instalación con el comando&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
sudo ./bin/instalador permisos:simple&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
Cambiamos el modo mantenimiento&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/instalador instalacion:modo-mantenimiento --sin-mantenimiento -n&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Luego configuramos Apache.&lt;br /&gt;
Lo mismo que con registry, como tengo toda la plataforma instalada en un mismo servidor, debo usar el '''ServerName &amp;quot;usuarios.local.siu&amp;quot;'''&lt;br /&gt;
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'''&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;VirtualHost *:80&amp;gt;&lt;br /&gt;
    ServerName usuarios.local.siu&lt;br /&gt;
    Redirect permanent / https://usuarios.local.siu/&lt;br /&gt;
&amp;lt;/VirtualHost&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&amp;lt;VirtualHost *:443&amp;gt;&lt;br /&gt;
&lt;br /&gt;
ServerName usuarios.local.siu&lt;br /&gt;
&lt;br /&gt;
SSLEngine on&lt;br /&gt;
SSLCertificateFile /certs/usuarios.local.siu.cert.pem&lt;br /&gt;
SSLCertificateKeyFile /certs/usuarios.local.siu.key.pem&lt;br /&gt;
&lt;br /&gt;
Include /usr/local/siu/usuarios/instalacion/toba.conf&lt;br /&gt;
&lt;br /&gt;
Include /usr/local/siu/usuarios/instalacion/idp.conf&lt;br /&gt;
&lt;br /&gt;
&amp;lt;/VirtualHost&amp;gt;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Reiniciamos Apache y todo debería funcionar, para verificar entramos en la URL definida para usuarios, en mi caso https://usuarios.local.siu/gestion&lt;br /&gt;
&lt;br /&gt;
Con todo esto funcionando el siguiente paso es agregar Usuarios a Registry y sincronizarlos. &lt;br /&gt;
Según esta instalación para agregar Usuarios al entorno hacemos&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/arai-cli registry:add --maintainer-email  jpiazza@siu.edu.ar --maintainer jpiazza http://registry.local.siu/arai-registry&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
y para sincronizarlo&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/arai-cli registry:sync&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== Arai-Huarpe ==&lt;br /&gt;
&lt;br /&gt;
Es similar a las instalaciones anteriores.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
cd /usr/local/siu&lt;br /&gt;
git clone --branch v1.1.0 https://hub.siu.edu.ar/siu-arai/huarpe-core.git huarpe&lt;br /&gt;
cd huarpe&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Para instalar seguimos la documentación del archivo '''doc/INSTALACION_MANUAL.md'''&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
composer install --no-dev&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
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.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
cp templates/huarpe.env.dist huarpe.env&lt;br /&gt;
nano huarpe.env&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
'''huarpe.env'''&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
###### CONFIG DEL INSTALADR ######&lt;br /&gt;
#INSTALADOR_TIMEOUT=&amp;quot;360&amp;quot;&lt;br /&gt;
ENTORNO_PRODUCCION=1&lt;br /&gt;
&lt;br /&gt;
###### CONFIG DE SIU-HUARPE ######&lt;br /&gt;
HUARPE_PATH=/usr/local/siu/huarpe&lt;br /&gt;
HUARPE_URL=https://huarpe.local.siu&lt;br /&gt;
HUARPE_URL_PORT=443&lt;br /&gt;
HUARPE_SESSION_NAME=huarpe&lt;br /&gt;
HUARPE_SESSION_HANDLER=&amp;quot;native_file&amp;quot;&lt;br /&gt;
#HUARPE_MEMCACHED_HOST=127.0.0.1&lt;br /&gt;
#HUARPE_MEMCACHED_PORT=11211&lt;br /&gt;
HUARPE_CERT_FILE=/certs/huarpe-cli.cert.pem&lt;br /&gt;
HUARPE_KEY_FILE=/certs/huarpe-cli.key.pem&lt;br /&gt;
#HUARPE_TOKEN=unt0k3n-al3at0r1o-s39ur0?&lt;br /&gt;
#HUARPE_PROXY=127.0.0.1&lt;br /&gt;
HUARPE_LOG_HANDLER=&amp;quot;error_log&amp;quot;&lt;br /&gt;
HUARPE_LOG_LEVEL=&amp;quot;DEBUG&amp;quot;&lt;br /&gt;
&lt;br /&gt;
###### CONFIG DE SIU-ARAI: REGISTRY ######&lt;br /&gt;
ARAI_REGISTRY_URL=http://registry.local.siu/arai-registry&lt;br /&gt;
ARAI_REGISTRY_USER=user&lt;br /&gt;
ARAI_REGISTRY_PASS=pass&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Una vez editado, verificamos que la configuración sea correcta&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/instalador proyecto:verificar&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
Si no sale ninguna alerta, procedemos a instalar.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
sudo ./bin/instalador proyecto:instalar&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
En Synfony es necesario dumpear los estilos y los JS con el siguiente comando.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/console assetic:dump --no-debug&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
Una vez instalado, modificamos los permisos de los archivos de la instalación con el comando&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
sudo ./bin/instalador permisos:simple&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Configuración apache ===&lt;br /&gt;
Lo mismo que con Registry o Usuarios, como tengo toda la plataforma instalada en un mismo servidor, debo usar el '''ServerName huarpe.local.siu'''.&lt;br /&gt;
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&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;VirtualHost *:80&amp;gt;&lt;br /&gt;
	ServerName huarpe.local.siu&lt;br /&gt;
	Redirect permanent / https://huarpe.local.siu:443/&lt;br /&gt;
&amp;lt;/VirtualHost&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;VirtualHost *:443&amp;gt;&lt;br /&gt;
&lt;br /&gt;
ServerName huarpe.local.siu&lt;br /&gt;
SSLEngine on&lt;br /&gt;
SSLCertificateFile /certs/huarpe.local.siu.cert.pem&lt;br /&gt;
SSLCertificateKeyFile /certs/huarpe.local.siu.key.pem&lt;br /&gt;
&lt;br /&gt;
Include /usr/local/siu/huarpe/app/config/alias.conf&lt;br /&gt;
&lt;br /&gt;
&amp;lt;/VirtualHost&amp;gt;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Reiniciamos apache, antes de verificar la instalación, debemos sincronizar con Registry.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/arai-cli registry:add --maintainer-email  jpiazza@siu.edu.ar --maintainer jpiazza http://registry.local.siu/arai-registry&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
Luego sincronizar&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/arai-cli registry:sync&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Hay que limpiar la cache y actualizar los permisos&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/console cache:clear --env=prod&lt;br /&gt;
sudo ./bin/instalador permisos:simple &lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
En Usuarios resincronizar para que se actualice con la nueva instalación&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
cd /usr/local/siu/usuarios&lt;br /&gt;
./bin/arai-cli registry:sync&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Para verificar que la instalación se realizo con éxito de debe ingresar en https://huarpe.local.siu/&lt;br /&gt;
&lt;br /&gt;
Si todo salio bien, tenemos instalada la plataforma ARAI lista para ser usada en nuestro servidor.&lt;/div&gt;</summary>
		<author><name>Ablanco</name></author>	</entry>

	<entry>
		<id>https://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Arai/ejemploPasoAPaso&amp;diff=27609</id>
		<title>SIU-Arai/ejemploPasoAPaso</title>
		<link rel="alternate" type="text/html" href="https://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Arai/ejemploPasoAPaso&amp;diff=27609"/>
				<updated>2017-08-02T19:20:57Z</updated>
		
		<summary type="html">&lt;p&gt;Ablanco: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;= Ejemplo paso a paso =&lt;br /&gt;
&lt;br /&gt;
Para este caso voy a usar una instalación de Debian Jessie&lt;br /&gt;
&lt;br /&gt;
El objetivo es tener una instalación funcionando de la paltaforma SIU-Arai que luego sirva para integrar otros sistemas toba.&lt;br /&gt;
&lt;br /&gt;
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í&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable zebra&amp;quot;&lt;br /&gt;
!colspan=&amp;quot;2&amp;quot;|URLs&lt;br /&gt;
|-&lt;br /&gt;
|Araí-Registry&lt;br /&gt;
|http://registry.local.siu&lt;br /&gt;
|-&lt;br /&gt;
|Araí-Usuarios&lt;br /&gt;
|https://usuarios.local.siu&lt;br /&gt;
|-&lt;br /&gt;
|Araí-Huarpe&lt;br /&gt;
|https://huarpe.local.siu&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
== Creación de certificados ==&lt;br /&gt;
Hay que tener en cuenta que voy a usar conexión segura, por lo que tanto voy a necesitar certificados.&lt;br /&gt;
Para crear los certificados uso el tutorial que se encuentra en http://documentacion.siu.edu.ar/wiki/SIU-Arai/certificados. &lt;br /&gt;
Ese artículo asume &lt;br /&gt;
 * Docker instalado (https://docs.docker.com/engine/installation/linux/docker-ce/debian/#install-using-the-repository). &lt;br /&gt;
 * Docker Compose instalado (https://github.com/docker/compose/releases). &lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
git clone https://hub.siu.edu.ar/siu/instaladores.git dockerCerts&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Editamos el archivo docker-compose según nuestras necesidades.&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
cd dockerCerts/certs&lt;br /&gt;
nano docker-compose.yml&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
En mi caso quedo así:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt; &lt;br /&gt;
certificados:&lt;br /&gt;
  image: siutoba/docker-certs&lt;br /&gt;
  container_name: docker-certs&amp;lt;br/&amp;gt;&lt;br /&gt;
  #env_file: docker.env&amp;lt;br/&amp;gt;&lt;br /&gt;
  environment:&amp;lt;br/&amp;gt;&lt;br /&gt;
    DOCKER_NAME: certs&amp;lt;br/&amp;gt;&lt;br /&gt;
    CA_PWD: pass&amp;lt;br/&amp;gt;&lt;br /&gt;
    CA_INT_PWD: pass&amp;lt;br/&amp;gt;&lt;br /&gt;
    LISTA_SERVER: huarpe.local.siu usuarios.local.siu&amp;lt;br/&amp;gt;&lt;br /&gt;
    LISTA_CLIENTES: usuarios-cli huarpe-cli&amp;lt;br/&amp;gt;&lt;br /&gt;
  volumes:&amp;lt;br/&amp;gt;&lt;br /&gt;
    - ./data/certificados:/CAs/intermediate&amp;lt;br/&amp;gt;&lt;br /&gt;
    - ./data/root:/CAs/rootCA&amp;lt;br/&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Guardamos y generamos el container.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
docker-compose up&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Una vez generado el container copiamos los certificados creados en la carpeta que nos sea mas cómodo, en mi caso /certs&lt;br /&gt;
Sin cambiar de directorio hacemos:&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
sudo mkdir /certs&lt;br /&gt;
sudo find data -name &amp;quot;*.pem&amp;quot; -exec cp {} /certs \;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Luego generamos los certificados para el IDP:&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
mkdir /certs/idp&lt;br /&gt;
cd /certs/idp&lt;br /&gt;
openssl req -newkey rsa:2048 -new -x509 -days 3652 -nodes -out certificado_idp.crt -keyout certificado_idp.pem&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Listo, con las URL definidas y los certificados creados se puede proceder a instalar la plataforma.&lt;br /&gt;
&lt;br /&gt;
== Instalación Arai-Registy ==&lt;br /&gt;
Creamos la carpeta '''/usr/local/siu''' y no posicionamos ahí&lt;br /&gt;
Clonamos el proyecto &lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
git clone https://hub.siu.edu.ar/siu-arai/arai-registry.git registry&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
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.&lt;br /&gt;
&lt;br /&gt;
Dentro del directorio del proyecto encontramos el archivo &amp;quot;doc/INSTALACION MANUAL.md&amp;quot;, la idea es seguir las instrucciones que encontramos en este archivo.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
cd registry&lt;br /&gt;
composer install --no-dev&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
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.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
cp templates/arai-registry.env.dist arai-registry.env&lt;br /&gt;
nano arai-registry.env&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
'''arai-registry.env'''&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
# config de la aplicacion&lt;br /&gt;
ARAI_REGISTRY_ALIAS=&amp;quot;/arai-registry&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_USER=&amp;quot;user&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_PASS=&amp;quot;pass&amp;quot;&lt;br /&gt;
&lt;br /&gt;
# config de la base de datos&lt;br /&gt;
ARAI_REGISTRY_DB_HOST=&amp;quot;172.27.31.114&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_DB_PORT=&amp;quot;7432&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_DB_DBNAME=&amp;quot;siu_registry&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_DB_USERNAME=&amp;quot;postgres&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_DB_PASSWORD=&amp;quot;postgres&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_DB_SCHEMA=&amp;quot;registry&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_DB_ENCODING=&amp;quot;UTF8&amp;quot;&lt;br /&gt;
&lt;br /&gt;
###### CONFIG DE LOGS ######&lt;br /&gt;
ARAI_REGISTRY_LOG_HANDLER=&amp;quot;errorlog&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_LOG_LEVEL=&amp;quot;DEBUG&amp;quot;&lt;br /&gt;
&lt;br /&gt;
# config del instalador&lt;br /&gt;
INSTALADOR_TIMEOUT=&amp;quot;360&amp;quot;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Una vez editado, verificamos que la configuración sea correcta&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/instalador proyecto:verificar&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Si no sale ninguna alerta, procedemos a instalar.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/instalador proyecto:instalar&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
Una vez instalado, modificamos los permisos de los archivos de la instalación con el comando&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
sudo ./bin/instalador permisos:simple&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Luego configuramos apache.&lt;br /&gt;
En mi caso, como tengo toda la plataforma instalada en un mismo servidor, debo usar el '''ServerName &amp;quot;registry.local.siu&amp;quot;'''&lt;br /&gt;
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'''&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;VirtualHost *:80&amp;gt;&lt;br /&gt;
ServerName registry.local.siu&lt;br /&gt;
Include /usr/local/siu/registry/config/alias.conf&lt;br /&gt;
&amp;lt;/VirtualHost&amp;gt;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Con todo esto, para verificar que todo funcione reiniciamos Apache y ejecutamos&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
curl --user registry:registry http://registry.local.siu/arai-registry/rest/packages/1&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Si la salida es:&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
{&lt;br /&gt;
    &amp;quot;error&amp;quot;: 404,&lt;br /&gt;
    &amp;quot;mensaje&amp;quot;: &amp;quot;404 Not Found&amp;quot;,&lt;br /&gt;
    &amp;quot;descripcion&amp;quot;: &amp;quot;El paquete solicitado no existe&amp;quot;&lt;br /&gt;
}&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
es que la instalación funcionó correctamente.&lt;br /&gt;
&lt;br /&gt;
Con registry instalado procedemos a instalar Usuarios&lt;br /&gt;
&lt;br /&gt;
==Arai-Usuarios==&lt;br /&gt;
&lt;br /&gt;
Nos posicionamos en /usr/local/siu y clonamos el proyecto&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
cd /usr/local/siu&lt;br /&gt;
git clone --branch v1.2.0 https://hub.siu.edu.ar/siu-arai/arai-usuarios.git usuarios&lt;br /&gt;
cd usuarios&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Para instalar seguimos la documentación del archivo '''doc/INSTALACION_MANUAL.md'''&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
composer install --no-dev&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
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.&lt;br /&gt;
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.&lt;br /&gt;
La variable TOBA_USUARIO debe contener el mismo usuarios administrado del LDAP.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
cp templates/arai-usuarios.env.dist arai-usuarios.env&lt;br /&gt;
nano arai-usuarios.env&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
'''arai-usuarios.env.dist'''&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
###### CONFIG DEL INSTALADR ######&lt;br /&gt;
#INSTALADOR_TIMEOUT=&amp;quot;360&amp;quot;&lt;br /&gt;
ENTORNO_PRODUCCION=&amp;quot;1&amp;quot;&lt;br /&gt;
&lt;br /&gt;
###### VARIABLES GLOBALES DEL ARCHIVO ######&lt;br /&gt;
ARAI_USUARIOS_DIR=/usr/local/siu/usuarios&lt;br /&gt;
&lt;br /&gt;
###### CONFIG DE TOBA ######&lt;br /&gt;
TOBA_URL_BASE=&amp;quot;https://usuarios.local.siu&amp;quot;&lt;br /&gt;
#TOBA_URL_PORT=&amp;quot;443&amp;quot;&lt;br /&gt;
TOBA_USUARIO=&amp;quot;admin&amp;quot;&lt;br /&gt;
TOBA_PASSWORD=&amp;quot;admin1234&amp;quot;&lt;br /&gt;
TOBA_INSTALACION_DIR=&amp;quot;${ARAI_USUARIOS_DIR}/instalacion&amp;quot;&lt;br /&gt;
TOBA_PROYECTO_DIR=&amp;quot;${ARAI_USUARIOS_DIR}/gestion&amp;quot;&lt;br /&gt;
TOBA_INSTALAR_USUARIOS=false&lt;br /&gt;
TOBA_INSTALAR_EDITOR=false&lt;br /&gt;
TOBA_INSTALAR_REFERENCIA=false&lt;br /&gt;
TOBA_ALIAS_PROYECTO=&amp;quot;/gestion&amp;quot;&lt;br /&gt;
TOBA_ALIAS_NUCLEO=&amp;quot;/toba_gestion&amp;quot;&lt;br /&gt;
#TOBA_ID_DESARROLLADOR=0&lt;br /&gt;
#TOBA_SESSION_NAME=&amp;quot;ARAI_SESSID&amp;quot;&lt;br /&gt;
&lt;br /&gt;
###### CONFIG DE BASE DE DATOS DE NEGOCIO ######&lt;br /&gt;
PROYECTO_DB_HOST=&amp;quot;172.27.31.114&amp;quot;&lt;br /&gt;
PROYECTO_DB_PORT=&amp;quot;7432&amp;quot;&lt;br /&gt;
PROYECTO_DB_DBNAME=&amp;quot;siu_usuarios&amp;quot;&lt;br /&gt;
PROYECTO_DB_USERNAME=&amp;quot;postgres&amp;quot;&lt;br /&gt;
PROYECTO_DB_PASSWORD=&amp;quot;postgres&amp;quot;&lt;br /&gt;
PROYECTO_DB_SCHEMA=&amp;quot;usuarios&amp;quot;&lt;br /&gt;
PROYECTO_DB_ENCODING=&amp;quot;LATIN1&amp;quot;&lt;br /&gt;
&lt;br /&gt;
###### CONFIG DE BASE DE DATOS DE TOBA. #####&lt;br /&gt;
######## DEFINIR SI SE QUIERE UTILIZAR UNA BASE DISTINTA A LA DE NEGOCIO&lt;br /&gt;
#TOBA_DB_HOST=&amp;quot;localhost&amp;quot;&lt;br /&gt;
#TOBA_DB_PORT=&amp;quot;5432&amp;quot;&lt;br /&gt;
#TOBA_DB_DBNAME=&amp;quot;instalador&amp;quot;&lt;br /&gt;
#TOBA_DB_USERNAME=&amp;quot;postgres&amp;quot;&lt;br /&gt;
#TOBA_DB_PASSWORD=&amp;quot;postgres&amp;quot;&lt;br /&gt;
#TOBA_DB_SCHEMA=&amp;quot;public&amp;quot;&lt;br /&gt;
&lt;br /&gt;
##### CONFIG IDM #####&lt;br /&gt;
ARAI_USUARIOS_URL_IDP=https://usuarios.local.siu/idp&lt;br /&gt;
## Deberá setearse si el sistema corre detrás de un proxy reverso&lt;br /&gt;
#ARAI_USUARIOS_PROXY_URL_IDP=http://url.arai-usuarios:80/idp&lt;br /&gt;
ARAI_USUARIOS_URL_PORTAL=https://huarpe.local.siu/portal&lt;br /&gt;
ARAI_USUARIOS_URL_PERFIL=https://huarpe.local.siu/perfil&lt;br /&gt;
ARAI_USUARIOS_URL_INSTITUCION=http://siu.edu.ar&lt;br /&gt;
&lt;br /&gt;
ARAI_USUARIOS_SIGLA_INSTITUCION=SIGLA&lt;br /&gt;
ARAI_USUARIOS_EMAIL_SOPORTE=mail.soporte@institucion.edu.ar&lt;br /&gt;
&lt;br /&gt;
##### CONFIG SEGURIDAD ####&lt;br /&gt;
SEGURIDAD_ALGORITMO_PASS=crypt&lt;br /&gt;
SEGURIDAD_LARGO_PASS=8&lt;br /&gt;
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'&lt;br /&gt;
SEGURIDAD_DURACION_DIAS_PASS=120&lt;br /&gt;
SEGURIDAD_RECAPTCHA_SITIO=6Fd_pQwTAAAAAOEqJz6KJmkjsrXcdXrAjWQYggZf&lt;br /&gt;
SEGURIDAD_RECAPTCHA_CLAVE=6Fd_pQwTAAAAAOEqJz6KJmkjsrXcdXrAjWQYggZf&lt;br /&gt;
SEGURIDAD_INTENTOS_RECAPTCHA=3&lt;br /&gt;
&lt;br /&gt;
##### CONFIG IDP #####&lt;br /&gt;
ARAI_USUARIOS_IDP_KEY_FILE=/certs/idp/certificado_idp.pem&lt;br /&gt;
ARAI_USUARIOS_IDP_CERT_FILE=/certs/idp/certificado_idp.crt&lt;br /&gt;
#ARAI_USUARIOS_IDP_LOG_LEVEL='WARNING'&lt;br /&gt;
#ARAI_USUARIOS_IDP_LOG_HANDLER='errorlog'&lt;br /&gt;
&lt;br /&gt;
##### CONFIG MAIL RECOVERY ####&lt;br /&gt;
MAIL_RECOVERY_SUBJECT='Recuperar contraseña SIU-Arai'&lt;br /&gt;
MAIL_RECOVERY_FROM='noreply@institucion.edu.ar'&lt;br /&gt;
MAIL_RECOVERY_REPLYTO='noreply@institucion.edu.ar'&lt;br /&gt;
MAIL_RECOVERY_FROMNAME='Institución'&lt;br /&gt;
&lt;br /&gt;
##### CONFIG LDAP #####&lt;br /&gt;
ARAI_USUARIOS_LDAP_HOST=172.27.31.114&lt;br /&gt;
ARAI_USUARIOS_LDAP_PORT=7389&lt;br /&gt;
ARAI_USUARIOS_LDAP_TLS=0&lt;br /&gt;
ARAI_USUARIOS_LDAP_METHOD=user&lt;br /&gt;
ARAI_USUARIOS_LDAP_BINDUSER=&amp;quot;cn=admin,dc=siu,dc=cin,dc=edu&amp;quot;&lt;br /&gt;
ARAI_USUARIOS_LDAP_BINDPASS=admin&lt;br /&gt;
ARAI_USUARIOS_LDAP_SEARCHBASE=&amp;quot;dc=siu,dc=cin,dc=edu&amp;quot;&lt;br /&gt;
&lt;br /&gt;
##### CONFIG ARAI-REGISTRY #####&lt;br /&gt;
ARAI_REGISTRY_URL=http://registry.local.siu/arai-registry&lt;br /&gt;
ARAI_REGISTRY_USER=user&lt;br /&gt;
ARAI_REGISTRY_PASS=pass&lt;br /&gt;
&lt;br /&gt;
###### CONFIG ENVIO MAILS (SMTP) ######&lt;br /&gt;
SMTP_ENTRADA=&amp;quot;arai-usuarios&amp;quot;&lt;br /&gt;
SMTP_HELO=&amp;quot;mail.unx.edu.ar&amp;quot;&lt;br /&gt;
SMTP_HOST=&amp;quot;smtp.googlemail.com&amp;quot;&lt;br /&gt;
SMTP_PORT=587&lt;br /&gt;
SMTP_FROM =&amp;quot;yo@midominio.com&amp;quot;&lt;br /&gt;
SMTP_SEGURIDAD =&amp;quot;ssl|tls&amp;quot;&lt;br /&gt;
SMTP_AUTH =&amp;quot;1&amp;quot;&lt;br /&gt;
SMTP_USUARIO =&amp;quot;usuario&amp;quot;&lt;br /&gt;
SMTP_CLAVE =&amp;quot;pass&amp;quot;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Una vez editado, verificamos que la configuración sea correcta&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/instalador proyecto:verificar -n&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Si no sale ninguna alerta, procedemos a instalar.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/instalador proyecto:instalar&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
Una vez instalado, modificamos los permisos de los archivos de la instalación con el comando&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
sudo ./bin/instalador permisos:simple&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
Cambiamos el modo mantenimiento&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/instalador instalacion:modo-mantenimiento --sin-mantenimiento -n&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Luego configuramos Apache.&lt;br /&gt;
Lo mismo que con registry, como tengo toda la plataforma instalada en un mismo servidor, debo usar el '''ServerName &amp;quot;usuarios.local.siu&amp;quot;'''&lt;br /&gt;
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'''&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;VirtualHost *:80&amp;gt;&lt;br /&gt;
    ServerName usuarios.local.siu&lt;br /&gt;
    Redirect permanent / https://usuarios.local.siu/&lt;br /&gt;
&amp;lt;/VirtualHost&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&amp;lt;VirtualHost *:443&amp;gt;&lt;br /&gt;
&lt;br /&gt;
ServerName usuarios.local.siu&lt;br /&gt;
&lt;br /&gt;
SSLEngine on&lt;br /&gt;
SSLCertificateFile /certs/usuarios.local.siu.cert.pem&lt;br /&gt;
SSLCertificateKeyFile /certs/usuarios.local.siu.key.pem&lt;br /&gt;
&lt;br /&gt;
Include /usr/local/siu/usuarios/instalacion/toba.conf&lt;br /&gt;
&lt;br /&gt;
Include /usr/local/siu/usuarios/instalacion/idp.conf&lt;br /&gt;
&lt;br /&gt;
&amp;lt;/VirtualHost&amp;gt;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Reiniciamos Apache y todo debería funcionar, para verificar entramos en la URL definida para usuarios, en mi caso https://usuarios.local.siu/gestion&lt;br /&gt;
&lt;br /&gt;
Con todo esto funcionando el siguiente paso es agregar Usuarios a Registry y sincronizarlos. &lt;br /&gt;
Según esta instalación para agregar Usuarios al entorno hacemos&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/arai-cli registry:add --maintainer-email  jpiazza@siu.edu.ar --maintainer jpiazza http://registry.local.siu/arai-registry&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
y para sincronizarlo&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/arai-cli registry:sync&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== Arai-Huarpe ==&lt;br /&gt;
&lt;br /&gt;
Es similar a las instalaciones anteriores.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
cd /usr/local/siu&lt;br /&gt;
git clone --branch v1.1.0 https://hub.siu.edu.ar/siu-arai/huarpe-core.git huarpe&lt;br /&gt;
cd huarpe&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Para instalar seguimos la documentación del archivo '''doc/INSTALACION_MANUAL.md'''&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
composer install --no-dev&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
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.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
cp templates/huarpe.env.dist huarpe.env&lt;br /&gt;
nano huarpe.env&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
'''huarpe.env'''&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
###### CONFIG DEL INSTALADR ######&lt;br /&gt;
#INSTALADOR_TIMEOUT=&amp;quot;360&amp;quot;&lt;br /&gt;
ENTORNO_PRODUCCION=1&lt;br /&gt;
&lt;br /&gt;
###### CONFIG DE SIU-HUARPE ######&lt;br /&gt;
HUARPE_PATH=/usr/local/siu/huarpe&lt;br /&gt;
HUARPE_URL=https://huarpe.local.siu&lt;br /&gt;
HUARPE_URL_PORT=443&lt;br /&gt;
HUARPE_SESSION_NAME=huarpe&lt;br /&gt;
HUARPE_SESSION_HANDLER=&amp;quot;native_file&amp;quot;&lt;br /&gt;
#HUARPE_MEMCACHED_HOST=127.0.0.1&lt;br /&gt;
#HUARPE_MEMCACHED_PORT=11211&lt;br /&gt;
HUARPE_CERT_FILE=/certs/huarpe-cli.cert.pem&lt;br /&gt;
HUARPE_KEY_FILE=/certs/huarpe-cli.key.pem&lt;br /&gt;
#HUARPE_TOKEN=unt0k3n-al3at0r1o-s39ur0?&lt;br /&gt;
#HUARPE_PROXY=127.0.0.1&lt;br /&gt;
HUARPE_LOG_HANDLER=&amp;quot;error_log&amp;quot;&lt;br /&gt;
HUARPE_LOG_LEVEL=&amp;quot;DEBUG&amp;quot;&lt;br /&gt;
&lt;br /&gt;
###### CONFIG DE SIU-ARAI: REGISTRY ######&lt;br /&gt;
ARAI_REGISTRY_URL=http://registry.local.siu/arai-registry&lt;br /&gt;
ARAI_REGISTRY_USER=user&lt;br /&gt;
ARAI_REGISTRY_PASS=pass&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Una vez editado, verificamos que la configuración sea correcta&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/instalador proyecto:verificar&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
Si no sale ninguna alerta, procedemos a instalar.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
sudo ./bin/instalador proyecto:instalar&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
En Synfony es necesario dumpear los estilos y los JS con el siguiente comando.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/console assetic:dump --no-debug&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
Una vez instalado, modificamos los permisos de los archivos de la instalación con el comando&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
sudo ./bin/instalador permisos:simple&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Configuración apache ===&lt;br /&gt;
Lo mismo que con Registry o Usuarios, como tengo toda la plataforma instalada en un mismo servidor, debo usar el '''ServerName huarpe.local.siu'''.&lt;br /&gt;
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&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;VirtualHost *:80&amp;gt;&lt;br /&gt;
	ServerName huarpe.local.siu&lt;br /&gt;
	Redirect permanent / https://huarpe.local.siu:443/&lt;br /&gt;
&amp;lt;/VirtualHost&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;VirtualHost *:443&amp;gt;&lt;br /&gt;
&lt;br /&gt;
ServerName huarpe.local.siu&lt;br /&gt;
SSLEngine on&lt;br /&gt;
SSLCertificateFile /certs/huarpe.local.siu.cert.pem&lt;br /&gt;
SSLCertificateKeyFile /certs/huarpe.local.siu.key.pem&lt;br /&gt;
&lt;br /&gt;
Include /usr/local/siu/huarpe/app/config/alias.conf&lt;br /&gt;
&lt;br /&gt;
&amp;lt;/VirtualHost&amp;gt;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Reiniciamos apache, antes de verificar la instalación, debemos sincronizar con Registry.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/arai-cli registry:add --maintainer-email  jpiazza@siu.edu.ar --maintainer jpiazza http://registry.local.siu/arai-registry&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
Luego sincronizar&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/arai-cli registry:sync&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Hay que limpiar la cache y actualizar los permisos&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/console cache:clear --env=prod&lt;br /&gt;
sudo ./bin/instalador permisos:simple &lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
En Usuarios resincronizar para que se actualice con la nueva instalación&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
cd /usr/local/siu/usuarios&lt;br /&gt;
./bin/arai-cli registry:sync&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Para verificar que la instalación se realizo con éxito de debe ingresar en https://huarpe.local.siu/&lt;br /&gt;
&lt;br /&gt;
Si todo salio bien, tenemos instalada la plataforma ARAI lista para ser usada en nuestro servidor.&lt;/div&gt;</summary>
		<author><name>Ablanco</name></author>	</entry>

	<entry>
		<id>https://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Arai/ejemploPasoAPaso&amp;diff=27608</id>
		<title>SIU-Arai/ejemploPasoAPaso</title>
		<link rel="alternate" type="text/html" href="https://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Arai/ejemploPasoAPaso&amp;diff=27608"/>
				<updated>2017-08-02T18:46:29Z</updated>
		
		<summary type="html">&lt;p&gt;Ablanco: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;= Ejemplo paso a paso =&lt;br /&gt;
&lt;br /&gt;
Para este caso voy a usar una instalación de Debian Jessie&lt;br /&gt;
&lt;br /&gt;
El objetivo es tener una instalación funcionando de la paltaforma SIU-Arai que luego sirva para integrar otros sistemas toba.&lt;br /&gt;
&lt;br /&gt;
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í&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable zebra&amp;quot;&lt;br /&gt;
!colspan=&amp;quot;2&amp;quot;|URLs&lt;br /&gt;
|-&lt;br /&gt;
|Araí-Registry&lt;br /&gt;
|https://usuarios.local.siu&lt;br /&gt;
|-&lt;br /&gt;
|Araí-Usuarios&lt;br /&gt;
|https://huarpe.local.siu&lt;br /&gt;
|-&lt;br /&gt;
|Araí-Huarpe&lt;br /&gt;
|https://huarpe&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
== Creación de certificados ==&lt;br /&gt;
Hay que tener en cuenta que voy a usar conexión segura, por lo que tanto voy a necesitar certificados.&lt;br /&gt;
Para crear los certificados uso el tutorial que se encuentra en http://documentacion.siu.edu.ar/wiki/SIU-Arai/certificados. &lt;br /&gt;
Ese artículo asume &lt;br /&gt;
 * Docker instalado (https://docs.docker.com/engine/installation/linux/docker-ce/debian/#install-using-the-repository). &lt;br /&gt;
 * Docker Compose instalado (https://github.com/docker/compose/releases). &lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
git clone https://hub.siu.edu.ar/siu/instaladores.git dockerCerts&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Editamos el archivo docker-compose según nuestras necesidades.&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
cd dockerCerts/certs&lt;br /&gt;
nano docker-compose.yml&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
En mi caso quedo así:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt; &lt;br /&gt;
certificados:&lt;br /&gt;
  image: siutoba/docker-certs&lt;br /&gt;
  container_name: docker-certs&amp;lt;br/&amp;gt;&lt;br /&gt;
  #env_file: docker.env&amp;lt;br/&amp;gt;&lt;br /&gt;
  environment:&amp;lt;br/&amp;gt;&lt;br /&gt;
    DOCKER_NAME: certs&amp;lt;br/&amp;gt;&lt;br /&gt;
    CA_PWD: pass&amp;lt;br/&amp;gt;&lt;br /&gt;
    CA_INT_PWD: pass&amp;lt;br/&amp;gt;&lt;br /&gt;
    LISTA_SERVER: huarpe.local.siu usuarios.local.siu&amp;lt;br/&amp;gt;&lt;br /&gt;
    LISTA_CLIENTES: usuarios-cli huarpe-cli&amp;lt;br/&amp;gt;&lt;br /&gt;
  volumes:&amp;lt;br/&amp;gt;&lt;br /&gt;
    - ./data/certificados:/CAs/intermediate&amp;lt;br/&amp;gt;&lt;br /&gt;
    - ./data/root:/CAs/rootCA&amp;lt;br/&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Guardamos y generamos el container.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
docker-compose up&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Una vez generado el container copiamos los certificados creados en la carpeta que nos sea mas cómodo, en mi caso /certs&lt;br /&gt;
Sin cambiar de directorio hacemos:&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
sudo mkdir /certs&lt;br /&gt;
sudo find data -name &amp;quot;*.pem&amp;quot; -exec cp {} /certs \;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Luego generamos los certificados para el IDP:&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
mkdir /certs/idp&lt;br /&gt;
cd /certs/idp&lt;br /&gt;
openssl req -newkey rsa:2048 -new -x509 -days 3652 -nodes -out certificado_idp.crt -keyout certificado_idp.pem&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Listo, con las URL definidas y los certificados creados se puede proceder a instalar la plataforma.&lt;br /&gt;
&lt;br /&gt;
== Instalación Arai-Registy ==&lt;br /&gt;
Creamos la carpeta '''/usr/local/siu''' y no posicionamos ahí&lt;br /&gt;
Clonamos el proyecto &lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
git clone https://hub.siu.edu.ar/siu-arai/arai-registry.git registry&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
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.&lt;br /&gt;
&lt;br /&gt;
Dentro del directorio del proyecto encontramos el archivo &amp;quot;doc/INSTALACION MANUAL.md&amp;quot;, la idea es seguir las instrucciones que encontramos en este archivo.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
cd registry&lt;br /&gt;
composer install --no-dev&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
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.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
cp templates/arai-registry.env.dist arai-registry.env&lt;br /&gt;
nano arai-registry.env&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
'''arai-registry.env'''&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
# config de la aplicacion&lt;br /&gt;
ARAI_REGISTRY_ALIAS=&amp;quot;/arai-registry&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_USER=&amp;quot;user&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_PASS=&amp;quot;pass&amp;quot;&lt;br /&gt;
&lt;br /&gt;
# config de la base de datos&lt;br /&gt;
ARAI_REGISTRY_DB_HOST=&amp;quot;172.27.31.114&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_DB_PORT=&amp;quot;7432&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_DB_DBNAME=&amp;quot;siu_registry&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_DB_USERNAME=&amp;quot;postgres&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_DB_PASSWORD=&amp;quot;postgres&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_DB_SCHEMA=&amp;quot;registry&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_DB_ENCODING=&amp;quot;UTF8&amp;quot;&lt;br /&gt;
&lt;br /&gt;
###### CONFIG DE LOGS ######&lt;br /&gt;
ARAI_REGISTRY_LOG_HANDLER=&amp;quot;errorlog&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_LOG_LEVEL=&amp;quot;DEBUG&amp;quot;&lt;br /&gt;
&lt;br /&gt;
# config del instalador&lt;br /&gt;
INSTALADOR_TIMEOUT=&amp;quot;360&amp;quot;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Una vez editado, verificamos que la configuración sea correcta&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/instalador proyecto:verificar&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Si no sale ninguna alerta, procedemos a instalar.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/instalador proyecto:instalar&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
Una vez instalado, modificamos los permisos de los archivos de la instalación con el comando&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
sudo ./bin/instalador permisos:simple&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Luego configuramos apache.&lt;br /&gt;
En mi caso, como tengo toda la plataforma instalada en un mismo servidor, debo usar el '''ServerName &amp;quot;registry.local.siu&amp;quot;'''&lt;br /&gt;
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'''&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;VirtualHost *:80&amp;gt;&lt;br /&gt;
ServerName registry.local.siu&lt;br /&gt;
Include /usr/local/siu/registry/config/alias.conf&lt;br /&gt;
&amp;lt;/VirtualHost&amp;gt;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Con todo esto, para verificar que todo funcione reiniciamos Apache y ejecutamos&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
curl --user registry:registry http://registry.local.siu/arai-registry/rest/packages/1&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Si la salida es:&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
{&lt;br /&gt;
    &amp;quot;error&amp;quot;: 404,&lt;br /&gt;
    &amp;quot;mensaje&amp;quot;: &amp;quot;404 Not Found&amp;quot;,&lt;br /&gt;
    &amp;quot;descripcion&amp;quot;: &amp;quot;El paquete solicitado no existe&amp;quot;&lt;br /&gt;
}&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
es que la instalación funcionó correctamente.&lt;br /&gt;
&lt;br /&gt;
Con registry instalado procedemos a instalar Usuarios&lt;br /&gt;
&lt;br /&gt;
==Arai-Usuarios==&lt;br /&gt;
&lt;br /&gt;
Nos posicionamos en /usr/local/siu y clonamos el proyecto&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
cd /usr/local/siu&lt;br /&gt;
git clone --branch v1.2.0 https://hub.siu.edu.ar/siu-arai/arai-usuarios.git usuarios&lt;br /&gt;
cd usuarios&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Para instalar seguimos la documentación del archivo '''doc/INSTALACION_MANUAL.md'''&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
composer install --no-dev&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
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.&lt;br /&gt;
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.&lt;br /&gt;
La variable TOBA_USUARIO debe contener el mismo usuarios administrado del LDAP.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
cp templates/arai-usuarios.env.dist arai-usuarios.env&lt;br /&gt;
nano arai-usuarios.env&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
'''arai-usuarios.env.dist'''&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
###### CONFIG DEL INSTALADR ######&lt;br /&gt;
#INSTALADOR_TIMEOUT=&amp;quot;360&amp;quot;&lt;br /&gt;
ENTORNO_PRODUCCION=&amp;quot;1&amp;quot;&lt;br /&gt;
&lt;br /&gt;
###### VARIABLES GLOBALES DEL ARCHIVO ######&lt;br /&gt;
ARAI_USUARIOS_DIR=/usr/local/siu/usuarios&lt;br /&gt;
&lt;br /&gt;
###### CONFIG DE TOBA ######&lt;br /&gt;
TOBA_URL_BASE=&amp;quot;https://usuarios.local.siu&amp;quot;&lt;br /&gt;
#TOBA_URL_PORT=&amp;quot;443&amp;quot;&lt;br /&gt;
TOBA_USUARIO=&amp;quot;admin&amp;quot;&lt;br /&gt;
TOBA_PASSWORD=&amp;quot;admin1234&amp;quot;&lt;br /&gt;
TOBA_INSTALACION_DIR=&amp;quot;${ARAI_USUARIOS_DIR}/instalacion&amp;quot;&lt;br /&gt;
TOBA_PROYECTO_DIR=&amp;quot;${ARAI_USUARIOS_DIR}/gestion&amp;quot;&lt;br /&gt;
TOBA_INSTALAR_USUARIOS=false&lt;br /&gt;
TOBA_INSTALAR_EDITOR=false&lt;br /&gt;
TOBA_INSTALAR_REFERENCIA=false&lt;br /&gt;
TOBA_ALIAS_PROYECTO=&amp;quot;/gestion&amp;quot;&lt;br /&gt;
TOBA_ALIAS_NUCLEO=&amp;quot;/toba_gestion&amp;quot;&lt;br /&gt;
#TOBA_ID_DESARROLLADOR=0&lt;br /&gt;
#TOBA_SESSION_NAME=&amp;quot;ARAI_SESSID&amp;quot;&lt;br /&gt;
&lt;br /&gt;
###### CONFIG DE BASE DE DATOS DE NEGOCIO ######&lt;br /&gt;
PROYECTO_DB_HOST=&amp;quot;172.27.31.114&amp;quot;&lt;br /&gt;
PROYECTO_DB_PORT=&amp;quot;7432&amp;quot;&lt;br /&gt;
PROYECTO_DB_DBNAME=&amp;quot;siu_usuarios&amp;quot;&lt;br /&gt;
PROYECTO_DB_USERNAME=&amp;quot;postgres&amp;quot;&lt;br /&gt;
PROYECTO_DB_PASSWORD=&amp;quot;postgres&amp;quot;&lt;br /&gt;
PROYECTO_DB_SCHEMA=&amp;quot;usuarios&amp;quot;&lt;br /&gt;
PROYECTO_DB_ENCODING=&amp;quot;LATIN1&amp;quot;&lt;br /&gt;
&lt;br /&gt;
###### CONFIG DE BASE DE DATOS DE TOBA. #####&lt;br /&gt;
######## DEFINIR SI SE QUIERE UTILIZAR UNA BASE DISTINTA A LA DE NEGOCIO&lt;br /&gt;
#TOBA_DB_HOST=&amp;quot;localhost&amp;quot;&lt;br /&gt;
#TOBA_DB_PORT=&amp;quot;5432&amp;quot;&lt;br /&gt;
#TOBA_DB_DBNAME=&amp;quot;instalador&amp;quot;&lt;br /&gt;
#TOBA_DB_USERNAME=&amp;quot;postgres&amp;quot;&lt;br /&gt;
#TOBA_DB_PASSWORD=&amp;quot;postgres&amp;quot;&lt;br /&gt;
#TOBA_DB_SCHEMA=&amp;quot;public&amp;quot;&lt;br /&gt;
&lt;br /&gt;
##### CONFIG IDM #####&lt;br /&gt;
ARAI_USUARIOS_URL_IDP=https://usuarios.local.siu/idp&lt;br /&gt;
## Deberá setearse si el sistema corre detrás de un proxy reverso&lt;br /&gt;
#ARAI_USUARIOS_PROXY_URL_IDP=http://url.arai-usuarios:80/idp&lt;br /&gt;
ARAI_USUARIOS_URL_PORTAL=https://huarpe.local.siu/portal&lt;br /&gt;
ARAI_USUARIOS_URL_PERFIL=https://huarpe.local.siu/perfil&lt;br /&gt;
ARAI_USUARIOS_URL_INSTITUCION=http://siu.edu.ar&lt;br /&gt;
&lt;br /&gt;
ARAI_USUARIOS_SIGLA_INSTITUCION=SIGLA&lt;br /&gt;
ARAI_USUARIOS_EMAIL_SOPORTE=mail.soporte@institucion.edu.ar&lt;br /&gt;
&lt;br /&gt;
##### CONFIG SEGURIDAD ####&lt;br /&gt;
SEGURIDAD_ALGORITMO_PASS=crypt&lt;br /&gt;
SEGURIDAD_LARGO_PASS=8&lt;br /&gt;
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'&lt;br /&gt;
SEGURIDAD_DURACION_DIAS_PASS=120&lt;br /&gt;
SEGURIDAD_RECAPTCHA_SITIO=6Fd_pQwTAAAAAOEqJz6KJmkjsrXcdXrAjWQYggZf&lt;br /&gt;
SEGURIDAD_RECAPTCHA_CLAVE=6Fd_pQwTAAAAAOEqJz6KJmkjsrXcdXrAjWQYggZf&lt;br /&gt;
SEGURIDAD_INTENTOS_RECAPTCHA=3&lt;br /&gt;
&lt;br /&gt;
##### CONFIG IDP #####&lt;br /&gt;
ARAI_USUARIOS_IDP_KEY_FILE=/certs/idp/certificado_idp.pem&lt;br /&gt;
ARAI_USUARIOS_IDP_CERT_FILE=/certs/idp/certificado_idp.crt&lt;br /&gt;
#ARAI_USUARIOS_IDP_LOG_LEVEL='WARNING'&lt;br /&gt;
#ARAI_USUARIOS_IDP_LOG_HANDLER='errorlog'&lt;br /&gt;
&lt;br /&gt;
##### CONFIG MAIL RECOVERY ####&lt;br /&gt;
MAIL_RECOVERY_SUBJECT='Recuperar contraseña SIU-Arai'&lt;br /&gt;
MAIL_RECOVERY_FROM='noreply@institucion.edu.ar'&lt;br /&gt;
MAIL_RECOVERY_REPLYTO='noreply@institucion.edu.ar'&lt;br /&gt;
MAIL_RECOVERY_FROMNAME='Institución'&lt;br /&gt;
&lt;br /&gt;
##### CONFIG LDAP #####&lt;br /&gt;
ARAI_USUARIOS_LDAP_HOST=172.27.31.114&lt;br /&gt;
ARAI_USUARIOS_LDAP_PORT=7389&lt;br /&gt;
ARAI_USUARIOS_LDAP_TLS=0&lt;br /&gt;
ARAI_USUARIOS_LDAP_METHOD=user&lt;br /&gt;
ARAI_USUARIOS_LDAP_BINDUSER=&amp;quot;cn=admin,dc=siu,dc=cin,dc=edu&amp;quot;&lt;br /&gt;
ARAI_USUARIOS_LDAP_BINDPASS=admin&lt;br /&gt;
ARAI_USUARIOS_LDAP_SEARCHBASE=&amp;quot;dc=siu,dc=cin,dc=edu&amp;quot;&lt;br /&gt;
&lt;br /&gt;
##### CONFIG ARAI-REGISTRY #####&lt;br /&gt;
ARAI_REGISTRY_URL=http://registry.local.siu/arai-registry&lt;br /&gt;
ARAI_REGISTRY_USER=user&lt;br /&gt;
ARAI_REGISTRY_PASS=pass&lt;br /&gt;
&lt;br /&gt;
###### CONFIG ENVIO MAILS (SMTP) ######&lt;br /&gt;
SMTP_ENTRADA=&amp;quot;arai-usuarios&amp;quot;&lt;br /&gt;
SMTP_HELO=&amp;quot;mail.unx.edu.ar&amp;quot;&lt;br /&gt;
SMTP_HOST=&amp;quot;smtp.googlemail.com&amp;quot;&lt;br /&gt;
SMTP_PORT=587&lt;br /&gt;
SMTP_FROM =&amp;quot;yo@midominio.com&amp;quot;&lt;br /&gt;
SMTP_SEGURIDAD =&amp;quot;ssl|tls&amp;quot;&lt;br /&gt;
SMTP_AUTH =&amp;quot;1&amp;quot;&lt;br /&gt;
SMTP_USUARIO =&amp;quot;usuario&amp;quot;&lt;br /&gt;
SMTP_CLAVE =&amp;quot;pass&amp;quot;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Una vez editado, verificamos que la configuración sea correcta&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/instalador proyecto:verificar -n&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Si no sale ninguna alerta, procedemos a instalar.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/instalador proyecto:instalar&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
Una vez instalado, modificamos los permisos de los archivos de la instalación con el comando&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
sudo ./bin/instalador permisos:simple&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
Cambiamos el modo mantenimiento&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/instalador instalacion:modo-mantenimiento --sin-mantenimiento -n&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Luego configuramos Apache.&lt;br /&gt;
Lo mismo que con registry, como tengo toda la plataforma instalada en un mismo servidor, debo usar el '''ServerName &amp;quot;usuarios.local.siu&amp;quot;'''&lt;br /&gt;
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'''&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;VirtualHost *:80&amp;gt;&lt;br /&gt;
    ServerName usuarios.local.siu&lt;br /&gt;
    Redirect permanent / https://usuarios.local.siu/&lt;br /&gt;
&amp;lt;/VirtualHost&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&amp;lt;VirtualHost *:443&amp;gt;&lt;br /&gt;
&lt;br /&gt;
ServerName usuarios.local.siu&lt;br /&gt;
&lt;br /&gt;
SSLEngine on&lt;br /&gt;
SSLCertificateFile /certs/usuarios.local.siu.cert.pem&lt;br /&gt;
SSLCertificateKeyFile /certs/usuarios.local.siu.key.pem&lt;br /&gt;
&lt;br /&gt;
Include /usr/local/siu/usuarios/instalacion/toba.conf&lt;br /&gt;
&lt;br /&gt;
Include /usr/local/siu/usuarios/instalacion/idp.conf&lt;br /&gt;
&lt;br /&gt;
&amp;lt;/VirtualHost&amp;gt;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Reiniciamos Apache y todo debería funcionar, para verificar entramos en la URL definida para usuarios, en mi caso https://usuarios.local.siu/gestion&lt;br /&gt;
&lt;br /&gt;
Con todo esto funcionando el siguiente paso es agregar Usuarios a Registry y sincronizarlos. &lt;br /&gt;
Según esta instalación para agregar Usuarios al entorno hacemos&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/arai-cli registry:add --maintainer-email  jpiazza@siu.edu.ar --maintainer jpiazza http://registry.local.siu/arai-registry&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
y para sincronizarlo&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/arai-cli registry:sync&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
===Arai-Huarpe===&lt;br /&gt;
&lt;br /&gt;
Es similar a las instalaciones anteriores.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
cd /usr/local/siu&lt;br /&gt;
git clone --branch v1.1.0 https://hub.siu.edu.ar/siu-arai/huarpe-core.git huarpe&lt;br /&gt;
cd huarpe&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Para instalar seguimos la documentación del archivo '''doc/INSTALACION_MANUAL.md'''&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
composer install --no-dev&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
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.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
cp templates/huarpe.env.dist huarpe.env&lt;br /&gt;
nano huarpe.env&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
'''huarpe.env'''&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
###### CONFIG DEL INSTALADR ######&lt;br /&gt;
#INSTALADOR_TIMEOUT=&amp;quot;360&amp;quot;&lt;br /&gt;
ENTORNO_PRODUCCION=1&lt;br /&gt;
&lt;br /&gt;
###### CONFIG DE SIU-HUARPE ######&lt;br /&gt;
HUARPE_PATH=/usr/local/siu/huarpe&lt;br /&gt;
HUARPE_URL=https://huarpe.local.siu&lt;br /&gt;
HUARPE_URL_PORT=443&lt;br /&gt;
HUARPE_SESSION_NAME=huarpe&lt;br /&gt;
HUARPE_SESSION_HANDLER=&amp;quot;native_file&amp;quot;&lt;br /&gt;
#HUARPE_MEMCACHED_HOST=127.0.0.1&lt;br /&gt;
#HUARPE_MEMCACHED_PORT=11211&lt;br /&gt;
HUARPE_CERT_FILE=/certs/huarpe-cli.cert.pem&lt;br /&gt;
HUARPE_KEY_FILE=/certs/huarpe-cli.key.pem&lt;br /&gt;
#HUARPE_TOKEN=unt0k3n-al3at0r1o-s39ur0?&lt;br /&gt;
#HUARPE_PROXY=127.0.0.1&lt;br /&gt;
HUARPE_LOG_HANDLER=&amp;quot;error_log&amp;quot;&lt;br /&gt;
HUARPE_LOG_LEVEL=&amp;quot;DEBUG&amp;quot;&lt;br /&gt;
&lt;br /&gt;
###### CONFIG DE SIU-ARAI: REGISTRY ######&lt;br /&gt;
ARAI_REGISTRY_URL=http://registry.local.siu/arai-registry&lt;br /&gt;
ARAI_REGISTRY_USER=user&lt;br /&gt;
ARAI_REGISTRY_PASS=pass&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Una vez editado, verificamos que la configuración sea correcta&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/instalador proyecto:verificar&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
Si no sale ninguna alerta, procedemos a instalar.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/instalador proyecto:instalar&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
En Synfony es necesario dumpear los estilos y los JS con el siguiente comando.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/console assetic:dump --no-debug&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
Una vez instalado, modificamos los permisos de los archivos de la instalación con el comando&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/instalador permisos:simple&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Configuramos apache.&lt;br /&gt;
Lo mismo que con registry u usuarios, como tengo toda la plataforma instalada en un mismo servidor, debo usar el '''ServerName huarpe.local.siu'''.&lt;br /&gt;
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&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;VirtualHost *:80&amp;gt;&lt;br /&gt;
	ServerName huarpe.local.siu&lt;br /&gt;
	Redirect permanent / https://huarpe.local.siu:443/&lt;br /&gt;
&amp;lt;/VirtualHost&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;VirtualHost *:443&amp;gt;&lt;br /&gt;
&lt;br /&gt;
ServerName huarpe.local.siu&lt;br /&gt;
SSLEngine on&lt;br /&gt;
SSLCertificateFile /certs/huarpe.local.siu.cert.pem&lt;br /&gt;
SSLCertificateKeyFile /certs/huarpe.local.siu.key.pem&lt;br /&gt;
&lt;br /&gt;
Include /usr/local/siu/huarpe/app/config/alias.conf&lt;br /&gt;
&lt;br /&gt;
&amp;lt;/VirtualHost&amp;gt;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Reiniciamos apache, antes de verificar la instalación, debemos sincronizar con Registry.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/arai-cli registry:add --maintainer-email  jpiazza@siu.edu.ar --maintainer jpiazza http://registry.local.siu/arai-registry&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
Luego sincronizar&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/arai-cli registry:sync&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
Si el archivo no tiene permisos de ejecución&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
chmod +x ./vendor/bin/arai-cli&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
y repetir los dos pasos anteriores.&lt;br /&gt;
&lt;br /&gt;
Para verificar que la instalación se realizo con éxito de debe ingresar en https://huarpe.local.siu/&lt;br /&gt;
&lt;br /&gt;
Si todo salio bien, tenemos instalada la plataforma ARAI lista para ser usada en nuestro servidor.&lt;/div&gt;</summary>
		<author><name>Ablanco</name></author>	</entry>

	<entry>
		<id>https://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Arai/ejemploPasoAPaso&amp;diff=27607</id>
		<title>SIU-Arai/ejemploPasoAPaso</title>
		<link rel="alternate" type="text/html" href="https://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Arai/ejemploPasoAPaso&amp;diff=27607"/>
				<updated>2017-08-02T18:05:44Z</updated>
		
		<summary type="html">&lt;p&gt;Ablanco: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;= Ejemplo paso a paso =&lt;br /&gt;
&lt;br /&gt;
Para este caso voy a usar una instalación de Debian Jessie&lt;br /&gt;
&lt;br /&gt;
El objetivo es tener una instalación funcionando de la paltaforma SIU-Arai que luego sirva para integrar otros sistemas toba.&lt;br /&gt;
&lt;br /&gt;
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í&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable zebra&amp;quot;&lt;br /&gt;
!colspan=&amp;quot;2&amp;quot;|URLs&lt;br /&gt;
|-&lt;br /&gt;
|Araí-Registry&lt;br /&gt;
|https://usuarios.local.siu&lt;br /&gt;
|-&lt;br /&gt;
|Araí-Usuarios&lt;br /&gt;
|https://huarpe.local.siu&lt;br /&gt;
|-&lt;br /&gt;
|Araí-Huarpe&lt;br /&gt;
|https://huarpe&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
== Creación de certificados ==&lt;br /&gt;
Hay que tener en cuenta que voy a usar conexión segura, por lo que tanto voy a necesitar certificados.&lt;br /&gt;
Para crear los certificados uso el tutorial que se encuentra en http://documentacion.siu.edu.ar/wiki/SIU-Arai/certificados. &lt;br /&gt;
Ese artículo asume &lt;br /&gt;
 * Docker instalado (https://docs.docker.com/engine/installation/linux/docker-ce/debian/#install-using-the-repository). &lt;br /&gt;
 * Docker Compose instalado (https://github.com/docker/compose/releases). &lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
git clone https://hub.siu.edu.ar/siu/instaladores.git dockerCerts&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Editamos el archivo docker-compose según nuestras necesidades.&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
cd dockerCerts/certs&lt;br /&gt;
nano docker-compose.yml&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
En mi caso quedo así:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt; &lt;br /&gt;
certificados:&lt;br /&gt;
  image: siutoba/docker-certs&lt;br /&gt;
  container_name: docker-certs&amp;lt;br/&amp;gt;&lt;br /&gt;
  #env_file: docker.env&amp;lt;br/&amp;gt;&lt;br /&gt;
  environment:&amp;lt;br/&amp;gt;&lt;br /&gt;
    DOCKER_NAME: certs&amp;lt;br/&amp;gt;&lt;br /&gt;
    CA_PWD: pass&amp;lt;br/&amp;gt;&lt;br /&gt;
    CA_INT_PWD: pass&amp;lt;br/&amp;gt;&lt;br /&gt;
    LISTA_SERVER: huarpe.local.siu usuarios.local.siu&amp;lt;br/&amp;gt;&lt;br /&gt;
    LISTA_CLIENTES: usuarios-cli huarpe-cli&amp;lt;br/&amp;gt;&lt;br /&gt;
  volumes:&amp;lt;br/&amp;gt;&lt;br /&gt;
    - ./data/certificados:/CAs/intermediate&amp;lt;br/&amp;gt;&lt;br /&gt;
    - ./data/root:/CAs/rootCA&amp;lt;br/&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Guardamos y generamos el container.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
docker-compose up&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Una vez generado el container copiamos los certificados creados en la carpeta que nos sea mas cómodo, en mi caso /certs&lt;br /&gt;
Sin cambiar de directorio hacemos:&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
sudo mkdir /certs&lt;br /&gt;
sudo find data -name &amp;quot;*.pem&amp;quot; -exec cp {} /certs \;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Luego generamos los certificados para el IDP:&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
mkdir /certs/idp&lt;br /&gt;
cd /certs/idp&lt;br /&gt;
openssl req -newkey rsa:2048 -new -x509 -days 3652 -nodes -out certificado_idp.crt -keyout certificado_idp.pem&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Listo, con las URL definidas y los certificados creados se puede proceder a instalar la plataforma.&lt;br /&gt;
&lt;br /&gt;
== Instalación Arai-Registy ==&lt;br /&gt;
Creamos la carpeta '''/usr/local/siu''' y no posicionamos ahí&lt;br /&gt;
Clonamos el proyecto &lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
git clone https://hub.siu.edu.ar/siu-arai/arai-registry.git registry&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
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.&lt;br /&gt;
&lt;br /&gt;
Dentro del directorio del proyecto encontramos el archivo &amp;quot;doc/INSTALACION MANUAL.md&amp;quot;, la idea es seguir las instrucciones que encontramos en este archivo.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
cd registry&lt;br /&gt;
composer install --no-dev&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
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.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
cp templates/arai-registry.env.dist arai-registry.env&lt;br /&gt;
nano arai-registry.env&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
'''arai-registry.env'''&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
# config de la aplicacion&lt;br /&gt;
ARAI_REGISTRY_ALIAS=&amp;quot;/arai-registry&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_USER=&amp;quot;user&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_PASS=&amp;quot;pass&amp;quot;&lt;br /&gt;
&lt;br /&gt;
# config de la base de datos&lt;br /&gt;
ARAI_REGISTRY_DB_HOST=&amp;quot;172.27.31.114&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_DB_PORT=&amp;quot;7432&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_DB_DBNAME=&amp;quot;siu_registry&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_DB_USERNAME=&amp;quot;postgres&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_DB_PASSWORD=&amp;quot;postgres&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_DB_SCHEMA=&amp;quot;registry&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_DB_ENCODING=&amp;quot;UTF8&amp;quot;&lt;br /&gt;
&lt;br /&gt;
###### CONFIG DE LOGS ######&lt;br /&gt;
ARAI_REGISTRY_LOG_HANDLER=&amp;quot;errorlog&amp;quot;&lt;br /&gt;
ARAI_REGISTRY_LOG_LEVEL=&amp;quot;DEBUG&amp;quot;&lt;br /&gt;
&lt;br /&gt;
# config del instalador&lt;br /&gt;
INSTALADOR_TIMEOUT=&amp;quot;360&amp;quot;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Una vez editado, verificamos que la configuración sea correcta&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/instalador proyecto:verificar&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Si no sale ninguna alerta, procedemos a instalar.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/instalador proyecto:instalar&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
Una vez instalado, modificamos los permisos de los archivos de la instalación con el comando&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
sudo ./bin/instalador permisos:simple&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Luego configuramos apache.&lt;br /&gt;
En mi caso, como tengo toda la plataforma instalada en un mismo servidor, debo usar el '''ServerName &amp;quot;registry.local.siu&amp;quot;'''&lt;br /&gt;
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'''&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;VirtualHost *:80&amp;gt;&lt;br /&gt;
ServerName registry.local.siu&lt;br /&gt;
Include /usr/local/siu/registry/config/alias.conf&lt;br /&gt;
&amp;lt;/VirtualHost&amp;gt;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Con todo esto, para verificar que todo funcione reiniciamos Apache y ejecutamos&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
curl --user registry:registry http://registry.local.siu/arai-registry/rest/packages/1&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Si la salida es:&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;json&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
{&lt;br /&gt;
    &amp;quot;error&amp;quot;: 404,&lt;br /&gt;
    &amp;quot;mensaje&amp;quot;: &amp;quot;404 Not Found&amp;quot;,&lt;br /&gt;
    &amp;quot;descripcion&amp;quot;: &amp;quot;El paquete solicitado no existe&amp;quot;&lt;br /&gt;
}&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
es que la instalación funcionó correctamente.&lt;br /&gt;
&lt;br /&gt;
Con registry instalado procedemos a instalar Usuarios&lt;br /&gt;
&lt;br /&gt;
===Arai-Usuarios===&lt;br /&gt;
&lt;br /&gt;
Nos posicionamos en /usr/local/siu y clonamos el proyecto&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
cd /usr/local/siu&lt;br /&gt;
git clone --branch v1.2.0 https://hub.siu.edu.ar/siu-arai/arai-usuarios.git usuarios&lt;br /&gt;
cd usuarios&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Para instalar segumos la documentación del archivo '''doc/INSTALACION_MANUAL.md'''&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
composer install --no-dev&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
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.&lt;br /&gt;
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.&lt;br /&gt;
La variable TOBA_USUARIO debe contener el mismo usuarios administrado del LDAP.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
cp templates/arai-usuarios.env.dist arai-usuarios.env&lt;br /&gt;
nano arai-usuarios.env&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
'''arai-usuarios.env.dist'''&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
###### CONFIG DEL INSTALADR ######&lt;br /&gt;
#INSTALADOR_TIMEOUT=&amp;quot;360&amp;quot;&lt;br /&gt;
ENTORNO_PRODUCCION=&amp;quot;1&amp;quot;&lt;br /&gt;
&lt;br /&gt;
###### VARIABLES GLOBALES DEL ARCHIVO ######&lt;br /&gt;
ARAI_USUARIOS_DIR=/usr/local/siu/usuarios&lt;br /&gt;
&lt;br /&gt;
###### CONFIG DE TOBA ######&lt;br /&gt;
TOBA_URL_BASE=&amp;quot;https://usuarios.local.siu&amp;quot;&lt;br /&gt;
TOBA_URL_PORT=&amp;quot;443&amp;quot;&lt;br /&gt;
TOBA_USUARIO=&amp;quot;admin&amp;quot;&lt;br /&gt;
TOBA_PASSWORD=&amp;quot;admin1234&amp;quot;&lt;br /&gt;
TOBA_INSTALACION_DIR=&amp;quot;${ARAI_USUARIOS_DIR}/instalacion&amp;quot;&lt;br /&gt;
TOBA_PROYECTO_DIR=&amp;quot;${ARAI_USUARIOS_DIR}/gestion&amp;quot;&lt;br /&gt;
TOBA_INSTALAR_USUARIOS=false&lt;br /&gt;
TOBA_INSTALAR_EDITOR=false&lt;br /&gt;
TOBA_INSTALAR_REFERENCIA=false&lt;br /&gt;
TOBA_ALIAS_PROYECTO=&amp;quot;/gestion&amp;quot;&lt;br /&gt;
TOBA_ALIAS_NUCLEO=&amp;quot;/toba_gestion&amp;quot;&lt;br /&gt;
#TOBA_ID_DESARROLLADOR=0&lt;br /&gt;
#TOBA_SESSION_NAME=&amp;quot;ARAI_SESSID&amp;quot;&lt;br /&gt;
&lt;br /&gt;
###### CONFIG DE BASE DE DATOS DE NEGOCIO ######&lt;br /&gt;
PROYECTO_DB_HOST=&amp;quot;172.27.31.114&amp;quot;&lt;br /&gt;
PROYECTO_DB_PORT=&amp;quot;7432&amp;quot;&lt;br /&gt;
PROYECTO_DB_DBNAME=&amp;quot;siu_usuarios&amp;quot;&lt;br /&gt;
PROYECTO_DB_USERNAME=&amp;quot;postgres&amp;quot;&lt;br /&gt;
PROYECTO_DB_PASSWORD=&amp;quot;postgres&amp;quot;&lt;br /&gt;
PROYECTO_DB_SCHEMA=&amp;quot;usuarios&amp;quot;&lt;br /&gt;
&lt;br /&gt;
###### CONFIG DE BASE DE DATOS DE TOBA. #####&lt;br /&gt;
######## DEFINIR SI SE QUIERE UTILIZAR UNA BASE DISTINTA A LA DE NEGOCIO&lt;br /&gt;
#TOBA_DB_HOST=&amp;quot;localhost&amp;quot;&lt;br /&gt;
#TOBA_DB_PORT=&amp;quot;5432&amp;quot;&lt;br /&gt;
#TOBA_DB_DBNAME=&amp;quot;instalador&amp;quot;&lt;br /&gt;
#TOBA_DB_USERNAME=&amp;quot;postgres&amp;quot;&lt;br /&gt;
#TOBA_DB_PASSWORD=&amp;quot;postgres&amp;quot;&lt;br /&gt;
#TOBA_DB_SCHEMA=&amp;quot;public&amp;quot;&lt;br /&gt;
&lt;br /&gt;
##### CONFIG IDM #####&lt;br /&gt;
ARAI_USUARIOS_URL_IDP=https://usuarios.local.siu/idp&lt;br /&gt;
## Deberá setearse si el sistema corre detrás de un proxy reverso&lt;br /&gt;
#ARAI_USUARIOS_PROXY_URL_IDP=http://url.arai-usuarios:80/idp&lt;br /&gt;
ARAI_USUARIOS_URL_PORTAL=https://huarpe.local.siu/portal&lt;br /&gt;
ARAI_USUARIOS_URL_PERFIL=https://huarpe.local.siu/perfil&lt;br /&gt;
ARAI_USUARIOS_URL_INSTITUCION=http://siu.edu.ar&lt;br /&gt;
&lt;br /&gt;
ARAI_USUARIOS_SIGLA_INSTITUCION=SIGLA&lt;br /&gt;
ARAI_USUARIOS_EMAIL_SOPORTE=mail.soporte@institucion.edu.ar&lt;br /&gt;
&lt;br /&gt;
##### CONFIG SEGURIDAD ####&lt;br /&gt;
SEGURIDAD_ALGORITMO_PASS=crypt&lt;br /&gt;
SEGURIDAD_LARGO_PASS=8&lt;br /&gt;
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'&lt;br /&gt;
SEGURIDAD_DURACION_DIAS_PASS=120&lt;br /&gt;
SEGURIDAD_RECAPTCHA_SITIO=6Fd_pQwTAAAAAOEqJz6KJmkjsrXcdXrAjWQYggZf&lt;br /&gt;
SEGURIDAD_RECAPTCHA_CLAVE=6Fd_pQwTAAAAAOEqJz6KJmkjsrXcdXrAjWQYggZf&lt;br /&gt;
SEGURIDAD_INTENTOS_RECAPTCHA=3&lt;br /&gt;
&lt;br /&gt;
##### CONFIG IDP #####&lt;br /&gt;
ARAI_USUARIOS_IDP_KEY_FILE=/certs/idp/certificado_idp.pem&lt;br /&gt;
ARAI_USUARIOS_IDP_CERT_FILE=/certs/idp/certificado_idp.crt&lt;br /&gt;
#ARAI_USUARIOS_IDP_LOG_LEVEL='WARNING'&lt;br /&gt;
#ARAI_USUARIOS_IDP_LOG_HANDLER='errorlog'&lt;br /&gt;
&lt;br /&gt;
##### CONFIG MAIL RECOVERY ####&lt;br /&gt;
MAIL_RECOVERY_SUBJECT='Recuperar contraseña SIU-Arai'&lt;br /&gt;
MAIL_RECOVERY_FROM='noreply@institucion.edu.ar'&lt;br /&gt;
MAIL_RECOVERY_REPLYTO='noreply@institucion.edu.ar'&lt;br /&gt;
MAIL_RECOVERY_FROMNAME='Institución'&lt;br /&gt;
&lt;br /&gt;
##### CONFIG LDAP #####&lt;br /&gt;
ARAI_USUARIOS_LDAP_HOST=172.27.31.114&lt;br /&gt;
ARAI_USUARIOS_LDAP_PORT=7389&lt;br /&gt;
ARAI_USUARIOS_LDAP_TLS=0&lt;br /&gt;
ARAI_USUARIOS_LDAP_METHOD=user&lt;br /&gt;
ARAI_USUARIOS_LDAP_BINDUSER=&amp;quot;cn=admin,dc=siu,dc=cin,dc=edu&amp;quot;&lt;br /&gt;
ARAI_USUARIOS_LDAP_BINDPASS=admin&lt;br /&gt;
ARAI_USUARIOS_LDAP_SEARCHBASE=&amp;quot;dc=siu,dc=cin,dc=edu&amp;quot;&lt;br /&gt;
&lt;br /&gt;
##### CONFIG ARAI-REGISTRY #####&lt;br /&gt;
ARAI_REGISTRY_URL=http://registry.local.siu/arai-registry&lt;br /&gt;
ARAI_REGISTRY_USER=user&lt;br /&gt;
ARAI_REGISTRY_PASS=pass&lt;br /&gt;
&lt;br /&gt;
###### CONFIG ENVIO MAILS (SMTP) ######&lt;br /&gt;
SMTP_ENTRADA=&amp;quot;arai-usuarios&amp;quot;&lt;br /&gt;
SMTP_HELO=&amp;quot;mail.unx.edu.ar&amp;quot;&lt;br /&gt;
SMTP_HOST=&amp;quot;smtp.googlemail.com&amp;quot;&lt;br /&gt;
SMTP_PORT=587&lt;br /&gt;
SMTP_FROM =&amp;quot;yo@midominio.com&amp;quot;&lt;br /&gt;
SMTP_SEGURIDAD =&amp;quot;ssl|tls&amp;quot;&lt;br /&gt;
SMTP_AUTH =&amp;quot;1&amp;quot;&lt;br /&gt;
SMTP_USUARIO =&amp;quot;usuario&amp;quot;&lt;br /&gt;
SMTP_CLAVE =&amp;quot;pass&amp;quot;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Una vez editado, verificamos que la configuración sea correcta&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/instalador proyecto:verificar&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Si no sale ninguna alerta, procedemos a instalar.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/instalador proyecto:instalar&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
Una vez instalado, modificamos los permisos de los archivos de la instalación con el comando&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/instalador permisos:simple&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
Cambiamos el modo mantenimiento&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/instalador instalacion:modo-mantenimiento --sin-mantenimiento&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Luego configuramos Apache.&lt;br /&gt;
Lo mismo que con registry, como tengo toda la plataforma instalada en un mismo servidor, debo usar el '''ServerName &amp;quot;usuarios.local.siu&amp;quot;'''&lt;br /&gt;
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'''&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;VirtualHost *:80&amp;gt;&lt;br /&gt;
    ServerName usuarios.local.siu&lt;br /&gt;
    Redirect permanent / https://usuarios.local.siu/&lt;br /&gt;
&amp;lt;/VirtualHost&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&amp;lt;VirtualHost *:443&amp;gt;&lt;br /&gt;
&lt;br /&gt;
ServerName usuarios.local.siu&lt;br /&gt;
&lt;br /&gt;
SSLEngine on&lt;br /&gt;
SSLCertificateFile /certs/usuarios.local.siu.cert.pem&lt;br /&gt;
SSLCertificateKeyFile /certs/usuarios.local.siu.key.pem&lt;br /&gt;
&lt;br /&gt;
Include /usr/local/siu/usuarios/instalacion/toba.conf&lt;br /&gt;
&lt;br /&gt;
Include /usr/local/siu/usuarios/instalacion/idp.conf&lt;br /&gt;
&lt;br /&gt;
&amp;lt;/VirtualHost&amp;gt;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Reiniciamos Apache y todo debería funcionar, para verificar entramos en la URL definida para usuarios, en mi caso https://usuarios.local.siu/gestion&lt;br /&gt;
&lt;br /&gt;
Con todo esto funcionando el siguiente paso es agregar Usuarios a Registry y sincronizarlos. &lt;br /&gt;
Según esta instalación para agregar Usuarios al entorno hacemos&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/arai-cli registry:add --maintainer-email  jpiazza@siu.edu.ar --maintainer jpiazza http://registry.local.siu/arai-registry&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
y para sincronizarlo&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/arai-cli registry:sync&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
===Arai-Huarpe===&lt;br /&gt;
&lt;br /&gt;
Es similar a las instalaciones anteriores.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
cd /usr/local/siu&lt;br /&gt;
git clone --branch v1.1.0 https://hub.siu.edu.ar/siu-arai/huarpe-core.git huarpe&lt;br /&gt;
cd huarpe&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Para instalar seguimos la documentación del archivo '''doc/INSTALACION_MANUAL.md'''&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
composer install --no-dev&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
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.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
cp templates/huarpe.env.dist huarpe.env&lt;br /&gt;
nano huarpe.env&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
'''huarpe.env'''&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
###### CONFIG DEL INSTALADR ######&lt;br /&gt;
#INSTALADOR_TIMEOUT=&amp;quot;360&amp;quot;&lt;br /&gt;
ENTORNO_PRODUCCION=1&lt;br /&gt;
&lt;br /&gt;
###### CONFIG DE SIU-HUARPE ######&lt;br /&gt;
HUARPE_PATH=/usr/local/siu/huarpe&lt;br /&gt;
HUARPE_URL=https://huarpe.local.siu&lt;br /&gt;
HUARPE_URL_PORT=443&lt;br /&gt;
HUARPE_SESSION_NAME=huarpe&lt;br /&gt;
HUARPE_SESSION_HANDLER=&amp;quot;native_file&amp;quot;&lt;br /&gt;
#HUARPE_MEMCACHED_HOST=127.0.0.1&lt;br /&gt;
#HUARPE_MEMCACHED_PORT=11211&lt;br /&gt;
HUARPE_CERT_FILE=/certs/huarpe-cli.cert.pem&lt;br /&gt;
HUARPE_KEY_FILE=/certs/huarpe-cli.key.pem&lt;br /&gt;
#HUARPE_TOKEN=unt0k3n-al3at0r1o-s39ur0?&lt;br /&gt;
#HUARPE_PROXY=127.0.0.1&lt;br /&gt;
HUARPE_LOG_HANDLER=&amp;quot;error_log&amp;quot;&lt;br /&gt;
HUARPE_LOG_LEVEL=&amp;quot;DEBUG&amp;quot;&lt;br /&gt;
&lt;br /&gt;
###### CONFIG DE SIU-ARAI: REGISTRY ######&lt;br /&gt;
ARAI_REGISTRY_URL=http://registry.local.siu/arai-registry&lt;br /&gt;
ARAI_REGISTRY_USER=user&lt;br /&gt;
ARAI_REGISTRY_PASS=pass&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Una vez editado, verificamos que la configuración sea correcta&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/instalador proyecto:verificar&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
Si no sale ninguna alerta, procedemos a instalar.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/instalador proyecto:instalar&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
En Synfony es necesario dumpear los estilos y los JS con el siguiente comando.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/console assetic:dump --no-debug&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
Una vez instalado, modificamos los permisos de los archivos de la instalación con el comando&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/instalador permisos:simple&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Configuramos apache.&lt;br /&gt;
Lo mismo que con registry u usuarios, como tengo toda la plataforma instalada en un mismo servidor, debo usar el '''ServerName huarpe.local.siu'''.&lt;br /&gt;
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&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;VirtualHost *:80&amp;gt;&lt;br /&gt;
	ServerName huarpe.local.siu&lt;br /&gt;
	Redirect permanent / https://huarpe.local.siu:443/&lt;br /&gt;
&amp;lt;/VirtualHost&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;VirtualHost *:443&amp;gt;&lt;br /&gt;
&lt;br /&gt;
ServerName huarpe.local.siu&lt;br /&gt;
SSLEngine on&lt;br /&gt;
SSLCertificateFile /certs/huarpe.local.siu.cert.pem&lt;br /&gt;
SSLCertificateKeyFile /certs/huarpe.local.siu.key.pem&lt;br /&gt;
&lt;br /&gt;
Include /usr/local/siu/huarpe/app/config/alias.conf&lt;br /&gt;
&lt;br /&gt;
&amp;lt;/VirtualHost&amp;gt;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Reiniciamos apache, antes de verificar la instalación, debemos sincronizar con Registry.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/arai-cli registry:add --maintainer-email  jpiazza@siu.edu.ar --maintainer jpiazza http://registry.local.siu/arai-registry&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
Luego sincronizar&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/arai-cli registry:sync&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
Si el archivo no tiene permisos de ejecución&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
chmod +x ./vendor/bin/arai-cli&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
y repetir los dos pasos anteriores.&lt;br /&gt;
&lt;br /&gt;
Para verificar que la instalación se realizo con éxito de debe ingresar en https://huarpe.local.siu/&lt;br /&gt;
&lt;br /&gt;
Si todo salio bien, tenemos instalada la plataforma ARAI lista para ser usada en nuestro servidor.&lt;/div&gt;</summary>
		<author><name>Ablanco</name></author>	</entry>

	<entry>
		<id>https://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Arai&amp;diff=27524</id>
		<title>SIU-Arai</title>
		<link rel="alternate" type="text/html" href="https://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Arai&amp;diff=27524"/>
				<updated>2017-07-27T17:53:08Z</updated>
		
		<summary type="html">&lt;p&gt;Ablanco: /* Token SAML */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;[[Archivo:siu-arai_iso.png|derecha|link=SIU-Arai]]&lt;br /&gt;
= SIU-Arai =&lt;br /&gt;
SIU-Araí es la plataforma integradora de servicios del SIU. Cada uno de los sistemas SIU son módulos dentro de la plataforma.&lt;br /&gt;
&lt;br /&gt;
Existen dos módulos que son vitales para el funcionamiento de la plataforma.&lt;br /&gt;
&lt;br /&gt;
* Arai-Registry: Repositorio central de servicios y aplicaciones&lt;br /&gt;
* Arai-Usuarios: IDP e IDM para toda la plataforma&lt;br /&gt;
&lt;br /&gt;
== Forma de trabajo ==&lt;br /&gt;
Toda la distribución de los proyectos se hace a través de gitlab: [https://hub.siu.edu.ar https://hub.siu.edu.ar].&amp;lt;br&amp;gt;&lt;br /&gt;
Cada uno de los módulos tiene una carpeta '''doc''' donde se incluyen instrucciones de instalación.&lt;br /&gt;
&lt;br /&gt;
== Pre Instalación ==&lt;br /&gt;
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.&lt;br /&gt;
=== Que se va a instalar? ===&lt;br /&gt;
* Araí-Registry &lt;br /&gt;
* Araí-Usuarios&lt;br /&gt;
** Un IdP&lt;br /&gt;
** Un módulo de gestión de identidad (IdM)&lt;br /&gt;
* Araí-Huarpe&lt;br /&gt;
=== Que necesitamos? ===&lt;br /&gt;
==== Definir URLs ====&lt;br /&gt;
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:&lt;br /&gt;
{| class=&amp;quot;wikitable zebra&amp;quot;&lt;br /&gt;
!colspan=&amp;quot;3&amp;quot;|URLs&lt;br /&gt;
|-&lt;br /&gt;
|Araí-Registry&lt;br /&gt;
|http://localhost/registry&lt;br /&gt;
|Este servicio no tiene que ser público&lt;br /&gt;
|-&lt;br /&gt;
|Araí-Usuarios IdP&lt;br /&gt;
|https://idp.arai-usuarios&lt;br /&gt;
|Este servicio es público, por eso está con TLS&lt;br /&gt;
|-&lt;br /&gt;
|Araí-Usuarios IdM&lt;br /&gt;
|https://arai-usuarios&lt;br /&gt;
|Este servicio es público, por eso está con TLS&lt;br /&gt;
|-&lt;br /&gt;
|Araí-Huarpe&lt;br /&gt;
|https://huarpe&lt;br /&gt;
|Este servicio es público, por eso está con TLS&lt;br /&gt;
|}&lt;br /&gt;
==== Certificados, certificados, certificados ... ====&lt;br /&gt;
El uso de certificados es extensivo a través de toda la plataforma.&lt;br /&gt;
&lt;br /&gt;
Se usan con tres fines:&lt;br /&gt;
* Para utilizar HTTPS en los servicios públicos y autenticar clientes de las APIs&lt;br /&gt;
* Para firmar el token de SAML&lt;br /&gt;
&lt;br /&gt;
Antes de continuar con la instalación debe generar los certificados necesarios.&lt;br /&gt;
===== HTTPS y autenticación de clientes =====&lt;br /&gt;
Para una instalación de producción es necesario contar con certificados reales válidos. &lt;br /&gt;
&lt;br /&gt;
Si su institución no cuenta con estos certificados son fáciles de obtener con este servicio [https://letsencrypt.org/ Let's Encrypt].&lt;br /&gt;
&lt;br /&gt;
Los certificados de cliente pueden ser auto-firmados porque son para uso interno. &lt;br /&gt;
&lt;br /&gt;
Más información en [[SIU-Arai/certificados|Certificados]]&lt;br /&gt;
&lt;br /&gt;
===== Token SAML =====&lt;br /&gt;
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:&lt;br /&gt;
&lt;br /&gt;
    openssl req -newkey rsa:2048 -new -x509 -days 3652 -nodes -out certificado.crt -keyout certificado.pem&lt;br /&gt;
&lt;br /&gt;
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.&lt;br /&gt;
&lt;br /&gt;
=== Seguridad ===&lt;br /&gt;
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. &lt;br /&gt;
&lt;br /&gt;
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.&lt;br /&gt;
&lt;br /&gt;
== Instalación ==&lt;br /&gt;
Una vez completada la pre-instalación ya se puede seguir con la instalación de cada uno de los módulos.&lt;br /&gt;
# [[SIU-Arai/registry|Arai-Registry]]&lt;br /&gt;
# [[SIU-Arai/usuarios|Arai-Usuarios]]&lt;br /&gt;
# [[SIU-Arai/catalogos-cliente|Arai-Catalogos (cliente)]]&lt;br /&gt;
# [[SIU-Arai/proveedores|Arai-Proveedores ]]&lt;br /&gt;
&lt;br /&gt;
== Módulos ==&lt;br /&gt;
* [[SIU-Arai/huarpe|Huarpe]]: Módulo de autogestión de recursos y servicios. La cara visible de la plataforma para los usuarios..&lt;/div&gt;</summary>
		<author><name>Ablanco</name></author>	</entry>

	<entry>
		<id>https://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Arai/certificados&amp;diff=27519</id>
		<title>SIU-Arai/certificados</title>
		<link rel="alternate" type="text/html" href="https://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Arai/certificados&amp;diff=27519"/>
				<updated>2017-07-26T18:17:52Z</updated>
		
		<summary type="html">&lt;p&gt;Ablanco: /* En el cliente de la API */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;[[Archivo:siu-arai_iso.png|derecha|link=SIU-Arai]]&lt;br /&gt;
= Certificados = &lt;br /&gt;
Se va a explicar como generar los certificados de cliente y servidor para lograr una instalación correcta.&lt;br /&gt;
&lt;br /&gt;
A través de esta página se asume que se quieren generar los certificados con la imágen de Docker provista por el SIU. RECUERDE QUE LOS CERTIFICADOS PARA SERVERS NO VAN A SER VALIDOS (candadito rojo).&lt;br /&gt;
&lt;br /&gt;
== Generar certificados con imágen de Docker ==&lt;br /&gt;
&lt;br /&gt;
Se creó una [https://github.com/SIU-Toba/docker-certs imagen de Docker] para crear de manera razonable certificados para varios servers firmados por la misma CA.&lt;br /&gt;
&lt;br /&gt;
Para utilizarlo hay que hacer lo siguiente:&lt;br /&gt;
* Tener instaladas las últimas versiones de Docker y Docker Compose&lt;br /&gt;
* Clonar [https://gitlab.siu.edu.ar/siu/instaladores este proyecto]&lt;br /&gt;
&lt;br /&gt;
=== Configurando el docker para generar certificados ===&lt;br /&gt;
Dirijirse a la carpeta '''certs'''. Dentro de este directorio hay un archivo llamado '''docker-compose.yml'''. Dentro de este archivo hay que modificar, mínimamente, dos variables: '''LISTA_SERVER''' y '''LISTA_CLIENTES'''.&lt;br /&gt;
* '''LISTA_SERVER''': Lista de dominios, separada por espacios, para los que se crearan certificados.&amp;lt;br /&amp;gt;Aquí van los nombres de dominios desde los que Apache va a servir sus archivos.&lt;br /&gt;
* '''LISTA_CLIENTES''': Lista de nombres, separada por espacios, a los que se les crearan certificados para actuar como clientes.&amp;lt;br /&amp;gt;La plataforma SIU-Araí usa como mecanismo de autenticación de APIs Rest '''client certificate authentication'''. Básicamente los servidores de las APIs guardan la clave pública de sus clientes y se apoya sobre la directiva de Apache '''SSLVerifyClient'''.&amp;lt;br /&amp;gt;El nombre (CN) que se ponga acá será el nombre de usuario de los consumidores de las APIs.&lt;br /&gt;
&lt;br /&gt;
Una vez configurado el archivo ejecutar&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
docker-compose up&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Esto creará una estructura de directorios dentro del directorio '''docker-data''' en la raíz del proyecto.&lt;br /&gt;
Para extraer todas las claves a un sólo directorio plano ejecutar el siguiente comando&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
mkdir &amp;lt;path con todos los certs&amp;gt;&lt;br /&gt;
sudo find docker-data -name &amp;quot;*.pem&amp;quot; -exec cp {} &amp;lt;path con todos los certs&amp;gt; \;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Luego de seguir estos pasos ya tendremos un directorio ('''&amp;lt;path con todos los certs&amp;gt;''') con todos los certificados que necesitaremos.&lt;br /&gt;
&amp;lt;div style=&amp;quot;background-color: #ffaaaa; border: 1px solid; padding: 5px; margin-top:10px; font-style:italic&amp;quot;&amp;gt;&lt;br /&gt;
Esta herramienta se incluye como ayuda para desarrollo y testeo. No hay garantías sobre uso en producción de estos certificados.&lt;br /&gt;
&amp;lt;/div&amp;gt;&lt;br /&gt;
== Configurando Apache con SSL ==&lt;br /&gt;
No hay muchas razones para no utilizar TLS/SSL hoy en día.&lt;br /&gt;
&lt;br /&gt;
En este artículo se dejan recursos y algunos tips de configuración para que todo funcione. De ninguna manera es '''LA''' guía de implementación. Simplemente intenta ser un lugar para aquellos que no están familiarizados con el tema.&lt;br /&gt;
&lt;br /&gt;
* [https://es.wikipedia.org/wiki/Hypertext_Transfer_Protocol_Secure HTTPS]&lt;br /&gt;
* [https://httpd.apache.org/docs/2.4/mod/mod_ssl.html Apache mod_ssl]&lt;br /&gt;
&lt;br /&gt;
=== Activando el módulo SSL en Apache ===&lt;br /&gt;
En Debian 8.0 la forma de activar el módulo de SSL es la siguiente&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
a2enmod ssl&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Sirviendo archivos con SSL ===&lt;br /&gt;
Copiar todos los certificados necesarios al directorio '''/etc/apache2/ssl'''. En este caso utilizaremos los creados para un entorno de pruebas.&amp;lt;br /&amp;gt;&lt;br /&gt;
Los archivos que tenemos en este directorio son:&lt;br /&gt;
&amp;lt;source lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
-r--r--r-- 1 root root 1931 nov 14 14:26 usuarios.local.cert.pem&lt;br /&gt;
-r--r--r-- 1 root root 1704 nov 14 14:27 usuarios.local.key.pem&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
Vamos a configurar el host llamado '''usuarios.local'''&lt;br /&gt;
&lt;br /&gt;
Activar el template SSL de Apache2&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
a2ensite default-ssl&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Luego hay que editar el el archivo '''/etc/apache2/sites-enabled/default-ssl.conf'''&lt;br /&gt;
* Agregar la entrada ServerName debajo de ServerAdmin. Por ejemplo:&lt;br /&gt;
 &lt;br /&gt;
&amp;lt;source lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
 &amp;lt;VirtualHost _default_:443&amp;gt;&lt;br /&gt;
    ...&lt;br /&gt;
    ServerAdmin webmaster@localhost&lt;br /&gt;
    ServerName usuarios.local:443&lt;br /&gt;
    SSLEngine on&lt;br /&gt;
    ...&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
* Modificar las siguientes entradas para configurar los certificados&lt;br /&gt;
&amp;lt;source lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;VirtualHost _default_:443&amp;gt;&lt;br /&gt;
    ...&lt;br /&gt;
    SSLCertificateFile    /etc/apache2/ssl/usuarios.local.cert.pem&lt;br /&gt;
    SSLCertificateKeyFile /etc/apache2/ssl/usuarios.local.key.pem&lt;br /&gt;
    ...&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* Redigir puerto 80 a 443. Hay que modificar el archivo '''/etc/apache2/sites-enabled/000-default.conf''' y agregar las siguientes líneas:&lt;br /&gt;
&amp;lt;source lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;VirtualHost *:80&amp;gt;&lt;br /&gt;
    ...&lt;br /&gt;
    ServerName usuarios.local&lt;br /&gt;
    Redirect permanent / https://usuarios.local/&lt;br /&gt;
&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* Reiniciar apache&lt;br /&gt;
&amp;lt;source lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
service apache2 restart&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* Listo! el sitio ya es accesible por HTTPS. Actualmente verá el warning de seguridad del browser. &amp;lt;br /&amp;gt;Si quiere evitar esto agregue el archivo '''/etc/apache2/ssl/ca.cert.pem''' a su navegador. En Google Chrome es Configuración -&amp;gt; Administrar Certificados&lt;br /&gt;
&lt;br /&gt;
== Verificando clientes con SSL ==&lt;br /&gt;
La verificación de cliente de Apache se utiliza como parte fundamental de la autenticación de pedidos Rest entre módulos.&lt;br /&gt;
&lt;br /&gt;
=== En el cliente de la API ===&lt;br /&gt;
Hay que agregar la CA como trusted. Para hacerlo ejecutar&lt;br /&gt;
&amp;lt;source lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
cp ca.cert.pem /usr/share/ca-certificates/ca_propia.crt&lt;br /&gt;
nano /etc/ca-certificates.conf&lt;br /&gt;
# agregar ca_propia.crt al final del archivo&lt;br /&gt;
update-ca-certificates --fresh&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Este paso es necesario para no tener que desactivar el verify de curl desde los clientes de las APIs.&lt;br /&gt;
&lt;br /&gt;
Este paso se puede omitir se se usaron certificados válidos (no auto-firmados) para configurar los servidores.&lt;br /&gt;
&lt;br /&gt;
=== En el servidor de la API ===&lt;br /&gt;
En el archivo '''/etc/apache2/sites-enabled/default-ssl.conf''' agregar las siguientes entradas.&lt;br /&gt;
 &lt;br /&gt;
&amp;lt;source lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
 &amp;lt;VirtualHost _default_:443&amp;gt;&lt;br /&gt;
    ...&lt;br /&gt;
    SSLCACertificateFile /etc/apache2/ssl/ca-chain.cert.pem&lt;br /&gt;
    # esta directiva es más laxa (ie, el valor no es 'require') porque el chequeo final se hace a nivel aplicación, no servidor&lt;br /&gt;
    SSLVerifyClient optional_no_ca&lt;br /&gt;
    SSLVerifyDepth 2&lt;br /&gt;
    SSLProtocol all -SSLv2 -SSLv3&lt;br /&gt;
    SSLOptions +StdEnvVars +ExportCertData&lt;br /&gt;
    BrowserMatch &amp;quot;MSIE [2-6]&amp;quot; \&lt;br /&gt;
         nokeepalive ssl-unclean-shutdown \&lt;br /&gt;
         downgrade-1.0 force-response-1.0&lt;br /&gt;
         # MSIE 7 and newer should be able to use keepalive&lt;br /&gt;
    BrowserMatch &amp;quot;MSIE [17-9]&amp;quot; ssl-unclean-shutdown&lt;br /&gt;
    ...&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* Listo! El servidor ya está listo para validar certificados de cliente&lt;/div&gt;</summary>
		<author><name>Ablanco</name></author>	</entry>

	<entry>
		<id>https://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Arai/certificados&amp;diff=27518</id>
		<title>SIU-Arai/certificados</title>
		<link rel="alternate" type="text/html" href="https://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Arai/certificados&amp;diff=27518"/>
				<updated>2017-07-26T18:17:35Z</updated>
		
		<summary type="html">&lt;p&gt;Ablanco: /* En el cliente de la API */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;[[Archivo:siu-arai_iso.png|derecha|link=SIU-Arai]]&lt;br /&gt;
= Certificados = &lt;br /&gt;
Se va a explicar como generar los certificados de cliente y servidor para lograr una instalación correcta.&lt;br /&gt;
&lt;br /&gt;
A través de esta página se asume que se quieren generar los certificados con la imágen de Docker provista por el SIU. RECUERDE QUE LOS CERTIFICADOS PARA SERVERS NO VAN A SER VALIDOS (candadito rojo).&lt;br /&gt;
&lt;br /&gt;
== Generar certificados con imágen de Docker ==&lt;br /&gt;
&lt;br /&gt;
Se creó una [https://github.com/SIU-Toba/docker-certs imagen de Docker] para crear de manera razonable certificados para varios servers firmados por la misma CA.&lt;br /&gt;
&lt;br /&gt;
Para utilizarlo hay que hacer lo siguiente:&lt;br /&gt;
* Tener instaladas las últimas versiones de Docker y Docker Compose&lt;br /&gt;
* Clonar [https://gitlab.siu.edu.ar/siu/instaladores este proyecto]&lt;br /&gt;
&lt;br /&gt;
=== Configurando el docker para generar certificados ===&lt;br /&gt;
Dirijirse a la carpeta '''certs'''. Dentro de este directorio hay un archivo llamado '''docker-compose.yml'''. Dentro de este archivo hay que modificar, mínimamente, dos variables: '''LISTA_SERVER''' y '''LISTA_CLIENTES'''.&lt;br /&gt;
* '''LISTA_SERVER''': Lista de dominios, separada por espacios, para los que se crearan certificados.&amp;lt;br /&amp;gt;Aquí van los nombres de dominios desde los que Apache va a servir sus archivos.&lt;br /&gt;
* '''LISTA_CLIENTES''': Lista de nombres, separada por espacios, a los que se les crearan certificados para actuar como clientes.&amp;lt;br /&amp;gt;La plataforma SIU-Araí usa como mecanismo de autenticación de APIs Rest '''client certificate authentication'''. Básicamente los servidores de las APIs guardan la clave pública de sus clientes y se apoya sobre la directiva de Apache '''SSLVerifyClient'''.&amp;lt;br /&amp;gt;El nombre (CN) que se ponga acá será el nombre de usuario de los consumidores de las APIs.&lt;br /&gt;
&lt;br /&gt;
Una vez configurado el archivo ejecutar&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
docker-compose up&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Esto creará una estructura de directorios dentro del directorio '''docker-data''' en la raíz del proyecto.&lt;br /&gt;
Para extraer todas las claves a un sólo directorio plano ejecutar el siguiente comando&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
mkdir &amp;lt;path con todos los certs&amp;gt;&lt;br /&gt;
sudo find docker-data -name &amp;quot;*.pem&amp;quot; -exec cp {} &amp;lt;path con todos los certs&amp;gt; \;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Luego de seguir estos pasos ya tendremos un directorio ('''&amp;lt;path con todos los certs&amp;gt;''') con todos los certificados que necesitaremos.&lt;br /&gt;
&amp;lt;div style=&amp;quot;background-color: #ffaaaa; border: 1px solid; padding: 5px; margin-top:10px; font-style:italic&amp;quot;&amp;gt;&lt;br /&gt;
Esta herramienta se incluye como ayuda para desarrollo y testeo. No hay garantías sobre uso en producción de estos certificados.&lt;br /&gt;
&amp;lt;/div&amp;gt;&lt;br /&gt;
== Configurando Apache con SSL ==&lt;br /&gt;
No hay muchas razones para no utilizar TLS/SSL hoy en día.&lt;br /&gt;
&lt;br /&gt;
En este artículo se dejan recursos y algunos tips de configuración para que todo funcione. De ninguna manera es '''LA''' guía de implementación. Simplemente intenta ser un lugar para aquellos que no están familiarizados con el tema.&lt;br /&gt;
&lt;br /&gt;
* [https://es.wikipedia.org/wiki/Hypertext_Transfer_Protocol_Secure HTTPS]&lt;br /&gt;
* [https://httpd.apache.org/docs/2.4/mod/mod_ssl.html Apache mod_ssl]&lt;br /&gt;
&lt;br /&gt;
=== Activando el módulo SSL en Apache ===&lt;br /&gt;
En Debian 8.0 la forma de activar el módulo de SSL es la siguiente&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
a2enmod ssl&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Sirviendo archivos con SSL ===&lt;br /&gt;
Copiar todos los certificados necesarios al directorio '''/etc/apache2/ssl'''. En este caso utilizaremos los creados para un entorno de pruebas.&amp;lt;br /&amp;gt;&lt;br /&gt;
Los archivos que tenemos en este directorio son:&lt;br /&gt;
&amp;lt;source lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
-r--r--r-- 1 root root 1931 nov 14 14:26 usuarios.local.cert.pem&lt;br /&gt;
-r--r--r-- 1 root root 1704 nov 14 14:27 usuarios.local.key.pem&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
Vamos a configurar el host llamado '''usuarios.local'''&lt;br /&gt;
&lt;br /&gt;
Activar el template SSL de Apache2&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
a2ensite default-ssl&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Luego hay que editar el el archivo '''/etc/apache2/sites-enabled/default-ssl.conf'''&lt;br /&gt;
* Agregar la entrada ServerName debajo de ServerAdmin. Por ejemplo:&lt;br /&gt;
 &lt;br /&gt;
&amp;lt;source lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
 &amp;lt;VirtualHost _default_:443&amp;gt;&lt;br /&gt;
    ...&lt;br /&gt;
    ServerAdmin webmaster@localhost&lt;br /&gt;
    ServerName usuarios.local:443&lt;br /&gt;
    SSLEngine on&lt;br /&gt;
    ...&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
* Modificar las siguientes entradas para configurar los certificados&lt;br /&gt;
&amp;lt;source lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;VirtualHost _default_:443&amp;gt;&lt;br /&gt;
    ...&lt;br /&gt;
    SSLCertificateFile    /etc/apache2/ssl/usuarios.local.cert.pem&lt;br /&gt;
    SSLCertificateKeyFile /etc/apache2/ssl/usuarios.local.key.pem&lt;br /&gt;
    ...&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* Redigir puerto 80 a 443. Hay que modificar el archivo '''/etc/apache2/sites-enabled/000-default.conf''' y agregar las siguientes líneas:&lt;br /&gt;
&amp;lt;source lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;VirtualHost *:80&amp;gt;&lt;br /&gt;
    ...&lt;br /&gt;
    ServerName usuarios.local&lt;br /&gt;
    Redirect permanent / https://usuarios.local/&lt;br /&gt;
&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* Reiniciar apache&lt;br /&gt;
&amp;lt;source lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
service apache2 restart&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* Listo! el sitio ya es accesible por HTTPS. Actualmente verá el warning de seguridad del browser. &amp;lt;br /&amp;gt;Si quiere evitar esto agregue el archivo '''/etc/apache2/ssl/ca.cert.pem''' a su navegador. En Google Chrome es Configuración -&amp;gt; Administrar Certificados&lt;br /&gt;
&lt;br /&gt;
== Verificando clientes con SSL ==&lt;br /&gt;
La verificación de cliente de Apache se utiliza como parte fundamental de la autenticación de pedidos Rest entre módulos.&lt;br /&gt;
&lt;br /&gt;
=== En el cliente de la API ===&lt;br /&gt;
Hay que agregar la CA como trusted. Para hacerlo ejecutar&lt;br /&gt;
&amp;lt;source lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
cp ca.cert.pem /usr/share/ca-certificates/ca_propia.crt&lt;br /&gt;
nano /etc/ca-certificates.conf&lt;br /&gt;
# agregar ca_propia.crt al final del archivo&lt;br /&gt;
update-ca-certificates --fresh&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Este paso es necesario para no tener que desactivar el verify de curl desde los clientes de las APIs.&lt;br /&gt;
Este paso se puede omitir se se usaron certificados válidos (no auto-firmados) para configurar los servidores.&lt;br /&gt;
&lt;br /&gt;
=== En el servidor de la API ===&lt;br /&gt;
En el archivo '''/etc/apache2/sites-enabled/default-ssl.conf''' agregar las siguientes entradas.&lt;br /&gt;
 &lt;br /&gt;
&amp;lt;source lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
 &amp;lt;VirtualHost _default_:443&amp;gt;&lt;br /&gt;
    ...&lt;br /&gt;
    SSLCACertificateFile /etc/apache2/ssl/ca-chain.cert.pem&lt;br /&gt;
    # esta directiva es más laxa (ie, el valor no es 'require') porque el chequeo final se hace a nivel aplicación, no servidor&lt;br /&gt;
    SSLVerifyClient optional_no_ca&lt;br /&gt;
    SSLVerifyDepth 2&lt;br /&gt;
    SSLProtocol all -SSLv2 -SSLv3&lt;br /&gt;
    SSLOptions +StdEnvVars +ExportCertData&lt;br /&gt;
    BrowserMatch &amp;quot;MSIE [2-6]&amp;quot; \&lt;br /&gt;
         nokeepalive ssl-unclean-shutdown \&lt;br /&gt;
         downgrade-1.0 force-response-1.0&lt;br /&gt;
         # MSIE 7 and newer should be able to use keepalive&lt;br /&gt;
    BrowserMatch &amp;quot;MSIE [17-9]&amp;quot; ssl-unclean-shutdown&lt;br /&gt;
    ...&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* Listo! El servidor ya está listo para validar certificados de cliente&lt;/div&gt;</summary>
		<author><name>Ablanco</name></author>	</entry>

	<entry>
		<id>https://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Arai/certificados&amp;diff=27517</id>
		<title>SIU-Arai/certificados</title>
		<link rel="alternate" type="text/html" href="https://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Arai/certificados&amp;diff=27517"/>
				<updated>2017-07-26T18:14:01Z</updated>
		
		<summary type="html">&lt;p&gt;Ablanco: /* En el servidor de la API */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;[[Archivo:siu-arai_iso.png|derecha|link=SIU-Arai]]&lt;br /&gt;
= Certificados = &lt;br /&gt;
Se va a explicar como generar los certificados de cliente y servidor para lograr una instalación correcta.&lt;br /&gt;
&lt;br /&gt;
A través de esta página se asume que se quieren generar los certificados con la imágen de Docker provista por el SIU. RECUERDE QUE LOS CERTIFICADOS PARA SERVERS NO VAN A SER VALIDOS (candadito rojo).&lt;br /&gt;
&lt;br /&gt;
== Generar certificados con imágen de Docker ==&lt;br /&gt;
&lt;br /&gt;
Se creó una [https://github.com/SIU-Toba/docker-certs imagen de Docker] para crear de manera razonable certificados para varios servers firmados por la misma CA.&lt;br /&gt;
&lt;br /&gt;
Para utilizarlo hay que hacer lo siguiente:&lt;br /&gt;
* Tener instaladas las últimas versiones de Docker y Docker Compose&lt;br /&gt;
* Clonar [https://gitlab.siu.edu.ar/siu/instaladores este proyecto]&lt;br /&gt;
&lt;br /&gt;
=== Configurando el docker para generar certificados ===&lt;br /&gt;
Dirijirse a la carpeta '''certs'''. Dentro de este directorio hay un archivo llamado '''docker-compose.yml'''. Dentro de este archivo hay que modificar, mínimamente, dos variables: '''LISTA_SERVER''' y '''LISTA_CLIENTES'''.&lt;br /&gt;
* '''LISTA_SERVER''': Lista de dominios, separada por espacios, para los que se crearan certificados.&amp;lt;br /&amp;gt;Aquí van los nombres de dominios desde los que Apache va a servir sus archivos.&lt;br /&gt;
* '''LISTA_CLIENTES''': Lista de nombres, separada por espacios, a los que se les crearan certificados para actuar como clientes.&amp;lt;br /&amp;gt;La plataforma SIU-Araí usa como mecanismo de autenticación de APIs Rest '''client certificate authentication'''. Básicamente los servidores de las APIs guardan la clave pública de sus clientes y se apoya sobre la directiva de Apache '''SSLVerifyClient'''.&amp;lt;br /&amp;gt;El nombre (CN) que se ponga acá será el nombre de usuario de los consumidores de las APIs.&lt;br /&gt;
&lt;br /&gt;
Una vez configurado el archivo ejecutar&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
docker-compose up&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Esto creará una estructura de directorios dentro del directorio '''docker-data''' en la raíz del proyecto.&lt;br /&gt;
Para extraer todas las claves a un sólo directorio plano ejecutar el siguiente comando&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
mkdir &amp;lt;path con todos los certs&amp;gt;&lt;br /&gt;
sudo find docker-data -name &amp;quot;*.pem&amp;quot; -exec cp {} &amp;lt;path con todos los certs&amp;gt; \;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Luego de seguir estos pasos ya tendremos un directorio ('''&amp;lt;path con todos los certs&amp;gt;''') con todos los certificados que necesitaremos.&lt;br /&gt;
&amp;lt;div style=&amp;quot;background-color: #ffaaaa; border: 1px solid; padding: 5px; margin-top:10px; font-style:italic&amp;quot;&amp;gt;&lt;br /&gt;
Esta herramienta se incluye como ayuda para desarrollo y testeo. No hay garantías sobre uso en producción de estos certificados.&lt;br /&gt;
&amp;lt;/div&amp;gt;&lt;br /&gt;
== Configurando Apache con SSL ==&lt;br /&gt;
No hay muchas razones para no utilizar TLS/SSL hoy en día.&lt;br /&gt;
&lt;br /&gt;
En este artículo se dejan recursos y algunos tips de configuración para que todo funcione. De ninguna manera es '''LA''' guía de implementación. Simplemente intenta ser un lugar para aquellos que no están familiarizados con el tema.&lt;br /&gt;
&lt;br /&gt;
* [https://es.wikipedia.org/wiki/Hypertext_Transfer_Protocol_Secure HTTPS]&lt;br /&gt;
* [https://httpd.apache.org/docs/2.4/mod/mod_ssl.html Apache mod_ssl]&lt;br /&gt;
&lt;br /&gt;
=== Activando el módulo SSL en Apache ===&lt;br /&gt;
En Debian 8.0 la forma de activar el módulo de SSL es la siguiente&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
a2enmod ssl&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Sirviendo archivos con SSL ===&lt;br /&gt;
Copiar todos los certificados necesarios al directorio '''/etc/apache2/ssl'''. En este caso utilizaremos los creados para un entorno de pruebas.&amp;lt;br /&amp;gt;&lt;br /&gt;
Los archivos que tenemos en este directorio son:&lt;br /&gt;
&amp;lt;source lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
-r--r--r-- 1 root root 1931 nov 14 14:26 usuarios.local.cert.pem&lt;br /&gt;
-r--r--r-- 1 root root 1704 nov 14 14:27 usuarios.local.key.pem&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
Vamos a configurar el host llamado '''usuarios.local'''&lt;br /&gt;
&lt;br /&gt;
Activar el template SSL de Apache2&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
a2ensite default-ssl&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Luego hay que editar el el archivo '''/etc/apache2/sites-enabled/default-ssl.conf'''&lt;br /&gt;
* Agregar la entrada ServerName debajo de ServerAdmin. Por ejemplo:&lt;br /&gt;
 &lt;br /&gt;
&amp;lt;source lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
 &amp;lt;VirtualHost _default_:443&amp;gt;&lt;br /&gt;
    ...&lt;br /&gt;
    ServerAdmin webmaster@localhost&lt;br /&gt;
    ServerName usuarios.local:443&lt;br /&gt;
    SSLEngine on&lt;br /&gt;
    ...&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
* Modificar las siguientes entradas para configurar los certificados&lt;br /&gt;
&amp;lt;source lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;VirtualHost _default_:443&amp;gt;&lt;br /&gt;
    ...&lt;br /&gt;
    SSLCertificateFile    /etc/apache2/ssl/usuarios.local.cert.pem&lt;br /&gt;
    SSLCertificateKeyFile /etc/apache2/ssl/usuarios.local.key.pem&lt;br /&gt;
    ...&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* Redigir puerto 80 a 443. Hay que modificar el archivo '''/etc/apache2/sites-enabled/000-default.conf''' y agregar las siguientes líneas:&lt;br /&gt;
&amp;lt;source lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;VirtualHost *:80&amp;gt;&lt;br /&gt;
    ...&lt;br /&gt;
    ServerName usuarios.local&lt;br /&gt;
    Redirect permanent / https://usuarios.local/&lt;br /&gt;
&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* Reiniciar apache&lt;br /&gt;
&amp;lt;source lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
service apache2 restart&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* Listo! el sitio ya es accesible por HTTPS. Actualmente verá el warning de seguridad del browser. &amp;lt;br /&amp;gt;Si quiere evitar esto agregue el archivo '''/etc/apache2/ssl/ca.cert.pem''' a su navegador. En Google Chrome es Configuración -&amp;gt; Administrar Certificados&lt;br /&gt;
&lt;br /&gt;
== Verificando clientes con SSL ==&lt;br /&gt;
La verificación de cliente de Apache se utiliza como parte fundamental de la autenticación de pedidos Rest entre módulos.&lt;br /&gt;
&lt;br /&gt;
=== En el cliente de la API ===&lt;br /&gt;
Hay que agregar la CA como trusted. Para hacerlo ejecutar&lt;br /&gt;
&amp;lt;source lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
cp ca.cert.pem /usr/share/ca-certificates/ca_propia.crt&lt;br /&gt;
nano /etc/ca-certificates.conf&lt;br /&gt;
# agregar ca_propia.crt al final del archivo&lt;br /&gt;
update-ca-certificates --fresh&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== En el servidor de la API ===&lt;br /&gt;
En el archivo '''/etc/apache2/sites-enabled/default-ssl.conf''' agregar las siguientes entradas.&lt;br /&gt;
 &lt;br /&gt;
&amp;lt;source lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
 &amp;lt;VirtualHost _default_:443&amp;gt;&lt;br /&gt;
    ...&lt;br /&gt;
    SSLCACertificateFile /etc/apache2/ssl/ca-chain.cert.pem&lt;br /&gt;
    # esta directiva es más laxa (ie, el valor no es 'require') porque el chequeo final se hace a nivel aplicación, no servidor&lt;br /&gt;
    SSLVerifyClient optional_no_ca&lt;br /&gt;
    SSLVerifyDepth 2&lt;br /&gt;
    SSLProtocol all -SSLv2 -SSLv3&lt;br /&gt;
    SSLOptions +StdEnvVars +ExportCertData&lt;br /&gt;
    BrowserMatch &amp;quot;MSIE [2-6]&amp;quot; \&lt;br /&gt;
         nokeepalive ssl-unclean-shutdown \&lt;br /&gt;
         downgrade-1.0 force-response-1.0&lt;br /&gt;
         # MSIE 7 and newer should be able to use keepalive&lt;br /&gt;
    BrowserMatch &amp;quot;MSIE [17-9]&amp;quot; ssl-unclean-shutdown&lt;br /&gt;
    ...&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* Listo! El servidor ya está listo para validar certificados de cliente&lt;/div&gt;</summary>
		<author><name>Ablanco</name></author>	</entry>

	<entry>
		<id>https://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Arai/certificados&amp;diff=27516</id>
		<title>SIU-Arai/certificados</title>
		<link rel="alternate" type="text/html" href="https://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Arai/certificados&amp;diff=27516"/>
				<updated>2017-07-26T18:13:54Z</updated>
		
		<summary type="html">&lt;p&gt;Ablanco: /* Verificando clientes con SSL */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;[[Archivo:siu-arai_iso.png|derecha|link=SIU-Arai]]&lt;br /&gt;
= Certificados = &lt;br /&gt;
Se va a explicar como generar los certificados de cliente y servidor para lograr una instalación correcta.&lt;br /&gt;
&lt;br /&gt;
A través de esta página se asume que se quieren generar los certificados con la imágen de Docker provista por el SIU. RECUERDE QUE LOS CERTIFICADOS PARA SERVERS NO VAN A SER VALIDOS (candadito rojo).&lt;br /&gt;
&lt;br /&gt;
== Generar certificados con imágen de Docker ==&lt;br /&gt;
&lt;br /&gt;
Se creó una [https://github.com/SIU-Toba/docker-certs imagen de Docker] para crear de manera razonable certificados para varios servers firmados por la misma CA.&lt;br /&gt;
&lt;br /&gt;
Para utilizarlo hay que hacer lo siguiente:&lt;br /&gt;
* Tener instaladas las últimas versiones de Docker y Docker Compose&lt;br /&gt;
* Clonar [https://gitlab.siu.edu.ar/siu/instaladores este proyecto]&lt;br /&gt;
&lt;br /&gt;
=== Configurando el docker para generar certificados ===&lt;br /&gt;
Dirijirse a la carpeta '''certs'''. Dentro de este directorio hay un archivo llamado '''docker-compose.yml'''. Dentro de este archivo hay que modificar, mínimamente, dos variables: '''LISTA_SERVER''' y '''LISTA_CLIENTES'''.&lt;br /&gt;
* '''LISTA_SERVER''': Lista de dominios, separada por espacios, para los que se crearan certificados.&amp;lt;br /&amp;gt;Aquí van los nombres de dominios desde los que Apache va a servir sus archivos.&lt;br /&gt;
* '''LISTA_CLIENTES''': Lista de nombres, separada por espacios, a los que se les crearan certificados para actuar como clientes.&amp;lt;br /&amp;gt;La plataforma SIU-Araí usa como mecanismo de autenticación de APIs Rest '''client certificate authentication'''. Básicamente los servidores de las APIs guardan la clave pública de sus clientes y se apoya sobre la directiva de Apache '''SSLVerifyClient'''.&amp;lt;br /&amp;gt;El nombre (CN) que se ponga acá será el nombre de usuario de los consumidores de las APIs.&lt;br /&gt;
&lt;br /&gt;
Una vez configurado el archivo ejecutar&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
docker-compose up&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Esto creará una estructura de directorios dentro del directorio '''docker-data''' en la raíz del proyecto.&lt;br /&gt;
Para extraer todas las claves a un sólo directorio plano ejecutar el siguiente comando&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
mkdir &amp;lt;path con todos los certs&amp;gt;&lt;br /&gt;
sudo find docker-data -name &amp;quot;*.pem&amp;quot; -exec cp {} &amp;lt;path con todos los certs&amp;gt; \;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Luego de seguir estos pasos ya tendremos un directorio ('''&amp;lt;path con todos los certs&amp;gt;''') con todos los certificados que necesitaremos.&lt;br /&gt;
&amp;lt;div style=&amp;quot;background-color: #ffaaaa; border: 1px solid; padding: 5px; margin-top:10px; font-style:italic&amp;quot;&amp;gt;&lt;br /&gt;
Esta herramienta se incluye como ayuda para desarrollo y testeo. No hay garantías sobre uso en producción de estos certificados.&lt;br /&gt;
&amp;lt;/div&amp;gt;&lt;br /&gt;
== Configurando Apache con SSL ==&lt;br /&gt;
No hay muchas razones para no utilizar TLS/SSL hoy en día.&lt;br /&gt;
&lt;br /&gt;
En este artículo se dejan recursos y algunos tips de configuración para que todo funcione. De ninguna manera es '''LA''' guía de implementación. Simplemente intenta ser un lugar para aquellos que no están familiarizados con el tema.&lt;br /&gt;
&lt;br /&gt;
* [https://es.wikipedia.org/wiki/Hypertext_Transfer_Protocol_Secure HTTPS]&lt;br /&gt;
* [https://httpd.apache.org/docs/2.4/mod/mod_ssl.html Apache mod_ssl]&lt;br /&gt;
&lt;br /&gt;
=== Activando el módulo SSL en Apache ===&lt;br /&gt;
En Debian 8.0 la forma de activar el módulo de SSL es la siguiente&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
a2enmod ssl&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Sirviendo archivos con SSL ===&lt;br /&gt;
Copiar todos los certificados necesarios al directorio '''/etc/apache2/ssl'''. En este caso utilizaremos los creados para un entorno de pruebas.&amp;lt;br /&amp;gt;&lt;br /&gt;
Los archivos que tenemos en este directorio son:&lt;br /&gt;
&amp;lt;source lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
-r--r--r-- 1 root root 1931 nov 14 14:26 usuarios.local.cert.pem&lt;br /&gt;
-r--r--r-- 1 root root 1704 nov 14 14:27 usuarios.local.key.pem&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
Vamos a configurar el host llamado '''usuarios.local'''&lt;br /&gt;
&lt;br /&gt;
Activar el template SSL de Apache2&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
a2ensite default-ssl&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Luego hay que editar el el archivo '''/etc/apache2/sites-enabled/default-ssl.conf'''&lt;br /&gt;
* Agregar la entrada ServerName debajo de ServerAdmin. Por ejemplo:&lt;br /&gt;
 &lt;br /&gt;
&amp;lt;source lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
 &amp;lt;VirtualHost _default_:443&amp;gt;&lt;br /&gt;
    ...&lt;br /&gt;
    ServerAdmin webmaster@localhost&lt;br /&gt;
    ServerName usuarios.local:443&lt;br /&gt;
    SSLEngine on&lt;br /&gt;
    ...&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
* Modificar las siguientes entradas para configurar los certificados&lt;br /&gt;
&amp;lt;source lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;VirtualHost _default_:443&amp;gt;&lt;br /&gt;
    ...&lt;br /&gt;
    SSLCertificateFile    /etc/apache2/ssl/usuarios.local.cert.pem&lt;br /&gt;
    SSLCertificateKeyFile /etc/apache2/ssl/usuarios.local.key.pem&lt;br /&gt;
    ...&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* Redigir puerto 80 a 443. Hay que modificar el archivo '''/etc/apache2/sites-enabled/000-default.conf''' y agregar las siguientes líneas:&lt;br /&gt;
&amp;lt;source lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;VirtualHost *:80&amp;gt;&lt;br /&gt;
    ...&lt;br /&gt;
    ServerName usuarios.local&lt;br /&gt;
    Redirect permanent / https://usuarios.local/&lt;br /&gt;
&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* Reiniciar apache&lt;br /&gt;
&amp;lt;source lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
service apache2 restart&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* Listo! el sitio ya es accesible por HTTPS. Actualmente verá el warning de seguridad del browser. &amp;lt;br /&amp;gt;Si quiere evitar esto agregue el archivo '''/etc/apache2/ssl/ca.cert.pem''' a su navegador. En Google Chrome es Configuración -&amp;gt; Administrar Certificados&lt;br /&gt;
&lt;br /&gt;
== Verificando clientes con SSL ==&lt;br /&gt;
La verificación de cliente de Apache se utiliza como parte fundamental de la autenticación de pedidos Rest entre módulos.&lt;br /&gt;
&lt;br /&gt;
=== En el cliente de la API ===&lt;br /&gt;
Hay que agregar la CA como trusted. Para hacerlo ejecutar&lt;br /&gt;
&amp;lt;source lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
cp ca.cert.pem /usr/share/ca-certificates/ca_propia.crt&lt;br /&gt;
nano /etc/ca-certificates.conf&lt;br /&gt;
# agregar ca_propia.crt al final del archivo&lt;br /&gt;
update-ca-certificates --fresh&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== En el servidor de la API ===&lt;br /&gt;
En el archivo '''/etc/apache2/sites-enabled/default-ssl.conf'''agregar las siguientes entradas.&lt;br /&gt;
 &lt;br /&gt;
&amp;lt;source lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
 &amp;lt;VirtualHost _default_:443&amp;gt;&lt;br /&gt;
    ...&lt;br /&gt;
    SSLCACertificateFile /etc/apache2/ssl/ca-chain.cert.pem&lt;br /&gt;
    # esta directiva es más laxa (ie, el valor no es 'require') porque el chequeo final se hace a nivel aplicación, no servidor&lt;br /&gt;
    SSLVerifyClient optional_no_ca&lt;br /&gt;
    SSLVerifyDepth 2&lt;br /&gt;
    SSLProtocol all -SSLv2 -SSLv3&lt;br /&gt;
    SSLOptions +StdEnvVars +ExportCertData&lt;br /&gt;
    BrowserMatch &amp;quot;MSIE [2-6]&amp;quot; \&lt;br /&gt;
         nokeepalive ssl-unclean-shutdown \&lt;br /&gt;
         downgrade-1.0 force-response-1.0&lt;br /&gt;
         # MSIE 7 and newer should be able to use keepalive&lt;br /&gt;
    BrowserMatch &amp;quot;MSIE [17-9]&amp;quot; ssl-unclean-shutdown&lt;br /&gt;
    ...&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* Listo! El servidor ya está listo para validar certificados de cliente&lt;/div&gt;</summary>
		<author><name>Ablanco</name></author>	</entry>

	<entry>
		<id>https://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Arai/certificados&amp;diff=27515</id>
		<title>SIU-Arai/certificados</title>
		<link rel="alternate" type="text/html" href="https://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Arai/certificados&amp;diff=27515"/>
				<updated>2017-07-26T18:10:28Z</updated>
		
		<summary type="html">&lt;p&gt;Ablanco: /* Verificando clientes con SSL */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;[[Archivo:siu-arai_iso.png|derecha|link=SIU-Arai]]&lt;br /&gt;
= Certificados = &lt;br /&gt;
Se va a explicar como generar los certificados de cliente y servidor para lograr una instalación correcta.&lt;br /&gt;
&lt;br /&gt;
A través de esta página se asume que se quieren generar los certificados con la imágen de Docker provista por el SIU. RECUERDE QUE LOS CERTIFICADOS PARA SERVERS NO VAN A SER VALIDOS (candadito rojo).&lt;br /&gt;
&lt;br /&gt;
== Generar certificados con imágen de Docker ==&lt;br /&gt;
&lt;br /&gt;
Se creó una [https://github.com/SIU-Toba/docker-certs imagen de Docker] para crear de manera razonable certificados para varios servers firmados por la misma CA.&lt;br /&gt;
&lt;br /&gt;
Para utilizarlo hay que hacer lo siguiente:&lt;br /&gt;
* Tener instaladas las últimas versiones de Docker y Docker Compose&lt;br /&gt;
* Clonar [https://gitlab.siu.edu.ar/siu/instaladores este proyecto]&lt;br /&gt;
&lt;br /&gt;
=== Configurando el docker para generar certificados ===&lt;br /&gt;
Dirijirse a la carpeta '''certs'''. Dentro de este directorio hay un archivo llamado '''docker-compose.yml'''. Dentro de este archivo hay que modificar, mínimamente, dos variables: '''LISTA_SERVER''' y '''LISTA_CLIENTES'''.&lt;br /&gt;
* '''LISTA_SERVER''': Lista de dominios, separada por espacios, para los que se crearan certificados.&amp;lt;br /&amp;gt;Aquí van los nombres de dominios desde los que Apache va a servir sus archivos.&lt;br /&gt;
* '''LISTA_CLIENTES''': Lista de nombres, separada por espacios, a los que se les crearan certificados para actuar como clientes.&amp;lt;br /&amp;gt;La plataforma SIU-Araí usa como mecanismo de autenticación de APIs Rest '''client certificate authentication'''. Básicamente los servidores de las APIs guardan la clave pública de sus clientes y se apoya sobre la directiva de Apache '''SSLVerifyClient'''.&amp;lt;br /&amp;gt;El nombre (CN) que se ponga acá será el nombre de usuario de los consumidores de las APIs.&lt;br /&gt;
&lt;br /&gt;
Una vez configurado el archivo ejecutar&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
docker-compose up&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Esto creará una estructura de directorios dentro del directorio '''docker-data''' en la raíz del proyecto.&lt;br /&gt;
Para extraer todas las claves a un sólo directorio plano ejecutar el siguiente comando&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
mkdir &amp;lt;path con todos los certs&amp;gt;&lt;br /&gt;
sudo find docker-data -name &amp;quot;*.pem&amp;quot; -exec cp {} &amp;lt;path con todos los certs&amp;gt; \;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Luego de seguir estos pasos ya tendremos un directorio ('''&amp;lt;path con todos los certs&amp;gt;''') con todos los certificados que necesitaremos.&lt;br /&gt;
&amp;lt;div style=&amp;quot;background-color: #ffaaaa; border: 1px solid; padding: 5px; margin-top:10px; font-style:italic&amp;quot;&amp;gt;&lt;br /&gt;
Esta herramienta se incluye como ayuda para desarrollo y testeo. No hay garantías sobre uso en producción de estos certificados.&lt;br /&gt;
&amp;lt;/div&amp;gt;&lt;br /&gt;
== Configurando Apache con SSL ==&lt;br /&gt;
No hay muchas razones para no utilizar TLS/SSL hoy en día.&lt;br /&gt;
&lt;br /&gt;
En este artículo se dejan recursos y algunos tips de configuración para que todo funcione. De ninguna manera es '''LA''' guía de implementación. Simplemente intenta ser un lugar para aquellos que no están familiarizados con el tema.&lt;br /&gt;
&lt;br /&gt;
* [https://es.wikipedia.org/wiki/Hypertext_Transfer_Protocol_Secure HTTPS]&lt;br /&gt;
* [https://httpd.apache.org/docs/2.4/mod/mod_ssl.html Apache mod_ssl]&lt;br /&gt;
&lt;br /&gt;
=== Activando el módulo SSL en Apache ===&lt;br /&gt;
En Debian 8.0 la forma de activar el módulo de SSL es la siguiente&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
a2enmod ssl&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Sirviendo archivos con SSL ===&lt;br /&gt;
Copiar todos los certificados necesarios al directorio '''/etc/apache2/ssl'''. En este caso utilizaremos los creados para un entorno de pruebas.&amp;lt;br /&amp;gt;&lt;br /&gt;
Los archivos que tenemos en este directorio son:&lt;br /&gt;
&amp;lt;source lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
-r--r--r-- 1 root root 1931 nov 14 14:26 usuarios.local.cert.pem&lt;br /&gt;
-r--r--r-- 1 root root 1704 nov 14 14:27 usuarios.local.key.pem&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
Vamos a configurar el host llamado '''usuarios.local'''&lt;br /&gt;
&lt;br /&gt;
Activar el template SSL de Apache2&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
a2ensite default-ssl&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Luego hay que editar el el archivo '''/etc/apache2/sites-enabled/default-ssl.conf'''&lt;br /&gt;
* Agregar la entrada ServerName debajo de ServerAdmin. Por ejemplo:&lt;br /&gt;
 &lt;br /&gt;
&amp;lt;source lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
 &amp;lt;VirtualHost _default_:443&amp;gt;&lt;br /&gt;
    ...&lt;br /&gt;
    ServerAdmin webmaster@localhost&lt;br /&gt;
    ServerName usuarios.local:443&lt;br /&gt;
    SSLEngine on&lt;br /&gt;
    ...&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
* Modificar las siguientes entradas para configurar los certificados&lt;br /&gt;
&amp;lt;source lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;VirtualHost _default_:443&amp;gt;&lt;br /&gt;
    ...&lt;br /&gt;
    SSLCertificateFile    /etc/apache2/ssl/usuarios.local.cert.pem&lt;br /&gt;
    SSLCertificateKeyFile /etc/apache2/ssl/usuarios.local.key.pem&lt;br /&gt;
    ...&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* Redigir puerto 80 a 443. Hay que modificar el archivo '''/etc/apache2/sites-enabled/000-default.conf''' y agregar las siguientes líneas:&lt;br /&gt;
&amp;lt;source lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;VirtualHost *:80&amp;gt;&lt;br /&gt;
    ...&lt;br /&gt;
    ServerName usuarios.local&lt;br /&gt;
    Redirect permanent / https://usuarios.local/&lt;br /&gt;
&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* Reiniciar apache&lt;br /&gt;
&amp;lt;source lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
service apache2 restart&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* Listo! el sitio ya es accesible por HTTPS. Actualmente verá el warning de seguridad del browser. &amp;lt;br /&amp;gt;Si quiere evitar esto agregue el archivo '''/etc/apache2/ssl/ca.cert.pem''' a su navegador. En Google Chrome es Configuración -&amp;gt; Administrar Certificados&lt;br /&gt;
&lt;br /&gt;
== Verificando clientes con SSL ==&lt;br /&gt;
La verificación de cliente de Apache se utiliza como parte fundamental de la autenticación de pedidos Rest entre módulos.&lt;br /&gt;
&lt;br /&gt;
Siga los siguientes pasos para configurarla.&lt;br /&gt;
&lt;br /&gt;
* En el archivo '''/etc/apache2/sites-enabled/default-ssl.conf'''&lt;br /&gt;
Agregar las siguientes entradas. Por ejemplo:&lt;br /&gt;
 &lt;br /&gt;
&amp;lt;source lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
 &amp;lt;VirtualHost _default_:443&amp;gt;&lt;br /&gt;
    ...&lt;br /&gt;
    SSLCACertificateFile /etc/apache2/ssl/ca-chain.cert.pem&lt;br /&gt;
    # esta directiva es más laxa (ie, el valor no es 'require') porque el chequeo final se hace a nivel aplicación, no servidor&lt;br /&gt;
    SSLVerifyClient optional_no_ca&lt;br /&gt;
    SSLVerifyDepth 2&lt;br /&gt;
    SSLProtocol all -SSLv2 -SSLv3&lt;br /&gt;
    SSLOptions +StdEnvVars +ExportCertData&lt;br /&gt;
    BrowserMatch &amp;quot;MSIE [2-6]&amp;quot; \&lt;br /&gt;
         nokeepalive ssl-unclean-shutdown \&lt;br /&gt;
         downgrade-1.0 force-response-1.0&lt;br /&gt;
         # MSIE 7 and newer should be able to use keepalive&lt;br /&gt;
    BrowserMatch &amp;quot;MSIE [17-9]&amp;quot; ssl-unclean-shutdown&lt;br /&gt;
    ...&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* Listo! El servidor ya está listo para validar certificados de cliente&lt;/div&gt;</summary>
		<author><name>Ablanco</name></author>	</entry>

	<entry>
		<id>https://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Arai/certificados&amp;diff=27514</id>
		<title>SIU-Arai/certificados</title>
		<link rel="alternate" type="text/html" href="https://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Arai/certificados&amp;diff=27514"/>
				<updated>2017-07-26T18:06:57Z</updated>
		
		<summary type="html">&lt;p&gt;Ablanco: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;[[Archivo:siu-arai_iso.png|derecha|link=SIU-Arai]]&lt;br /&gt;
= Certificados = &lt;br /&gt;
Se va a explicar como generar los certificados de cliente y servidor para lograr una instalación correcta.&lt;br /&gt;
&lt;br /&gt;
A través de esta página se asume que se quieren generar los certificados con la imágen de Docker provista por el SIU. RECUERDE QUE LOS CERTIFICADOS PARA SERVERS NO VAN A SER VALIDOS (candadito rojo).&lt;br /&gt;
&lt;br /&gt;
== Generar certificados con imágen de Docker ==&lt;br /&gt;
&lt;br /&gt;
Se creó una [https://github.com/SIU-Toba/docker-certs imagen de Docker] para crear de manera razonable certificados para varios servers firmados por la misma CA.&lt;br /&gt;
&lt;br /&gt;
Para utilizarlo hay que hacer lo siguiente:&lt;br /&gt;
* Tener instaladas las últimas versiones de Docker y Docker Compose&lt;br /&gt;
* Clonar [https://gitlab.siu.edu.ar/siu/instaladores este proyecto]&lt;br /&gt;
&lt;br /&gt;
=== Configurando el docker para generar certificados ===&lt;br /&gt;
Dirijirse a la carpeta '''certs'''. Dentro de este directorio hay un archivo llamado '''docker-compose.yml'''. Dentro de este archivo hay que modificar, mínimamente, dos variables: '''LISTA_SERVER''' y '''LISTA_CLIENTES'''.&lt;br /&gt;
* '''LISTA_SERVER''': Lista de dominios, separada por espacios, para los que se crearan certificados.&amp;lt;br /&amp;gt;Aquí van los nombres de dominios desde los que Apache va a servir sus archivos.&lt;br /&gt;
* '''LISTA_CLIENTES''': Lista de nombres, separada por espacios, a los que se les crearan certificados para actuar como clientes.&amp;lt;br /&amp;gt;La plataforma SIU-Araí usa como mecanismo de autenticación de APIs Rest '''client certificate authentication'''. Básicamente los servidores de las APIs guardan la clave pública de sus clientes y se apoya sobre la directiva de Apache '''SSLVerifyClient'''.&amp;lt;br /&amp;gt;El nombre (CN) que se ponga acá será el nombre de usuario de los consumidores de las APIs.&lt;br /&gt;
&lt;br /&gt;
Una vez configurado el archivo ejecutar&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
docker-compose up&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Esto creará una estructura de directorios dentro del directorio '''docker-data''' en la raíz del proyecto.&lt;br /&gt;
Para extraer todas las claves a un sólo directorio plano ejecutar el siguiente comando&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
mkdir &amp;lt;path con todos los certs&amp;gt;&lt;br /&gt;
sudo find docker-data -name &amp;quot;*.pem&amp;quot; -exec cp {} &amp;lt;path con todos los certs&amp;gt; \;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Luego de seguir estos pasos ya tendremos un directorio ('''&amp;lt;path con todos los certs&amp;gt;''') con todos los certificados que necesitaremos.&lt;br /&gt;
&amp;lt;div style=&amp;quot;background-color: #ffaaaa; border: 1px solid; padding: 5px; margin-top:10px; font-style:italic&amp;quot;&amp;gt;&lt;br /&gt;
Esta herramienta se incluye como ayuda para desarrollo y testeo. No hay garantías sobre uso en producción de estos certificados.&lt;br /&gt;
&amp;lt;/div&amp;gt;&lt;br /&gt;
== Configurando Apache con SSL ==&lt;br /&gt;
No hay muchas razones para no utilizar TLS/SSL hoy en día.&lt;br /&gt;
&lt;br /&gt;
En este artículo se dejan recursos y algunos tips de configuración para que todo funcione. De ninguna manera es '''LA''' guía de implementación. Simplemente intenta ser un lugar para aquellos que no están familiarizados con el tema.&lt;br /&gt;
&lt;br /&gt;
* [https://es.wikipedia.org/wiki/Hypertext_Transfer_Protocol_Secure HTTPS]&lt;br /&gt;
* [https://httpd.apache.org/docs/2.4/mod/mod_ssl.html Apache mod_ssl]&lt;br /&gt;
&lt;br /&gt;
=== Activando el módulo SSL en Apache ===&lt;br /&gt;
En Debian 8.0 la forma de activar el módulo de SSL es la siguiente&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
a2enmod ssl&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Sirviendo archivos con SSL ===&lt;br /&gt;
Copiar todos los certificados necesarios al directorio '''/etc/apache2/ssl'''. En este caso utilizaremos los creados para un entorno de pruebas.&amp;lt;br /&amp;gt;&lt;br /&gt;
Los archivos que tenemos en este directorio son:&lt;br /&gt;
&amp;lt;source lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
-r--r--r-- 1 root root 1931 nov 14 14:26 usuarios.local.cert.pem&lt;br /&gt;
-r--r--r-- 1 root root 1704 nov 14 14:27 usuarios.local.key.pem&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
Vamos a configurar el host llamado '''usuarios.local'''&lt;br /&gt;
&lt;br /&gt;
Activar el template SSL de Apache2&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
a2ensite default-ssl&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Luego hay que editar el el archivo '''/etc/apache2/sites-enabled/default-ssl.conf'''&lt;br /&gt;
* Agregar la entrada ServerName debajo de ServerAdmin. Por ejemplo:&lt;br /&gt;
 &lt;br /&gt;
&amp;lt;source lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
 &amp;lt;VirtualHost _default_:443&amp;gt;&lt;br /&gt;
    ...&lt;br /&gt;
    ServerAdmin webmaster@localhost&lt;br /&gt;
    ServerName usuarios.local:443&lt;br /&gt;
    SSLEngine on&lt;br /&gt;
    ...&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
* Modificar las siguientes entradas para configurar los certificados&lt;br /&gt;
&amp;lt;source lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;VirtualHost _default_:443&amp;gt;&lt;br /&gt;
    ...&lt;br /&gt;
    SSLCertificateFile    /etc/apache2/ssl/usuarios.local.cert.pem&lt;br /&gt;
    SSLCertificateKeyFile /etc/apache2/ssl/usuarios.local.key.pem&lt;br /&gt;
    ...&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* Redigir puerto 80 a 443. Hay que modificar el archivo '''/etc/apache2/sites-enabled/000-default.conf''' y agregar las siguientes líneas:&lt;br /&gt;
&amp;lt;source lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;VirtualHost *:80&amp;gt;&lt;br /&gt;
    ...&lt;br /&gt;
    ServerName usuarios.local&lt;br /&gt;
    Redirect permanent / https://usuarios.local/&lt;br /&gt;
&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* Reiniciar apache&lt;br /&gt;
&amp;lt;source lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
service apache2 restart&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* Listo! el sitio ya es accesible por HTTPS. Actualmente verá el warning de seguridad del browser. &amp;lt;br /&amp;gt;Si quiere evitar esto agregue el archivo '''/etc/apache2/ssl/ca.cert.pem''' a su navegador. En Google Chrome es Configuración -&amp;gt; Administrar Certificados&lt;br /&gt;
&lt;br /&gt;
== Verificando clientes con SSL ==&lt;br /&gt;
La verificación de cliente de Apache se utiliza como parte fundamental de la autenticación de pedidos Rest entre módulos.&lt;br /&gt;
&lt;br /&gt;
Siga los siguientes pasos para configurarla.&lt;br /&gt;
* Agregar la CA como trusted en los dos servidores. Para hacerlo ejecutar&lt;br /&gt;
&amp;lt;source lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
cp ca.cert.pem /usr/share/ca-certificates/ca_propia.crt&lt;br /&gt;
nano /etc/ca-certificates.conf&lt;br /&gt;
# agregar ca_propia.crt al final del archivo&lt;br /&gt;
update-ca-certificates --fresh&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* En el archivo '''/etc/apache2/sites-enabled/default-ssl.conf'''&lt;br /&gt;
Agregar las siguientes entradas. Por ejemplo:&lt;br /&gt;
 &lt;br /&gt;
&amp;lt;source lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
 &amp;lt;VirtualHost _default_:443&amp;gt;&lt;br /&gt;
    ...&lt;br /&gt;
    SSLVerifyClient optional_no_ca&lt;br /&gt;
    SSLVerifyDepth 2&lt;br /&gt;
    SSLProtocol all -SSLv2 -SSLv3&lt;br /&gt;
    SSLOptions +StdEnvVars +ExportCertData&lt;br /&gt;
    BrowserMatch &amp;quot;MSIE [2-6]&amp;quot; \&lt;br /&gt;
         nokeepalive ssl-unclean-shutdown \&lt;br /&gt;
         downgrade-1.0 force-response-1.0&lt;br /&gt;
         # MSIE 7 and newer should be able to use keepalive&lt;br /&gt;
    BrowserMatch &amp;quot;MSIE [17-9]&amp;quot; ssl-unclean-shutdown&lt;br /&gt;
    ...&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* Listo! El servidor ya está listo para validar certificados de cliente&lt;/div&gt;</summary>
		<author><name>Ablanco</name></author>	</entry>

	<entry>
		<id>https://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Arai/certificados&amp;diff=27513</id>
		<title>SIU-Arai/certificados</title>
		<link rel="alternate" type="text/html" href="https://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Arai/certificados&amp;diff=27513"/>
				<updated>2017-07-26T18:06:18Z</updated>
		
		<summary type="html">&lt;p&gt;Ablanco: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;[[Archivo:siu-arai_iso.png|derecha|link=SIU-Arai]]&lt;br /&gt;
= Certificados = &lt;br /&gt;
Se va a explicar como generar los certificados de cliente y servidor para lograr una instalación correcta.&lt;br /&gt;
&lt;br /&gt;
A través de esta página se asume que se quieren generar los certificados con la imágen de Docker provista por el SIU. RECUERDE QUE LOS CERTIFICADOS PARA SERVERS NO VAN A SER VALIDOS (candadito rojo).&lt;br /&gt;
&lt;br /&gt;
== Generar certificados con imágen de Docker ==&lt;br /&gt;
&lt;br /&gt;
Se creó una [https://github.com/SIU-Toba/docker-certs imagen de Docker] para crear de manera razonable certificados para varios servers firmados por la misma CA.&lt;br /&gt;
&lt;br /&gt;
Para utilizarlo hay que hacer lo siguiente:&lt;br /&gt;
* Tener instaladas las últimas versiones de Docker y Docker Compose&lt;br /&gt;
* Clonar [https://gitlab.siu.edu.ar/siu/instaladores este proyecto]&lt;br /&gt;
&lt;br /&gt;
=== Configurando el docker para generar certificados ===&lt;br /&gt;
Dirijirse a la carpeta '''certs'''. Dentro de este directorio hay un archivo llamado '''docker-compose.yml'''. Dentro de este archivo hay que modificar, mínimamente, dos variables: '''LISTA_SERVER''' y '''LISTA_CLIENTES'''.&lt;br /&gt;
* '''LISTA_SERVER''': Lista de dominios, separada por espacios, para los que se crearan certificados.&amp;lt;br /&amp;gt;Aquí van los nombres de dominios desde los que Apache va a servir sus archivos.&lt;br /&gt;
* '''LISTA_CLIENTES''': Lista de nombres, separada por espacios, a los que se les crearan certificados para actuar como clientes.&amp;lt;br /&amp;gt;La plataforma SIU-Araí usa como mecanismo de autenticación de APIs Rest '''client certificate authentication'''. Básicamente los servidores de las APIs guardan la clave pública de sus clientes y se apoya sobre la directiva de Apache '''SSLVerifyClient'''.&amp;lt;br /&amp;gt;El nombre (CN) que se ponga acá será el nombre de usuario de los consumidores de las APIs.&lt;br /&gt;
&lt;br /&gt;
Una vez configurado el archivo ejecutar&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
docker-compose up&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Esto creará una estructura de directorios dentro del directorio '''docker-data''' en la raíz del proyecto.&lt;br /&gt;
Para extraer todas las claves a un sólo directorio plano ejecutar el siguiente comando&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
mkdir &amp;lt;path con todos los certs&amp;gt;&lt;br /&gt;
sudo find docker-data -name &amp;quot;*.pem&amp;quot; -exec cp {} &amp;lt;path con todos los certs&amp;gt; \;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Luego de seguir estos pasos ya tendremos un directorio ('''&amp;lt;path con todos los certs&amp;gt;''') con todos los certificados que necesitaremos.&lt;br /&gt;
&amp;lt;div style=&amp;quot;background-color: #ffaaaa; border: 1px solid; padding: 5px; margin-top:10px; font-style:italic&amp;quot;&amp;gt;&lt;br /&gt;
Esta herramienta se incluye como ayuda para desarrollo y testeo. No hay garantías sobre uso en producción de estos certificados.&lt;br /&gt;
&amp;lt;/div&amp;gt;&lt;br /&gt;
== Configurando Apache con SSL ==&lt;br /&gt;
No hay muchas razones para no utilizar TLS/SSL hoy en día.&lt;br /&gt;
&lt;br /&gt;
En este artículo se dejan recursos y algunos tips de configuración para que todo funcione. De ninguna manera es '''LA''' guía de implementación. Simplemente intenta ser un lugar para aquellos que no están familiarizados con el tema.&lt;br /&gt;
&lt;br /&gt;
* [https://es.wikipedia.org/wiki/Hypertext_Transfer_Protocol_Secure HTTPS]&lt;br /&gt;
* [https://httpd.apache.org/docs/2.4/mod/mod_ssl.html Apache mod_ssl]&lt;br /&gt;
&lt;br /&gt;
=== Activando el módulo SSL en Apache ===&lt;br /&gt;
En Debian 8.0 la forma de activar el módulo de SSL es la siguiente&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
a2enmod ssl&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Sirviendo archivos con SSL ===&lt;br /&gt;
Copiar todos los certificados necesarios al directorio '''/etc/apache2/ssl'''. En este caso utilizaremos los creados para un entorno de pruebas.&amp;lt;br /&amp;gt;&lt;br /&gt;
Los archivos que tenemos en este directorio son:&lt;br /&gt;
&amp;lt;source lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
-r--r--r-- 1 root root 1931 nov 14 14:26 usuarios.local.cert.pem&lt;br /&gt;
-r--r--r-- 1 root root 1704 nov 14 14:27 usuarios.local.key.pem&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
Vamos a configurar el host llamado '''usuarios.local'''&lt;br /&gt;
&lt;br /&gt;
Activar el template SSL de Apache2&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
a2ensite default-ssl&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Luego hay que editar el el archivo '''/etc/apache2/sites-enabled/default-ssl.conf'''&lt;br /&gt;
* Agregar la entrada ServerName debajo de ServerAdmin. Por ejemplo:&lt;br /&gt;
 &lt;br /&gt;
&amp;lt;source lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
 &amp;lt;VirtualHost _default_:443&amp;gt;&lt;br /&gt;
    ...&lt;br /&gt;
    ServerAdmin webmaster@localhost&lt;br /&gt;
    ServerName usuarios.local:443&lt;br /&gt;
    SSLEngine on&lt;br /&gt;
    ...&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
* Modificar las siguientes entradas para configurar los certificados&lt;br /&gt;
&amp;lt;source lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;VirtualHost _default_:443&amp;gt;&lt;br /&gt;
    ...&lt;br /&gt;
    SSLCertificateFile    /etc/apache2/ssl/usuarios.local.cert.pem&lt;br /&gt;
    SSLCertificateKeyFile /etc/apache2/ssl/usuarios.local.key.pem&lt;br /&gt;
    ...&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* Redigir puerto 80 a 443. Hay que modificar el archivo '''/etc/apache2/sites-enabled/000-default.conf''' y agregar las siguientes líneas:&lt;br /&gt;
&amp;lt;source lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;VirtualHost *:80&amp;gt;&lt;br /&gt;
    ...&lt;br /&gt;
    ServerName usuarios.local&lt;br /&gt;
    Redirect permanent / https://usuarios.local/&lt;br /&gt;
&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* Reiniciar apache&lt;br /&gt;
&amp;lt;source lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
service apache2 restart&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* Listo! el sitio ya es accesible por HTTPS. Actualmente verá el warning de seguridad del browser. &amp;lt;br /&amp;gt;Si quiere evitar esto agregue el archivo '''/etc/apache2/ssl/ca.cert.pem''' a su navegador. En Google Chrome es Configuración -&amp;gt; Administrar Certificados&lt;br /&gt;
&lt;br /&gt;
== Verificando clientes con SSL ==&lt;br /&gt;
La verificación de cliente de Apache se utiliza como parte fundamental de la autenticación de pedidos Rest entre módulos.&lt;br /&gt;
&lt;br /&gt;
Siga los siguientes pasos para configurarla.&lt;br /&gt;
* Agregar la CA como trusted en los dos servidores. Para hacerlo ejecutar&lt;br /&gt;
&amp;lt;source lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
cp ca.cert.pem /usr/share/ca-certificates/ca_propia.crt&lt;br /&gt;
nano /etc/ca-certificates.conf&lt;br /&gt;
# agregar ca_propia.crt al final del archivo&lt;br /&gt;
update-ca-certificates --fresh&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* En el archivo '''/etc/apache2/sites-enabled/default-ssl.conf'''&lt;br /&gt;
Agregar las siguientes entradas. Por ejemplo:&lt;br /&gt;
 &lt;br /&gt;
&amp;lt;source lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
 &amp;lt;VirtualHost _default_:443&amp;gt;&lt;br /&gt;
    ...&lt;br /&gt;
    SSLVerifyClient optional_no_ca&lt;br /&gt;
    SSLVerifyDepth 2&lt;br /&gt;
    SSLProtocol all -SSLv2 -SSLv3&lt;br /&gt;
    SSLOptions +StdEnvVars +ExportCertData&lt;br /&gt;
    BrowserMatch &amp;quot;MSIE [2-6]&amp;quot; \&lt;br /&gt;
         nokeepalive ssl-unclean-shutdown \&lt;br /&gt;
         downgrade-1.0 force-response-1.0&lt;br /&gt;
         # MSIE 7 and newer should be able to use keepalive&lt;br /&gt;
    BrowserMatch &amp;quot;MSIE [17-9]&amp;quot; ssl-unclean-shutdown&lt;br /&gt;
    ...&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* Listo! El servidor ya está listo para validar certificados de cliente&lt;br /&gt;
&lt;br /&gt;
= Configurando Apache con SSL =&lt;br /&gt;
No hay muchas razones para no utilizar TLS/SSL hoy en día.&lt;br /&gt;
&lt;br /&gt;
En este artículo se dejan recursos y algunos tips de configuración para que todo funcione. De ninguna manera es '''LA''' guía de implementación. Simplemente intenta ser un lugar para aquellos que no están familiarizados con el tema.&lt;br /&gt;
&lt;br /&gt;
* [https://es.wikipedia.org/wiki/Hypertext_Transfer_Protocol_Secure HTTPS]&lt;br /&gt;
* [https://httpd.apache.org/docs/2.4/mod/mod_ssl.html Apache mod_ssl]&lt;br /&gt;
&lt;br /&gt;
== Activando el módulo SSL en Apache ==&lt;br /&gt;
En Debian 8.0 la forma de activar el módulo de SSL es la siguiente&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
a2enmod ssl&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== Generando certificados válidos de prueba ==&lt;br /&gt;
Se creó una [https://github.com/SIU-Toba/docker-certs imagen de Docker] para crear de manera razonable certificados para varios servers firmados por la misma CA.&lt;br /&gt;
&lt;br /&gt;
Para utilizarlo hay que hacer lo siguiente:&lt;br /&gt;
* Tener instaladas las últimas versiones de Docker y Docker Compose&lt;br /&gt;
* Clonar [https://gitlab.siu.edu.ar/siu/instaladores este proyecto]&lt;br /&gt;
&lt;br /&gt;
=== Configurando el docker para generar certificados ===&lt;br /&gt;
&lt;br /&gt;
== Sirviendo archivos con SSL ==&lt;br /&gt;
Copiar todos los certificados necesarios al directorio '''/etc/apache2/ssl'''. En este caso utilizaremos los creados para un entorno de pruebas.&amp;lt;br /&amp;gt;&lt;br /&gt;
Los archivos que tenemos en este directorio son:&lt;br /&gt;
&amp;lt;source lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
-rw-r--r-- 1 root root 1980 nov 14 14:28 ca.cert.pem&lt;br /&gt;
-r--r--r-- 1 root root 3980 nov 14 14:28 ca-chain.cert.pem&lt;br /&gt;
-r--r--r-- 1 root root 1931 nov 14 14:26 usuarios.local.cert.pem&lt;br /&gt;
-r--r--r-- 1 root root 1704 nov 14 14:27 usuarios.local.key.pem&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
Vamos a configurar el host llamado '''usuarios.local'''&lt;br /&gt;
&lt;br /&gt;
Activar el template SSL de Apache2&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
a2ensite default-ssl&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Luego hay que editar el el archivo '''/etc/apache2/sites-enabled/default-ssl.conf'''&lt;br /&gt;
* Agregar la entrada ServerName debajo de ServerAdmin. Por ejemplo:&lt;br /&gt;
 &lt;br /&gt;
&amp;lt;source lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
 &amp;lt;VirtualHost _default_:443&amp;gt;&lt;br /&gt;
    ...&lt;br /&gt;
    ServerAdmin webmaster@localhost&lt;br /&gt;
    ServerName usuarios.local:443&lt;br /&gt;
    ...&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
* Modificar las siguientes entradas para configurar los certificados&lt;br /&gt;
&amp;lt;source lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;VirtualHost _default_:443&amp;gt;&lt;br /&gt;
    ...&lt;br /&gt;
    SSLCertificateFile    /etc/apache2/ssl/usuarios.local.cert.pem&lt;br /&gt;
    SSLCertificateKeyFile /etc/apache2/ssl/usuarios.local.key.pem&lt;br /&gt;
    ...&lt;br /&gt;
    # aca ponemos en CA la chain que la contiene&lt;br /&gt;
    SSLCACertificateFile /etc/apache2/ssl/ca-chain.cert.pem            &lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* Redigir puerto 80 a 443. Hay que modificar el archivo '''/etc/apache2/sites-enabled/000-default.conf''' y agregar las siguientes líneas:&lt;br /&gt;
&amp;lt;source lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;VirtualHost *:80&amp;gt;&lt;br /&gt;
    ...&lt;br /&gt;
    ServerName usuarios.local&lt;br /&gt;
    Redirect permanent / https://usuarios.local/&lt;br /&gt;
&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* Reiniciar apache&lt;br /&gt;
&amp;lt;source lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
service apache2 restart&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* Listo! el sitio ya es accesible por HTTPS. Actualmente verá el warning de seguridad del browser. &amp;lt;br /&amp;gt;Si quiere evitar esto agregue el archivo '''/etc/apache2/ssl/ca.cert.pem''' a su navegador. En Google Chrome es Configuración -&amp;gt; Administrar Certificados&lt;br /&gt;
== Verificando clientes con SSL ==&lt;br /&gt;
La verificación de cliente de Apache se utiliza como parte fundamental de la autenticación de pedidos Rest entre módulos.&lt;br /&gt;
&lt;br /&gt;
Siga los siguientes pasos para configurarla.&lt;br /&gt;
* Agregar la CA como trusted en los dos servidores. Para hacerlo ejecutar&lt;br /&gt;
&amp;lt;source lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
cp ca.cert.pem /usr/share/ca-certificates/ca_propia.crt&lt;br /&gt;
nano /etc/ca-certificates.conf&lt;br /&gt;
# agregar ca_propia.crt al final del archivo&lt;br /&gt;
update-ca-certificates --fresh&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* En el archivo '''/etc/apache2/sites-enabled/default-ssl.conf'''&lt;br /&gt;
Agregar las siguientes entradas. Por ejemplo:&lt;br /&gt;
 &lt;br /&gt;
&amp;lt;source lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
 &amp;lt;VirtualHost _default_:443&amp;gt;&lt;br /&gt;
    ...&lt;br /&gt;
    SSLVerifyClient optional_no_ca&lt;br /&gt;
    SSLVerifyDepth 2&lt;br /&gt;
    SSLProtocol all -SSLv2 -SSLv3&lt;br /&gt;
    SSLOptions +StdEnvVars +ExportCertData&lt;br /&gt;
    BrowserMatch &amp;quot;MSIE [2-6]&amp;quot; \&lt;br /&gt;
         nokeepalive ssl-unclean-shutdown \&lt;br /&gt;
         downgrade-1.0 force-response-1.0&lt;br /&gt;
         # MSIE 7 and newer should be able to use keepalive&lt;br /&gt;
    BrowserMatch &amp;quot;MSIE [17-9]&amp;quot; ssl-unclean-shutdown&lt;br /&gt;
    ...&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* Listo! El servidor ya está listo para validar certificados de cliente&lt;/div&gt;</summary>
		<author><name>Ablanco</name></author>	</entry>

	<entry>
		<id>https://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Arai/certificados&amp;diff=27510</id>
		<title>SIU-Arai/certificados</title>
		<link rel="alternate" type="text/html" href="https://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Arai/certificados&amp;diff=27510"/>
				<updated>2017-07-26T17:56:29Z</updated>
		
		<summary type="html">&lt;p&gt;Ablanco: Página creada con «link=SIU-Arai = Certificados =  Se va a explicar como generar los certificados de cliente y servidor para lograr una instalación corre...»&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;[[Archivo:siu-arai_iso.png|derecha|link=SIU-Arai]]&lt;br /&gt;
= Certificados = &lt;br /&gt;
Se va a explicar como generar los certificados de cliente y servidor para lograr una instalación correcta.&lt;br /&gt;
&lt;br /&gt;
A través de esta página se asume que se quieren generar los certificados con la imágen de Docker provista por el SIU. RECUERDE QUE LOS CERTIFICADOS PARA SERVERS NO VAN A SER VALIDOS (candadito rojo).&lt;br /&gt;
&lt;br /&gt;
== Generar certificados con imágen de Docker ==&lt;br /&gt;
&lt;br /&gt;
Se creó una [https://github.com/SIU-Toba/docker-certs imagen de Docker] para crear de manera razonable certificados para varios servers firmados por la misma CA.&lt;br /&gt;
&lt;br /&gt;
Para utilizarlo hay que hacer lo siguiente:&lt;br /&gt;
* Tener instaladas las últimas versiones de Docker y Docker Compose&lt;br /&gt;
* Clonar [https://gitlab.siu.edu.ar/siu/instaladores este proyecto]&lt;br /&gt;
&lt;br /&gt;
=== Configurando el docker para generar certificados ===&lt;br /&gt;
Dirijirse a la carpeta '''certs'''. Dentro de este directorio hay un archivo llamado '''docker-compose.yml'''. Dentro de este archivo hay que modificar, mínimamente, dos variables: '''LISTA_SERVER''' y '''LISTA_CLIENTES'''.&lt;br /&gt;
* '''LISTA_SERVER''': Lista de dominios, separada por espacios, para los que se crearan certificados.&amp;lt;br /&amp;gt;Aquí van los nombres de dominios desde los que Apache va a servir sus archivos.&lt;br /&gt;
* '''LISTA_CLIENTES''': Lista de nombres, separada por espacios, a los que se les crearan certificados para actuar como clientes.&amp;lt;br /&amp;gt;La plataforma SIU-Araí usa como mecanismo de autenticación de APIs Rest '''client certificate authentication'''. Básicamente los servidores de las APIs guardan la clave pública de sus clientes y se apoya sobre la directiva de Apache '''SSLVerifyClient'''.&amp;lt;br /&amp;gt;El nombre (CN) que se ponga acá será el nombre de usuario de los consumidores de las APIs.&lt;br /&gt;
&lt;br /&gt;
Una vez configurado el archivo ejecutar&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
docker-compose up&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Esto creará una estructura de directorios dentro del directorio '''docker-data''' en la raíz del proyecto.&lt;br /&gt;
Para extraer todas las claves a un sólo directorio plano ejecutar el siguiente comando&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
mkdir &amp;lt;path con todos los certs&amp;gt;&lt;br /&gt;
sudo find docker-data -name &amp;quot;*.pem&amp;quot; -exec cp {} &amp;lt;path con todos los certs&amp;gt; \;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Luego de seguir estos pasos ya tendremos un directorio ('''&amp;lt;path con todos los certs&amp;gt;''') con todos los certificados que necesitaremos.&lt;br /&gt;
&amp;lt;div style=&amp;quot;background-color: #ffaaaa; border: 1px solid; padding: 5px; margin-top:10px; font-style:italic&amp;quot;&amp;gt;&lt;br /&gt;
Esta herramienta se incluye como ayuda para desarrollo y testeo. No hay garantías sobre uso en producción de estos certificados.&lt;br /&gt;
&amp;lt;/div&amp;gt;&lt;br /&gt;
[[Archivo:siu-arai_iso.png|derecha|link=SIU-Arai]]&lt;br /&gt;
= Configurando Apache con SSL =&lt;br /&gt;
No hay muchas razones para no utilizar TLS/SSL hoy en día.&lt;br /&gt;
&lt;br /&gt;
En este artículo se dejan recursos y algunos tips de configuración para que todo funcione. De ninguna manera es '''LA''' guía de implementación. Simplemente intenta ser un lugar para aquellos que no están familiarizados con el tema.&lt;br /&gt;
&lt;br /&gt;
* [https://es.wikipedia.org/wiki/Hypertext_Transfer_Protocol_Secure HTTPS]&lt;br /&gt;
* [https://httpd.apache.org/docs/2.4/mod/mod_ssl.html Apache mod_ssl]&lt;br /&gt;
&lt;br /&gt;
== Activando el módulo SSL en Apache ==&lt;br /&gt;
En Debian 8.0 la forma de activar el módulo de SSL es la siguiente&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
a2enmod ssl&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== Generando certificados válidos de prueba ==&lt;br /&gt;
&lt;br /&gt;
== Sirviendo archivos con SSL ==&lt;br /&gt;
Copiar todos los certificados necesarios al directorio '''/etc/apache2/ssl'''. En este caso utilizaremos los creados para un entorno de pruebas.&amp;lt;br /&amp;gt;&lt;br /&gt;
Los archivos que tenemos en este directorio son:&lt;br /&gt;
&amp;lt;source lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
-rw-r--r-- 1 root root 1980 nov 14 14:28 ca.cert.pem&lt;br /&gt;
-r--r--r-- 1 root root 3980 nov 14 14:28 ca-chain.cert.pem&lt;br /&gt;
-r--r--r-- 1 root root 1931 nov 14 14:26 usuarios.local.cert.pem&lt;br /&gt;
-r--r--r-- 1 root root 1704 nov 14 14:27 usuarios.local.key.pem&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
Vamos a configurar el host llamado '''usuarios.local'''&lt;br /&gt;
&lt;br /&gt;
Activar el template SSL de Apache2&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
a2ensite default-ssl&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Luego hay que editar el el archivo '''/etc/apache2/sites-enabled/default-ssl.conf'''&lt;br /&gt;
* Agregar la entrada ServerName debajo de ServerAdmin. Por ejemplo:&lt;br /&gt;
 &lt;br /&gt;
&amp;lt;source lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
 &amp;lt;VirtualHost _default_:443&amp;gt;&lt;br /&gt;
    ...&lt;br /&gt;
    ServerAdmin webmaster@localhost&lt;br /&gt;
    ServerName usuarios.local:443&lt;br /&gt;
    ...&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
* Modificar las siguientes entradas para configurar los certificados&lt;br /&gt;
&amp;lt;source lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;VirtualHost _default_:443&amp;gt;&lt;br /&gt;
    ...&lt;br /&gt;
    SSLCertificateFile    /etc/apache2/ssl/usuarios.local.cert.pem&lt;br /&gt;
    SSLCertificateKeyFile /etc/apache2/ssl/usuarios.local.key.pem&lt;br /&gt;
    ...&lt;br /&gt;
    # aca ponemos en CA la chain que la contiene&lt;br /&gt;
    SSLCACertificateFile /etc/apache2/ssl/ca-chain.cert.pem            &lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* Redigir puerto 80 a 443. Hay que modificar el archivo '''/etc/apache2/sites-enabled/000-default.conf''' y agregar las siguientes líneas:&lt;br /&gt;
&amp;lt;source lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;VirtualHost *:80&amp;gt;&lt;br /&gt;
    ...&lt;br /&gt;
    ServerName usuarios.local&lt;br /&gt;
    Redirect permanent / https://usuarios.local/&lt;br /&gt;
&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* Reiniciar apache&lt;br /&gt;
&amp;lt;source lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
service apache2 restart&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* Listo! el sitio ya es accesible por HTTPS. Actualmente verá el warning de seguridad del browser. &amp;lt;br /&amp;gt;Si quiere evitar esto agregue el archivo '''/etc/apache2/ssl/ca.cert.pem''' a su navegador. En Google Chrome es Configuración -&amp;gt; Administrar Certificados&lt;br /&gt;
== Verificando clientes con SSL ==&lt;br /&gt;
La verificación de cliente de Apache se utiliza como parte fundamental de la autenticación de pedidos Rest entre módulos.&lt;br /&gt;
&lt;br /&gt;
Siga los siguientes pasos para configurarla.&lt;br /&gt;
* Agregar la CA como trusted en los dos servidores. Para hacerlo ejecutar&lt;br /&gt;
&amp;lt;source lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
cp ca.cert.pem /usr/share/ca-certificates/ca_propia.crt&lt;br /&gt;
nano /etc/ca-certificates.conf&lt;br /&gt;
# agregar ca_propia.crt al final del archivo&lt;br /&gt;
update-ca-certificates --fresh&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* En el archivo '''/etc/apache2/sites-enabled/default-ssl.conf'''&lt;br /&gt;
Agregar las siguientes entradas. Por ejemplo:&lt;br /&gt;
 &lt;br /&gt;
&amp;lt;source lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
 &amp;lt;VirtualHost _default_:443&amp;gt;&lt;br /&gt;
    ...&lt;br /&gt;
    SSLVerifyClient optional_no_ca&lt;br /&gt;
    SSLVerifyDepth 2&lt;br /&gt;
    SSLProtocol all -SSLv2 -SSLv3&lt;br /&gt;
    SSLOptions +StdEnvVars +ExportCertData&lt;br /&gt;
    BrowserMatch &amp;quot;MSIE [2-6]&amp;quot; \&lt;br /&gt;
         nokeepalive ssl-unclean-shutdown \&lt;br /&gt;
         downgrade-1.0 force-response-1.0&lt;br /&gt;
         # MSIE 7 and newer should be able to use keepalive&lt;br /&gt;
    BrowserMatch &amp;quot;MSIE [17-9]&amp;quot; ssl-unclean-shutdown&lt;br /&gt;
    ...&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* Listo! El servidor ya está listo para validar certificados de cliente&lt;br /&gt;
&lt;br /&gt;
= Configurando Apache con SSL =&lt;br /&gt;
No hay muchas razones para no utilizar TLS/SSL hoy en día.&lt;br /&gt;
&lt;br /&gt;
En este artículo se dejan recursos y algunos tips de configuración para que todo funcione. De ninguna manera es '''LA''' guía de implementación. Simplemente intenta ser un lugar para aquellos que no están familiarizados con el tema.&lt;br /&gt;
&lt;br /&gt;
* [https://es.wikipedia.org/wiki/Hypertext_Transfer_Protocol_Secure HTTPS]&lt;br /&gt;
* [https://httpd.apache.org/docs/2.4/mod/mod_ssl.html Apache mod_ssl]&lt;br /&gt;
&lt;br /&gt;
== Activando el módulo SSL en Apache ==&lt;br /&gt;
En Debian 8.0 la forma de activar el módulo de SSL es la siguiente&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
a2enmod ssl&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== Generando certificados válidos de prueba ==&lt;br /&gt;
Se creó una [https://github.com/SIU-Toba/docker-certs imagen de Docker] para crear de manera razonable certificados para varios servers firmados por la misma CA.&lt;br /&gt;
&lt;br /&gt;
Para utilizarlo hay que hacer lo siguiente:&lt;br /&gt;
* Tener instaladas las últimas versiones de Docker y Docker Compose&lt;br /&gt;
* Clonar [https://gitlab.siu.edu.ar/siu/instaladores este proyecto]&lt;br /&gt;
&lt;br /&gt;
=== Configurando el docker para generar certificados ===&lt;br /&gt;
&lt;br /&gt;
== Sirviendo archivos con SSL ==&lt;br /&gt;
Copiar todos los certificados necesarios al directorio '''/etc/apache2/ssl'''. En este caso utilizaremos los creados para un entorno de pruebas.&amp;lt;br /&amp;gt;&lt;br /&gt;
Los archivos que tenemos en este directorio son:&lt;br /&gt;
&amp;lt;source lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
-rw-r--r-- 1 root root 1980 nov 14 14:28 ca.cert.pem&lt;br /&gt;
-r--r--r-- 1 root root 3980 nov 14 14:28 ca-chain.cert.pem&lt;br /&gt;
-r--r--r-- 1 root root 1931 nov 14 14:26 usuarios.local.cert.pem&lt;br /&gt;
-r--r--r-- 1 root root 1704 nov 14 14:27 usuarios.local.key.pem&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
Vamos a configurar el host llamado '''usuarios.local'''&lt;br /&gt;
&lt;br /&gt;
Activar el template SSL de Apache2&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
a2ensite default-ssl&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Luego hay que editar el el archivo '''/etc/apache2/sites-enabled/default-ssl.conf'''&lt;br /&gt;
* Agregar la entrada ServerName debajo de ServerAdmin. Por ejemplo:&lt;br /&gt;
 &lt;br /&gt;
&amp;lt;source lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
 &amp;lt;VirtualHost _default_:443&amp;gt;&lt;br /&gt;
    ...&lt;br /&gt;
    ServerAdmin webmaster@localhost&lt;br /&gt;
    ServerName usuarios.local:443&lt;br /&gt;
    ...&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
* Modificar las siguientes entradas para configurar los certificados&lt;br /&gt;
&amp;lt;source lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;VirtualHost _default_:443&amp;gt;&lt;br /&gt;
    ...&lt;br /&gt;
    SSLCertificateFile    /etc/apache2/ssl/usuarios.local.cert.pem&lt;br /&gt;
    SSLCertificateKeyFile /etc/apache2/ssl/usuarios.local.key.pem&lt;br /&gt;
    ...&lt;br /&gt;
    # aca ponemos en CA la chain que la contiene&lt;br /&gt;
    SSLCACertificateFile /etc/apache2/ssl/ca-chain.cert.pem            &lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* Redigir puerto 80 a 443. Hay que modificar el archivo '''/etc/apache2/sites-enabled/000-default.conf''' y agregar las siguientes líneas:&lt;br /&gt;
&amp;lt;source lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;VirtualHost *:80&amp;gt;&lt;br /&gt;
    ...&lt;br /&gt;
    ServerName usuarios.local&lt;br /&gt;
    Redirect permanent / https://usuarios.local/&lt;br /&gt;
&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* Reiniciar apache&lt;br /&gt;
&amp;lt;source lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
service apache2 restart&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* Listo! el sitio ya es accesible por HTTPS. Actualmente verá el warning de seguridad del browser. &amp;lt;br /&amp;gt;Si quiere evitar esto agregue el archivo '''/etc/apache2/ssl/ca.cert.pem''' a su navegador. En Google Chrome es Configuración -&amp;gt; Administrar Certificados&lt;br /&gt;
== Verificando clientes con SSL ==&lt;br /&gt;
La verificación de cliente de Apache se utiliza como parte fundamental de la autenticación de pedidos Rest entre módulos.&lt;br /&gt;
&lt;br /&gt;
Siga los siguientes pasos para configurarla.&lt;br /&gt;
* Agregar la CA como trusted en los dos servidores. Para hacerlo ejecutar&lt;br /&gt;
&amp;lt;source lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
cp ca.cert.pem /usr/share/ca-certificates/ca_propia.crt&lt;br /&gt;
nano /etc/ca-certificates.conf&lt;br /&gt;
# agregar ca_propia.crt al final del archivo&lt;br /&gt;
update-ca-certificates --fresh&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* En el archivo '''/etc/apache2/sites-enabled/default-ssl.conf'''&lt;br /&gt;
Agregar las siguientes entradas. Por ejemplo:&lt;br /&gt;
 &lt;br /&gt;
&amp;lt;source lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
 &amp;lt;VirtualHost _default_:443&amp;gt;&lt;br /&gt;
    ...&lt;br /&gt;
    SSLVerifyClient optional_no_ca&lt;br /&gt;
    SSLVerifyDepth 2&lt;br /&gt;
    SSLProtocol all -SSLv2 -SSLv3&lt;br /&gt;
    SSLOptions +StdEnvVars +ExportCertData&lt;br /&gt;
    BrowserMatch &amp;quot;MSIE [2-6]&amp;quot; \&lt;br /&gt;
         nokeepalive ssl-unclean-shutdown \&lt;br /&gt;
         downgrade-1.0 force-response-1.0&lt;br /&gt;
         # MSIE 7 and newer should be able to use keepalive&lt;br /&gt;
    BrowserMatch &amp;quot;MSIE [17-9]&amp;quot; ssl-unclean-shutdown&lt;br /&gt;
    ...&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* Listo! El servidor ya está listo para validar certificados de cliente&lt;/div&gt;</summary>
		<author><name>Ablanco</name></author>	</entry>

	<entry>
		<id>https://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Arai&amp;diff=27509</id>
		<title>SIU-Arai</title>
		<link rel="alternate" type="text/html" href="https://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Arai&amp;diff=27509"/>
				<updated>2017-07-26T17:49:15Z</updated>
		
		<summary type="html">&lt;p&gt;Ablanco: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;[[Archivo:siu-arai_iso.png|derecha|link=SIU-Arai]]&lt;br /&gt;
= SIU-Arai =&lt;br /&gt;
SIU-Araí es la plataforma integradora de servicios del SIU. Cada uno de los sistemas SIU son módulos dentro de la plataforma.&lt;br /&gt;
&lt;br /&gt;
Existen dos módulos que son vitales para el funcionamiento de la plataforma.&lt;br /&gt;
&lt;br /&gt;
* Arai-Registry: Repositorio central de servicios y aplicaciones&lt;br /&gt;
* Arai-Usuarios: IDP e IDM para toda la plataforma&lt;br /&gt;
&lt;br /&gt;
== Forma de trabajo ==&lt;br /&gt;
Toda la distribución de los proyectos se hace a través de gitlab: [https://hub.siu.edu.ar https://hub.siu.edu.ar].&amp;lt;br&amp;gt;&lt;br /&gt;
Cada uno de los módulos tiene una carpeta '''doc''' donde se incluyen instrucciones de instalación.&lt;br /&gt;
&lt;br /&gt;
== Pre Instalación ==&lt;br /&gt;
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.&lt;br /&gt;
=== Que se va a instalar? ===&lt;br /&gt;
* Araí-Registry &lt;br /&gt;
* Araí-Usuarios&lt;br /&gt;
** Un IdP&lt;br /&gt;
** Un módulo de gestión de identidad (IdM)&lt;br /&gt;
* Araí-Huarpe&lt;br /&gt;
=== Que necesitamos? ===&lt;br /&gt;
==== Definir URLs ====&lt;br /&gt;
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:&lt;br /&gt;
{| class=&amp;quot;wikitable zebra&amp;quot;&lt;br /&gt;
!colspan=&amp;quot;3&amp;quot;|URLs&lt;br /&gt;
|-&lt;br /&gt;
|Araí-Registry&lt;br /&gt;
|http://localhost/registry&lt;br /&gt;
|Este servicio no tiene que ser público&lt;br /&gt;
|-&lt;br /&gt;
|Araí-Usuarios IdP&lt;br /&gt;
|https://idp.arai-usuarios&lt;br /&gt;
|Este servicio es público, por eso está con TLS&lt;br /&gt;
|-&lt;br /&gt;
|Araí-Usuarios IdM&lt;br /&gt;
|https://arai-usuarios&lt;br /&gt;
|Este servicio es público, por eso está con TLS&lt;br /&gt;
|-&lt;br /&gt;
|Araí-Huarpe&lt;br /&gt;
|https://huarpe&lt;br /&gt;
|Este servicio es público, por eso está con TLS&lt;br /&gt;
|}&lt;br /&gt;
==== Certificados, certificados, certificados ... ====&lt;br /&gt;
El uso de certificados es extensivo a través de toda la plataforma.&lt;br /&gt;
&lt;br /&gt;
Se usan con tres fines:&lt;br /&gt;
* Para utilizar HTTPS en los servicios públicos y autenticar clientes de las APIs&lt;br /&gt;
* Para firmar el token de SAML&lt;br /&gt;
&lt;br /&gt;
Antes de continuar con la instalación debe generar los certificados necesarios.&lt;br /&gt;
===== HTTPS y autenticación de clientes =====&lt;br /&gt;
Para una instalación de producción es necesario contar con certificados reales válidos. &lt;br /&gt;
&lt;br /&gt;
Si su institución no cuenta con estos certificados son fáciles de obtener con este servicio [https://letsencrypt.org/ Let's Encrypt].&lt;br /&gt;
&lt;br /&gt;
Los certificados de cliente pueden ser auto-firmados porque son para uso interno. &lt;br /&gt;
&lt;br /&gt;
Más información en [[SIU-Arai/certificados|Certificados]]&lt;br /&gt;
&lt;br /&gt;
===== Token SAML =====&lt;br /&gt;
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 [documentación](https://simplesamlphp.org/docs/stable/simplesamlphp-idp#section_4). Es posible, entonces, generar certificados autofirmados de la siguiente forma:&lt;br /&gt;
&lt;br /&gt;
    openssl req -newkey rsa:2048 -new -x509 -days 3652 -nodes -out certificado.crt -keyout certificado.pem&lt;br /&gt;
&lt;br /&gt;
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. &lt;br /&gt;
&lt;br /&gt;
=== Seguridad ===&lt;br /&gt;
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. &lt;br /&gt;
&lt;br /&gt;
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.&lt;br /&gt;
&lt;br /&gt;
== Instalación ==&lt;br /&gt;
Una vez completada la pre-instalación ya se puede seguir con la instalación de cada uno de los módulos.&lt;br /&gt;
# [[SIU-Arai/registry|Arai-Registry]]&lt;br /&gt;
# [[SIU-Arai/usuarios|Arai-Usuarios]]&lt;br /&gt;
# [[SIU-Arai/catalogos-cliente|Arai-Catalogos (cliente)]]&lt;br /&gt;
# [[SIU-Arai/proveedores|Arai-Proveedores ]]&lt;br /&gt;
&lt;br /&gt;
== Módulos ==&lt;br /&gt;
* [[SIU-Arai/huarpe|Huarpe]]: Módulo de autogestión de recursos y servicios. La cara visible de la plataforma para los usuarios..&lt;/div&gt;</summary>
		<author><name>Ablanco</name></author>	</entry>

	<entry>
		<id>https://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Arai&amp;diff=27508</id>
		<title>SIU-Arai</title>
		<link rel="alternate" type="text/html" href="https://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Arai&amp;diff=27508"/>
				<updated>2017-07-26T17:44:36Z</updated>
		
		<summary type="html">&lt;p&gt;Ablanco: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;[[Archivo:siu-arai_iso.png|derecha|link=SIU-Arai]]&lt;br /&gt;
= SIU-Arai =&lt;br /&gt;
SIU-Araí es la plataforma integradora de servicios del SIU. Cada uno de los sistemas SIU son módulos dentro de la plataforma.&lt;br /&gt;
&lt;br /&gt;
Existen dos módulos que son vitales para el funcionamiento de la plataforma.&lt;br /&gt;
&lt;br /&gt;
* Arai-Registry: Repositorio central de servicios y aplicaciones&lt;br /&gt;
* Arai-Usuarios: IDP e IDM para toda la plataforma&lt;br /&gt;
&lt;br /&gt;
== Forma de trabajo ==&lt;br /&gt;
Toda la distribución de los proyectos se hace a través de gitlab: [https://hub.siu.edu.ar https://hub.siu.edu.ar].&amp;lt;br&amp;gt;&lt;br /&gt;
Cada uno de los módulos tiene una carpeta '''doc''' donde se incluyen instrucciones de instalación.&lt;br /&gt;
&lt;br /&gt;
== Pre Instalación ==&lt;br /&gt;
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.&lt;br /&gt;
=== Que se va a instalar? ===&lt;br /&gt;
* Araí-Registry &lt;br /&gt;
* Araí-Usuarios&lt;br /&gt;
** Un IdP&lt;br /&gt;
** Un módulo de gestión de identidad (IdM)&lt;br /&gt;
* Araí-Huarpe&lt;br /&gt;
=== Que necesitamos? ===&lt;br /&gt;
==== Definir URLs ====&lt;br /&gt;
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:&lt;br /&gt;
{| class=&amp;quot;wikitable zebra&amp;quot;&lt;br /&gt;
!colspan=&amp;quot;3&amp;quot;|URLs&lt;br /&gt;
|-&lt;br /&gt;
|Araí-Registry&lt;br /&gt;
|http://localhost/registry&lt;br /&gt;
|Este servicio no tiene que ser público&lt;br /&gt;
|-&lt;br /&gt;
|Araí-Usuarios IdP&lt;br /&gt;
|https://idp.arai-usuarios&lt;br /&gt;
|Este servicio es público, por eso está con TLS&lt;br /&gt;
|-&lt;br /&gt;
|Araí-Usuarios IdM&lt;br /&gt;
|https://arai-usuarios&lt;br /&gt;
|Este servicio es público, por eso está con TLS&lt;br /&gt;
|-&lt;br /&gt;
|Araí-Huarpe&lt;br /&gt;
|https://huarpe&lt;br /&gt;
|Este servicio es público, por eso está con TLS&lt;br /&gt;
|}&lt;br /&gt;
==== Certificados, certificados, certificados ... ====&lt;br /&gt;
El uso de certificados es extensivo a través de toda la plataforma.&lt;br /&gt;
&lt;br /&gt;
Se usan con tres fines:&lt;br /&gt;
* Para utilizar HTTPS en los servicios públicos&lt;br /&gt;
* Para firmar el token de SAML&lt;br /&gt;
* Para autenticar a clientes de las APIs&lt;br /&gt;
&lt;br /&gt;
Antes de continuar con la instalación debe generar los certificados necesarios.&lt;br /&gt;
===== HTTPS =====&lt;br /&gt;
Para una instalación de producción es necesario contar con certificados reales válidos. &lt;br /&gt;
&lt;br /&gt;
Si su institución no cuenta con estos certificados son fáciles de obtener con este servicio [https://letsencrypt.org/ Let's Encrypt].&lt;br /&gt;
&lt;br /&gt;
Para generar certificados para una instalación de prueba/desarrollo contamos con una imágen de Docker para facilitar este proceso.&lt;br /&gt;
===== Token SAML =====&lt;br /&gt;
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 [documentación](https://simplesamlphp.org/docs/stable/simplesamlphp-idp#section_4). Es posible, entonces, generar certificados autofirmados de la siguiente forma:&lt;br /&gt;
&lt;br /&gt;
    openssl req -newkey rsa:2048 -new -x509 -days 3652 -nodes -out certificado.crt -keyout certificado.pem&lt;br /&gt;
&lt;br /&gt;
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. &lt;br /&gt;
&lt;br /&gt;
===== Autenticación con certificados de clientes =====&lt;br /&gt;
Estos certificados pueden ser auto-firmados porque son para uso interno. Los puede generar a mano o utilizando la imágen de Docker.&lt;br /&gt;
=== Seguridad ===&lt;br /&gt;
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. &lt;br /&gt;
&lt;br /&gt;
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.&lt;br /&gt;
&lt;br /&gt;
== Instalación ==&lt;br /&gt;
Una vez completada la pre-instalación ya se puede seguir con la instalación de cada uno de los módulos.&lt;br /&gt;
# [[SIU-Arai/registry|Arai-Registry]]&lt;br /&gt;
# [[SIU-Arai/usuarios|Arai-Usuarios]]&lt;br /&gt;
# [[SIU-Arai/catalogos-cliente|Arai-Catalogos (cliente)]]&lt;br /&gt;
# [[SIU-Arai/proveedores|Arai-Proveedores ]]&lt;br /&gt;
&lt;br /&gt;
== Módulos ==&lt;br /&gt;
* [[SIU-Arai/huarpe|Huarpe]]: Módulo de autogestión de recursos y servicios. La cara visible de la plataforma para los usuarios..&lt;/div&gt;</summary>
		<author><name>Ablanco</name></author>	</entry>

	<entry>
		<id>https://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Arai&amp;diff=27498</id>
		<title>SIU-Arai</title>
		<link rel="alternate" type="text/html" href="https://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Arai&amp;diff=27498"/>
				<updated>2017-07-25T17:05:28Z</updated>
		
		<summary type="html">&lt;p&gt;Ablanco: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;[[Archivo:siu-arai_iso.png|derecha|link=SIU-Arai]]&lt;br /&gt;
= SIU-Arai =&lt;br /&gt;
SIU-Araí es la plataforma integradora de servicios del SIU. Cada uno de los sistemas SIU son módulos dentro de la plataforma.&lt;br /&gt;
&lt;br /&gt;
Existen dos módulos que son vitales para el funcionamiento de la plataforma.&lt;br /&gt;
&lt;br /&gt;
* Arai-Registry: Repositorio central de servicios y aplicaciones&lt;br /&gt;
* Arai-Usuarios: IDP e IDM para toda la plataforma&lt;br /&gt;
&lt;br /&gt;
== Forma de trabajo ==&lt;br /&gt;
Toda la distribución de los proyectos se hace a través de gitlab: [https://hub.siu.edu.ar https://hub.siu.edu.ar].&amp;lt;br&amp;gt;&lt;br /&gt;
Cada uno de los módulos tiene una carpeta '''doc''' donde se incluyen instrucciones de instalación.&lt;br /&gt;
&lt;br /&gt;
== Pre Instalación ==&lt;br /&gt;
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.&lt;br /&gt;
=== Que se va a instalar? ===&lt;br /&gt;
* Araí-Registry &lt;br /&gt;
* Araí-Usuarios&lt;br /&gt;
** Un IdP&lt;br /&gt;
** Un módulo de gestión de identidad (IdM)&lt;br /&gt;
* Araí-Huarpe&lt;br /&gt;
=== Que necesitamos? ===&lt;br /&gt;
==== Definir URLs ====&lt;br /&gt;
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:&lt;br /&gt;
{| class=&amp;quot;wikitable zebra&amp;quot;&lt;br /&gt;
!colspan=&amp;quot;3&amp;quot;|URLs&lt;br /&gt;
|-&lt;br /&gt;
|Araí-Registry&lt;br /&gt;
|http://localhost/registry&lt;br /&gt;
|Este servicio no tiene que ser público&lt;br /&gt;
|-&lt;br /&gt;
|Araí-Usuarios IdP&lt;br /&gt;
|https://idp.arai-usuarios&lt;br /&gt;
|Este servicio es público, por eso está con TLS&lt;br /&gt;
|-&lt;br /&gt;
|Araí-Usuarios IdM&lt;br /&gt;
|https://arai-usuarios&lt;br /&gt;
|Este servicio es público, por eso está con TLS&lt;br /&gt;
|-&lt;br /&gt;
|Araí-Huarpe&lt;br /&gt;
|https://huarpe&lt;br /&gt;
|Este servicio es público, por eso está con TLS&lt;br /&gt;
|}&lt;br /&gt;
==== Certificados, certificados, certificados ... ====&lt;br /&gt;
El uso de certificados es extensivo a través de toda la plataforma.&lt;br /&gt;
&lt;br /&gt;
Se usan con tres fines:&lt;br /&gt;
* Para utilizar HTTPS en los servicios públicos&lt;br /&gt;
* Para firmar el token de SAML&lt;br /&gt;
* Para autenticar a clientes de las APIs&lt;br /&gt;
&lt;br /&gt;
Antes de continuar con la instalación debe generar los certificados necesarios.&lt;br /&gt;
===== HTTPS =====&lt;br /&gt;
Para una instalación de producción es necesario contar con certificados reales válidos. &lt;br /&gt;
&lt;br /&gt;
Si su institución no cuenta con estos certificados son fáciles de obtener con este servicio [https://letsencrypt.org/ Let's Encrypt].&lt;br /&gt;
&lt;br /&gt;
Para generar certificados para una instalación de prueba/desarrollo contamos con una imágen de Docker para facilitar este proceso.&lt;br /&gt;
===== Token SAML =====&lt;br /&gt;
COPIAR DOC DE doc/instalacion de arai-usuarios&lt;br /&gt;
===== Autenticación con certificados de clientes =====&lt;br /&gt;
Estos certificados pueden ser auto-firmados porque son para uso interno. Los puede generar a mano o utilizando la imágen de Docker.&lt;br /&gt;
=== Seguridad ===&lt;br /&gt;
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. &lt;br /&gt;
&lt;br /&gt;
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.&lt;br /&gt;
&lt;br /&gt;
== Instalación ==&lt;br /&gt;
Una vez completada la pre-instalación ya se puede seguir con la instalación de cada uno de los módulos.&lt;br /&gt;
# [[SIU-Arai/registry|Arai-Registry]]&lt;br /&gt;
# [[SIU-Arai/usuarios|Arai-Usuarios]]&lt;br /&gt;
# [[SIU-Arai/catalogos-cliente|Arai-Catalogos (cliente)]]&lt;br /&gt;
# [[SIU-Arai/proveedores|Arai-Proveedores ]]&lt;br /&gt;
&lt;br /&gt;
== Módulos ==&lt;br /&gt;
* [[SIU-Arai/huarpe|Huarpe]]: Módulo de autogestión de recursos y servicios. La cara visible de la plataforma para los usuarios..&lt;/div&gt;</summary>
		<author><name>Ablanco</name></author>	</entry>

	<entry>
		<id>https://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Arai&amp;diff=27497</id>
		<title>SIU-Arai</title>
		<link rel="alternate" type="text/html" href="https://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Arai&amp;diff=27497"/>
				<updated>2017-07-25T16:52:41Z</updated>
		
		<summary type="html">&lt;p&gt;Ablanco: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;[[Archivo:siu-arai_iso.png|derecha|link=SIU-Arai]]&lt;br /&gt;
= SIU-Arai =&lt;br /&gt;
SIU-Araí es la plataforma integradora de servicios del SIU. Cada uno de los sistemas SIU son módulos dentro de la plataforma.&lt;br /&gt;
&lt;br /&gt;
Existen dos módulos que son vitales para el funcionamiento de la plataforma.&lt;br /&gt;
&lt;br /&gt;
* Arai-Registry: Repositorio central de servicios y aplicaciones&lt;br /&gt;
* Arai-Usuarios: IDP e IDM para toda la plataforma&lt;br /&gt;
&lt;br /&gt;
== Forma de trabajo ==&lt;br /&gt;
Toda la distribución de los proyectos se hace a través de gitlab: [https://hub.siu.edu.ar https://hub.siu.edu.ar].&amp;lt;br&amp;gt;&lt;br /&gt;
Cada uno de los módulos tiene una carpeta '''doc''' donde se incluyen instrucciones de instalación.&lt;br /&gt;
&lt;br /&gt;
== Pre Instalación ==&lt;br /&gt;
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.&lt;br /&gt;
=== Que se va a instalar? ===&lt;br /&gt;
* Araí-Registry &lt;br /&gt;
* Araí-Usuarios&lt;br /&gt;
** Un IdP&lt;br /&gt;
** Un módulo de gestión de identidad (IdM)&lt;br /&gt;
* Araí-Huarpe&lt;br /&gt;
=== Que necesitamos? ===&lt;br /&gt;
==== Definir URLs ====&lt;br /&gt;
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:&lt;br /&gt;
{| class=&amp;quot;wikitable zebra&amp;quot;&lt;br /&gt;
!colspan=&amp;quot;3&amp;quot;|URLs&lt;br /&gt;
|-&lt;br /&gt;
|Araí-Registry&lt;br /&gt;
|http://localhost/registry&lt;br /&gt;
|Este servicio no tiene que ser público&lt;br /&gt;
|-&lt;br /&gt;
|Araí-Usuarios IdP&lt;br /&gt;
|https://idp.arai-usuarios&lt;br /&gt;
|Este servicio es público, por eso está con TLS&lt;br /&gt;
|-&lt;br /&gt;
|Araí-Usuarios IdM&lt;br /&gt;
|https://arai-usuarios&lt;br /&gt;
|Este servicio es público, por eso está con TLS&lt;br /&gt;
|-&lt;br /&gt;
|Araí-Huarpe&lt;br /&gt;
|https://huarpe&lt;br /&gt;
|Este servicio es público, por eso está con TLS&lt;br /&gt;
|}&lt;br /&gt;
==== Certificados, certificados, certificados ... ====&lt;br /&gt;
El uso de certificados es extensivo a través de toda la plataforma.&lt;br /&gt;
&lt;br /&gt;
Se usan con tres fines:&lt;br /&gt;
* Para utilizar HTTPS en los servicios públicos&lt;br /&gt;
* Para firmar el token de SAML&lt;br /&gt;
* Para autenticar a clientes de las APIs&lt;br /&gt;
&lt;br /&gt;
Antes de continuar con la instalación debe generar los certificados necesarios.&lt;br /&gt;
===== HTTPS =====&lt;br /&gt;
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].&lt;br /&gt;
&lt;br /&gt;
Para generar certificados para una instalación de prueba/desarrollo contamos con una imágen de Docker para facilitar este proceso.&lt;br /&gt;
===== Token SAML =====&lt;br /&gt;
COPIAR DOC DE doc/instalacion de arai-usuarios&lt;br /&gt;
===== Autenticación con certificados de clientes =====&lt;br /&gt;
Estos certificados pueden ser auto-firmados porque son para uso interno. Los puede generar a mano o utilizando la imágen de Docker.&lt;br /&gt;
=== Seguridad ===&lt;br /&gt;
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. &lt;br /&gt;
&lt;br /&gt;
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.&lt;br /&gt;
&lt;br /&gt;
== Instalación ==&lt;br /&gt;
Una vez completada la pre-instalación ya se puede seguir con la instalación de cada uno de los módulos.&lt;br /&gt;
# [[SIU-Arai/registry|Arai-Registry]]&lt;br /&gt;
# [[SIU-Arai/usuarios|Arai-Usuarios]]&lt;br /&gt;
# [[SIU-Arai/catalogos-cliente|Arai-Catalogos (cliente)]]&lt;br /&gt;
# [[SIU-Arai/proveedores|Arai-Proveedores ]]&lt;br /&gt;
&lt;br /&gt;
== Módulos ==&lt;br /&gt;
* [[SIU-Arai/huarpe|Huarpe]]: Módulo de autogestión de recursos y servicios. La cara visible de la plataforma para los usuarios..&lt;/div&gt;</summary>
		<author><name>Ablanco</name></author>	</entry>

	<entry>
		<id>https://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Arai/huarpe&amp;diff=20464</id>
		<title>SIU-Arai/huarpe</title>
		<link rel="alternate" type="text/html" href="https://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Arai/huarpe&amp;diff=20464"/>
				<updated>2017-04-19T14:34:33Z</updated>
		
		<summary type="html">&lt;p&gt;Ablanco: Página creada con «= SIU-Huarpe = Es un portal de autegestión de recursos y servicios. Sirve como puerta de entrada a una institución.   == Funcionamiento == Huarpe no depende de una conexi...»&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;= SIU-Huarpe =&lt;br /&gt;
Es un portal de autegestión de recursos y servicios. Sirve como puerta de entrada a una institución. &lt;br /&gt;
&lt;br /&gt;
== Funcionamiento ==&lt;br /&gt;
Huarpe no depende de una conexión a una base de datos. El login depende si o si de un iDP y la interacción con datos del usuario se hace a través de las APIs rest que estén conectadas al sistema.&lt;br /&gt;
&lt;br /&gt;
== Instalación ==&lt;br /&gt;
Remitirse a la [https://hub.siu.edu.ar/siu-arai/huarpe-core/tree/master/doc documentación de instalación] presente en el proyecto SIU-Huarpe, alojado en el [https://hub.siu.edu.ar hub] del SIU. Recordar que esta documentación depende y/o varía de acuerdo a la versión específica de cada sistema.&lt;br /&gt;
&lt;br /&gt;
== Componentes ==&lt;br /&gt;
Originalmente SIU-Huarpe tiene incluído un bundle de conexión con Mapuche para mostrar información de sueldos y licencias.&lt;br /&gt;
Se pueden crear bundles específicos a cada institución y luego cargarlos por configuración dentro de Huarpe.&lt;br /&gt;
&lt;br /&gt;
== Guias prácticas de uso ==&lt;br /&gt;
* [[SIU-Arai/huarpe/creacion-bundles|Creación de bundles específicos]]&lt;/div&gt;</summary>
		<author><name>Ablanco</name></author>	</entry>

	<entry>
		<id>https://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Arai/apache-ssl&amp;diff=14326</id>
		<title>SIU-Arai/apache-ssl</title>
		<link rel="alternate" type="text/html" href="https://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Arai/apache-ssl&amp;diff=14326"/>
				<updated>2016-11-21T15:55:29Z</updated>
		
		<summary type="html">&lt;p&gt;Ablanco: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;[[Archivo:siu-arai_iso.png|derecha|link=SIU-Arai]]&lt;br /&gt;
= Configurando Apache con SSL =&lt;br /&gt;
No hay muchas razones para no utilizar TLS/SSL hoy en día.&lt;br /&gt;
&lt;br /&gt;
En este artículo se dejan recursos y algunos tips de configuración para que todo funcione. De ninguna manera es LA guía de implementación. Simplemente intenta ser un lugar para aquellos que no están familiarizados con el tema.&lt;br /&gt;
&lt;br /&gt;
* [https://es.wikipedia.org/wiki/Hypertext_Transfer_Protocol_Secure HTTPS]&lt;br /&gt;
* [https://httpd.apache.org/docs/2.4/mod/mod_ssl.html Apache mod_ssl]&lt;br /&gt;
&lt;br /&gt;
== Activando el módulo SSL en Apache ==&lt;br /&gt;
En Debian 8.0 la forma de activar el módulo de SSL es la siguiente&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
a2enmod ssl&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== Generando certificados válidos de prueba ==&lt;br /&gt;
Se creó una [https://github.com/SIU-Toba/docker-certs imagen de Docker] para crear de manera razonable certificados para varios servers firmados por la misma CA.&lt;br /&gt;
&lt;br /&gt;
Para utilizarlo hay que hacer lo siguiente:&lt;br /&gt;
* Tener instaladas las últimas versiones de Docker y Docker Compose&lt;br /&gt;
* Clonar [https://gitlab.siu.edu.ar/siu/instaladores este proyecto]&lt;br /&gt;
&lt;br /&gt;
=== Configurando el docker para generar certificados ===&lt;br /&gt;
Dirijirse a la carpeta '''certs'''. Dentro de este directorio hay un archivo llamado '''docker-compose.yml'''. Dentro de este archivo hay que modificar, mínimamente, dos variables: '''LISTA_SERVER''' y '''LISTA_CLIENTES'''.&lt;br /&gt;
* '''LISTA_SERVER''': Lista de dominios, separada por espacios, para los que se crearan certificados.&amp;lt;br /&amp;gt;Aquí van los nombres de dominios desde los que Apache va a servir sus archivos.&lt;br /&gt;
* '''LISTA_CLIENTES''': Lista de nombres, separada por espacios, a los que se les crearan certificados para actuar como clientes.&amp;lt;br /&amp;gt;La plataforma SIU-Araí usa como mecanismo de autenticación de APIs Rest '''client certificate authentication'''. Básicamente los servidores de las APIs guardan la clave pública de sus clientes y se apoya sobre la directiva de Apache '''SSLVerifyClient'''.&amp;lt;br /&amp;gt;El nombre (CN) que se ponga acá será el nombre de usuario de los consumidores de las APIs.&lt;br /&gt;
&lt;br /&gt;
Una vez configurado el archivo ejecutar&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
docker-compose up&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Esto creará una estructura de directorios dentro del directorio '''data''' en la raíz del proyecto.&lt;br /&gt;
Para extraer todas las claves a un sólo directorio plano ejecutar el siguiente comando&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
mkdir &amp;lt;path con todos los certs&amp;gt;&lt;br /&gt;
sudo find data -name &amp;quot;*.pem&amp;quot; -exec cp {} &amp;lt;path con todos los certs&amp;gt; \;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Luego de seguir estos pasos ya tendremos un directorio ('''&amp;lt;path con todos los certs&amp;gt;''') con todos los certificados que necesitaremos.&lt;br /&gt;
&amp;lt;div style=&amp;quot;background-color: #ffaaaa; border: 1px solid; padding: 5px; margin-top:10px; font-style:italic&amp;quot;&amp;gt;&lt;br /&gt;
Esta herramienta se incluye como ayuda para desarrollo y testeo. No hay garantías sobre uso en producción de estos certificados.&lt;br /&gt;
&amp;lt;/div&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== Sirviendo archivos con SSL ==&lt;br /&gt;
Copiar todos los certificados necesarios al directorio '''/etc/apache2/ssl'''. En este caso utilizaremos los creados para un entorno de pruebas.&amp;lt;br /&amp;gt;&lt;br /&gt;
Los archivos que tenemos en este directorio son:&lt;br /&gt;
&amp;lt;source lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
-rw-r--r-- 1 root root 1980 nov 14 14:28 ca.cert.pem&lt;br /&gt;
-r--r--r-- 1 root root 3980 nov 14 14:28 ca-chain.cert.pem&lt;br /&gt;
-r--r--r-- 1 root root 1931 nov 14 14:26 usuarios.local.cert.pem&lt;br /&gt;
-r--r--r-- 1 root root 1704 nov 14 14:27 usuarios.local.key.pem&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
Vamos a configurar el host llamado '''usuarios.local'''&lt;br /&gt;
&lt;br /&gt;
Activar el template SSL de Apache2&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
a2ensite default-ssl&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Luego hay que editar el el archivo '''/etc/apache2/sites-enabled/default-ssl.conf'''&lt;br /&gt;
* Agregar la entrada ServerName debajo de ServerAdmin. Por ejemplo:&lt;br /&gt;
 &lt;br /&gt;
&amp;lt;source lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
 &amp;lt;VirtualHost _default_:443&amp;gt;&lt;br /&gt;
    ...&lt;br /&gt;
    ServerAdmin webmaster@localhost&lt;br /&gt;
    ServerName usuarios.local:443&lt;br /&gt;
    ...&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
* Modificar las siguientes entradas para configurar los certificados&lt;br /&gt;
&amp;lt;source lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;VirtualHost _default_:443&amp;gt;&lt;br /&gt;
    ...&lt;br /&gt;
    SSLCertificateFile    /etc/apache2/ssl/usuarios.local.cert.pem&lt;br /&gt;
    SSLCertificateKeyFile /etc/apache2/ssl/usuarios.local.key.pem&lt;br /&gt;
    ...&lt;br /&gt;
    SSLCACertificateFile /etc/apache2/ssl/ca-chain.cert.pem            &lt;br /&gt;
    SSLCertificateChainFile /etc/apache2/ssl/ca-chain.cert.pem&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* Redigir puerto 80 a 443. Hay que modificar el archivo '''/etc/apache2/sites-enabled/000-default.conf''' y agregar las siguientes líneas:&lt;br /&gt;
&amp;lt;source lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;VirtualHost *:80&amp;gt;&lt;br /&gt;
    ...&lt;br /&gt;
    ServerName usuarios.local&lt;br /&gt;
    Redirect permanent / https://usuarios.local/&lt;br /&gt;
&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* Reiniciar apache&lt;br /&gt;
&amp;lt;source lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
service apache2 restart&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* Listo! el sitio ya es accesible por HTTPS. Actualmente verá el warning de seguridad del browser. &amp;lt;br /&amp;gt;Si quiere evitar esto agregue el archivo '''/etc/apache2/ssl/ca.cert.pem''' a su navegador. En Google Chrome es Configuración -&amp;gt; Administrar Certificados&lt;br /&gt;
== Verificando clientes con SSL ==&lt;br /&gt;
La verificación de cliente de Apache se utiliza como parte fundamental de la autenticación de pedidos Rest entre módulos.&lt;br /&gt;
&lt;br /&gt;
Siga los siguientes pasos para configurarla.&lt;br /&gt;
* Agregar la CA como trusted en los dos servidores. Para hacerlo ejecutar&lt;br /&gt;
&amp;lt;source lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
cp ca.cert.pem /usr/share/ca-certificates/ca_propia.crt&lt;br /&gt;
nano /etc/ca-certificates.conf&lt;br /&gt;
# agregar ca_propia.crt al final del archivo&lt;br /&gt;
update-ca-certificates --fresh&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* En el archivo '''/etc/apache2/sites-enabled/default-ssl.conf'''&lt;br /&gt;
Agregar las siguientes entradas. Por ejemplo:&lt;br /&gt;
 &lt;br /&gt;
&amp;lt;source lang=&amp;quot;apache&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
 &amp;lt;VirtualHost _default_:443&amp;gt;&lt;br /&gt;
    ...&lt;br /&gt;
    SSLVerifyClient optional_no_ca&lt;br /&gt;
    SSLVerifyDepth 2&lt;br /&gt;
    SSLProtocol all -SSLv2 -SSLv3&lt;br /&gt;
    SSLOptions +StdEnvVars +ExportCertData&lt;br /&gt;
    BrowserMatch &amp;quot;MSIE [2-6]&amp;quot; \&lt;br /&gt;
         nokeepalive ssl-unclean-shutdown \&lt;br /&gt;
         downgrade-1.0 force-response-1.0&lt;br /&gt;
         # MSIE 7 and newer should be able to use keepalive&lt;br /&gt;
    BrowserMatch &amp;quot;MSIE [17-9]&amp;quot; ssl-unclean-shutdown&lt;br /&gt;
    ...&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* Listo! El servidor ya está listo para validar certificados de cliente&lt;/div&gt;</summary>
		<author><name>Ablanco</name></author>	</entry>

	<entry>
		<id>https://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Arai/usuarios/templates&amp;diff=14325</id>
		<title>SIU-Arai/usuarios/templates</title>
		<link rel="alternate" type="text/html" href="https://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Arai/usuarios/templates&amp;diff=14325"/>
				<updated>2016-11-21T15:46:03Z</updated>
		
		<summary type="html">&lt;p&gt;Ablanco: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;[[Archivo:siu-arai_iso.png|derecha|link=SIU-Arai]]&lt;br /&gt;
= Templates para páginas de login =&lt;br /&gt;
Existe un paquete para desarrollar los templates de la pantalla de login de Araí-Usuarios. Es [https://github.com/SIU-Toba/inline-template este].&lt;br /&gt;
&lt;br /&gt;
== Creación de un nuevo template ==&lt;br /&gt;
Crear un proyecto vacío en algún repo GIT. Para este tutorial se asume Github, pero puede ser cualquiera.&lt;br /&gt;
Ejecutar el siguiente comando para descargar el template vacío&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
composer create-project siu-toba/inline-template CARPETA-DESTINO&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Entrar al directorio descargado y ejecutar los siguiente pasos para sincronizar el template vacío con el proyecto creado&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
git init&lt;br /&gt;
git remote add origin https://github.com/usuario/&amp;lt;NOMBRE PROYECTO&amp;gt;.git&lt;br /&gt;
git add .&lt;br /&gt;
git commit -m &amp;quot;commit inicial&amp;quot;&lt;br /&gt;
git push -u origin master&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Ya está listo para desarrollar!&lt;br /&gt;
&lt;br /&gt;
== Testeando ==&lt;br /&gt;
Se puede ver el template generado ejecutando el comando: &lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
bin/server.sh&lt;br /&gt;
# acceder a http://localhost:8080&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
La idea es que todo el css, js e imágenes se acumule en los directorios correspondientes (css, img y js).&lt;br /&gt;
&lt;br /&gt;
== Modificando el template ==&lt;br /&gt;
El html del template es generado a través del archivo twig que está en &amp;lt;code&amp;gt;templates/index.twig&amp;lt;/code&amp;gt;.&lt;br /&gt;
Para utilizar los recursos cargados en las carpetas css, img y js se debe hacer uso de estas tres funciones de twig:&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;php&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
inline_img('NOMBRE_IMG')&lt;br /&gt;
inline_js('NOMBRE_JS')&lt;br /&gt;
inline_css('NOMBRE_CSS')&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
Se puede ver, a modo de ejemplo, [https://hub.siu.edu.ar/siu-design/template-login-cin este repo] donde está armado el template que utilizamos dentro del SIU.&lt;br /&gt;
&lt;br /&gt;
=== Contexto ===&lt;br /&gt;
Para armar estos templates es necesario contar con datos del contexto. Araí-Usuarios deja disponible dentro del twig un arreglo con las siguientes entradas:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;php&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
[ 'arai_usuarios' =&amp;gt; [&lt;br /&gt;
    'sigla_institucion' =&amp;gt; 'SIU',&lt;br /&gt;
    'url_institucion' =&amp;gt; 'https://siu.edu.ar',&lt;br /&gt;
    'error_login' =&amp;gt; '',&lt;br /&gt;
    'nombre_usuario' =&amp;gt; '',&lt;br /&gt;
    'state_params' =&amp;gt; [&lt;br /&gt;
        'AuthState' =&amp;gt; 'algun token'&lt;br /&gt;
    ],&lt;br /&gt;
    'url_recuperar_pass' =&amp;gt; 'https://siu.edu.ar/recuperar',&lt;br /&gt;
    'email_soporte' =&amp;gt; 'soporte@siu.edu.ar'&lt;br /&gt;
 ]]&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Para desarrollar se puede incluir ese arreglo en el '''index.php''', pueden utilizar el [https://gitlab.siu.edu.ar/siu-design/template-login-cin/blob/master/index.php#L5 template del SIU] como referencia.&lt;br /&gt;
&lt;br /&gt;
== Publicando el template ==&lt;br /&gt;
Una vez terminado el trabajo comitear todos los cambios (incluyendo los assets) y pushearlos.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
git add -A&lt;br /&gt;
git commit -m &amp;quot;un mensaje significativo&amp;quot;&lt;br /&gt;
git push&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;/div&gt;</summary>
		<author><name>Ablanco</name></author>	</entry>

	<entry>
		<id>https://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Arai/usuarios/templates-login&amp;diff=14324</id>
		<title>SIU-Arai/usuarios/templates-login</title>
		<link rel="alternate" type="text/html" href="https://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Arai/usuarios/templates-login&amp;diff=14324"/>
				<updated>2016-11-21T15:44:18Z</updated>
		
		<summary type="html">&lt;p&gt;Ablanco: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;[[Archivo:siu-arai_iso.png|derecha|link=SIU-Arai]]&lt;br /&gt;
= Cambiando el template de página de login =&lt;br /&gt;
Los templates se construyen [[SIU-Arai/usuarios/templates|así]]. &lt;br /&gt;
&lt;br /&gt;
Luego hay que descargarlos en un directorio accesible para Araí-Usuarios y por último hay que configurar Araí-Usuarios para que lo utilice.&lt;br /&gt;
&lt;br /&gt;
== Configuración de Araí-Usuarios ==&lt;br /&gt;
La configuración de los templates de login se hace desde el archivo &amp;lt;code&amp;gt;config/idp.yml&amp;lt;/code&amp;gt;, este archivo tiene una sección &amp;lt;code&amp;gt;templates_login&amp;lt;/code&amp;gt;, se puede ver un ejemplo en el [https://hub.siu.edu.ar/siu-arai/arai-usuarios/blob/develop/templates/config/idp.yml.dist#L25 archivo de template].&lt;br /&gt;
&lt;br /&gt;
La configuración está dividida en tres partes:&lt;br /&gt;
# &amp;lt;code&amp;gt;definition&amp;lt;/code&amp;gt;&amp;lt;br /&amp;gt;En esta sección se definen los templates que se pueden utilizar. &amp;lt;br/&amp;gt; A cada template hay que asignarle un identificador, puede ser cualquier identificador válido de PHP.&amp;lt;br/&amp;gt; Para cada definición hay que setear tres valores&lt;br /&gt;
#* &amp;lt;code&amp;gt;type&amp;lt;/code&amp;gt; tipo de paquete del template, por ahora el único valor válido es &amp;lt;code&amp;gt;composer-package&amp;lt;/code&amp;gt;&lt;br /&gt;
#* &amp;lt;code&amp;gt;class&amp;lt;/code&amp;gt; el namespace y clase del template&lt;br /&gt;
#* &amp;lt;code&amp;gt;dir&amp;lt;/code&amp;gt; el directorio donde se descargó el template&lt;br /&gt;
# &amp;lt;code&amp;gt;default&amp;lt;/code&amp;gt;&amp;lt;br /&amp;gt; El template que se utiliza por defecto. Para nombrarlo se utilizan los identificadores creados en la sección anterior&lt;br /&gt;
# &amp;lt;code&amp;gt;usage&amp;lt;/code&amp;gt;&amp;lt;br /&amp;gt; Se especifica por aplicación cuál template se quiere utilizar. Las aplicaciones se nombran por su ID. Este se puede ver desde la UI de Araí-Usuarios&lt;/div&gt;</summary>
		<author><name>Ablanco</name></author>	</entry>

	<entry>
		<id>https://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Arai/usuarios/templates&amp;diff=14283</id>
		<title>SIU-Arai/usuarios/templates</title>
		<link rel="alternate" type="text/html" href="https://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Arai/usuarios/templates&amp;diff=14283"/>
				<updated>2016-11-17T18:23:57Z</updated>
		
		<summary type="html">&lt;p&gt;Ablanco: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;[[Archivo:siu-arai_iso.png|derecha|link=SIU-Arai]]&lt;br /&gt;
= Templates para páginas de login =&lt;br /&gt;
Existe un paquete para desarrollar los templates de la pantalla de login de Araí-Usuarios. Es [https://github.com/SIU-Toba/inline-template este].&lt;br /&gt;
&lt;br /&gt;
== Creación de un nuevo template ==&lt;br /&gt;
Crear un proyecto vacío en algún repo GIT. Para este tutorial se asume Github, pero puede ser cualquiera.&lt;br /&gt;
Ejecutar el siguiente comando para descargar el template vacío&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
composer create-project siu-toba/inline-template CARPETA-DESTINO&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Entrar al directorio descargado y ejecutar los siguiente pasos para sincronizar el template vacío con el proyecto creado&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
git init&lt;br /&gt;
git remote add origin https://github.com/usuario/&amp;lt;NOMBRE PROYECTO&amp;gt;.git&lt;br /&gt;
git add .&lt;br /&gt;
git commit -m &amp;quot;commit inicial&amp;quot;&lt;br /&gt;
git push -u origin master&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Ya está listo para desarrollar!&lt;br /&gt;
&lt;br /&gt;
== Testeando ==&lt;br /&gt;
Se puede ver el template generado ejecutando el comando: &lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
bin/server.sh&lt;br /&gt;
# acceder a http://localhost:8080&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
La idea es que todo el css, js e imágenes se acumule en los directorios correspondientes (css, img y js).&lt;br /&gt;
&lt;br /&gt;
== Modificando el template ==&lt;br /&gt;
El html del template es generado a través del archivo twig que está en &amp;lt;code&amp;gt;templates/index.twig&amp;lt;/code&amp;gt;.&lt;br /&gt;
Para utilizar los recursos cargados en las carpetas css, img y js se debe hacer uso de estas tres funciones de twig:&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;php&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
inline_img('NOMBRE_IMG')&lt;br /&gt;
inline_js('NOMBRE_JS')&lt;br /&gt;
inline_css('NOMBRE_CSS')&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
Se puede ver, a modo de ejemplo, [https://hub.siu.edu.ar/siu-design/template-login-cin este repo] donde está armado el template que utilizamos dentro del SIU.&lt;br /&gt;
&lt;br /&gt;
=== Contexto ===&lt;br /&gt;
Para armar estos templates es necesario contar con datos del contexto. Araí-Usuarios deja disponible dentro del twig un arreglo con las siguientes entradas:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;php&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
[ 'arai_usuarios' =&amp;gt; [&lt;br /&gt;
    'sigla_institucion' =&amp;gt; 'SIU',&lt;br /&gt;
    'url_institucion' =&amp;gt; 'https://siu.edu.ar',&lt;br /&gt;
    'error_login' =&amp;gt; '',&lt;br /&gt;
    'nombre_usuario' =&amp;gt; '',&lt;br /&gt;
    'state_params' =&amp;gt; [&lt;br /&gt;
        'AuthState' =&amp;gt; 'algun token'&lt;br /&gt;
    ],&lt;br /&gt;
    'url_recuperar_pass' =&amp;gt; 'https://siu.edu.ar/recuperar',&lt;br /&gt;
    'email_soporte' =&amp;gt; 'soporte@siu.edu.ar'&lt;br /&gt;
 ]]&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Para ir probando meter ese arreglo en el '''index.php''', de nuevo pueden utilizar el [https://gitlab.siu.edu.ar/siu-design/template-login-cin/blob/master/index.php#L5 template del SIU] como guía.&lt;br /&gt;
&lt;br /&gt;
== Publicando el template ==&lt;br /&gt;
Una vez terminado el trabajo comitear todos los cambios (incluyendo los assets) y pushearlos.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
git add -A&lt;br /&gt;
git commit -m &amp;quot;un mensaje significativo&amp;quot;&lt;br /&gt;
git push&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;/div&gt;</summary>
		<author><name>Ablanco</name></author>	</entry>

	<entry>
		<id>https://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Arai/usuarios/templates-login&amp;diff=14282</id>
		<title>SIU-Arai/usuarios/templates-login</title>
		<link rel="alternate" type="text/html" href="https://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Arai/usuarios/templates-login&amp;diff=14282"/>
				<updated>2016-11-17T18:23:38Z</updated>
		
		<summary type="html">&lt;p&gt;Ablanco: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;[[Archivo:siu-arai_iso.png|derecha|link=SIU-Arai]]&lt;br /&gt;
= Cambiando el template de página de login =&lt;br /&gt;
Para manejar &lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
[[SIU-Arai/usuarios/templates|Creando templates para las páginas de login]]&lt;/div&gt;</summary>
		<author><name>Ablanco</name></author>	</entry>

	<entry>
		<id>https://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Arai&amp;diff=14280</id>
		<title>SIU-Arai</title>
		<link rel="alternate" type="text/html" href="https://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Arai&amp;diff=14280"/>
				<updated>2016-11-17T18:23:12Z</updated>
		
		<summary type="html">&lt;p&gt;Ablanco: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;[[Archivo:siu-arai_iso.png|derecha|link=SIU-Arai]]&lt;br /&gt;
= SIU-Arai =&lt;br /&gt;
SIU-Araí es la plataforma integradora de servicios del SIU. Cada uno de los sistemas SIU son módulos dentro de la plataforma.&lt;br /&gt;
&lt;br /&gt;
Existen dos módulos que son vitales para el funcionamiento de la plataforma.&lt;br /&gt;
&lt;br /&gt;
* Arai-Registry: Repositorio central de servicios y aplicaciones&lt;br /&gt;
* Arai-Usuarios: IDP e IDM para toda la plataforma&lt;br /&gt;
&lt;br /&gt;
== Seguridad ==&lt;br /&gt;
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. &lt;br /&gt;
&lt;br /&gt;
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.&lt;br /&gt;
&lt;br /&gt;
== Forma de trabajo ==&lt;br /&gt;
Toda la distribución de los proyectos se hace a través de gitlab: [https://hub.siu.edu.ar https://hub.siu.edu.ar].&amp;lt;br&amp;gt;&lt;br /&gt;
Cada uno de los módulos tiene una carpeta '''doc''' donde se incluyen instrucciones de instalación.&lt;br /&gt;
&lt;br /&gt;
== Instalación ==&lt;br /&gt;
Para comenzar a integrarse a la plataforma deberán instalarse los dos componentes centrales en este orden:&lt;br /&gt;
# [[SIU-Arai/registry|Arai-Registry]]&lt;br /&gt;
# [[SIU-Arai/usuarios|Arai-Usuarios]]&lt;br /&gt;
&lt;br /&gt;
== Módulos ==&lt;br /&gt;
* [[SIU-Arai/huarpe|Huarpe]]: Módulo de autogestión de recursos y servicios. La cara visible de la plataforma para los usuarios.&lt;/div&gt;</summary>
		<author><name>Ablanco</name></author>	</entry>

	<entry>
		<id>https://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Arai/usuarios/templates-login&amp;diff=14277</id>
		<title>SIU-Arai/usuarios/templates-login</title>
		<link rel="alternate" type="text/html" href="https://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Arai/usuarios/templates-login&amp;diff=14277"/>
				<updated>2016-11-17T18:19:35Z</updated>
		
		<summary type="html">&lt;p&gt;Ablanco: Página creada con «= Cambiando el template de página de login = Para manejar     Creando templates para las páginas de login»&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;= Cambiando el template de página de login =&lt;br /&gt;
Para manejar &lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
[[SIU-Arai/usuarios/templates|Creando templates para las páginas de login]]&lt;/div&gt;</summary>
		<author><name>Ablanco</name></author>	</entry>

	<entry>
		<id>https://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Arai/usuarios&amp;diff=14267</id>
		<title>SIU-Arai/usuarios</title>
		<link rel="alternate" type="text/html" href="https://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Arai/usuarios&amp;diff=14267"/>
				<updated>2016-11-17T17:45:52Z</updated>
		
		<summary type="html">&lt;p&gt;Ablanco: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;[[Archivo:siu-arai_iso.png|derecha|link=SIU-Arai]]&lt;br /&gt;
&lt;br /&gt;
= Arai-Usuarios =&lt;br /&gt;
Arai-Usuarios es un Identity Provider y Manager.&lt;br /&gt;
Provee identidad y login centralizado (Single-Sign-On) implementado con el protocolo SAML. A su vez mantiene una base de datos común de usuarios, provee una interfaz de gestión, una API de acceso a los usuarios y herramientas de auditoría.&lt;br /&gt;
&lt;br /&gt;
== Componentes ==&lt;br /&gt;
Arai-Usuarios ofrece diferentes componentes:&lt;br /&gt;
* Un IDP implementado con un SimpleSAMLPhp con un único authsource (la base de datos común de usuarios)&lt;br /&gt;
* Una aplicación denominado ARAI-Usuarios Gestión que ofrece &lt;br /&gt;
** ABMs de usuarios&lt;br /&gt;
** Configuración de políticas de acceso y seguridad&lt;br /&gt;
** Auditoría de edición y acceso a las diferentes aplicaciones del repositorio&lt;br /&gt;
* Una API Rest de gestión de usuarios, para que los diferentes sistemas puedan obtener&lt;br /&gt;
* Dentro del paquete de datos que ofrece, se encuentra el que espera la librería js-app-launcher que ayuda a la uniformidad de comportamientos del usuario dentro dentro de las diferentes aplicaciones.&lt;br /&gt;
* Una Base de datos común de Usuarios, con scripts y utilidades para integrar aplicaciones existentes.&lt;br /&gt;
&lt;br /&gt;
== Guias prácticas de uso ==&lt;br /&gt;
* [[SIU-Arai/usuarios/templates-login|Cambiar el template de páginas de login]]&lt;br /&gt;
* [[SIU-Arai/usuarios/migracion-usuarios|Migración inicial de usuarios Toba hacia Arai-Usuarios]]&lt;br /&gt;
* [[SIU-Arai/usuarios/integracion-inicial-toba|Integrando una aplicación Toba con Arai-Usuarios]]&lt;/div&gt;</summary>
		<author><name>Ablanco</name></author>	</entry>

	<entry>
		<id>https://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Arai/usuarios/templates&amp;diff=14263</id>
		<title>SIU-Arai/usuarios/templates</title>
		<link rel="alternate" type="text/html" href="https://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Arai/usuarios/templates&amp;diff=14263"/>
				<updated>2016-11-17T16:21:53Z</updated>
		
		<summary type="html">&lt;p&gt;Ablanco: Página creada con «= Templates para páginas de login = Existe un paquete para desarrollar los templates de la pantalla de login de Araí-Usuarios. Es [https://github.com/SIU-Toba/inline-temp...»&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;= Templates para páginas de login =&lt;br /&gt;
Existe un paquete para desarrollar los templates de la pantalla de login de Araí-Usuarios. Es [https://github.com/SIU-Toba/inline-template este].&lt;br /&gt;
&lt;br /&gt;
== Creación de un nuevo template ==&lt;br /&gt;
Crear un proyecto vacío en algún repo GIT. Para este tutorial se asume Github, pero puede ser cualquiera.&lt;br /&gt;
Ejecutar el siguiente comando para descargar el template vacío&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
composer create-project siu-toba/inline-template CARPETA-DESTINO&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Entrar al directorio descargado y ejecutar los siguiente pasos para sincronizar el template vacío con el proyecto creado&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
git init&lt;br /&gt;
git remote add origin https://github.com/usuario/&amp;lt;NOMBRE PROYECTO&amp;gt;.git&lt;br /&gt;
git add .&lt;br /&gt;
git commit -m &amp;quot;commit inicial&amp;quot;&lt;br /&gt;
git push -u origin master&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Ya está listo para desarrollar!&lt;br /&gt;
&lt;br /&gt;
== Testeando ==&lt;br /&gt;
Se puede ver el template generado ejecutando el comando: &lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
bin/server.sh&lt;br /&gt;
# acceder a http://localhost:8080&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
La idea es que todo el css, js e imágenes se acumule en los directorios correspondientes (css, img y js).&lt;br /&gt;
&lt;br /&gt;
== Modificando el template ==&lt;br /&gt;
El html del template es generado a través del archivo twig que está en &amp;lt;code&amp;gt;templates/index.twig&amp;lt;/code&amp;gt;.&lt;br /&gt;
Para utilizar los recursos cargados en las carpetas css, img y js se debe hacer uso de estas tres funciones de twig:&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;php&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
inline_img('NOMBRE_IMG')&lt;br /&gt;
inline_js('NOMBRE_JS')&lt;br /&gt;
inline_css('NOMBRE_CSS')&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
Se puede ver, a modo de ejemplo, [https://hub.siu.edu.ar/siu-design/template-login-cin este repo] donde está armado el template que utilizamos dentro del SIU.&lt;br /&gt;
&lt;br /&gt;
=== Contexto ===&lt;br /&gt;
Para armar estos templates es necesario contar con datos del contexto. Araí-Usuarios deja disponible dentro del twig un arreglo con las siguientes entradas:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;php&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
[ 'arai_usuarios' =&amp;gt; [&lt;br /&gt;
    'sigla_institucion' =&amp;gt; 'SIU',&lt;br /&gt;
    'url_institucion' =&amp;gt; 'https://siu.edu.ar',&lt;br /&gt;
    'error_login' =&amp;gt; '',&lt;br /&gt;
    'nombre_usuario' =&amp;gt; '',&lt;br /&gt;
    'state_params' =&amp;gt; [&lt;br /&gt;
        'AuthState' =&amp;gt; 'algun token'&lt;br /&gt;
    ],&lt;br /&gt;
    'url_recuperar_pass' =&amp;gt; 'https://siu.edu.ar/recuperar',&lt;br /&gt;
    'email_soporte' =&amp;gt; 'soporte@siu.edu.ar'&lt;br /&gt;
 ]]&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Para ir probando meter ese arreglo en el '''index.php''', de nuevo pueden utilizar el [https://gitlab.siu.edu.ar/siu-design/template-login-cin/blob/master/index.php#L5 template del SIU] como guía.&lt;br /&gt;
&lt;br /&gt;
== Publicando el template ==&lt;br /&gt;
Una vez terminado el trabajo comitear todos los cambios (incluyendo los assets) y pushearlos.&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
git add -A&lt;br /&gt;
git commit -m &amp;quot;un mensaje significativo&amp;quot;&lt;br /&gt;
git push&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;/div&gt;</summary>
		<author><name>Ablanco</name></author>	</entry>

	</feed>