Attributo Affiliazione

Da WIKI IDEM GARR.
Jump to navigation Jump to search

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 soltanto: student, staff, alum, member, 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=13423"