Resum
Qwickly Attendance per Canvas funciona correctament sense necessitat d'aplicar restriccions de permisos, però si la institució les imposa, cal assegurar-se que la clau de desenvolupador inclogui tots els permisos requerits per evitar errors "invalid_scope". Aquest article detalla els permisos específics necessaris i com solucionar problemes relacionats amb la configuració dels permisos en Canvas.
No és obligatori aplicar àmbits per utilitzar Qwickly Attendance amb Canvas.
Per defecte, Qwickly Attendance funcionarà correctament sense habilitar Aplicar Àmbits a la clau de desenvolupador de Canvas. La majoria d’institucions poden completar la seva integració sense modificar la configuració dels àmbits.
Algunes institucions opten per aplicar àmbits com a part de les seves polítiques internes de seguretat. Si la vostra institució ha habilitat Aplicar Àmbits, heu d’assegurar-vos que la clau de desenvolupador de Qwickly Attendance inclogui tots els permisos requerits. Sense els àmbits necessaris, els usuaris poden trobar un error “invalid_scope” en iniciar l’aplicació.
Com sé si s’apliquen els àmbits?
A Canvas, navegueu a Admin > Clau de Desenvolupador > Clau API de Qwickly Attendance > icona de llapis per editar. Si els àmbits estan habilitats, veureu el control lliscant 'Aplicar Àmbits' activat:
Nota important: Si utilitzeu una clau de desenvolupador amb àmbits aplicats, assegureu-vos de marcar la casella anomenada "Permetre paràmetres Include"
Permisos requerits
Si la vostra institució aplica àmbits, els següents permisos han d’estar habilitats a la clau de desenvolupador de Qwickly Attendance:
Comptes
- Àmbit: url:GET|/api/v1/accounts/:account_id/sub_accounts
- Descripció: Llista els comptes que són subcomptes del compte indicat.
- Àmbit: url:GET|/api/v1/accounts/:account_id/courses
- Descripció: Recupera una llista paginada de cursos d’aquest compte.
Usuaris
- Àmbit: url:GET|/api/v1/users/:id
- Descripció: Mostra detalls d’un usuari específicat.
- Àmbit: url:GET|/api/v1/users/:user_id/profile
- Descripció: Retorna dades del perfil de l’usuari, incloent ID d’usuari, nom i URL de la imatge d’avatar
Admins
- Àmbit: url:GET|/api/v1/accounts/:account_id/admins
- Descripció: Una llista paginada dels administradors del compte.
Registre de canvis de notes
- Àmbit: url:GET|/api/v1/audit/grade_change/courses/:course_id
- Descripció: Llista els esdeveniments de canvi de nota per a un curs determinat.
Cursos
- Àmbit: url:GET|/api/v1/courses/:id
- Descripció: Retorna informació d’un sol curs.
- Àmbit: url:GET|/api/v1/courses/:course_id/users
- Descripció: Retorna una llista paginada d’usuaris d’un curs.
Rols
- Àmbit: url:GET|/api/v1/accounts/:account_id/roles
- Descripció: Una llista paginada dels rols disponibles per a un compte.
Inscripcions
- Àmbit: url:GET|/api/v1/courses/:course_id/enrollments
- Descripció: Retorna una llista paginada de totes les inscripcions en un curs.
Grups
- Àmbit: url:GET|/api/v1/courses/:course_id/groups
- Descripció: Retorna la llista paginada de grups actius en el context donat que són visibles per a l'usuari.
- Àmbit: url:GET|/api/v1/groups/:group_id/users
- Descripció: Retorna una llista paginada d'usuaris en el grup.
Seccions
- Àmbit: url:GET|/api/v1/courses/:course_id/sections
- Descripció: Una llista paginada de les seccions d'aquest curs.
Assignacions
- Àmbit: url:GET|/api/v1/courses/:course_id/assignments
- Descripció: Retorna la llista paginada d'assignacions per al curs o grup d'assignacions actual.
- Àmbit: url:GET|/api/v1/courses/:course_id/assignments/:id
- Descripció: Retorna l'assignació amb l'identificador donat.
- Àmbit: url:POST|/api/v1/courses/:course_id/assignments
- Descripció: Crea una nova assignació per a aquest curs. L'assignació es crea en estat actiu.
- Àmbit: url:PUT|/api/v1/courses/:course_id/assignments/:id
- Descripció: Modificar una tasca existent.
- Àmbit: url:DELETE|/api/v1/courses/:course_id/assignments/:id
- Descripció: Eliminar la tasca indicada.
Enviaments
- Àmbit: url:GET|/api/v1/courses/:course_id/assignments/:assignment_id/submissions
- Descripció: Retorna una llista paginada de tots els enviaments existents per a una tasca.
- Àmbit: url:PUT|/api/v1/courses/:course_id/assignments/:assignment_id/submissions/:user_id
- Descripció: Comentar i/o actualitzar la qualificació d’un enviament de tasca d’un estudiant. Si es proporcionen arguments de submission o rubric_assessment, l’usuari ha de tenir permís per gestionar qualificacions en el context adequat (curs o secció).
Temes de discussió
- Àmbit: url:GET|/api/v1/courses/:course_id/discussion_topics
- Descripció: Retorna la llista paginada de temes de discussió per a aquest curs o grup.
- Àmbit: url:GET|/api/v1/courses/:course_id/discussion_topics/:topic_id/entries
- Descripció: Recupera les entrades de primer nivell (paginades) en un tema de discussió.
Qüestionaris
- Àmbit: url:GET|/api/v1/courses/:course_id/quizzes
- Descripció: Retorna la llista paginada de qüestionaris d’aquest curs.
Enviaments de qüestionaris
- Abast: url:GET|/api/v1/courses/:course_id/quizzes/:quiz_id/submissions
- Descripció: Obté una llista de totes les presentacions per a aquest qüestionari. Els usuaris que poden veure o gestionar les qualificacions d’un curs tindran presentacions de múltiples usuaris retornades. Un usuari que només pot presentar tindrà només les seves pròpies presentacions retornades. Quan un usuari té una presentació en curs, només es retorna aquesta presentació. Quan no hi ha cap presentació de qüestionari en curs, es retornen totes les presentacions completades, incloent intents anteriors.
A més, els usuaris de l’App Mòbil Qwickly Attendance Student també haurien d’aplicar l’abast següent:
Cursos
- Abast: url:GET|/api/v1/users/:user_id/courses
- Descripció: Retorna una llista paginada de cursos per a l’estudiant indicat.
Resolució de problemes: Error “invalid_scope”
Si la teva institució aplica restriccions d’abast LTI i un o més abasts requerits no estan habilitats, pot aparèixer un error “invalid_scope” en iniciar l’aplicació.
Aquest error indica que Canvas no ha concedit tots els permisos necessaris perquè la integració funcioni correctament.
Exemple de missatge d’error:
Com resoldre aquest problema
Revisa el missatge d’error que apareix a la pàgina.
Localitza l’URL d’abast subratllat (per exemple:
url:GET|/api/v1/accounts/:account_id/courses).Aquest URL identifica el permís específic que falta.
-
Actualitza la teva Clau de Desenvolupador LTI o la configuració de la integració a Canvas per incloure l’abast que falta:
Inicieu sessió a Canvas com a administrador.
Navegueu a Admin → Claus de desenvolupador.
Localitzeu la clau de desenvolupador que s’utilitza per a la integració de Qwickly Attendance.
Seleccioneu Edita la clau.
A la secció Àmbits, assegureu-vos que l’àmbit que falta i que es mostra al missatge d’error està habilitat.
Deseu els canvis.
Torneu a llançar l’eina Qwickly Attendance.
Deseu els canvis i torneu a llançar l’aplicació.
Notes addicionals
L’URL de l’àmbit subratllat proporciona informació precisa sobre quin permís s’ha d’habilitar.
El vostre administrador de Canvas pot necessitar actualitzar aquests ajustos si no hi teniu accés.
Si no esteu segur de com actualitzar els àmbits, poseu-vos en contacte amb el vostre administrador de Canvas o amb el vostre representant de suport de Qwickly.
Comentaris
0 comentaris
Iniciï sessió per deixar un comentari.