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 education

    • primary_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 or owner.

  • When populated from eduOrg/OrgUnit, this value is admin for employees, and member 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
    }
}