El servicio provee un mecanismo de login para el id_usuario (o id_usuario + id_grupo) proporcionado y arroja excepciones distinguiendo cuando el usuario no existe, el grupo no existe, la clave es incorrecta, etc.

Estas excepciones son útiles cuando se requiere advertir al usuario que su login no pudo ser efectuado. También es útil para verificar si un par id_usuario + clave es válido como login.

Por otro lado hay veces que no es necesario validar la clave del usuario, es decir, fuera de la plataforma el id_usuario ya se sabe que es válido, porque el usuario ya efectuó un login. En estos casos es aconsejable utilizar el servicio autenticar_usuario_confiable()


Declaración:

autenticar_usuario ( string id_usuario, string clave, int id_grupo )

Valida el usuario y retorna una URL absoluta de login


Parámetros:

id_usuario

Requerido.
Identificación del usuario

clave

Requerido.
Clave del usuario. La clave del usuario debe estar codificada utilizando el algoritmo MD5

id_grupo

Opcional.
Identificación del grupo al que será ingresado el usuario. En caso de no proporcionarse este parámetro, la url retornada por el método dirige al usuario a la segunda pantalla del login, en donde debe seleccionar el grupo de acceso


Excepciones:

Educativa::Aula::Error::UsuarioInexistente

Esta excepción se lanza cuando el usuario indicado en el parámetro no existe

Educativa::Error::LoginInvalido

Ocurre cuando la clave proporcionada esta vacía o no concuerda con la del usuario.

Educativa::Aula::Error::GrupoInexistente

Ocurre cuando el parámetro id_grupo esta establecido pero el grupo es inexistente.

Educativa::Aula::Error::UsuarioInexistenteEnGrupo

Ocurre si se especifica el parámetro id_grupo pero este no se encuentra asignado al usuario o el grupo se encuentra desactivo.

Educativa::Aula::Error::UsuarioDesactivo

Si el usuario esta desactivo en el grupo especificado o esta desactivo en todos los grupos y no se especifica el parámetro id_grupo


Devuelve:

Una URL donde el cliente deberá hacer un redirect para completar el login


SOAP Request

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"

   xmlns:aula="urn:Educativa/Aula/">

  <soapenv:Header/>

  <soapenv:Body>

     <aula:autenticar_usuario>

        <aula:id_usuario>?</aula:id_usuario>

        <aula:clave>?</aula:clave>

        <aula:id_grupo>?</aula:id_grupo>

     </aula:autenticar_usuario>

  </soapenv:Body>

</soapenv:Envelope>