Organization groups
An organization can be any kind of organization, including school, university, or other educational institutions.
These groups are based upon information defined in norEdu.
Group attributes
Attributes from VOOT Core
type
fc:org
id
A unique identifier of the organization.
In Feide, all groups populated from the eduOrg objects are generated in the following form:
fc:org:{realm}
, e.g.fc:org:uninett.no
. For all organization units, this identifier is generated in the following form:fc:org:{realm}:unit:{norEduOrgUnitUniqueIdentifier}
, e.g.:fc:org:uninett.no:unit:NO876326125
Leading and trailing backspace are dropped when identifiers are generated from eduOrg attributes.Example:
"fc:org:uninett.no"
orgType
JSON array of the following types:
higher_education
Institution in higher educationprimary_and_lower_secondary_owner
Municipality, primary school owner (“kommune, eier av grunnskole”)upper_secondary_owner
County, upper secondary school owner (“fylkeskommune, eier av videregående skole”)upper_secondary
Upper secondary school (“videregående skole”)primary_and_lower_secondary
Primary and lower secondary school (“Barne og / eller ungdomsskole”)Example:
["primary_and_lower_secondary"]
parent
Indicates that the organization is part of another organization. The parent attribute value MUST include an ID of another organization. Typically in Feide, the parent attribute is always populated on group objects that are obtained from an eduOrgUnit, where it points to the corresponding eduOrg object. E.g.: «Frogner VGS» (orgunit) puts «Oslo Kommune» (org) as a parent.
Example:
"fc:org:trondheim.kommune.no"
displayName
A human friendly name of the organization. Obtained from
eduPersonOrgDN:o
Datatype: Translatable String
Example:
"Trondheim kommune"
description
is a textual description of the group (optional). It may be translated as well.
Leave this field out rather than replicate the name of the organization.
Datatype: SCIM String
Example:
"Kunnskapssektorens tjenesteleverand\u0058r"
public
Is a boolean flag indicating whether the existence of this group and the basic group information is publicly available. It is always false for this group type.
Datatype: SCIM Boolean
Example:
false
Specific attributes for fc:org
eduOrgLegalName
Mandatory in Feide 1.5.1
Organization’s legal name obtained from
eduPersonOrgDN:eduOrgLegalName
Example:
"Trondheim kommune"
norEduOrgNIN
Mandatory in Feide 1.5.1
Organizational number obtained from
eduPersonOrgDN:norEduOrgNIN
Example:
"NO976820037"
mail
Mandatory in Feide 1.5.1
Organization’s mail obtained from
eduPersonOrgDN:mail
Example:
"post@eksempel.no"
telephoneNumber
Recommended in Feide 1.5.1
Telephone number obtained from
eduPersonOrgDN:telephoneNumber
Example:
"+4712345678"
postalAddress
Recommended in Feide 1.5.1
Postal address obtained from
eduPersonOrgDN:postalAddress
Example:
"Postboks 9876$6789 Bekkvik"
eduOrgHomePageURI
Home page URI obtained from
eduPersonOrgDN:eduOrgHomePageURI
Example:
"https://www.example.org"
eduOrgIdentityAuthNPolicyURI
Location of organization’s policy regarding identification and authentication. Obtained from
eduPersonOrgDN:eduOrgIdentityAuthNPolicyURI
Example:
"https://www.example.org/IA-policy.html"
eduOrgWhitePagesURI
The URL of the open white pages directory service for the organization. Obtained from
eduPersonOrgDN:eduOrgWhitePagesURI
Example:
"ldaps://whitepages.example.org"
facsimileTelephoneNumber
Obtained from
eduPersonOrgDN:facsimileTelephoneNumber
Example:
"+4712345679"
l
Organization’s location. Obtained from
eduPersonOrgDN:l
Example:
"Trondheim"
labeledURI
Labeled URI to organization. Obtained from
eduPersonOrgDN:labeledURI
Example:
"https://www.example.org"
norEduOrgAcronym
Acronym for the organization. Obtained from
eduPersonOrgDN:norEduOrgAcronym
Example:
"NTNU"
norEduOrgUniqueIdentifier
Organization’s unique identifier in the Norwegian Universities and Colleges Admission Service (“Samordna opptak”). Obtained from
eduPersonOrgDN:norEduOrgUniqueIdentifier
Example:
"00000987"
postalCode
Organization’s postal code. Obtained from
eduPersonOrgDN:postalCode
Example:
"7045"
postOfficeBox
Organization’s postal office box. Obtained from
eduPersonOrgDN:postOfficeBox
Example:
"382"
street
Organization street address. Obtained from
eduPersonOrgDN:street
Example:
"Munkegata 1"
Membership attributes
The user’s relationship to the group is expressed in a membership object. For organization groups, the object can contain the following attributes:
basic
This value may be
member
,admin
orowner
.When populated from eduOrg/OrgUnit, this value is
admin
for employees, andmember
for all others.Example:
"admin"
displayName
A human readable descriptive name of an individual’s membership of the group.
Example:
"L\u00e6rer"
affiliation
Mandatory in Feide 1.5.1
The user’s affiliation to this org. Obtained from eduPerson.
eduPersonAffiliation
A string, or a JSON array of strings
Example:
["member", "student"]
primaryAffiliation
Mandatory in Feide 1.5.1
The user’s primary affiliation to this org. Obtained from eduPerson.
eduPersonPrimaryAffiliation
Example:
"student"
title
Optional in Feide 1.5.1
Obtained from eduPerson
title
Example:
"student"
Example 1: Employee in Uninett
In the following example, an employee of Uninett:
{
"name": "Andreas Åkre Solberg"
}
is a member of the Uninett group:
{
"id": "fc:org:uninett.no",
"type": "fc:org",
"displayName": "Uninett",
"public": false,
"eduOrgLegalName": "Uninett AS",
"norEduOrgNIN": "NO968100211",
"mail": "info@uninett.no",
"telephoneNumber": "+47 73557900",
"eduOrgHomePageURI": "https://www.uninett.no/",
"l": "Trondheim",
"membership": {
"basic": "admin",
"affiliation": [
"employee",
"member"
],
"primaryAffiliation": "employee",
"displayName": "Ansatt"
},
"orgType": [
"higher_education"
]
}
and is a member of a group for the ASM department:
{
"id": "fc:org:uninett.no:unit:AVD-U20",
"type": "fc:orgunit",
"displayName": "Avdeling for System og Mellomvare",
"public": false,
"membership": {
"basic": "member",
"primaryOrgUnit": true
}
}
Example 2: teacher at two schools
In the following example, a teacher:
{
"name": "Anne Istad"
}
is teaching at two schools, both schools with the same school owner Oslo Kommune
{
"id": "fc:org:oslo-kommune.no",
"type": "fc:org",
"orgType": [
"primary_and_lower_secondary_owner",
"upper_secondary_owner"
],
"displayName": "Oslo kommune",
"public": false,
"eduOrgLegalName": "Oslo Kommune",
"norEduOrgNIN": "NO976820037",
"mail": "info@oslo-kommune.no",
"membership": {
"basic": "admin",
"affiliation": [
"member",
"faculty",
"employee"
],
"primaryAffiliation": "faculty",
"displayName": "L\u00e6rer"
}
}
The two schools are also represented as groups:
Alna grunnskole
{
"id": "fc:org:oslo-kommune.no:unit:NO876326125",
"type": "fc:org",
"orgType": [
"primary_and_lower_secondary",
"upper_secondary"
],
"parent": "fc:org:oslo-kommune.no",
"displayName": "Alna grunnskole",
"membership": {
"basic": "member",
"primarySchool": true
}
}
and Bjerke grunnskole
{
"id": "fc:org:oslo-kommune.no:unit:NO876326126",
"type": "fc:org",
"orgType": [
"primary_and_lower_secondary",
"upper_secondary"
],
"parent": "fc:org:oslo-kommune.no",
"displayName": "Bjerke grunnskole",
"membership": {
"basic": "member",
"primarySchool": true
}
}
Example 3: pupil at Frogner VGS
In the following example, a pupil:
{
"name": "Thea Eide"
}
is studying at Frogner VGS, owned by Oslo Kommune
{
"id": "fc:org:oslo-kommune.no",
"type": "fc:org",
"orgType": [
"primary_and_lower_secondary_owner",
"upper_secondary_owner"
],
"displayName": "Oslo kommune",
"public": false,
"eduOrgLegalName": "Oslo kommune",
"norEduOrgNIN": "NO976820037",
"mail": "post@test.feide.no",
"membership": {
"basic": "member",
"affiliation": [
"student",
"member"
],
"primaryAffiliation": "student"
}
}
A group representing the school Frogner VGS
{
"id": "fc:org:oslo-kommune.no:unit:NO895395126",
"type": "fc:org",
"orgType": [
"primary_and_lower_secondary",
"upper_secondary"
],
"displayName": "Frogner VGS",
"public": false,
"parent": "fc:org:feide.no",
"membership": {
"basic": "member",
"primarySchool": true
}
}