Cette collection permet d'experimenter et de tester le connecteur vers l'API de La-vie-scolaire.fr.
\nLa connexion au serveur peut être faite selon 3 méthodes :
\nGénère un ticket de session auprès de l'établissement LaVieScolaire sélectionné, valable 30 secondes. Le client doit ensuite fournir les informations de l'utilisateur pour le connecter.
\n","urlObject":{"protocol":"https","path":["vsn.main","autoLoginTicketSession","getTicket",""],"host":["{{url_etablissement}}"],"query":[],"variable":[]}},"response":[{"id":"acc52b7f-aec0-4f2d-bf3e-5af5f9fcbf99","name":"Obtenir un ticket RSA valable 30 secondes","originalRequest":{"method":"GET","header":[],"url":"https://{{url_etablissement}}/vsn.main/autoLoginTicketSession/getTicket/"},"status":"OK","code":200,"_postman_previewlanguage":"html","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Fri, 24 Jan 2020 15:15:14 GMT"},{"key":"Content-Type","value":"text/html;charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=20"},{"key":"Vary","value":"Accept-Encoding"},{"key":"Vary","value":"Accept-Encoding"},{"key":"P3P","value":"policyref=\"/w3c/p3p.xml\", CP=\"NON CUR ADM OUR STP STA\""},{"key":"Strict-Transport-Security","value":"max-age=3456000"},{"key":"Content-Encoding","value":"gzip"}],"cookie":[],"responseTime":null,"body":"2c8acb42c34ccf3cf9d6d38795b04e88"}],"_postman_id":"093fb0a5-ffbb-4547-87b2-c7ebc4ea3c40"},{"name":"Connexion d'un utilisateur","event":[{"listen":"prerequest","script":{"id":"33549d44-9c9f-40ae-af1b-d65dace8130e","exec":["// Récupère les données en vue de les chiffrer et les donner au serveur LVS","","// jeu de donnée d'un utilisateur (à variabilisier qqpart)","let user = { "," \"id\" : \"sso.professeur\","," \"profil\" : \"professeur\","," \"nom\" : \"Professeur\","," \"prenom\" : \"sso\", "," \"dtn\" : \"13/07/2012\"","};","// Fonction String Builder qui génère la fin d'url attendu par LVS.","function concatenateToUrl(appli, user, ticket) {"," return `entPersonneJointure=${user.id}&appli=${appli}&profil=${user.profil}&nom=${user.nom}&prenom=${user.prenom}&dtn=${user.dtn}&ticket=${ticket}`;","}","","// Clé RSA public de LVS (depuis les variables globales)","let rsa = pm.globals.get(\"rsaLVS\");","//console.log(\"Clef RSA utilisée: \" + rsa);","","// instanciations nécessaire à la lib.","var navigator = {};","var window = {};","","// import lib. jsrsasign-all-min.js pour l'utiliser ","if(!pm.globals.has(\"rsaLibrary\")){"," "," pm.sendRequest(\"https://kjur.github.io/jsrsasign/jsrsasign-all-min.js\", function (err, res) {",""," if (err){"," console.log(err);"," }"," else {"," pm.globals.set(\"rsaLibrary\", res.text());"," }});","}","eval(postman.getGlobalVariable(\"rsaLibrary\"));","","","// Prepare URL avec les données qu'on à","url = concatenateToUrl(pm.environment.get(\"appli\"), user, pm.environment.get(\"ticket\"));","console.log(\"URL à digérer : \" + url);","","","// Digestion","try {"," // Objectifie le string RSA"," let key = KEYUTIL.getKey(rsa);"," // Chiffre l'URL + clé"," var jsrsa = KJUR.crypto.Cipher.encrypt(url, key);"," ","} catch(err) {"," console.error(err);","}","","var chaine = encodeURIComponent(btoa( jsrsa));","console.log(\"chaine chiffrée : \" + chaine);","","pm.environment.set(\"chaine_cryptee\", chaine);","","","","","","",""],"type":"text/javascript"}}],"id":"ad0ad70d-a4bb-46a2-a3ca-5a900ca37fc0","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://{{url_etablissement}}/vsn.main/?extautolog={{chaine_cryptee}}","description":"Chiffre préalablement les données de l'utilisateur avec la clef RSA de LVS avant de faire la connexion, puis connecte un utilisateur donné à l'établissement LaVieScolaire donné.
\n{chaine chiffré} est le résultat du chiffrage RSA d’une chaine comprenant les éléments suivantes :
{id de l’utilisateur} l’identifiant de l’utilisateur chez l’ENT{client} Identifiant de l’ENT{profil}{nom}{prénom}{date de naissance}{ticket} le ticket obtenu via GET Ticket RSA{clef publique} la clé RSA de LVS.Remarques :
\nChaîne de caractères obtenue après cryptage RSA d'une chaine spécifique.
\n","type":"text/plain"},"key":"extautolog","value":"{{chaine_cryptee}}"}],"variable":[]}},"response":[{"id":"f1513f1d-92db-47ee-9bbf-5a22bba322d3","name":"Connection avec une chaine mal formée, entrainant un échec du serveur","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://{{url_etablissement}}/vsn.main/?extautolog={{chaine_cryptee}}","protocol":"https","host":["{{url_etablissement}}"],"path":["vsn.main",""],"query":[{"key":"extautolog","value":"{{chaine_cryptee}}"}]}},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Fri, 24 Jan 2020 16:12:27 GMT"},{"key":"Content-Type","value":"application/json;charset=UTF-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=20"}],"cookie":[],"responseTime":null,"body":"{\n \"title\": \"Cannot invoke method trim() on null object\",\n \"body\": \" at com.omt.securite.AuthCredentials.setProfil(AuthCredentials.groovy:64)\",\n \"stack\": [\n \" at com.omt.securite.AuthCredentials.setProfil(AuthCredentials.groovy:64)\",\n \" at com.omt.vsn.socle.AbstractAuthController.checkAutologInfos(AbstractAuthController.groovy:363)\",\n \" at com.omt.ws.vsn.WSAuthController.traiterAutologin(WSAuthController.groovy:502)\",\n \" at com.omt.ws.vsn.WSAuthController.extAutolog(WSAuthController.groovy:477)\",\n \" at net.bull.javamelody.JspWrapper.invoke(JspWrapper.java:152)\",\n \" at net.bull.javamelody.JdbcWrapper$DelegatingInvocationHandler.invoke(JdbcWrapper.java:294)\",\n \" at org.grails.plugins.web.rest.api.ControllersRestApi.forward(ControllersRestApi.groovy:53)\",\n \" at com.omt.vsn.socle.MainController.index(MainController.groovy:40)\",\n \" at net.bull.javamelody.JspWrapper.invoke(JspWrapper.java:152)\",\n \" at net.bull.javamelody.JdbcWrapper$DelegatingInvocationHandler.invoke(JdbcWrapper.java:294)\",\n \" at net.bull.javamelody.MonitoringFilter.doFilter(MonitoringFilter.java:232)\"\n ],\n \"omtstack\": [\n {\n \"class\": \"java.lang.StackTraceElement\",\n \"className\": \"com.omt.securite.AuthCredentials\",\n \"fileName\": \"AuthCredentials.groovy\",\n \"lineNumber\": 64,\n \"methodName\": \"setProfil\",\n \"nativeMethod\": false\n },\n {\n \"class\": \"java.lang.StackTraceElement\",\n \"className\": \"com.omt.vsn.socle.AbstractAuthController\",\n \"fileName\": \"AbstractAuthController.groovy\",\n \"lineNumber\": 363,\n \"methodName\": \"checkAutologInfos\",\n \"nativeMethod\": false\n },\n {\n \"class\": \"java.lang.StackTraceElement\",\n \"className\": \"com.omt.ws.vsn.WSAuthController\",\n \"fileName\": \"WSAuthController.groovy\",\n \"lineNumber\": 502,\n \"methodName\": \"traiterAutologin\",\n \"nativeMethod\": false\n },\n {\n \"class\": \"java.lang.StackTraceElement\",\n \"className\": \"com.omt.ws.vsn.WSAuthController\",\n \"fileName\": \"WSAuthController.groovy\",\n \"lineNumber\": 477,\n \"methodName\": \"extAutolog\",\n \"nativeMethod\": false\n },\n {\n \"class\": \"java.lang.StackTraceElement\",\n \"className\": \"com.omt.vsn.socle.MainController\",\n \"fileName\": \"MainController.groovy\",\n \"lineNumber\": 40,\n \"methodName\": \"index\",\n \"nativeMethod\": false\n }\n ]\n}"}],"_postman_id":"ad0ad70d-a4bb-46a2-a3ca-5a900ca37fc0"}],"id":"042c4317-cefa-42d1-adb6-4900b1d854a8","description":"Il faut exécuter une série d'étapes avec le sous-domaine de LaVieScolaire. Le module Fake-SSO de notre ENT s’occupe de cette procédure.
\nhttps://{{url_etablissement}}/vsn.main/autoLoginTocketSession/getTicket/ où{{url_etablissement}} est l’adresse de base de l'établissement de LaVieScolaire auquel l’utilisateur souhaite se connecter. Exemples : etab3.la-vie-scolaire.fr, etablissementsso.la-vie-scolaire.fr87e06d813451d6a1c33b0aaa6f8794e8https://{{url_etablissement}}/vsn.main/?extautolog={{chaine chiffrée}} où{{chaine chiffrée}} est une chaine composée de plusieurs paramètres.{Id de l’utilisateur} pour ne plus le ré-authentifier.\n\nPas implémenté ici.
\n
Génère un jeton d'authentification à retourner au client, et utilisé entre le client et le serveur pour confirmer la connexion.
\n","urlObject":{"protocol":"https","path":["vsn.main",""],"host":["{{url_etablissement}}"],"query":[{"description":{"content":"Code unique de 20 caractères déterminé par Axess Education et identifiant l'établissement de notre ENT.
\n","type":"text/plain"},"key":"ident","value":"{{appli}}"}],"variable":[]}},"response":[{"id":"d98a5584-4ada-4e50-8606-0d25c70fcf47","name":"Demander un ticket PT, mais être redirigé vers la page de connexion ","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://{{url_etablissement}}/vsn.main/?ident={{appli}}","protocol":"https","host":["{{url_etablissement}}"],"path":["vsn.main",""],"query":[{"key":"ident","value":"{{appli}}","description":"Code unique de 20 caractères déterminé par Axess Education et identifiant l'établissement de notre ENT."}]}},"status":"OK","code":200,"_postman_previewlanguage":"html","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Fri, 24 Jan 2020 18:07:06 GMT"},{"key":"Content-Type","value":"text/html"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=20"},{"key":"Vary","value":"Accept-Encoding"},{"key":"Vary","value":"Accept-Encoding"},{"key":"P3P","value":"policyref=\"/w3c/p3p.xml\", CP=\"NON CUR ADM OUR STP STA\""},{"key":"Strict-Transport-Security","value":"max-age=3456000"},{"key":"Content-Encoding","value":"gzip"}],"cookie":[],"responseTime":null,"body":"\n\n\t\n\t\t\n\t\tConnecte un utilisateur donné à l'établissement LaVieScolaire donné à l'aide de l'autorité CAS donnée et du jeton d'authentification.
\n\n\n","urlObject":{"protocol":"https","path":["vsn.main","autoLoginTicketSession","getCasTicket",""],"host":["{{url_etablissement}}"],"query":[{"description":{"content":"Pas implémenté ici.
\n
Jeton d'authentification reçu par le client et émis par l'autorité CAS du client.
\n","type":"text/plain"},"key":"casTicket","value":"{{ticket CAS}}"},{"description":{"content":"Code unique de 20 caractères déterminé par Axess Education et identifiant l'établissement de notre ENT
\n","type":"text/plain"},"key":"ident","value":"{{appli}}"},{"description":{"content":"URL d'accès au serveur CAS de l'application appelante (peux également comprendre le port).\nCette URL permettra de valider le ticket PT que\nl'application appelante a fourni en paramètre.
\n","type":"text/plain"},"key":"hostCAS","value":"{{url serveur CAS}}"},{"description":{"content":"Le profil de l'utilisateur parmis eleve, responsable, professeur.
Le nom de l'utilisateur
\n","type":"text/plain"},"key":"nom","value":"{{nom}}"},{"description":{"content":"Le prénom de l'utilisateur
\n","type":"text/plain"},"key":"prenom","value":"{{prenom}}"},{"description":{"content":"La date de naissance de l'utilisateur
\n","type":"text/plain"},"key":"dtn","value":"{{dtn}}"}],"variable":[]}},"response":[{"id":"a7b24362-317e-4b1b-a85d-fcb5a62683d0","name":"Connecter un professeur sans fournir de ticket ni d'autorité, retourne sur une page de connexion.","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://{{url_etablissement}}/vsn.main/autoLoginTicketSession/getCasTicket/?casTicket={{ticket_CAS}}&ident={{appli}}&hostCAS={{url_serveur_CAS}}&profil=professeur&nom=Professeur&prenom=sso&dtn=13/07/2012","protocol":"https","host":["{{url_etablissement}}"],"path":["vsn.main","autoLoginTicketSession","getCasTicket",""],"query":[{"key":"casTicket","value":"{{ticket_CAS}}"},{"key":"ident","value":"{{appli}}"},{"key":"hostCAS","value":"{{url_serveur_CAS}}"},{"key":"profil","value":"professeur"},{"key":"nom","value":"Professeur"},{"key":"prenom","value":"sso"},{"key":"dtn","value":"13/07/2012"}]}},"status":"OK","code":200,"_postman_previewlanguage":"html","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Thu, 23 Jan 2020 17:59:53 GMT"},{"key":"Content-Type","value":"text/html"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=20"},{"key":"Vary","value":"Accept-Encoding"},{"key":"Vary","value":"Accept-Encoding"},{"key":"P3P","value":"policyref=\"/w3c/p3p.xml\", CP=\"NON CUR ADM OUR STP STA\""},{"key":"Strict-Transport-Security","value":"max-age=3456000"},{"key":"Content-Encoding","value":"gzip"}],"cookie":[],"responseTime":null,"body":"\n\n\t\n\t\t\n\t\t\n\nRemarque : Nous n'utilisons pas cette méthode, aussi elle n'est pas complètement documentée, et les API présentées ici ne sont pas opérationnelles.
\n
Le client et le serveurs utilise une autorité pour identifier un utilisateur des deux plateformes et permettre la connexion. \nLorsque le client contacte le serveur, il lui fournit l'URL vers l'autorité et des informations de l'utilisateur. Plus précisément :
\nserviceValidate() qui réponds avec un XML comprenant les informations de l'utilisateur (dont l'uuid cas:user) et retrouve le compte correspondant dans son environnement.\n a. Si le compte est trouvé, le client récupère une URL prédéfinie pour rediriger l'utilisateur\n b. Si le compte n'est pas trouvé : ?\n c. Si une erreur interne survient : ?\n d. Si les informations données sont incomplètes ou mal formées : ?