Autenticar usuario

autenticar_usuario (id_usuario as String , clave as String , (opcional) id_grupo as Integer)

el método nos proporciona una url con la cual podremos loguearnos a la plataforma con el usuario pasado como parámetro. También podemos realizar el logueo directamente en un grupo en particular.

Devuelve: result

Una url que permite el acceso del usuario a la plataforma.


Funcionamiento

  • Para loguearnos a la plataforma con un usuario, ejecutamos el WS con los parámetros 'id_usuario' y 'clave'
  • Para loguearnos directamente a un grupo específico de la plataforma, ejecutamos el WS con los parámetros 'id_usuario', 'clave' y 'id_grupo'
  • La 'clave' debe ser indicada a partir del md5 de la clave plana
  • El acceso generado será válido mientras que el usuario asociado al mismo no haya iniciado sesión (tenga un nuevo acceso)


Ejemplo de Respuesta

Ejemplo de respuesta de la llamada autenticar_usuario, para un usuario en un grupo en particular:

  • Llamada:

     <aula:autenticar_usuario>
       <aula:id_usuario>alberto</aula:id_usuario>
       <aula:clave>7815696ecbf1c96e6894b779456d330e</aula:clave>
       <aula:id_grupo>69</aula:id_grupo>
    </aula:autenticar_usuario>

En esta llamada, podemos observar que se solicita autenticar al 'usuario'= "alberto", en el grupo con 'id_grupo'= "69"


  • Respuesta:

   <autenticar_usuario_response xmlns="urn:Educativa/Aula/">
       <result>http://manuel.e-ducativa.x/open_70803/aula/acceso.cgi?auth=6b3d65647563617469766126763d3266336561333233336666306238326538363864366135356534663463666262366435323533333963623336326335646561623538313131313463626432333634306536326462333965333763336239343039383439623034343164396631393562303361323930326437333435366634353439613163616235663934303336633964653261396464313438623735376164356239636161393331353632316532313761623137633866623135396436663637393938303637326664623963326133323830366665</result>
    </autenticar_usuario_response>


Errores de validación

  • Educativa::Aula::Error::UsuarioInexistente - cuando el usuario indicado en el parámetro no existe.
  • Educativa::Error::LoginInvalido - cuando la clave proporcionada esta vacía o no concuerda con la del usuario.
  • Educativa::Aula::Error::GrupoInexistente - cuando el parámetro id_grupo esta establecido pero el grupo es inexistente.
  • Educativa::Aula::Error::UsuarioInexistenteEnGrupo - cuando se especifica el parámetro id_grupo pero este no se encuentra asignado al usuario.
  • Educativa::Aula::Error::UsuarioDesactivo - cuando el usuario esta desactivo en el grupo especificado o esta desactivo en todos los grupos y no se especifica el parámetro id_grupo