RDM Intégration

URLs


URL
REF
ABN
PROD
API endpoint 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/portail/rdm-api/v2/
API swagger UI (pour essayer l'API dans le navigateur) 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
Page d'accueil de l'intégration (nécessaire lorsque votre application envoie des E-Mail/lettres d'intégration).
https://www.myaccount-r.
eiam.admin.ch/portal/
selfadminservice/app
/onboarding 		https://www.myaccount-a.
eiam.admin.ch/portail/
selfadminservice/app
/onboarding 		https://www.myaccount.
eiam.admin.ch/portail/
selfadminservice/app
/onboarding

Autorisation

L'accès se fera avec un certificat client lié à un compte utilisateur technique. Vous devez commander ce compte technique par Remedy. Pour RDM 2.0 les rôles suivants sont nécessaires :
  • DelegatedManager_User
  • DelegatedManager_Permission

Description technique

Pour une description technique détaillée, veuillez consulter la définition swagger. Vous pouvez soit utiliser le lien API swagger UI indiqué ci-dessus, soit charger le fichier swagger dans l'éditeur public disponible Swagger file editor Dans ce cas, vous ne pouvez pas essayer les méthodes, mais seulement lire la description.

Avec l'éditeur swagger (dans les deux sens) vous pouvez aussi créer votre documentation html, des stubs client pour commencer le développement côté client ou des stubs côté serveur pour créer des mocks.

Vous trouverez ici le fichier yaml actuel qui peut être téléchargé et ouvert dans l'éditeur Swagger: Swagger File.

Lorsque vous ajoutez un utilisateur en utilisant nevisIDM SOAP

Lorsque vous n'ajoutez pas un utilisateur RDM, mais par exemple en utilisant l'API SOAP de
nevisIDM, vous devez définir explicitement l'état Onboarding ready:

nevisIDM SOAP API


Accéder à Swagger UI – un aperçu rapide de l'API RDM

L'API RDM met à disposition sa spécification OpenAPI via Swagger UI, protégée par le même protocole TLS bidirectionnel (certificat client) que les points de terminaison SOAP/REST.
Ces étapes servent uniquement à te donner un aperçu rapide de l’API.

Prérequis
Un compte TechUser (demandé via OPS) avec le certificat client correspondant (.p12) pour l’environnement souhaité (DEV/TEST/REF/ABN/PROD).

Procédure

  • Importer le certificat dans le navigateur
    - Firefox (recommandé) : Paramètres → Confidentialité et sécurité → Certificats → Gérer les certificats → Mes certificats → Importer → Sélectionner le fichier .p12 → Entrer le mot de passe.
    - Chrome / Edge : utiliser le magasin de certificats Windows (double-clic sur le fichier .p12 ou certmgr.msc).
  • Ouvrir l’URL de l’interface Swagger de l’environnement
    • Voir le tableau « URL » en haut de cette page (colonne Swagger UI / REST FQDN).
  • Sélectionner le certificat TechUser dans la fenêtre contextuelle du navigateur.
    • L'interface Swagger UI se charge ; tu peux tester directement les points de terminaison (par ex. POST /v2/clients/{clientExtId}/onboarding).

    Remarque : N'utilise jamais de certificats de test dans des environnements de production. Pour une utilisation automatisée (scripts, CI/CD), utilise le certificat par programmation – pas via le navigateur.