Manuel Migration Certificat 2016 SSO Table des matières 1 INTRODUCTION ......................................................................................................................................................2 2 IMPACTS SUR LA CONFIGURATION DE L’ACCELERATEUR PHP ...............................................................3 2.1 RECONFIGURATION DU CERTIFICAT DE L’APPEL SECURISE ........................................................................................3 2.1.1 Reconfiguration du certificat pour l’appel sécurisé avec un pont Java .....................................................3 2.1.2 Reconfiguration pour l’appel sécurisé direct .................................................................................................3 2.2 RECONFIGURATION DU CERTIFICAT DE VERIFICATION DE L’ASSERTION SSO............................................................4 2.2.1 Reconfiguration du certificat SSO lors d’un appel sécurisé par pont Java ...............................................4 2.2.2 Reconfiguration du certificat SSO lors d’un appel sécurisé direct .............................................................4 Error! Reference source not found. Error! Reference source not found.Error! Reference source not found. 1 Introduction Le certificat utilisé pour la signature des certificats SSO expire en septembre 2016. Un changement est nécessaire pour garantir le fonctionnement au-delà de cette date. Ce document décrit les impacts que ce changement implique dans la configuration des applications partenaires. Page 2 / 4 Error! Reference source not found. Error! Reference source not found.Error! Reference source not found. 2 Impacts sur la configuration de l’accélérateur PHP 2.1 Reconfiguration du certificat de l’appel sécurisé Ce certificat est utilisé pour effectuer l’appel de service sécurisé avec le protocole WS-Security. Il représente la partie publique du certificat serveur qui doit être installée dans l’accélérateur pour chiffrer les messages envoyés au service sécurisé. 2.1.1 Reconfiguration du certificat pour l’appel sécurisé avec un pont Java Dans ce cas, l’appel sécurisé est effectué en amont par l’accélérateur Java. C’est donc ce dernier qui doit être reconfiguré. Cf. documentation correspondante. 2.1.2 Reconfiguration pour l’appel sécurisé direct 2.1.2.1 Reconfiguration du certificat serveur L’accélérateur PHP charge les certificats à partir de fichiers. Il faut donc modifier le chemin de ces derniers en configuration. C’est le paramètre de configuration « securedCallServerCertificatePath » se trouvant dans le fichier « pshelper\main\classes\PSHelper.php » qui indique le chemin du certificat serveur à charger. Il doit être reconfiguré pour pointer vers le fichier « sante-ra-2016.cer » fourni avec cette documentation. Ce chemin dépendra de l’implémentation faite par l’éditeur. Par défaut, les certificats pour les pages d’exemple sont stockés dans le répertoire « pshelper\test\resources ». 2.1.2.2 Reconfiguration de l’URL de l’appel sécurisé Les URL d’appels sécurisées par l’ancien certificat sont : Environnement Valeur Recette https://recette.santera.fr/ServicesSecurises/RoutingService.svc/CompatibilitySecured Production https://www.santera.fr/ServicesSecurises/RoutingService.svc/CompatibilitySecured Avec le nouveau certificat elle deviennent : Environnement Valeur Recette https://soap-recette.santera.fr/ServicesSecurises2016/RoutingService.svc/CompatibilitySecured Production https://soap.santera.fr/ServicesSecurises2016/RoutingService.svc/CompatibilitySecured Cette URL est renseignée dans paramètre « urlTokenProviderSecured ». Page 3 / 4 le fichier « pshelper\main\classes\PSHelper.php » avec le Error! Reference source not found. Error! Reference source not found.Error! Reference source not found. 2.2 Reconfiguration du certificat de vérification de l’assertion SSO Ce certificat est utilisé pour vérifier que les données de l’assertion SAML récupérées lors d’une résolution de jeton SSO sont correctement signées et n’ont pas été altérées. Plus exactement, il intervient lors de la vérification du certificat qui a été utilisé pour la signature, lequel est directement renvoyé avec l’assertion SAML. Pour cela, c’est l’autorité intermédiaire du certificat de signature qui doit être configurée dans l’accélérateur PHP. En pratique, le certificat en question est directement chargé à partir d’un fichier. Dans notre cas, il s’agit du « sante-ra-2016-intermediate.cer » fournis avec ce manuel. 2.2.1 Reconfiguration du certificat SSO lors d’un appel sécurisé par pont Java Dans ce cas, les vérifications de sécurité sont faites en amont par l’accélérateur Java. Cf. documentation correspondante. 2.2.2 Reconfiguration du certificat SSO lors d’un appel sécurisé direct C’est le paramètre de configuration « tokenSignatureTrustCertificatePath » se trouvant dans le fichier « pshelper\main\classes\PSHelper.php » qui indique le chemin du certificat à charger. Il doit être reconfiguré pour pointer vers le fichier « sante-ra-2016-intermediate.cer ». Ce chemin dépendra de l’implémentation faite par l’éditeur. Par défaut, les certificats pour les pages d’exemple sont stockés dans le répertoire « pshelper\test\resources ». Page 4 / 4