ELMS: Autentificació n a trave s de su Universidad

Transcripción

1 ELMS: Autentificació n a trave s de su Universidad Introducción En este tutorial se explica cómo utilizar el sistema de autentificación de su Universidad para identificar a los usuarios en el portal ELMS, proporcionado con la licencia MSDN Academic Alliance. Qué es MSDN Academic Alliance? MSDN Academic Alliance es un programa de suscripción anual especialmente diseñado para los departamentos universitarios y de Formación Profesional que imparten tecnología y diseño, y desean utilizar los productos de Microsoft para sus actividades docentes. El programa tiene dos objetivos principales: Hacer más fácil y económico el acceso a las herramientas de desarrollo y diseño, plataformas, y servidores de Microsoft con fines docentes y de investigación. Crear una comunidad de académicos con el fin de compartir currículum y otros recursos pedagógicos respaldados por el uso de estas tecnologías. El programa MSDN Academic Alliance permite poner a disposición de los profesores y los alumnos de los departamentos de tecnología y diseño, en el aula o en su casa, la gama de herramientas de desarrollo y diseño, productos de servidor, sistemas operativos, aplicaciones y librerías de información de Microsoft, con el propósito de ser utilizados para investigación y docencia. Qué es ELMS? ELMS (e-academy License Management System) es un sitio Web de distribución de software que cada Administrador de Programas puede adaptar a las necesidades de su departamento. ELMS se ofrece como un beneficio gratuito para los departamentos de todo el mundo que son miembros de MSDN Academic Alliance, de modo que no se cobra ningún cargo adicional por su uso. Cómo autentificar a mis usuarios en ELMS a través del portal de mi Universidad? Lo primero que deberá hacer para que sus usuarios se autentifiquen en su ELMS es configurarlo. Para más información vea el apartado Configuración de ELMS. Existen dos formas por las cuales sus usuarios se pueden autentificar en ELMS utilizando el sistema de su Universidad. Estos son los siguientes: - Identificación desde el ELMS. Este proceso se inicia desde el propio ELMS cuando el usuario hace clic en Iniciar sesión y éste es redirigido a la página de autentificación de su universidad.

2 - Identificación desde la web de la universidad. El usuario se autentifica en la web de su universidad y más tarde accede al ELMS sin necesidad de volver a autentificarse. Configuración del ELMS Antes de empezar a programar, debe configurar el sistema de autentificación integrada del ELMS. Para acceder a la configuración, dentro del portal ELMS y desde un usuario administrador acceda a: Administración/Gestión de usuarios/autenticación de campus integrada Nota: Asegúrese de que durante el proceso de desarrollo indique el estado Modo de prueba, hasta que se haya completado la implementación y todo funcione perfectamente. Mover el estado de Modo Test a Modo Producción debe ser el último paso. A continuación se detallan todas las opciones configurables dentro de la sección indicada anteriormente. Autentificación de campus Desactivado: Es la configuración por defecto. En este modo, los usuarios se autentifican directamente en la base de datos del ELMS. Antes de comenzar el proceso de integración, debes tener un usuario con privilegios administrativos. Con este usuario podrás acceder, además de a la configuración de campus integrada, al resto de configuraciones. Modo de prueba: Cambia al modo de prueba cuando estés preparado para comenzar con la implementación. En modo de prueba, el botón Iniciar sesión redirecciona a la página de autentificación de su Universidad. En la parte inferior del ELMS se encuentra un enlace Inicio de sesión en ELMS que te permitirá usar las credenciales internas de ELMS para acceder a los servicios. Activado: El último paso cuando cambias a estado activado se supone que se ha completado todo el proceso de testeo del módulo de validación. Una vez que se ha pasado a Activado el enlace Inicio de sesión en ELMS de la parte inferior de la página desaparece. Si pasa a estado Activado y no es capaz de acceder al ELMS, por favor contacte con su representante de e-academy para que le vuelva a poner el estado Modo de prueba. URL de autentificación del campus La URL de autentificación del campus será la dirección a la que se redireccionará al usuario cuando intente autentificarse en la web. En esta página al usuario se le preguntará por sus credenciales, se verificarán y se devolverá al usuario al ELMS.

3 Departamento para comprobación El departamento al que estará asociado el usuario en el ELMS. Approximate Number of Students/Faculty Debe seleccionar el rango que más se aproxime al número de estudiantes y profesores que componen la comunidad de su campus. Esta información es usada por el equipo de e-academy para ayudar a estimar la máxima carga de proceso del servidor (para balanceo de carga). Dirección IP de servidor CGI del campus Lista de direcciones IP de los servidores desde los cuales el usuario puede autentificarse, suele contener las direcciones IP de los servidores web de su Universidad. El ELMS verificará esta lista de direcciones IP cada vez que un servidor intente hacer una identificación de un usuario para el ELMS. Esto corresponde a un sistema de seguridad. Conector de CGI de ELMS Corresponde con la dirección web con a la cual debe hacer las peticiones necesarias para completar la autentificación de los usuarios. Para más información al respecto, vea las secciones siguientes. Identificación desde ELMS En este escenario el usuario accede desde un primer momento al ELMS de su universidad. Una vez en esta página, el usuario debe autentificarse para acceder a todos los servicios haciendo clic en Iniciar sesión. Es en este punto cuando comienza el proceso de autentificación: 1. El usuario hace clic en el enlace de Autentificación del ELMS 2. El ELMS redirige al usuario hacia la página de autentificación de su Universidad. Junto con la redirección y a través del método GET se le pasan a su página dos variables: token y return_url. Un ejemplo de la redirección sería el siguiente: //elms.e-academy.com/elms/security/integratedlogin.aspx?campus=universidad El significado de cada una de las variables es el siguiente: o Token: Representa un código de sesión que deberá utilizar en toda las posibles comunicaciones con el sistema ELMS. Sirve para corroborar el estado de comunicación con la página de autentificación de su universidad. o Return_url: Es la dirección de la página a la que deberá redirigir al usuario, una vez se haya terminado de establecer la comunicación con el ELMS. Tenga en cuenta que la página de autentificación de su Universidad deberá mantener los valores de estas dos variables hasta que se termine la autentificación 3. La página de autentificación de su universidad autentifica al usuario dentro de su sistema.

4 4. Una vez que el usuario ha sido identificado en el sistema de su Universidad, deberá realizar una petición al enlace de identificación proporcionado durante la configuración del ELMS (vea el apartado Configuración del ELMS). Un ejemplo de petición es el siguiente: oe&groups=student,staff&department=department Observe que existen varias variables que usted debe proporcionar a través de GET al enlace de autentificación. A continuación se exponen las variables que puede pasarle: Nombre Descripción Requerido Restricciones / Notas uid Identificación del usuario Sí - Debe contener un máximo de 255 caracteres. - Si la identificación del usuario no existe dentro del ELMS, el sistema lo Groups Token Department lname fname Lista de grupos a los que pertenece el usuario. Generado automáticamente y enviado al abrir la sesión en el ELMS. Departamento al que pertenece el usuario. Apellidos del usuario Nombre del usuario Sí Sí No No No creará automáticamente. - En caso de que el usuario pertenezca a más de un grupo, estos se indicaran en una lista, separados por comas. Por ejemplo: groups=estudiantes,informática - Es un número entero positivo comprendido entre 0 y El token es único a cada sesión y dura como máximo 5 minutos. El token debe pasarse al ELMS cuando se procede a la identificación y durante la redirección final del usuario al ELMS. - Un único departamento. - Máximo 50 caracteres. - Máximo 50 caracteres. del usuario No - Máximo 255 caracteres. 5. Si la petición al ELMS se ha realizado con éxito, se recibirá un código de estado HTTP 200 (OK), y en el cuerpo de la respuesta se encontrará un código de resultado de la petición. Deberá comprobar dicho código de resultado para identificar si se produjo algún error en la petición o si por el contrario todo ha ido bien. A continuación se exponen todos los posibles códigos de resultados que pueden ser devueltos por el ELMS. Condigo de resultado Tipo Descripción 0 Account created Correcto La autentificación ha sido exitosa. Es la primera vez

5 que el usuario accede al ELMS y por lo tanto se ha creado una identificación nueva. 0 Account updated Correcto La autentificación ha sido exitosa. Todos los datos pasados al ELMS (departamento, grupos, etc) serán actualizados 0001 Department name El nombre del departamento especificado no existe doesn t match 0002 IP address doesn t match dentro de la configuración del ELMS. La dirección desde la que está intentando hacer la petición no coincide con ninguna de las configuradas en el ELMS Group list is empty No se indicó ningún grupo al que pertenece el usuario UID not passed No se indicó un identificador de usuario Multiple usernames found El identificador de usuario aparece múltiples veces en la base de datos del ELMS. Aunque es raro, este error puede aparecer si el usuario intenta identificarse a la vez en varios navegadores a la vez. Para arreglar este error, por favor, póngase en contacto con el servicio técnico security Token was El token no se pasó al hacer la petición. not passed 0007 Department not found El departamento no se indicó Campus not found El nombre del campus no se indicó en la petición. Este error solo se reporta si estas utilizando autentificación de Multi-Campus Campus Country not found 0010 Security Token not found Este es un error interno. Por favor contacte con el servicio técnico. El token que se indicó no se encuentra en la base de datos del ELMS. Esto, típicamente, corresponde con un error a la hora de tomar el token de la respuesta GET correspondiente a la apertura de la sesión Token Expired El token que se indicó ha expirado. El token es únicamente válido durante los 5 primeros minutos desde su creación. El token solo se puede crear una vez. Una vez que se usa, el token expirará, aunque no hayan pasado 5 minutos. 6. Tras la correcta petición al ELMS, solo queda redirigir al usuario a la dirección proporcionada en la variable return_url durante la apertura de la sesión, junto con las variables que necesarias para la autentificación, pasadas a través de GET. Un ejemplo de esta dirección es el siguiente: 23&uid=jdoe A continuación se muestra un esquema que muestra el proceso de comunicación entre la Universidad y el ELMS, para este escenario.

6 Identificación desde la web de la Universidad A diferencia del escenario planteado en la sección anterior, el usuario en este caso comienza identificándose en la página de su universidad y más tarde accede al ELMS. El proceso de autentificación sería el siguiente. 1. El usuario accede a la página de su universidad y se autentifica correctamente 2. El usuario desea acceder al ELMS y hace clic en el enlace pertinente. 3. La página de su Universidad debe redireccionar al usuario a la página de identificación del ELMS. Una vez que el usuario haya sido redirigido a dicha página del ELMS, este volverá a redirigir al usuario, pero ésta vez a la página de autentificación de la universidad enviándole a través de GET las variables token y return_url necesarias para todo el proceso. Un ejemplo de página de autentificación de ELMS es la siguiente: 4. Puede continuar con el proceso de autentificación a partir del punto 2 del apartado anterior Identificación desde ELMS.

7 A continuación se muestra un esquema que muestra el proceso de comunicación entre la Universidad y el ELMS, para este escenario.