RDM Integration

URLs


URL
REF
ABN
PROD
API-Endpunkt https://services.portal-r.
eiam.admin.ch/portal/rdm-api/v2/ 		https://services.portal-a.
eiam.admin.ch/portal/rdm-api/v2/ 		https://services.portal.
eiam.admin.ch/portal/rdm-api/v2/
API swagger UI (zum Ausprobieren der API im Browser) https://services.portal-r
.eiam.admin.ch/portal/rdm-api/swagger-ui/index.html 		https://services.portal-a
.eiam.admin.ch/portal/rdm-api/swagger-ui/index.html 		https://services.portal.
eiam.admin.ch/portal/rdm-api/swagger-ui/index.html
Onboarding-Landingpage (wird benötigt, wenn Ihre Anwendung Onboarding
E-Mails/Briefe versendet)
https://www.myaccount-r.
eiam.admin.ch/portal/
selfadminservice/app
/onboarding 		https://www.myaccount-a.
eiam.admin.ch/portal/
selfadminservice/app
/onboarding 		https://www.myaccount.
eiam.admin.ch/portal/
selfadminservice/app
/onboarding

Autorisierung

Der Zugriff erfolgt mit einem Client-Zertifikat, das an ein technisches Benutzerkonto gebunden ist. Dieses technische Konto müssen Sie bei Remedy bestellen. Für RDM 2.0 werden die folgenden Rollen benötigt:
  • DelegatedManager_User
  • DelegatedManager_Permission

Technische Beschreibung

Eine detaillierte technische Beschreibung finden Sie in der Swagger-Definition. Sie können entweder den oben aufgeführten API-Swagger-UI-Link verwenden oder die Swagger-Datei in den öffentlich zugänglichen Editor Swagger file editor laden. In diesem Fall können Sie die Methoden nicht ausprobieren, sondern nur die Beschreibung lesen.

Mit dem Swagger-Editor (auf beiden Wegen) können Sie auch Ihre HTML-Dokumentation, Client-Stubs zum Starten der clientseitigen Entwicklung oder serverseitige Stubs zum Erstellen von Mocks erstellen.

Hier finden Sie das aktuelle yaml File welches heruntergeladen und im Swagger Editor geöffnet werden kann: Swagger File.

Wenn Sie Benutzer mit nevisIDM SOAP hinzufügen

Wenn Sie den Benutzer nicht per RDM, sondern z.B. über die nevisIDM SOAP API hinzufügen, müssen Sie den Onboarding ready state explizit setzen:

nevisIDM SOAP API

Swagger UI aufrufen – schneller Blick in die RDM API

Die RDM API stellt ihre OpenAPI-Spezifikation über Swagger UI bereit, geschützt durch denselben 2-Way-TLS (Client-Zertifikat) wie die SOAP/REST-Endpoints.
Diese Schritte dienen nur der schnellen Orientierung in der API.

Voraussetzungen

Ein TechUser (über OPS beantragt) mit dem zugehörigen Client-Zertifikat (.p12) für die gewünschte Umgebung (DEV/TEST/REF/ABN/PROD).

Vorgehen

  • Zertifikat in den Browser importieren
    - Firefox (empfohlen): Einstellungen → Datenschutz & Sicherheit → Zertifikate → Zertifikate verwalten → Eigene Zertifikate → Importieren → .p12 wählen → Passwort eingeben.
    - Chrome / Edge: Windows-Zertifikatspeicher nutzen (Doppelklick auf .p12 oder certmgr.msc).

  • Swagger-UI-URL der Umgebung öffnen
    • Siehe Tabelle „URLs” oben auf dieser Seite (Spalte Swagger UI / REST FQDN).

  • TechUser-Zertifikat im Browser-Popup auswählen.
    • Die Swagger UI lädt; Endpunkte können direkt ausprobiert werden (z. B. POST /v2/clients/{clientExtId}/onboarding).

    Hinweis: Testzertifikate niemals auf Produktivumgebungen anwenden. Für automatisierte Nutzung (Skripte, CI/CD) das Zertifikat programmatisch verwenden – nicht über den Browser.