Skip to main content

Ally para la integración de Brightspace de D2L

Para integrar Ally en su instancia de Brightspace de D2L, debe seguir estos pasos:

  1. Creación de roles y usuarios. Esto debe hacerse antes de comunicarse con el contacto de Anthology Ally.

  2. Configuración principal

  3. Configurar LTI

    • Configuración del cliente

    • Informe institucional

    • Informe de accesibilidad del curso

Creación de usuarios y roles

  1. Crear un nuevo rol 

    1. Desde el menú de Configuración (icono de engranajes) navega a Roles y permisos 

    2. Inicia el proceso de crear rol seleccionando el botón Crear/Copiar 

    3. Crea un nuevo rol en blanco seleccionando el botón Empezar de cero 

    4. Configuración del rol: 

      • Nombre: Aliado Rol REST 

      • Descripción: El conjunto de permisos para permitir que Ally se comunique de forma segura con las APIs REST de Brightspace 

      • Habilitar rol en cascada 

        Deja deshabilitada la opción Facilitador Principal ya que puede que ya no sea necesaria

      • Alias de rol: aliado 

      • No es necesario hacer cambios bajo Opciones de comportamiento de herramientas, todo puede seguir deshabilitado 

      • No es necesario hacer cambios en Opciones de visualización de la lista de clases todo puede seguir deshabilitado 

      • En Opciones de acceso al curso: 

        • Habilitar todas las opciones de acceso: 

          • Acceder a cursos inactivos 

          • Accede a cursos anteriores 

          • Accede a futuros cursos 

        • Secciones y Grupos pueden permanecer configurados en Ninguno de los anteriores 

    5. Interacciones de los roles: 

      1. En Inscribir rol de Ally REST, seleccione la casilla de verificación en la intersección de la fila Administrador y la columna Organización. Esto permite crear un usuario con este rol más adelante. 

      2. En Buscar rol de Ally REST, seleccione la casilla de verificación en la intersección de la fila Administrador y la columna Organización. Esto permite buscar un usuario con este rol más adelante. 

      3. No es necesario realizar ningún otro cambio.

  2. Configurar los permisos del rol 

    Una vez guardado, el nuevo rol de REST de Aliado aparecerá al final de la lista de roles. Abra el menú desplegable y seleccione Editar permisos. En esta pantalla, debe conceder los siguientes permisos: 

    1. Filtra por la herramienta Contenido y concede los siguientes permisos en la columna Oferta de cursos: 

      • Ver contenido del curso 

      • Compilar y descarga contenido 

      • Descarga temas de contenido 

      • Ver contenido que no se ha publicado 

      • Gestionar contenido 

      • Crear y editar módulos y temas 

      • Eliminar módulos y temas (necesarios para eliminar imágenes que podrían provocar convulsiones)

    2. Consola de gestión de cursos

      • Consulta la información del curso (oferta de cursos). Este permiso es necesario para que Ally recupere las unidades organizativas del departamento.

    3. Lista de clase

      • Tiene acceso a la lista de clase

    4. Debates 

      • Ver debates (Oferta de cursos)

        Esto es necesario para listar enlaces a temas de debate en un curso y su tabla de contenido. 

    5. Cuestionarios cortos 

      • Ver cuestionarios cortos (Oferta de cursos)

        Esto es necesario para listar enlaces a cuestionarios cortos en la tabla de contenido de un curso. 

    6. Editor de Unidad de Org 

      • Ver editor de Unidad de Organización (Organización)  

      • Añadir y editar los tipos de unidades de organización (Organización).

        Necesitamos este puesto para listar los semestres. Desafortunadamente, no hay ningún permiso de "solo lectura" disponible. Ally nunca creará ni editará información tipo unidad organizacional.

    7. Seguridad 

      • Ver roles y permisos (Organización)

    8. Privacidad de la información de los usuarios

      1. Ver Nombres de usuario (oferta de cursos)

        Este permiso permite a Ally ver el identificador del Usuario, pero nada más. Esta información no se almacena nunca, pero debido a razones técnicas, es necesario para determinar la cantidad de alumnos inscritos en un curso.

      2. Véase Nombres de pila (organización)

        Es necesario para recuperar el nombre y el correo electrónico del usuario cuando solicite ayuda. Ally nunca almacena esta información y solo se transmite al correo electrónico de ayuda.

      3. Ver Apellidos (Organización)

        Es necesario para recuperar el nombre y el correo electrónico del usuario cuando solicite ayuda. Ally nunca almacena esta información y solo se transmite al correo electrónico de ayuda.

      4. Ver direcciones de correo electrónico (organización)

        Es necesario para recuperar el nombre y el correo electrónico del usuario cuando solicite ayuda. Ally nunca almacena esta información y solo se transmite al correo electrónico de ayuda.

    9. Usuarios

      1. Ver inscripciones de usuarios (Oferta del curso)

      2. Buscar 'Estudiante' (Oferta de cursos)

        Estudiante es el nombre predeterminado para el rol de estudiante. Si su institución usa un nombre diferente para este tipo de usuario, habilite Buscar "..." en su lugar. Esto es necesario para recuperar el número de estudiantes en la oferta de un curso. Los datos enviados son anónimos.

      3. Ver la dirección de correo electrónico de los usuarios (organización)

        Es necesario recuperar el correo electrónico del usuario cuando solicite ayuda. Ally nunca almacena esta información y solo se transmite al correo electrónico de ayuda.

      4. Ver la herramienta de gestión de usuarios (organización)

        Es necesario recuperar el nombre y el correo electrónico del usuario cuando solicita ayuda. Ally nunca almacena esta información y solo se transmite al correo electrónico de ayuda.)

  3. Creación de usuarios

    Una vez configurado el rol, se puede crear un nuevo usuario con este conjunto limitado de permisos. 

    1. Desde el menú de Configuración (icono de engranaje), navega a Usuarios 

    2. Inicia el proceso de crear rol seleccionando el botón Nuevo Usuario 

    3. Ajustes: 

      • Nombre: Ally 

      • Apellido: Usuario 

      • Rol: Rol de aliado en REST 

      • Nombre de usuario: aliado 

      • Seleccione Establecer contraseña manualmente e introduzca una contraseña segura y adecuada en el campo Contraseña. Es fundamental que esta contraseña tenga la seguridad suficiente, ya que cambiarla más adelante requerirá configurar todo de nuevo.

      • Guarda al usuario seleccionando el botón Guardar  

Configuración principal

Importante

Asegúrese de que la configuración del usuario y rol haya sido realizada primero. La siguiente configuración se realiza en una llamada con un contacto de Anthology Ally. Asegúrese de primero programar la llamada de configuración.

  1. En el menú Ajustes (ícono de engranaje), vaya a Gestión de extensibilidad

  2. Asegúrese de estar en la pestaña OAuth 2.0

  3. Selecciona el botón Registrar una app

  4. Complete el formulario de la siguiente manera:

    • Nombre: Ally

    • URI de redirección: <URI de redirección proporcionado por el contacto de Anthology>

      por ejemplo, https://[Ally env]/api/v1/d2l/callback?clientId=[Ally client ID]

    • Alcance: content:*:read content:file:write core:*:* custom:contentaccess:read enrollment:orgunit:read

    • Solicitud de consentimiento del usuario: No

    • Habilitar tokens de refresco: Sí

    • Acepto el acuerdo de Desarrollador No Comercial: Sí

  5. Seleccione el botón Registrar

  6. Ahora se le mostrarán los detalles de la aplicación recién creada. Copie el ID del cliente y la clave secreta; luego, compártalos con su contacto Anthology Ally.

  7. Después de obtener la confirmación Anthology Ally, seleccione Actualizar

  8. Inicie sesión en Brightspace como usuario allyuser

  9. Ingrese a la URL que le proporcionó el contacto de Anthology Ally (en Administrador Ally, Detalles de integración del cliente). Si bien se trata de una URL cuyo nombre de host finaliza en .ally.ac, se lo redirigirá automáticamente a su instancia de Brightspace. Brightspace mostrará una pantalla solicitando permiso para que Ally interactúe con los usuarios de la API REST. Seleccione Aceptar.

  10. Si todo ha ido bien, debería mostrar el siguiente mensaje de éxito: ¡La integración REST ha sido configurada con éxito!

  11. En el menú Ajustes (ícono de engranaje), vaya a Configurar el navegador variable

  12. Localiza las configuraciones de Ally usando el menú de árbol a la izquierda: 3ª Fiesta > Aliada

    La integración de Ally vive en d2l.3rdParty.Ally.*

  13. Agregue los valores de configuración con los que le proporcionó su contacto Blackboard 

    • ClientId

    • ClientSecret – Brightspace mostrará dos entradas. Utilice el LTI secreto para las dos entradas.

    • ScriptUrl

  14. En el menú Configuración (icono de engranaje), vaya a Herramientas organizativas

  15. Busque la fila para la Integración Ally y active la casilla de verificación.

Configurar LTI

Siga este paso para configurar el sistema LTI y registrar las herramientas Ally.