En Canvas, puede crear dos tipos de claves para desarrolladores: las claves de LTI y las de API. Estas instrucciones corresponden a las claves de LTI. Si desea crear claves de API para desarrolladores, diríjase a la sección correspondiente de Canvas.

Ally utiliza LTI para la integración con su sistema de gestión del aprendizaje (LMS). LTI es un estándar que IMS Global desarrolló para lograr una integración segura y sin interrupciones.

El estándar permite que los usuarios accedan a Ally sin salir de Canvas. Ya no tendrá que iniciar sesión en varios sitios: LTI posibilita el intercambio seguro de información para que los usuarios tengan una experiencia uniforme.

Existen dos versiones de LTI: 1.1 y 1.3. Cada una requiere diferentes pasos para la configuración. La versión actual es LTI 1.3. La diferencia más importante con respecto a las anteriores es el modelo de seguridad mejorado basado en OAuth2, OpenID Connect y JSON Web Tokens.

Ally adopta LTI 1.3 para aprovechar el modelo de seguridad mejorado.

¿Qué significa para usted? Si no utilizaba Ally en el pasado, nada cambiará. Nosotros configuraremos la integración de Ally por usted. Sin embargo, si ya tiene la herramienta integrada con su LMS, tendrá que volver a configurar la integración con LTI 1.3.

Vuelva a configurar la integración de Ally con la versión de LTI 1.3

Una institución típica podría tener estas tres herramientas de Ally disponibles en la cuenta raíz:

Cada herramienta tiene su propia aplicación y clave de LTI para desarrolladores.

Deberá configurar cada herramienta siguiendo estos pasos:

  1. Cree una clave de LTI 1.3 para desarrolladores para cada herramienta.
  2. Configure la aplicación de cada herramienta con la información de la clave para desarrolladores.
  3. Envíe el ID de la clave para desarrolladores y el ID de implementación de LTI de cada herramienta a Ally para la configuración. 
  4. Elimine la configuración de LTI 1.1.

    Deje este último paso para el final, de modo que pueda lograr una transición sin interrupciones.

Cree una clave de LTI para desarrolladores para cada herramienta

  1. Vaya a la cuenta raíz de la instancia de Canvas y diríjase a Claves para desarrolladores.
  2. Haga clic en el botón Nueva clave para desarrolladores y seleccione Clave de LTI.
    Developer Keys page on a Canvas environment. The + Developer Key button is expanded showing the LTI Key option.
    Se abrirá la pantalla Configuración de parámetros de claves.
  3. Seleccione el menú Método, y luego Pegar JSON.
    The Method menu opened with the Paste JSON open highlighted.
  4. Abra la URL de la herramienta LTI para la que está creando la clave, para generar la configuración de JSON.Reemplace [AllyEnvironment] por la información del entorno en el que se aloja su institución. 
    • Informe institucional: https://[AllyEnvironment]/api/v2/auth/lti/1.3/configure/canvas/institution
    • Configuración del cliente: https://[AllyEnvironment]/api/v2/auth/lti/1.3/configure/canvas/config
    • Informe de accesibilidad del curso: https://[AllyEnvironment]/api/v2/auth/lti/1.3/configure/canvas/course
  5. Copie la información en la página web que se abra.
  6. Copie y pegue este enlace en el campo URI de redirección.Reemplace [AllyEnvironment] por la información del entorno en el que se aloja su institución. 
    • https://<AllyEnvironment>/api/v2/auth/lti/1.3/callback
  7. Proporcione un nombre de clave.

    Incluya el nombre de la herramienta y LTI 1.3 en cada uno. Por ejemplo: Informe institucional de Ally LTI 1.3, Informe de accesibilidad del curso de Ally LTI 1.3 y Configuración del cliente de Ally LTI 1.3

  8. Seleccione Guardar. Se agregará la nueva clave a la página Claves para desarrolladores y se encontrará Desactivada de forma predeterminada.
  9. Active la clave nueva.
  10. Copie el número de ID y el secreto de la clave en la columna Detalles. Este número de ID de la clave es su ID de cliente único.

Entorno de Ally para su región

Utilice la información del entorno de Ally en el que se aloja su institución.

  • Centro de datos de EE. UU.: prod.ally.ac
  • Centro de datos de Canadá: prod-ca-central-1.ally.ac
  • Centro de datos de Europa: prod-eu-central-1.ally.ac
  • Centro de datos de Singapur: prod-ap-southeast-1.ally.ac
  • Centro de datos de Australia: prod-ap-southeast-2.ally.ac

Configure la herramienta

Siga estos pasos para las herramientas de informe institucional, configuración del cliente e informe de accesibilidad del curso.

  1. En la cuenta raíz, seleccione Ajustes.
  2. Seleccione Aplicaciones y Ver ajustes de la aplicación.
  3. Seleccione el botón agregar una aplicación.
  4. En el menú Tipo de ajuste, seleccione Por ID de cliente.
  5. Pegue el número de ID de la clave de cliente que le proporcionó al equipo de soporte técnico de Ally en el campo ID de cliente.
  6. Seleccione Enviar.
  7. Seleccione Instalar.
  8. Copie el ID de implementación de LTI para cada herramienta de informes.

Aparecerá un nuevo enlace para la herramienta en la lista de navegación izquierda de enlaces. Una vez que Ally configure la herramienta en el sistema, podrá acceder a la herramienta desde este enlace.

Envíe el ID de la clave a Ally

Diríjase a Behind the Blackboard y cree un boleto de caso de soporte técnico con esta información para que el equipo de Ally pueda configurar las herramientas dentro del sistema de Ally:

  • ID de la clave del desarrollador para cada herramienta
  • ID de implementación de LTI para cada herramienta
  • Solicitud para configurar las herramientas LTI 1.3

Por ejemplo, mi clave para desarrolladores del informe institucional es la siguiente: #00000000000000000. Mi ID de implementación del informe institucional es el siguiente: 0000:00c00dc0ec00c00cdc000fced. Configure mi informe de LTI 1.3.

Puede generar informes individuales para las diferentes cuentas secundarias en su entorno de Canvas.Copie el ID de implementación de la cuenta secundaria y agregue esa información al boleto de soporte.

Actualice el fragmento de código de Ally en el tema de Canvas

Una vez que se configure el informe institucional de Ally con LTI 1.3, actualice el fragmento de código de Ally en el tema de Canvas. Se debe agregar un campo "lti13Id" que corresponda al ID de cliente del informe institucional de LTI 1.3 (el ID de la herramienta Ally).

  1. Como administrador de Canvas, vaya a Administrador y seleccione Cuenta.
  2. Seleccione Temas.
  3. Coloque el cursor sobre el tema activo y seleccione Abrir en el editor de temas.
  4. Seleccione la pestaña Cargas.
  5. En el fragmento de código de JavaScript, agregue la propiedad ltil3Id. Reemplace [InstitutionalReportDeveloperKeyID] por su ID de clave para desarrolladores del informe institucional.

    window.ALLY_CFG = {
     'baseUrl': 'https://prod.ally.ac',
     'clientId': 00000,
     'lti13Id': '<YourInstitutionalReportDeveloperKeyID>'
    };
    $.getScript(ALLY_CFG.baseUrl + '/integration/canvas/ally.js');

  6. Seleccione Aplicar tema.