Technical guides and APIs

The Switch edu-ID service currently supports various programming interfaces:

Name Description
SCIM API The SCIM API (Affiliation API) for organizations to add, edit and remove current affiliations for their members via the push interface, and also manage the personal edu-ID of users
AP API The AP API (Attribute Provider API) is the implementation of the organization pull interface (implemented by a university or optionally by Switch), allowing the edu-ID components (Attribute Aggregator) to update the edu-ID affiliation database once per day
Tools API Various helper functions around the edu-ID

The SCIM API and the Shared Attribute API are specified according to the SCIM specification. They implement a subset and extensions of SCIM 2.

SCIM defines a core schema for user resources, which has been extended. The attribute set in Switch edu-ID is mostly inherited from the AAI federation. Since most of the AAI-attributes cannot be mapped to the SCIM core user schema or the enterprise user extension, a specific extension for edu-ID is required.

For the purpose of Switch edu-ID the new SCIM resource type Affiliation has been defined. It is able to represent an organizational identity as affiliation of edu-ID.