In Canvas, puoi creare due tipi di chiavi sviluppatore: Chiavi LTI e API Queste istruzioni sono per le chiavi sviluppatore dell'LTI. Vuoi creare chiavi sviluppatore dell'API? Passa alle chiavi sviluppatore dell'API di Canvas.

Ally usa LTI per integrarsi con il tuo Learning Management System (LMS). LTI è uno standard sviluppato da IMS Global per integrazioni semplici e sicure.

Lo standard consente agli utenti di accedere ad Ally senza uscire da Canvas. Non dovrai più accedere a diversi siti: LTI consente uno scambio sicuro di informazioni che consente un'esperienza coerente per i tuoi utenti.

Esistono due versioni di LTI: v1.1 e v1.3. Ciascuna versione richiede passaggi di configurazione diversi. La versione attuale è LTI v1.3. La principale differenza rispetto alle versioni precedenti è il modello di sicurezza aggiornato basato su OAuth2, OpenID Connect e token Web JSON.

Ally sta passando a LTI 1.3 per sfruttare il modello di sicurezza aggiornato.

Cosa comporta per te? Se sei un nuovo utente di Ally, niente. Eseguiremo la configurazione dell'integrazione di Ally con te. Ma se hai già integrato Ally con il tuo LMS, dovrai riconfigurare la tua integrazione con LTI 1.3.

Riconfigurare l'integrazione di Ally con LTI 1.3

In genere, un istituto ha a disposizione questi tre strumenti Ally nell'account root:

Ciascuno strumento ha una chiave sviluppatore e un'applicazione LTI corrispondente.

Dovrai configurare ciascuno strumento seguendo questo processo:

  1. Crea una chiave sviluppatore LTI 1.3 per ciascuno strumento.
  2. Configura ciascuna applicazione dello strumento con le informazioni della chiave sviluppatore.
  3. Invia l'ID della chiavesviluppatore e l'ID della distribuzione LTI di ciascuno strumento per la configurazione. 
  4. Rimuovi la configurazione LTI 1.1.

    Esegui quest'ultimo passaggio per una transizione fluida senza interruzioni.

Crea una chiave sviluppatore LTI 1.3 per ciascuno strumento.

  1. Vai all'account root dell'istanza di Canvas e cerca le chiavi sviluppatore.
  2. Seleziona il pulsante + chiave sviluppatore e la chiave LTI.
    Developer Keys page on a Canvas environment. The + Developer Key button is expanded showing the LTI Key option.
    Si apre la schemata Configura impostazioni chiave.
  3. Seleziona il menu Metodo e Incolla JSON.
    The Method menu opened with the Paste JSON open highlighted.
  4. Apri l'URL dello strumento LTI per cui stai creando la chiave per generare la configurazione JSON. Sostituisci [AllyEnvironment] con le informazioni dell'ambiente nel quale è ospitato il tuo istituto. 
    • Report dell’istituto: https://[AllyEnvironment]/api/v2/auth/lti/1.3/configure/canvas/institution
    • Configurazione client: https://[AllyEnvironment]/api/v2/auth/lti/1.3/configure/canvas/config
    • Report di accessibilità dei corsi: https://[AllyEnvironment]/api/v2/auth/lti/1.3/configure/canvas/course
  5. Copia le informazioni nella pagina web che si apre.
  6. Copia e incolla questo link nel campo Reindirizzamento URI. Sostituisci [AllyEnvironment] con le informazioni dell'ambiente nel quale è ospitato il tuo istituto. 
    • https://<AllyEnvironment>/api/v2/auth/lti/1.3/callback
  7. Fornisci un nome chiave.

    Includi il nome dello strumento e LTI 1.3 in ciascuno. Ad esempio: Report Ally LTI 1.3 dell'istituto, Report Ally LTI 1.3 di accessibilità dei corsi e Configurazione client Ally LTI 1.3.

  8. Seleziona Salva. La nuova chiave viene aggiunta alla pagina Chiavi sviluppatore ed è Disattivata per impostazione predefinita.
  9. Attiva la nuova chiave.
  10. Copia il numero dell'ID della chiave e il segreto nella colonna Dettagli. Il numero ID di questa chiave se il tuo ID client univoco.

Ambiente Ally per la tua regione

Usa le informazioni dell'ambiente di Ally nel quale è ospitato il tuo istituto.

  • Data center negli USA: prod.ally.ac
  • Data center in Canada: prod-ca-central-1.ally.ac
  • Data center in Europa: prod-eu-central-1.ally.ac
  • Data center a Singapore: prod-ap-southeast-1.ally.ac
  • Data center in Australia: prod-ap-southeast-2.ally.ac

Configurare lo strumento

Segui questi passaggi per gli strumenti Report dell’istituto, Configurazione client e Report di accessibilità del corso.

  1. Dall'account root, seleziona Impostazioni.
  2. Seleziona Applicazioni e Visualizza configurazioni applicazioni.
  3. Seleziona il pulsante Applicazione.
  4. Dal menu Tipo di configurazione seleziona Per ID client.
  5. Incolla il numero ID della chiave client che hai fornito al team di assistenza Ally nel campo ID client ID.
  6. Seleziona Invia.
  7. Seleziona Installa.
  8. Copia l'ID distribuzione LTI per ogni strumento di report.

Un nuovo link per lo strumento viene visualizzato nell'elenco di navigazione a sinistra dei link. Dopo che Ally ha configurato lo strumento nel sistema Ally, puoi accedere allo strumento da questo link.

Invia l'ID chiave ad Ally

Vai a Behind the Blackboard e crea un ticket di supporto con queste informazioni, così il team Ally potrà configurare l'integrazione all'interno del sistema Ally.

  • ID chiave sviluppatore per ciascuno strumento
  • ID della distribuzione dell'LTI per ciascuno strumento
  • Richiedere di configurare gli strumeni LTI 1.3

Per esempio, la chiave sviluppatore del report dell'istituto è: #00000000000000000. L'ID chiave sviluppatore del report dell'istituto è: 0000:00c00dc0ec00c00cdc000fced. Imposta il mio report LTI1.3.

Puoi avere report separati per i diversi account secondari nel tuo ambiente Canvas. Copia l'ID di distribuzione dell'account secondario e aggiungi anche tali informazioni al ticket di supporto.

Aggiorna lo snippet Ally del tema Canvas

Dopo che il report dell’istituto Ally è stato configurato con LTI 1.3, aggiorna lo snippet Ally nel tema Canvas. È necessario che sia presente un campo "lti13Id" corrispondente all'ID client del report dell'istituto LTI 1.3 (l'ID strumento di Ally) aggiunto.

  1. In qualità di amministratore di Canvas, seleziona Admin e Account.
  2. Seleziona Temi.
  3. Vai al tema attivo e seleziona Apri nell'editor temi.
  4. Seziona la scheda Carica.
  5. Nello snippet Javascript, aggiungi la proprietà ltil3Id . Sostituisci con il [InstitutionalReportDeveloperKeyID] con il tuo ID chiave sviluppatore del report dell'istituto.

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

  6. Seleziona Applica tema.