Entity categories is are used for data release minimization and scalable attribute release from an Identity Provider within SWAMID to a Service Provider in SWAMID and/or eduGAIN.

If an owner of a Service and the Identity Provider Home Organisation has a bilateral agreement the attribute release can be extended with additional attributes based on the agreement.

Please note that the old entity categories SWAMD Research and Education and SWAMID SFS 1993:1153 is deprecated and will removed from all services metadata at the end of 2022.

Best Practice attribute release based on entity categories

x - Attribute is released if it's available in the Home Organisation Identity Provider.
o - Attribute is released only if requested and required in the metadata for the service and if it's available in the Home Organisation Identity Provider.

...

SAML2 Attribute Identifier	Friendly Name	Without enitity category	Data protection Code of Conduct (REFEDS CoCo v2 and GÉANT CoCo v1)	REFEDS Personalized Access Entity Category	REFEDS Pseudonymous Access Entity Category	REFEDS Anonymous Access Entity Category	REFEDS Research and Scholarship Entity Category (R&S

SWAMID R&ESWAMID SFS-1993-11532020-09-01.

Note

title	Restriction

Attributes released only for users with a Swedish personal identity number (sv. personnummer), a Swedish co-ordination number (sv. samordningsnummer) or a organisational student interim identity number (sv. interimspersonnummer)

eduPersonTargetedID

)

European Student Identifier Entity Category

Note

title	Restriction

Attribute released
"only if requested and required" in metadata¹.

Note that norEduPersonNIN and personalIdentityNumber has additional restrictions².

Warning

title	Deprecated and will be removed from 2021-03-31

No new EntityID will be permitted to use this category from 2020-09-01.
This entity category is deprecated and will be removed from all entities 2021-03-31. The process of removal will start 2020-09-01.

Info

title	Dependency

SWAMID R&E is used in pair with one of the entity categories SWAMID EU-Adequate-Protection, SWAMID NREN-Service and SWAMID HEI-Service

Warning

title	Deprecated and will be removed from 2021-03-31

No new EntityID will be permitted to use this category from 2020-09-01.
This entity category is deprecated and will be removed from all entities 2021-03-31. The process of removal will start


urn:oasis:names:tc:SAML:attribute:pairwise-id	pairwise-id	o		x
urn:oasis:names:tc:SAML:attribute:subject-id	subject-id	o	x

urn:oid:1.3.6.1.4.1.5923.1.1.1.10

eduPersonTargetedID

o

(x³

eduPersonPrincipalName

)
urn:oid:1.3.6.1.4.1.5923.1.1.1.6

eduPersonPrincipalName

o

x

eduPersonUniqueID⁴


urn:oid:1.3.6.1.4.1.5923.1.1.1.

13

16

urn:oid:1.3.6.1.

eduPersonOrcid

o

xx eduPersonOrcid

⁴

.1.5923.1.1.1.16 o norEduPersonNIN


urn:oid:1.3.6.1.4.1.2428.90.1.5

norEduPersonNIN

o²

xpersonalIdentityNumber


urn:oid:1.2.752.29.4.13

personalIdentityNumber

o²

schacDateOfBirth


urn:oid:1.3.6.1.4.1.25178.1.2.3	schacDateOfBirth		o

mail


urn:oid:0.9.2342.19200300.100.1.3

mail

o

x

displayName

urn:oid:2.16.840.1.113730.3.1

.241 oxx

.13	mailLocalAddress		o⁵
urn:oid:2.5.4.42	givenName		o⁶	x⁶			x⁶

cn (commonName)


urn:oid:2.5.4.

3

4

sn (aka surname)

o⁶

givenName

x⁶

urn:oid:2

.5.4.42 oxx

.16.840.1.113730.3.1.241	displayName		o⁶	x⁶			x⁶
urn:oid:1.3.6.1.4.1.2428.90.1.10	norEduPersonLegalName		o⁶

sn (surname)


urn:oid:2.5.4.

4 oxx

3

cn (aka commonName)

o⁶

eduPersonAssurance


urn:oid:1.3.6.1.4.1.5923.1.1.1.11

eduPersonScopedAffiliation

eduPersonAssurance

o

x

⁷
urn:oid:1.3.6.1.4.1.5923.1.1.1.9

eduPersonScopedAffiliation

o

x

eduPersonAffiliation

x
urn:oid:1.3.6.1.4.1.5923.1.1.1.1

eduPersonAffiliation

o

o (organizationName)


urn:oid:2.5.4.10

o (aka organizationName)

o

x

norEduOrgAcronym


urn:oid:1.3.6.1.4.1.2428.90.1.6

norEduOrgAcronym

o

x c (countryName)


urn:oid:2.5.4.6

co (friendlyCountryName)

c (aka countryName)

o

x

urn:oid:0.9.2342.19200300.100.1.43

co (aka friendlyCountryName)

o

schacHomeOrganization

x

urn:oid:1.3.6.1.4.1.25178.1.2.9

schacHomeOrganization

o

x

schacHomeOrganizationType


urn:oid:1.3.6.1.4.1.25178.1.2.10

schacHomeOrganizationType

o


urn:oid:1.3.6.1.4.1.25178.1.2.14	schacPersonalUniqueCode							x⁸

The entity category the REFEDS and GÉANT Code of Conduct entity categories does not have a specific attribute bundle. Instead of an attribute bundle it uses attribute request in metadata for specific required attributes.
norEduPersonNIN and personalIdentityNumber shall only be released when required by entities registered with in SWAMID (registrationAuthority="http://www.swamid.se/").
- personalIdentityNumber must only contain Swedish Personal Numbers or Swedish Co-ordination Numbers.
- norEduPersonNIN can besides Swedish Personal Numbers and Swedish Co-ordination Numbers also contain Interim Personal Numbers from the student documentation system Ladok and the Swedish national study enrolment system.
eduPersonTargetedID should only be released in with the entity category REFEDS Research & Scholarship if eduPersonPrincipalName is reassignable.eduPersonUniqueID must be a long term unique identifier that will not be reused. If eduPersonPrincipalName is non-reassignable then eduPersonUniqueID can have the same value as eduPersonPrincipalName.if eduPersonPrincipalName is reassignable. All Identity Providers in SWAMID must by the SWAMID Assurance Profiles be longterm unique and therefore it should not be released.
eduPersonOrcid should only be released if and only if the IdP organization has retrived the ORCID iD via the ORCID Collect & Connect service. ORCID iDs are persistent digital identifiers for individual researchers. Their primary purpose is to unambiguously and definitively link them with their scholarly work products. ORCID iDs are assigned,managed and maintained by the ORCID organization.
mailLocalAddress is used for services that may need access to more than one mail address for the user, for example mail aliases and secondary mail addresses. A use case for this is when a person is invited by another mail address than the one in released in the mail attribute.
Name attribute are expected to be released as following:
- givenName is the legal first name of the person. If the person has more than one legal first name it's possible to only release the default name (sw. tilltalsnamn) or the person can choose which one of the legal first names they want to be released.
- sn (aka surname) is the legal last name (or family name) of the person.
- displayName shall always be the combination of givenName and sn.
- norEduPersonLegalName must always be the full legal name from the population registry or official travel documents defined in ICAO 9306 (passports or European national identity cards), otherwise it must not be released.
- cn (aka commonName) must be the persons full name, not the attribute value from Active Directory.
Within SWAMID the REFEDS Research and Scholarship Entity Category is extended to also include eduPersonAssurance.
This entity category should only trigger release of the European Student Identifier (ESI) value as specified by https://wiki.geant.org/display/SM/European+Student+Identifier