Resumen
Qwickly Attendance para Canvas funciona correctamente sin necesidad de aplicar la opción de "Enforce Scopes" en la clave de desarrollador, aunque algunas instituciones pueden requerirlo por políticas de seguridad. Si se habilita esta opción, es crucial que la clave incluya todos los permisos necesarios para evitar errores como "invalid_scope" al usar la aplicación.
Hacer cumplir los ámbitos no es obligatorio para usar Qwickly Attendance con Canvas.
Por defecto, Qwickly Attendance funcionará correctamente sin habilitar Hacer cumplir los á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 los ámbitos.
Algunas instituciones eligen hacer cumplir los ámbitos como parte de sus políticas internas de seguridad. Si su institución ha habilitado Hacer cumplir los á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 los ámbitos están siendo aplicados?
En Canvas, navegue a Admin > Claves de desarrollador > Clave API de Qwickly Attendance > icono de lápiz para editar. Si los ámbitos están habilitados, verá el interruptor 'Hacer cumplir los ámbitos' activado:
Nota importante: Si está usando una clave de desarrollador con los ámbitos aplicados, asegúrese de marcar la casilla etiquetada "Permitir incluir parámetros"
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 curso individual.
- Á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 o grupo de tareas actual.
- Á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 una tarea de un estudiante. Si se proporcionan argumentos de entrega o evaluación de rúbrica, el usuario debe tener permiso para gestionar calificaciones en el contexto apropiado (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
- Ámbito: 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 recibirán entregas de múltiples usuarios. Un usuario que solo puede enviar tendrá solo sus propias entregas. 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 ámbito:
Cursos
- Ámbito: 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 ámbito LTI y uno o más ámbitos 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 del ámbito 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 ámbito 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 scope 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 scope subrayada 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 scopes, por favor contacte a su administrador de Canvas o a su representante de soporte de Qwickly.
Comentarios
0 comentarios
Inicie sesión para dejar un comentario.