Differenze tra le versioni di "Attributo Affiliazione"

Da WIKI IDEM GARR.
Jump to navigation Jump to search
 
(26 versioni intermedie di 3 utenti non mostrate)
Riga 2: Riga 2:
 
L'affiliazione definisce la relazione che esiste tra l'utente e la propria Organizzazione di Appartenenza.
 
L'affiliazione definisce la relazione che esiste tra l'utente e la propria Organizzazione di Appartenenza.
  
−
In IDEM l'attributo che contiene i valori di affiliazione è '''eduPersonScopedAffiliation''' nella forma ''eduPersonAffiliation''@<''idp-scope''>'''.''' I valori che '''eduPersonAffiliation''' può contenere sono limitati e definiti da una specifica grammatica:
+
In IDEM l'attributo che contiene i valori di affiliazione è '''<code>eduPersonScopedAffiliation</code>''' nella forma <code>eduPersonAffiliation@<idp-scope></code>'''.''' I valori che '''<code>eduPersonAffiliation</code>''' può contenere sono limitati e definiti da una specifica grammatica:
  
 
https://wiki.refeds.org/display/STAN/eduPerson+2020-01#eduPerson202001-eduPersonAffiliation
 
https://wiki.refeds.org/display/STAN/eduPerson+2020-01#eduPerson202001-eduPersonAffiliation
  
−
In particolare i valori usati in IDEM sono soltanto: '''student''', '''staff''', '''alum''', '''member''', '''affiliate''' e '''library-walk-in'''.
+
In particolare i valori usati in IDEM sono: '''student''', '''staff''', '''faculty''', '''member''', '''alum''', '''affiliate''' e '''library-walk-in'''.
  
−
Preghiamo di notare che '''member''' deve essere sempre asserito in corrispondenza delle specializzazioni di affiliazione '''student''' e '''staff'''.
+
Preghiamo di notare che '''member''' non può essere rilasciato da solo ma deve essere sempre asserito in corrispondenza delle specializzazioni di affiliazione '''student,''' '''staff''' e '''faculty'''.
  
 
Le classi '''alum,''' '''affiliate''' e '''library-walk-in''' non sono tipicamente da considerarsi Membri dell'Organizzazione (a meno che non si verifichino casi particolari indicati nella sezione "''Descrizione delle classi di affiliazione''").
 
Le classi '''alum,''' '''affiliate''' e '''library-walk-in''' non sono tipicamente da considerarsi Membri dell'Organizzazione (a meno che non si verifichino casi particolari indicati nella sezione "''Descrizione delle classi di affiliazione''").
 +
 +
===Riferimenti===
 +
https://wiki.refeds.org/display/STAN/eduPerson eduPerson Specification e download del file ldif
 +
 +
[[:File:SpecificheTecnicheAttributi v3.0 20161129.pdf|File:SpecificheTecnicheAttributi v3.0 20161129.pdf]] Documento ufficiale IDEM  "'''''Specifiche tecniche per la compilazione e l'uso degli attributi'''''"<blockquote>'''IMPORTANTE: La tabella di corrispondenza tra ruoli e valori di affilizione contenuta nelle Specifiche Tecniche Attributi è stata aggiornata per comprendere nuovi casi d'uso, vedi''' [[Attributo Affiliazione#Tabella Corrispondenza tra le categorie note e le possibili affiliazioni]]</blockquote>
 +
 +
===Descrizione delle classi di affiliazione===
 +
'''Member''' contiene tutte le persone che hanno un rapporto istituzionale con l'organizzazione di appartenenza e ai quali viene dato un insieme base di privilegi. Sono member tutti gli appartenenti a staff e student, ma tipicamente non gli alum.
 +
 +
'''Student''', '''staff''' e '''faculty''' sono quindi due specializzazioni distinte di member:
 +
 +
*Il valore '''staff''' va utilizzato per tutto il personale (docenti, personale amministrativo, bibliotecario e tecnico di supporto) in servizio presso l'organizzazione di appartenenza, con qualunque tipo di contratto, anche a tempo determinato, oppure rientrante nei contratti cosiddetti atipici.
 +
*il valore '''faculty''' indica tutto il personale la cui attività principale è la ricerca e o l'insegnamento.
 +
*Con '''student''' si indicano gli studenti regolarmente iscritti ad uno dei corsi dell'organizzazione di appartenenza.
 +
 +
'''Affiliate''' si applica alle persone con le quali l'organizzazione di appartenenza ha una qualsiasi forma di rapporto ed alle quali è necessario attribuire un'identità di utente, ma per cui non vengono estesi i privilegi derivanti dall'essere membri dell'organizzazione stessa. Potrebbero rientrare in questa categoria i fornitori di servizi o di materiali delle organizzazioni, ricercatori di altre organizzazioni che collaborano con un gruppo interno, persone per le quali è necessaria l'identificazione per servizi molto particolari riservati ad esterni all'università stessa. Normalmente gli affiliate non sono member , se non in casi eccezionali: ad esempio uno studente che sia anche dipendente di una ditta che fornisce servizi ad un'università.
 +
 +
'''Alum''' comprende gli ex studenti dell'organizzazione di appartenenza che hanno completato almeno il primo livello di studi. E’ possibile che un alum sia anche staff oppure affiliate dell'organizzazione.
 +
 +
'''Library-walk-in''' indica i frequentatori di una biblioteca ed è pensato per semplificare la gestione di frequenti accordi contrattuali con i fornitori di risorse. Il valore è indipendente dagli altri valori indicanti l'affiliazione, ciò vuol dire che il possedere tale requisito non influisce o pregiudica l'avere un altro tipo di affiliazione e viceversa.
 +
 +
===Corrispondenza tra le categorie note e le possibili affiliazioni===
 +
Vedi la tabella in appendice: [[Attributo Affiliazione#Tabella Corrispondenza tra le categorie note e le possibili affiliazioni]].
  
 
===Esempi Pratici===
 
===Esempi Pratici===
  
−
*Personale tecnico amministrativo e docenti:
+
*Personale tecnico amministrativo:
 
*#eduPersonAffiliation​:​ staff
 
*#eduPersonAffiliation​:​ staff
 
*#eduPersonAffiliation​:​ member
 
*#eduPersonAffiliation​:​ member
  
 +
*Docenti e ricercatori:
 +
*#eduPersonAffiliation​:​ staff
 +
*#eduPersonAffiliation​:​ faculty
 +
*#eduPersonAffiliation​:​ member
 
*Studenti:
 
*Studenti:
 
*#eduPersonAffiliation​:​ student
 
*#eduPersonAffiliation​:​ student
Riga 28: Riga 55:
 
*#eduPersonAffiliation​:​ alum
 
*#eduPersonAffiliation​:​ alum
  
−
===Descrizione delle classi di affiliazione===
+
===Esempi di implementazione Shib IdP v4===
−
'''Member''' contiene tutte le persone che hanno un rapporto istituzionale con l'organizzazione di appartenenza e ai quali viene dato un insieme base di privilegi. Sono member tutti gli appartenenti a staff e student, ma tipicamente non gli alum.
+
Tutti gli esempi qui sotto riportati fanno riferimento al file di configurazione <code>attribute-resolver.xml</code>.
 +
 
 +
Per approfondimenti su come funziona la definizione di Attributi ('''Attribute Definition''') in Shibboleth Idp fare riferimento alla pagina dedicata: [[ComeRilasciareAttributiShibv4]]
 +
 
 +
===='''eduPersonAffiliation''' con definizione '''Mapped (Corso Migrazione)'''====
 +
'''<code>eduPersonAffiliation</code>''' con definizione '''Mapped''' [https://github.com/ConsortiumGARR/idem-shib-idp-course/blob/master/2020/28-29-30%20Ottobre/attribute-resolver-dynamic.xml attribute-resolver-dynamic.xml] tratto dal corso '''Corso Migrazione a Shibboleth IdP v4'''
 +
 
 +
===='''eduPersonAffiliation''' con definizione '''Mapped''' ricavato dal '''login name''' contenuto nell'attributo '''<u>uid</u>'''====
 +
<syntaxhighlight lang="xml" line="1">
 +
<!-- file attribute-resolver.xml -->
 +
 
 +
<AttributeDefinition id="eduPersonAffiliation" xsi:type="Mapped">
 +
    <InputDataConnector ref="myLDAP" attributeNames="uid" />
 +
    <ValueMap>
 +
        <ReturnValue>student</ReturnValue>
 +
        <SourceValue>stud.+</SourceValue>
 +
    </ValueMap>
 +
    <ValueMap>
 +
        <ReturnValue>staff</ReturnValue>
 +
        <SourceValue>dir.+</SourceValue>
 +
    </ValueMap>
 +
    <ValueMap>
 +
        <ReturnValue>member</ReturnValue>
 +
        <SourceValue>stud.+</SourceValue>
 +
        <SourceValue>dir.+</SourceValue>
 +
    </ValueMap>
 +
</AttributeDefinition>
 +
</syntaxhighlight><br />
 +
 
 +
===='''eduPersonAffiliation''' con definizione '''Mapped''' ricavato dal '''nome del gruppo''' eventualmente contenuto in uno speciale attributo '''Usergroup'''====
 +
<syntaxhighlight lang="xml" line="1">
 +
<!-- file attribute-resolver.xml -->
 +
 
 +
<AttributeDefinition id="eduPersonAffiliation" xsi:type="Mapped">
 +
    <InputDataConnector ref="myLDAP" attributeNames="Usergroup" />
 +
    <DefaultValue>affiliate</DefaultValue>
 +
    <ValueMap>
 +
        <ReturnValue>staff</ReturnValue>
 +
        <SourceValue partialMatch="true">D</SourceValue>
 +
    </ValueMap>
 +
    <ValueMap>
 +
        <ReturnValue>student</ReturnValue>
 +
        <SourceValue partialMatch="true">ST</SourceValue>
 +
    </ValueMap>
 +
    <ValueMap>
 +
        <ReturnValue>alum</ReturnValue>
 +
        <SourceValue partialMatch="true">A</SourceValue>
 +
    </ValueMap>
 +
    <ValueMap>
 +
        <ReturnValue>member</ReturnValue>
 +
        <SourceValue>[^ ]+</SourceValue>
 +
    </ValueMap>
 +
</AttributeDefinition>
 +
</syntaxhighlight>
 +
 
 +
===='''eduPersonAffiliation''' con definizione '''Mapped''' ricavato a partire dal nome DN del ramo LDAP e contenuto nell'attributo '''distinguishedName'''====
 +
<syntaxhighlight lang="xml" line="1">
 +
<!-- file attribute-resolver.xml -->
 +
 
 +
<AttributeDefinition id="eduPersonAffiliation" xsi:type="Mapped">
 +
    <InputDataConnector ref="myLDAP" attributeNames="distinguishedName" />
 +
    <ValueMap>
 +
        <ReturnValue>affiliate</ReturnValue>
 +
        <SourceValue partialMatch="true">,OU=Affiliati,OU=People,DC=example,DC=org</SourceValue>
 +
    </ValueMap>
 +
    <ValueMap>
 +
        <ReturnValue>staff</ReturnValue>
 +
        <SourceValue partialMatch="true">,OU=Staff,OU=People,DC=example,DC=org</SourceValue>
 +
    </ValueMap>
 +
    <ValueMap>
 +
        <ReturnValue>student</ReturnValue>
 +
        <SourceValue partialMatch="true">,OU=Studenti,OU=People,DC=example,DC=org</SourceValue>
 +
    </ValueMap>
 +
    <ValueMap>
 +
        <ReturnValue>faculty</ReturnValue>
 +
        <SourceValue partialMatch="true">,OU=Ricercatori,OU=People,DC=example,DC=org</SourceValue>
 +
        <SourceValue partialMatch="true">,OU=Docenti,OU=People,DC=example,DC=org</SourceValue>
 +
    </ValueMap>
 +
    <ValueMap>
 +
        <ReturnValue>member</ReturnValue>
 +
        <SourceValue partialMatch="true">,OU=Studenti,OU=People,DC=example,DC=org</SourceValue>
 +
        <SourceValue partialMatch="true">,OU=Staff,OU=People,DC=example,DC=org</SourceValue>
 +
        <SourceValue partialMatch="true">,OU=Ricercatori,OU=People,DC=example,DC=org</SourceValue>
 +
        <SourceValue partialMatch="true">,OU=Docenti,OU=People,DC=example,DC=org</SourceValue>
 +
    </ValueMap>
 +
</AttributeDefinition>
 +
</syntaxhighlight>
 +
 
 +
===='''eduPersonScoped Affiliation''' con definizione Scoped====
 +
Dopo aver scelto la modalità di generazione per '''<code>eduPersonAffiliation</code>''' sarà necessario procedere alla definizione ('''Attribute Definition''') di '''<code>eduPersonScopedAffiliation</code>''' che è un attributo obbligatorio per la partecipazione a IDEM'''.'''<syntaxhighlight lang="xml">
 +
<!-- file attribute-resolver.xml -->
  
−
'''Student''' e '''staff''' sono quindi due specializzazioni distinte di member:
+
<AttributeDefinition scope="%{idp.scope}" xsi:type="Scoped" id="eduPersonScopedAffiliation">
 +
       
 +
    <!-- se eduPersonAffiliation viene preso dal DataConnector usare "InputDataConnector" -->
 +
    <!-- <InputDataConnector ref="myLDAP" attributeNames="eduPersonAffiliation" /> -->
  
−
*Il valore '''staff''' va utilizzato per tutto il personale (docenti, personale amministrativo, bibliotecario e tecnico di supporto) in servizio presso l'organizzazione di appartenenza, con qualunque tipo di contratto, anche a tempo determinato, oppure rientrante nei contratti cosiddetti atipici.
+
    <!-- se eduPersonAffiliation è stato definito come Attribute Definition usare "InputAttributeDefinition" -->
−
*Con '''student''' si indicano gli studenti regolarmente iscritti ad uno dei corsi dell'organizzazione di appartenenza.
+
    <InputAttributeDefinition ref="eduPersonAffiliation" />
  
−
'''Affiliate''' si applica alle persone con le quali l'organizzazione di appartenenza ha una qualsiasi forma di rapporto ed alle quali è necessario attribuire un'identità di utente, ma per cui non vengono estesi i privilegi derivanti dall'essere membri dell'organizzazione stessa. Potrebbero rientrare in questa categoria i fornitori di servizi o di materiali delle organizzazioni, ricercatori di altre organizzazioni che collaborano con un gruppo interno, persone per le quali è necessaria l'identificazione per servizi molto particolari riservati ad esterni all'università stessa. Normalmente gli affiliate non sono member , se non in casi eccezionali: ad esempio uno studente che sia anche dipendente di una ditta che fornisce servizi ad un'università.
+
</AttributeDefinition>
 +
</syntaxhighlight>
  
−
'''Alum''' comprende gli ex studenti dell'organizzazione di appartenenza che hanno completato almeno il primo livello di studi. E’ possibile che un alum sia anche staff oppure affiliate dell'organizzazione.
+
==Appendici==
  
−
'''Library-walk-in''' indica i frequentatori di una biblioteca ed è pensato per semplificare la gestione di frequenti accordi contrattuali con i fornitori di risorse. Il valore è indipendente dagli altri valori indicanti l'affiliazione, ciò vuol dire che il possedere tale requisito non influisce o pregiudica l'avere un altro tipo di affiliazione e viceversa.
+
====Tabella Corrispondenza tra le categorie note e le possibili affiliazioni====
  
−
===Corrispondenza tra le categorie note e le possibili affiliazioni===
+
La tabella suggerisce le possibili corrispondenze tra i ruoli comunemente presenti in ambito universitario e negli istituti di ricerca ed i valori da assegnare agli attributi ''eduPersonAffiliation'' e  ''eduPersonScopedAffiliation''.  <blockquote>'''ATTENZIONE: Rispetto alle corrispondenze indicate nelle Specifiche Tecniche Attributi, la tabella che segue è stata aggiornata in data 25 Ottobre 2024 per includere il valore ''faculty'' sulla base delle esigenze di rilascio attributi del servizio EOSC EU Node. Infatti, il valore ''faculty'' è necessario per essere riconosciuti come "academic researchers" e quindi avere accesso alle risorse dedicate ai ricercatori, come ad esempio le Virtual Machine. Per maggiori informazioni vedi la EOSC EU Node User Access Policy Version 1.0 https://open-science-cloud.ec.europa.eu/support/user-access-policy''' </blockquote>
−
Fare riferimento alla tabella riportata nel documento [[:File:SpecificheTecnicheAttributi v3.0 20161129.pdf|File:SpecificheTecnicheAttributi v3.0 20161129.pdf]] pagina 30.
+
{| class="wikitable"
 +
|-
 +
|'''Ruolo'''
 +
|'''eduPersonAffiliation'''
 +
|-
 +
|assistente universitario
 +
|staff, member
 +
|-
 +
|associato (ad es. CNR)
 +
|member
 +
|-
 +
|cessato
 +
|(none)
 +
|-
 +
|collaboratore coordinato continuativo
 +
|staff, member
 +
|-
 +
|collaboratore linguistico
 +
|staff, member
 +
|-
 +
|consorziato (membro del consorzio a cui l'ente appartiene)
 +
|member
 +
|-
 +
|convenzionato (cliente delle convenzioni)
 +
|affiliate
 +
|-
 +
|cultore della materia
 +
|staff, member
 +
|-
 +
|dipendente altra università
 +
|member
 +
|-
 +
|dipendente altro ente di ricerca
 +
|member
 +
|-
 +
|dipendente azienda ospedaliera/policlinico
 +
|member
 +
|-
 +
|dipendente di altra azienda sanitaria
 +
|member
 +
|-
 +
|direttore amministrativo
 +
|staff, member
 +
|-
 +
|dirigente
 +
|staff, member
 +
|-
 +
|dirigente a contratto
 +
|staff, member
 +
|-
 +
|dirigente di ricerca
 +
|staff, faculty, member
 +
|-
 +
|dirigente tecnologo
 +
|staff, faculty, member
 +
|-
 +
|docente a contratto
 +
|staff, faculty, member
 +
|-
 +
|dottorando
 +
|staff, faculty, member, student
 +
|-
 +
|dottorando di altra università (consorziata)
 +
|faculty, member
 +
|-
 +
|esperto linguistico
 +
|staff, member
 +
|-
 +
|fornitore (dipendente o titolare delle ditte fornitrici)
 +
|affiliate
 +
|-
 +
|interinale
 +
|staff, member
 +
|-
 +
|ispettore generale
 +
|affiliate
 +
|-
 +
|laureato frequentatore/collaboratore di ricerca (a titolo gratuito)
 +
|member
 +
|-
 +
|lavoratore occasionale (con contratto personale senza partita iva)
 +
|staff, member
 +
|-
 +
|lettore di scambio
 +
|member
 +
|-
 +
|libero professionista (con contratto personale con partita iva)
 +
|staff, member
 +
|-
 +
|ospite / visitatore
 +
|affiliate
 +
|-
 +
|personale tecnico-amministrativo a tempo determinato
 +
|staff, member
 +
|-
 +
|personale tecnico-amministrativo
 +
|staff, member
 +
|-
 +
|primo ricercatore
 +
|staff, faculty, member
 +
|-
 +
|primo tecnologo
 +
|staff, faculty, member
 +
|-
 +
|professore associato
 +
|staff, faculty, member
 +
|-
 +
|professore emerito
 +
|faculty, member
 +
|-
 +
|professore incaricato interno
 +
|staff, faculty, member
 +
|-
 +
|professore incaricato esterno
 +
|staff, faculty, member
 +
|-
 +
|professore ordinario
 +
|staff, faculty, member
 +
|-
 +
|ricercatore
 +
|staff, faculty, member
 +
|-
 +
|specializzando
 +
|staff, faculty, member, student
 +
|-
 +
|studente
 +
|student, member
 +
|-
 +
|studente erasmus in ingresso
 +
|student
 +
|-
 +
|studente fuori sede (tesista, tirocinante, …)
 +
|student, member
 +
|-
 +
|studente laurea specialistica
 +
|student, member
 +
|-
 +
|studente master
 +
|student, member
 +
|-
 +
|studente siss
 +
|student, member
 +
|-
 +
|supervisore siss
 +
|staff, member
 +
|-
 +
|supplente docente
 +
|staff, faculty, member
 +
|-
 +
|titolare di assegno di ricerca
 +
|staff, faculty, member
 +
|-
 +
|titolare di borsa di studio
 +
|member
 +
|-
 +
|tecnologo
 +
|staff, faculty, member
 +
|-
 +
|tutor
 +
|staff, member
 +
|-
 +
|volontario servizio civile nazionale
 +
|member
 +
|}

Versione attuale delle 11:45, 26 ott 2024

Descrizione generale

L'affiliazione definisce la relazione che esiste tra l'utente e la propria Organizzazione di Appartenenza.

In IDEM l'attributo che contiene i valori di affiliazione è eduPersonScopedAffiliation nella forma eduPersonAffiliation@<idp-scope>. I valori che eduPersonAffiliation può contenere sono limitati e definiti da una specifica grammatica:

https://wiki.refeds.org/display/STAN/eduPerson+2020-01#eduPerson202001-eduPersonAffiliation

In particolare i valori usati in IDEM sono: student, staff, faculty, member, alum, affiliate e library-walk-in.

Preghiamo di notare che member non può essere rilasciato da solo ma deve essere sempre asserito in corrispondenza delle specializzazioni di affiliazione student, staff e faculty.

Le classi alum, affiliate e library-walk-in non sono tipicamente da considerarsi Membri dell'Organizzazione (a meno che non si verifichino casi particolari indicati nella sezione "Descrizione delle classi di affiliazione").

Riferimenti

https://wiki.refeds.org/display/STAN/eduPerson eduPerson Specification e download del file ldif

File:SpecificheTecnicheAttributi v3.0 20161129.pdf Documento ufficiale IDEM "Specifiche tecniche per la compilazione e l'uso degli attributi"

IMPORTANTE: La tabella di corrispondenza tra ruoli e valori di affilizione contenuta nelle Specifiche Tecniche Attributi è stata aggiornata per comprendere nuovi casi d'uso, vedi Attributo Affiliazione#Tabella Corrispondenza tra le categorie note e le possibili affiliazioni

Descrizione delle classi di affiliazione

Member contiene tutte le persone che hanno un rapporto istituzionale con l'organizzazione di appartenenza e ai quali viene dato un insieme base di privilegi. Sono member tutti gli appartenenti a staff e student, ma tipicamente non gli alum.

Student, staff e faculty sono quindi due specializzazioni distinte di member:

  • Il valore staff va utilizzato per tutto il personale (docenti, personale amministrativo, bibliotecario e tecnico di supporto) in servizio presso l'organizzazione di appartenenza, con qualunque tipo di contratto, anche a tempo determinato, oppure rientrante nei contratti cosiddetti atipici.
  • il valore faculty indica tutto il personale la cui attività principale è la ricerca e o l'insegnamento.
  • Con student si indicano gli studenti regolarmente iscritti ad uno dei corsi dell'organizzazione di appartenenza.

Affiliate si applica alle persone con le quali l'organizzazione di appartenenza ha una qualsiasi forma di rapporto ed alle quali è necessario attribuire un'identità di utente, ma per cui non vengono estesi i privilegi derivanti dall'essere membri dell'organizzazione stessa. Potrebbero rientrare in questa categoria i fornitori di servizi o di materiali delle organizzazioni, ricercatori di altre organizzazioni che collaborano con un gruppo interno, persone per le quali è necessaria l'identificazione per servizi molto particolari riservati ad esterni all'università stessa. Normalmente gli affiliate non sono member , se non in casi eccezionali: ad esempio uno studente che sia anche dipendente di una ditta che fornisce servizi ad un'università.

Alum comprende gli ex studenti dell'organizzazione di appartenenza che hanno completato almeno il primo livello di studi. E’ possibile che un alum sia anche staff oppure affiliate dell'organizzazione.

Library-walk-in indica i frequentatori di una biblioteca ed è pensato per semplificare la gestione di frequenti accordi contrattuali con i fornitori di risorse. Il valore è indipendente dagli altri valori indicanti l'affiliazione, ciò vuol dire che il possedere tale requisito non influisce o pregiudica l'avere un altro tipo di affiliazione e viceversa.

Corrispondenza tra le categorie note e le possibili affiliazioni

Vedi la tabella in appendice: Attributo Affiliazione#Tabella Corrispondenza tra le categorie note e le possibili affiliazioni.

Esempi Pratici

  • Personale tecnico amministrativo:
    1. eduPersonAffiliation​:​ staff
    2. eduPersonAffiliation​:​ member
  • Docenti e ricercatori:
    1. eduPersonAffiliation​:​ staff
    2. eduPersonAffiliation​:​ faculty
    3. eduPersonAffiliation​:​ member
  • Studenti:
    1. eduPersonAffiliation​:​ student
    2. eduPersonAffiliation​:​ member
  • Studente con un contratto presso la stessa università:
    1. eduPersonAffiliation​:​ student
    2. eduPersonAffiliation​:​ staff
    3. eduPersonAffiliation​:​ member
  • Ex studente:
    1. eduPersonAffiliation​:​ alum

Esempi di implementazione Shib IdP v4

Tutti gli esempi qui sotto riportati fanno riferimento al file di configurazione attribute-resolver.xml.

Per approfondimenti su come funziona la definizione di Attributi (Attribute Definition) in Shibboleth Idp fare riferimento alla pagina dedicata: ComeRilasciareAttributiShibv4

eduPersonAffiliation con definizione Mapped (Corso Migrazione)

eduPersonAffiliation con definizione Mapped attribute-resolver-dynamic.xml tratto dal corso Corso Migrazione a Shibboleth IdP v4

eduPersonAffiliation con definizione Mapped ricavato dal login name contenuto nell'attributo uid

 1 <!-- file attribute-resolver.xml -->
 2 
 3 <AttributeDefinition id="eduPersonAffiliation" xsi:type="Mapped">
 4     <InputDataConnector ref="myLDAP" attributeNames="uid" />
 5     <ValueMap>
 6         <ReturnValue>student</ReturnValue>
 7         <SourceValue>stud.+</SourceValue>
 8     </ValueMap>
 9     <ValueMap>
10         <ReturnValue>staff</ReturnValue>
11         <SourceValue>dir.+</SourceValue>
12     </ValueMap>
13     <ValueMap>
14         <ReturnValue>member</ReturnValue>
15         <SourceValue>stud.+</SourceValue>
16         <SourceValue>dir.+</SourceValue>
17     </ValueMap>
18 </AttributeDefinition>


eduPersonAffiliation con definizione Mapped ricavato dal nome del gruppo eventualmente contenuto in uno speciale attributo Usergroup

 1 <!-- file attribute-resolver.xml -->
 2 
 3 <AttributeDefinition id="eduPersonAffiliation" xsi:type="Mapped">
 4     <InputDataConnector ref="myLDAP" attributeNames="Usergroup" />
 5     <DefaultValue>affiliate</DefaultValue>
 6     <ValueMap>
 7         <ReturnValue>staff</ReturnValue>
 8         <SourceValue partialMatch="true">D</SourceValue>
 9     </ValueMap>
10     <ValueMap>
11         <ReturnValue>student</ReturnValue>
12         <SourceValue partialMatch="true">ST</SourceValue>
13     </ValueMap>
14     <ValueMap>
15         <ReturnValue>alum</ReturnValue>
16         <SourceValue partialMatch="true">A</SourceValue>
17     </ValueMap>
18     <ValueMap>
19         <ReturnValue>member</ReturnValue>
20         <SourceValue>[^ ]+</SourceValue>
21     </ValueMap>
22 </AttributeDefinition>

eduPersonAffiliation con definizione Mapped ricavato a partire dal nome DN del ramo LDAP e contenuto nell'attributo distinguishedName

 1 <!-- file attribute-resolver.xml -->
 2 
 3 <AttributeDefinition id="eduPersonAffiliation" xsi:type="Mapped">
 4     <InputDataConnector ref="myLDAP" attributeNames="distinguishedName" />
 5     <ValueMap>
 6         <ReturnValue>affiliate</ReturnValue>
 7         <SourceValue partialMatch="true">,OU=Affiliati,OU=People,DC=example,DC=org</SourceValue>
 8     </ValueMap>
 9     <ValueMap>
10         <ReturnValue>staff</ReturnValue>
11         <SourceValue partialMatch="true">,OU=Staff,OU=People,DC=example,DC=org</SourceValue>
12     </ValueMap>
13     <ValueMap>
14         <ReturnValue>student</ReturnValue>
15         <SourceValue partialMatch="true">,OU=Studenti,OU=People,DC=example,DC=org</SourceValue>
16     </ValueMap>
17     <ValueMap>
18         <ReturnValue>faculty</ReturnValue>
19         <SourceValue partialMatch="true">,OU=Ricercatori,OU=People,DC=example,DC=org</SourceValue>
20         <SourceValue partialMatch="true">,OU=Docenti,OU=People,DC=example,DC=org</SourceValue>
21     </ValueMap>
22     <ValueMap>
23         <ReturnValue>member</ReturnValue>
24         <SourceValue partialMatch="true">,OU=Studenti,OU=People,DC=example,DC=org</SourceValue>
25         <SourceValue partialMatch="true">,OU=Staff,OU=People,DC=example,DC=org</SourceValue>
26         <SourceValue partialMatch="true">,OU=Ricercatori,OU=People,DC=example,DC=org</SourceValue>
27         <SourceValue partialMatch="true">,OU=Docenti,OU=People,DC=example,DC=org</SourceValue>
28     </ValueMap>
29 </AttributeDefinition>

eduPersonScoped Affiliation con definizione Scoped

Dopo aver scelto la modalità di generazione per eduPersonAffiliation sarà necessario procedere alla definizione (Attribute Definition) di eduPersonScopedAffiliation che è un attributo obbligatorio per la partecipazione a IDEM.

<!-- file attribute-resolver.xml -->

<AttributeDefinition scope="%{idp.scope}" xsi:type="Scoped" id="eduPersonScopedAffiliation">
        
    <!-- se eduPersonAffiliation viene preso dal DataConnector usare "InputDataConnector" -->
    <!-- <InputDataConnector ref="myLDAP" attributeNames="eduPersonAffiliation" /> -->

    <!-- se eduPersonAffiliation è stato definito come Attribute Definition usare "InputAttributeDefinition" -->
    <InputAttributeDefinition ref="eduPersonAffiliation" />

</AttributeDefinition>

Appendici

Tabella Corrispondenza tra le categorie note e le possibili affiliazioni

La tabella suggerisce le possibili corrispondenze tra i ruoli comunemente presenti in ambito universitario e negli istituti di ricerca ed i valori da assegnare agli attributi eduPersonAffiliation e eduPersonScopedAffiliation.

ATTENZIONE: Rispetto alle corrispondenze indicate nelle Specifiche Tecniche Attributi, la tabella che segue è stata aggiornata in data 25 Ottobre 2024 per includere il valore faculty sulla base delle esigenze di rilascio attributi del servizio EOSC EU Node. Infatti, il valore faculty è necessario per essere riconosciuti come "academic researchers" e quindi avere accesso alle risorse dedicate ai ricercatori, come ad esempio le Virtual Machine. Per maggiori informazioni vedi la EOSC EU Node User Access Policy Version 1.0 https://open-science-cloud.ec.europa.eu/support/user-access-policy

Ruolo eduPersonAffiliation
assistente universitario staff, member
associato (ad es. CNR) member
cessato (none)
collaboratore coordinato continuativo staff, member
collaboratore linguistico staff, member
consorziato (membro del consorzio a cui l'ente appartiene) member
convenzionato (cliente delle convenzioni) affiliate
cultore della materia staff, member
dipendente altra università member
dipendente altro ente di ricerca member
dipendente azienda ospedaliera/policlinico member
dipendente di altra azienda sanitaria member
direttore amministrativo staff, member
dirigente staff, member
dirigente a contratto staff, member
dirigente di ricerca staff, faculty, member
dirigente tecnologo staff, faculty, member
docente a contratto staff, faculty, member
dottorando staff, faculty, member, student
dottorando di altra università (consorziata) faculty, member
esperto linguistico staff, member
fornitore (dipendente o titolare delle ditte fornitrici) affiliate
interinale staff, member
ispettore generale affiliate
laureato frequentatore/collaboratore di ricerca (a titolo gratuito) member
lavoratore occasionale (con contratto personale senza partita iva) staff, member
lettore di scambio member
libero professionista (con contratto personale con partita iva) staff, member
ospite / visitatore affiliate
personale tecnico-amministrativo a tempo determinato staff, member
personale tecnico-amministrativo staff, member
primo ricercatore staff, faculty, member
primo tecnologo staff, faculty, member
professore associato staff, faculty, member
professore emerito faculty, member
professore incaricato interno staff, faculty, member
professore incaricato esterno staff, faculty, member
professore ordinario staff, faculty, member
ricercatore staff, faculty, member
specializzando staff, faculty, member, student
studente student, member
studente erasmus in ingresso student
studente fuori sede (tesista, tirocinante, …) student, member
studente laurea specialistica student, member
studente master student, member
studente siss student, member
supervisore siss staff, member
supplente docente staff, faculty, member
titolare di assegno di ricerca staff, faculty, member
titolare di borsa di studio member
tecnologo staff, faculty, member
tutor staff, member
volontario servizio civile nazionale member
Estratto da "https://wiki.idem.garr.it/w/index.php?title=Attributo_Affiliazione&oldid=13424"