Resum
Qwickly Attendance per Canvas funciona correctament sense aplicar restriccions de permisos, però si la institució activa l'opció "Enforce Scopes", cal assegurar que la clau de desenvolupador inclogui tots els permisos necessaris per evitar errors "invalid_scope". L'article detalla els permisos requerits i com solucionar possibles problemes relacionats amb la configuració de 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 els à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 necessaris. Sense els àmbits requerits, els usuaris poden trobar un error “invalid_scope” quan inicien 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 de comptes que són subcomptes del compte indicat.
- Àmbit: url:GET|/api/v1/accounts/:account_id/courses
- Descripció: Recupera una llista paginada de cursos en aquest compte.
Usuaris
- Àmbit: url:GET|/api/v1/users/:id
- Descripció: Mostra detalls d’un usuari especificat.
- À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 de l’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 d’esdeveniments de canvi de nota per a un curs donat.
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 en 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.
Presentacions
- Àmbit: url:GET|/api/v1/courses/:course_id/assignments/:assignment_id/submissions
- Descripció: Retorna una llista paginada de totes les presentacions 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’una presentació d’una tasca d’un estudiant. Si es proporcionen arguments de presentació o avaluació de rúbrica, l’usuari ha de tenir permís per gestionar les 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ó: Recuperar 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.
Presentacions de Qüestionaris
- Àmbit: url:GET|/api/v1/courses/:course_id/quizzes/:quiz_id/submissions
- Descripció: Obtenir una llista de totes les presentacions per a aquest qüestionari. Els usuaris que poden veure o gestionar les qualificacions d’un curs tindran les 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, incloses les intents anteriors.
A més, els usuaris de l’App mòbil Qwickly Attendance Student també haurien d’aplicar l’últim àmbit següent:
Cursos
- Àmbit: 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 vostra institució aplica restriccions d’àmbit LTI i un o més àmbits requerits no estan habilitats, podeu trobar 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
Reviseu el missatge d’error que apareix a la pàgina.
Localitzeu l’URL d’àmbit subratllat (per exemple:
url:GET|/api/v1/accounts/:account_id/courses).Aquest URL identifica el permís específic que falta.
-
Actualitzeu la vostra clau de desenvolupador LTI o la configuració de la integració a Canvas per incloure l’àmbit 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 Editar 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.
Pot ser que l’administrador de Canvas hagi d’actualitzar aquests paràmetres si no hi teniu accés.
Si no esteu segur de com actualitzar els àmbits, poseu-vos en contacte amb l’administrador de Canvas o amb el vostre representant de suport de Qwickly.
Comentaris
0 comentaris
Iniciï sessió per deixar un comentari.