Resumen
Qwickly Attendance para Canvas funciona correctamente sin necesidad de aplicar restricciones de permisos (scopes), aunque algunas instituciones optan por hacerlo por políticas de seguridad. Si se habilitan estas restricciones, es crucial que la clave de desarrollador incluya todos los permisos necesarios para evitar errores como "invalid_scope" al iniciar la aplicación. Además, se detallan los permisos específicos requeridos y cómo solucionar problemas relacionados con la configuración de estos scopes.
No es obligatorio aplicar ámbitos para usar Qwickly Attendance con Canvas.
Por defecto, Qwickly Attendance funcionará correctamente sin habilitar Aplicar Ámbitos en la clave de desarrollador de Canvas. La mayoría de las instituciones pueden completar su integración sin modificar la configuración de ámbitos.
Algunas instituciones eligen aplicar ámbitos como parte de sus políticas internas de seguridad. Si su institución ha habilitado Aplicar Ámbitos, debe asegurarse de que la clave de desarrollador de Qwickly Attendance incluya todos los permisos requeridos. Sin los ámbitos necesarios, los usuarios pueden encontrar un error “invalid_scope” al iniciar la aplicación.
¿Cómo sé si se aplican los ámbitos?
En Canvas, navegue a Administrador > Claves de desarrollador > Clave API de Qwickly Attendance > icono de lápiz para editar. Si los ámbitos están habilitados, verá el interruptor 'Aplicar Ámbitos' activado:
Nota importante: Si está usando una clave de desarrollador con ámbitos aplicados, asegúrese de marcar la casilla etiquetada como "Permitir parámetros Include"
Permisos requeridos
Si su institución aplica ámbitos, los siguientes permisos deben estar habilitados en la Clave de Desarrollador de Qwickly Attendance:
Cuentas
- Ámbito: url:GET|/api/v1/accounts/:account_id/sub_accounts
- Descripción: Lista las cuentas que son subcuentas de la cuenta dada.
- Ámbito: url:GET|/api/v1/accounts/:account_id/courses
- Descripción: Recupera una lista paginada de cursos en esta cuenta.
Usuarios
- Ámbito: url:GET|/api/v1/users/:id
- Descripción: Muestra detalles de un usuario especificado.
- Ámbito: url:GET|/api/v1/users/:user_id/profile
- Descripción: Devuelve datos del perfil del usuario, incluyendo ID de usuario, nombre y URL de la imagen del avatar
Administradores
- Ámbito: url:GET|/api/v1/accounts/:account_id/admins
- Descripción: Una lista paginada de los administradores en la cuenta.
Registro de Cambios de Calificaciones
- Ámbito: url:GET|/api/v1/audit/grade_change/courses/:course_id
- Descripción: Lista eventos de cambio de calificaciones para un curso dado.
Cursos
- Ámbito: url:GET|/api/v1/courses/:id
- Descripción: Devuelve información sobre un solo curso.
- Ámbito: url:GET|/api/v1/courses/:course_id/users
- Descripción: Devuelve una lista paginada de usuarios en un curso.
Roles
- Ámbito: url:GET|/api/v1/accounts/:account_id/roles
- Descripción: Una lista paginada de los roles disponibles para una cuenta.
Inscripciones
- Ámbito: url:GET|/api/v1/courses/:course_id/enrollments
- Descripción: Devuelve una lista paginada de todas las inscripciones en un curso.
Grupos
- Ámbito: url:GET|/api/v1/courses/:course_id/groups
- Descripción: Devuelve la lista paginada de grupos activos en el contexto dado que son visibles para el usuario.
- Ámbito: url:GET|/api/v1/groups/:group_id/users
- Descripción: Devuelve una lista paginada de usuarios en el grupo.
Secciones
- Ámbito: url:GET|/api/v1/courses/:course_id/sections
- Descripción: Una lista paginada de las secciones de este curso.
Tareas
- Ámbito: url:GET|/api/v1/courses/:course_id/assignments
- Descripción: Devuelve la lista paginada de tareas para el curso actual o grupo de tareas.
- Ámbito: url:GET|/api/v1/courses/:course_id/assignments/:id
- Descripción: Devuelve la tarea con el id dado.
- Ámbito: url:POST|/api/v1/courses/:course_id/assignments
- Descripción: Crea una nueva tarea para este curso. La tarea se crea en estado activo.
- Ámbito: url:PUT|/api/v1/courses/:course_id/assignments/:id
- Descripción: Modificar una tarea existente.
- Ámbito: url:DELETE|/api/v1/courses/:course_id/assignments/:id
- Descripción: Eliminar la tarea indicada.
Entregas
- Ámbito: url:GET|/api/v1/courses/:course_id/assignments/:assignment_id/submissions
- Descripción: Devuelve una lista paginada de todas las entregas existentes para una tarea.
- Ámbito: url:PUT|/api/v1/courses/:course_id/assignments/:assignment_id/submissions/:user_id
- Descripción: Comentar y/o actualizar la calificación de la entrega de un estudiante para una tarea. Si se proporcionan argumentos de entrega o evaluación de rúbrica, el usuario debe tener permiso para gestionar calificaciones en el contexto correspondiente (curso o sección).
Temas de discusión
- Ámbito: url:GET|/api/v1/courses/:course_id/discussion_topics
- Descripción: Devuelve la lista paginada de temas de discusión para este curso o grupo.
- Ámbito: url:GET|/api/v1/courses/:course_id/discussion_topics/:topic_id/entries
- Descripción: Recuperar las entradas de primer nivel (paginadas) en un tema de discusión.
Cuestionarios
- Ámbito: url:GET|/api/v1/courses/:course_id/quizzes
- Descripción: Devuelve la lista paginada de cuestionarios en este curso.
Entregas de cuestionarios
- Alcance: url:GET|/api/v1/courses/:course_id/quizzes/:quiz_id/submissions
- Descripción: Obtiene una lista de todas las entregas para este cuestionario. Los usuarios que pueden ver o gestionar las calificaciones de un curso tendrán entregas de múltiples usuarios devueltas. Un usuario que solo puede enviar tendrá solo sus propias entregas devueltas. Cuando un usuario tiene una entrega en progreso, solo se devuelve esa entrega. Cuando no hay una entrega de cuestionario en progreso, se devuelven todas las entregas completadas, incluidos intentos anteriores.
Además, los usuarios de la aplicación móvil Qwickly Attendance Student también deben aplicar el siguiente alcance:
Cursos
- Alcance: url:GET|/api/v1/users/:user_id/courses
- Descripción: Devuelve una lista paginada de cursos para el estudiante dado.
Solución de problemas: Error “invalid_scope”
Si su institución aplica restricciones de alcance LTI y uno o más alcances requeridos no están habilitados, puede encontrar un error “invalid_scope” al iniciar la aplicación.
Este error indica que Canvas no ha concedido todos los permisos necesarios para que la integración funcione correctamente.
Ejemplo de mensaje de error:
Cómo resolver este problema
Revise el mensaje de error que se muestra en la página.
Ubique la URL de alcance subrayada (por ejemplo:
url:GET|/api/v1/accounts/:account_id/courses).Esta URL identifica el permiso específico que falta.
-
Actualice su Clave de Desarrollador LTI o la configuración de integración en Canvas para incluir el alcance que falta:
Inicie sesión en Canvas como administrador.
Navegue a Admin → Developer Keys.
Ubique la clave de desarrollador utilizada para la integración de Qwickly Attendance.
Seleccione Editar clave.
En la sección Scopes, asegúrese de que el ámbito faltante que se muestra en el mensaje de error esté habilitado.
Guarde los cambios.
Reinicie la herramienta Qwickly Attendance.
Guarde sus cambios y reinicie la aplicación.
Notas adicionales
La URL del ámbito subrayado proporciona información precisa sobre qué permiso debe estar habilitado.
Su administrador de Canvas puede necesitar actualizar estas configuraciones si usted no tiene acceso.
Si no está seguro de cómo actualizar los ámbitos, comuníquese con su administrador de Canvas o con su representante de soporte de Qwickly.
Comentarios
0 comentarios
Inicie sesión para dejar un comentario.