Attributo Affiliazione

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