SPConfig

Versión 12 (Emilio Penna, Jueves, 15 de Octubre de 2026 19:25:35 -0300)

1 1
h1. SPConfig
2 1
3 1
4 1
5 8 Emilio Penna
h3. 1. Configuracion de entityID en shibboleth2.xml
6 1
7 9 Emilio Penna
Setear identificador de la entidad (entityID). Ejemplo:
8 1
9 1
<pre><code class="xml">
10 9 Emilio Penna
<ApplicationDefaults entityID="https://spe.seciu.edu.uy/shibboleth"
11 1
</code></pre>
12 1
13 10 Emilio Penna
14 1
15 1
16 1
17 1
18 5 Emilio Penna
19 10 Emilio Penna
-------------------------------------------
20 10 Emilio Penna
21 1
h3. 4. Definir y cargar una fuente de metadata
22 1
23 12 Emilio Penna
Obtener metadata del IdP, se adjunta al final la metadata del IdP de test de seciu, si se va a integrar con el IdP de producción debe solicitarla por correo a idp-udelar@seciu.edu.uy
24 1
25 1
Guardarla en el directorio metadata de su SP (si no existe crearlo).
26 1
27 1
/etc/shibboleth/metadata/metadata-idp-test-udelar.xml
28 1
29 1
Registrarla en el SP, para esto, en el archivo shibboleth2.xml, ajustar el path en el elemento <MetadataProvider>:
30 1
31 1
<pre> <code class="xml">
32 1
<MetadataProvider type="XML" path="/etc/shibboleth/metadata/metadata-idp-test-udelar.xml" ></MetadataProvider>
33 1
</code> </pre>
34 1
35 1
36 1
h3. 5. Configurar Inicio de Sesión
37 1
38 1
Se debe configurar elemento SSO dentro del archivo shibboleth2.xml para que use el provedor de identidad de test de Seciu: 
39 1
40 8 Emilio Penna
<pre> <code class="xml">
41 1
<SSO entityID="https://pirapire.seciu.edu.uy/idp/shibboleth"
42 1
</code></pre>
43 1
44 1
h3. 6. Configuración del archivo attribute-map.xml
45 1
46 1
Shibboleth SP extrae los atributos del Assertion SAML que le envia el IdP, y almacena los valores en variables del servidor web. El mapeo entre los atributos recibidos y las variables se define en el archivo attribute-map.xml.
47 1
48 1
Se puede utilizar el que viene por defecto, luego se van descomentando o agregando los atributos que se utilicen.
49 1
Al final se adjunta un ejemplo de archivo attribute-map.xml
50 12 Emilio Penna
51 12 Emilio Penna
52 12 Emilio Penna
Luego se debe reiniciar el proceso de Shibboleth (service shibd stop/service shibd start).
53 12 Emilio Penna
54 12 Emilio Penna
Para verificar la configuración se puede ejecutar el siguiente comando: 
55 12 Emilio Penna
56 12 Emilio Penna
<pre>
57 12 Emilio Penna
shibd -t.
58 12 Emilio Penna
</pre>
59 12 Emilio Penna
60 12 Emilio Penna
La salida esperada es la siguiente:
61 12 Emilio Penna
62 12 Emilio Penna
<pre>
63 12 Emilio Penna
overall configuration is loadable, check console for non-fatal problems
64 12 Emilio Penna
</pre>
65 12 Emilio Penna
66 12 Emilio Penna
67 1
68 1
69 3 Emilio Penna
h3. 7. Enviar Metadata de su SP para registro
70 1
71 1
Debe obtener la metadata de su SP y contactarse con Seciu para su registro. 
72 1
73 1
La información sobre como obtener y ajustar la metadata puede verla en esta pagina: [[SP-Metadata]]
74 1
75 1
76 3 Emilio Penna
h3. 8. Configuracion de Apache para proteger un recurso
77 1
78 1
En Apache, se recomienda setear correctamente el ServerName y también setear "UseCanonicalName On".
79 6 Emilio Penna
También se recomienda utilizar el "worker" MPM.
80 1
81 1
Referencia: https://wiki.shibboleth.net/confluence/display/SHIB2/NativeSPApacheConfig
82 1
83 1
Al instalar el modulo, se agrega mods-available/shib2.load, donde se carga el módulo.
84 1
85 1
86 1
Para agregar un recurso (Location) protegido, agregar en shib.conf o en el virtual host:
87 1
88 11 Emilio Penna
<pre> 
89 1
90 1
# You MUST enable AuthType shibboleth for the module to process
91 1
# any requests, and there MUST be a require command as well.
92 1
93 1
<Location /secure>
94 1
  AuthType shibboleth
95 1
  ShibRequestSetting requireSession 1
96 1
  require shib-session
97 1
</Location>
98 11 Emilio Penna
</pre>
99 1
100 7 Emilio Penna
Se pueden definir reglas mas complejas para control de acceso, incluso utilizando los aributos emitidos por el IdP.
101 1
Ejemplos de reglas para control de acceso:
102 1
https://www.switch.ch/aai/guides/sp/access-rules/