RIS Synergy Netzwerk

Das RIS Synergy Netzwerk bietet Zugangs- bzw. Austauschmöglichkeiten für Forschungsinformationssysteme von Fördergebern, Forschungsstätten und der öffentlichen Verwaltung. Im Fokus stehen die Datenerfassung nach dem Once-Only-Prinzip sowie der Austausch von Informationen zu Förderprogrammen, Organisationsstrukturen, Daten aus e-Call-Systemen, Datenmanagementplänen und Metadaten zu Forschungsoutputs.

Allgemeine Informationen über das RIS Synergy Projekt finden Sie auf der Ris Synergy Webpage.

Netzwerk Architektur

• Das Netzwerk besteht aus den teilnehmenden Universitäten, Fördergebern und einer zentral verwalteten Instanz (in der Abbildung „RIS Apps“). Der Datenaustausch funktioniert generell dezentral.
• Einträge sämtlicher Mitglieder des RIS Synergy Netwerks, welche Informationen zu den Authentifizierungs- und Info-Enpoints enthalten, können über die zentral verwaltete Registry abgefragt werden.
• OAuth2-Zugangsdaten (Client ID und Client Secret) müssen bilateral zwischen den Mitgliedern ausgetauscht werden.
• Zugang zu den Ressourcen wird durch das Abholen der jeweiligen Access Tokens ermöglicht.
• Gemeinsam entwickelte RIS Apps bieten zusätzliche Funktionen innerhalb des RIS Synergy Netzwerks.

Registry

Die Registry ist eine zentral verwaltete Ressource, in der sich die Einträge sämtlicher Teilnehmer des RIS Synergy Netzwerks befinden. Die Einträge in der Registry enthalten den OAuth2-Endpoint sowie den Endpoint zur lokalen Info-Ressource. Die aktuelle Version der Registry ist online über https://forschungsdaten.at/registry/registry.json abrufbar.

Struktur eines Eintrags in der Registry

Jeder Eintrag in der Registry ist als JSON-Objekt strukturiert und enthält die folgenden Felder:

• `id`: Ein eindeutiger Identifikator für die Institution oder Organisation.
• `acronym`: Ein Kürzel oder Akronym, das die Institution oder Organisation repräsentiert.
• `name`: Der vollständige Name der Institution oder Organisation.
• `contact`: Eine Kontakt-E-Mail-Adresse für Anfragen im Zusammenhang mit der jeweiligen Institution oder Organisation.
• `oauth2`: Der URL-Endpunkt für OAuth2 Authorization Requests.
• `info`: Der URL-Endpunkt zur lokalen Info-Ressource

Beispieleintrag in der Registry

{
     "id": "ID",
     "acronym": "XXX",
     "name": " Universitaet XXX",
     "contact": "contact@uni.at",
     "oauth2": "<base-url>/oauth/token",
     "info": "<base-url>/ris-synergy/info/v1/info"
}

Authorization Endpoint

Jeder Teilnehmer im RIS Synergy Netzwerk muss einen OAuth2-Server anbieten, der für die Bereitstellung von Access-Token verantwortlich ist.
Die API Endpoints sind auf dem Ressource-Server mittels Access-Token gesichert. Weitere Details dazu finden Sie im Abschnitt API Sicherheit.

Info Endpoint

Die Info Ressource beschreibt die zur Verfügung stehenden Systeme und eine Auflistung der jeweiligen Ressourcen-Endpoints und deren implementierten Versionen. Es sollen immer zumindest zwei Versionen unterstützt werden (aktuelle und vorherige).

Beispiel Daten einer Info Ressource

Die Info Ressource einer Forschungsstätte (gesichert mit Access Token) liefert folgende Informationen über die Organisationseinheit und den implementierten Enpoints:

{
    "endpoints": [
        {
                "orgUnit": [
                {
                    "name": "organigram",
                    "majorVersion": 1,
                    "minorVersion": 3,
                    "href": "<base-url>/ris-synergy/orgUnit/v1/orgUnits/organigram"
                },
                    {
                    "name": "organigram",
                    "majorVersion": 2,
                    "minorVersion": 3,
                    "href": "<base-url>/ris-synergy/orgUnit/v2/orgUnits/organigram"
                },
            
                {
                    "name": "orgunit",
                    "majorVersion": 1,
                    "minorVersion": 1,
                    "href": "<base-url>/ris-synergy/orgUnit/v1/orgUnit/{id}"
                }
            ]
        },
        {
            "funding": [
                {
                    "name": "funding",
                    "majorVersion": 1,
                    "minorVersion": 3,
                    "href": "<base-url>/ris-synergy/funding/v1/funding/{id}"
                },

                {
                    "name": "fundings",
                    "majorVersion": 1,
                    "minorVersion": 1,
                    "href": "<base-url>/ris-synergy/funding/v1/fundings"
                }
            ]
        }
    ]
}