A Canvas, podeu crear dos tipus de claus de desenvolupador: claus d'LTI i claus d'API. Aquestes instruccions són per a les claus de desenvolupador d'LTI. ¿Voleu crear claus de desenvolupador d'API? Aneu a les claus de desenvolupador d'API de Canvas.

Ally fa servir LTI per integrar amb el vostre sistema de gestió de l'aprenentatge (LMS). L'LTI is a standard developed by IMS Global for secure and seamless integrations.

Aquest estàndard permet als usuaris accedir a Ally sense sortir de Canvas. Oblideu-vos d'iniciar la sessió a diversos llocs web: l'LTI ofereix un intercanvi d'informació segur que us permetrà oferir una experiència cohesiva als vostres usuaris.

Hi ha dues versions de l'LTI: v1.1 i v1.3. Els passos de configuració són diferents en cada versió. La versió actual és LTI v1.3. La principal diferència de les versions anteriors és el model de seguretat actualitzat, basat en OAuth2, OpenID Connect i JSON Web Tokens.

Ally es trasllada a LTI 1.3 per aprofitar el model de seguretat millorada.

Què vol dir això per als usuaris? Per als usuaris nous d'Ally, no res. Nosaltres ens encarreguem de la integració d'Ally. Però si ja teniu integrat Ally al vostre LMS, haureu de reconfigurar la vostra integració amb LTI 1.3.

Reconfigurar la vostra integració d'Ally amb LTI 1.3

Una institució típica tindrà aquestes eines d'Ally disponibles al compte arrel:

Cada eina té una clau de desenvolupador d'LTI i aplicació.

Haureu de configurar cada eina seguint aquest procés:

  1. Creeu una clau de desenvolupador d'LTI 1.3 per a cada eina.
  2. Configureu l'aplicació de cada eina amb la informació de la clau de desenvolupador.
  3. Envieu l'ID de la clau de desenvolupador i l'ID de desplegament d'LTI de cada eina a Ally per a la configuració.
  4. Elimineu la configuració d'LTI 1.1.

    Feu aquest pas en darrer lloc per a una transició sense problemes ni interrupcions.

Crear una clau de desenvolupador d'LTI per a cada eina

  1. Aneu al compte arrel de la instància de Canvas i aneu a Claus de desenvolupador.
  2. Seleccioneu el botó Selecciona la tonalitat de la pell i trieu la tonalitat que vulgueu.
  3. Seleccioneu l’eina.
    LTI Advantage page is open with a table of tools registered. An arrow points points to the tools to select.
  4. Obriu l'URL de l'eina LTI per a la qual esteu creant la clau per generar la configuració JSON.  Substitueix [AllyEnvironment] amb la informació de l'entorn on està allotjada la vostra institució. 
    • Informe institucionalhttps://[AllyEnvironment]/api/v2/auth/lti/1.3/configure/canvas/institution
    • Configuració de clienthttps://[AllyEnvironment]/api/v2/auth/lti/1.3/configure/canvas/config
    • Informe d'accessibilitat del curs: https://[AllyEnvironment]/api/v2/auth/lti/1.3/configure/canvas/course
  5. Copieu la informació de la pàgina web que s'obrirà.
  6. Copieu i enganxeu aquest enllaç al camp URI de redirecció.  Substitueix [AllyEnvironment] amb la informació de l'entorn on està allotjada la vostra institució. 
    • https://<AllyEnvironment>/api/v2/auth/lti/1.3/callback
  7. Indiqueu un Nom de clau.

    Incloeu el nom de l'eina i l'LTI 1.3 a cadascuna. Per exemple: Informe institucional d'Ally LTI 1.3, Informe d'accessibilitat del curs d'Ally LTI 1.3 i Configuració de client d'Ally LTI 1.3.

  8. Seleccioneu Desa. La clau nova s'afegeix a la pàgina de claus de desenvolupador i està desactivada per defecte.
  9. Activeu la clau nova.
  10. Copieu el número d'ID de la clau i el secret a la columna de detalls. Aquest número d'ID de clau és el vostre ID de client únic.

Entorn d'Ally de la vostra regió

Feu servir la informació de l’entorn d’Ally on està allotjada la vostra institució.

  • Centre de dades dels EUA: prod.ally.ac
  • Centre de dades canadenc: prod-ca-central-1.ally.ac
  • Centre de dades europeu: prod-eu-central-1.ally.ac
  • Centre de dades de Singapur: prod-ap-southeast-1.ally.ac
  • Centre de dades australià: prod-ap-southeast-2.ally.ac

Configureu l'eina

Seguiu aquesta passos per a les eines Informe institucional, Configuració del client i Informe d'accessibilitat del curs.

  1. Al compte arrel, seleccioneu Configuració.
  2. Seleccioneu Aplicacions i Mostra la configuració de les aplicacions.
  3. Seleccioneu el botó per afegir una Aplicació.
  4. Al menú Tipus de configuració, seleccioneu Per ID de client.
  5. Enganxeu el número d'identificador de la clau de client que vàreu donar a l'equip d'assistència dAlly al camp ID de client.
  6. Seleccioneu Tramet.
  7. Seleccioneu Instal·la.
  8. Copieu l'ID de desplegament d'LTI de cada eina d'informe.

Es mostra un enllaç nou per a l'eina a la llista d'enllaços de la navegació esquerra. Després que Ally configuri l'eina al sistema d'Ally, podreu accedir a l'eina des d'aquest enllaç.

Enviar l'ID de clau a Ally

Aneu a Behind the Blackboard i creeu un tiquet de sol·licitud d'assistència amb aquesta informació perquè l'equip d'Ally pugui configurar les eines amb el sistema d'Ally:

  • ID de clau de desenvolupador de cada eina
  • ID de desplegament d'LTI de cada eina
  • Sol·licitar la configuració de les eines d'LTI 1.3

Per exemple, La meva clau de desenvolupador de l'Informe institucional és: #00000000000000000. L'ID de desenvolupament del meu informe institucional és: 0000:00c00dc0ec00c00cdc000fced. Configura el meu informe LTI1.3.

Podeu tenir informes separats per als diferents subcomptes del vostre entorn Canvas.  Copieu l'identificador de desplegament del subcompte i afegiu també aquesta informació al bitllet de suport.

Actualitzar el fragment de codi d'Ally del tema de Canvas

Després de configurar l'informe institucional d'Ally amb l'LTI 1.3, actualitzeu el fragment de codi d'Ally al tema de Canvas. Hi ha d'haver un camp 'lti13Id' corresponent a l'ID de client de l'informe institucional d'LTI 1.3 (l'ID de l'eina d'Ally) que s'ha afegit.

  1. Com a administrador de Canvas, aneu a Administració i seleccioneu Compte.
  2. Seleccioneu Temes.
  3. Apunteu al tema actiu seleccionat i seleccioneu Obre a l'Editor de temes.
  4. Seleccioneu la pestanya Penja.
  5. Al fragment de codi Javascript, afegiu la propietat ltil3Id . Substituïu [InstitutionalReportDeveloperKeyID] per l'ID de la clau de desenvolupador de l'Informe institucional.

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

  6. Seleccioneu Aplica el tema.