Technical guides and APIs
The SWITCH edu-ID service currently supports various programming interfaces:
Name | Description |
---|---|
Tools API | Various helper functions around the edu-ID |
SCIM API | With this API organizations can add, edit and remove current affiliations for their members (this API is currently under development), and also manage the private edu-ID of users |
Shared attribute API | An API to set and remove entitlements or membership attributes for users. (This API may be merged in the groups resource of the SCIM API in the future) |
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.