Genere un token de acceso de Ally

Ally necesita poder sincronizar datos como cursos y archivos de la API REST de Canvas para generar informes y proporcionar comentarios de profesores. Para hacer esto de forma segura, es necesario generar un token de acceso.

Esto solo está disponible para los administradores en el LMS Instructure Canvas.


Paso 1: cree un rol de cuenta nueva

Tener un rol de cuenta nueva le permite definir los permisos que tendrá el servicio de Ally. Si bien puede ver qué permisos, específicamente, se otorgan al servicio de Ally en la interfaz de administración de Canvas, en un nivel superior estos permisos habilitan a Ally para que descargue información sobre el archivo, el período y el curso, a fin de generar comentarios sobre la accesibilidad y versiones alternativas. Además, permite que Ally elimine y reemplace el contenido del archivo. Estas operaciones son importantes para ayudar a los profesores a remediar el contenido del curso.

  1. Ingrese a la instalación de Canvas como administrador.
  2. Seleccione el ícono Administrador que se encuentra a la izquierda y seleccione su cuenta en la ventana que se despliega.
  3. Seleccione Permisos y, luego, Roles de cuentas.
  4. Seleccione Agregar rol.
  5. Guarde un rol con el nombre Ally. Una vez que se guarde, debe aparecer una columna nueva llamada Ally en la tabla.
  6. En la columna Ally, habilite estos permisos.
    • Cursos: vista de lista
    • Usuarios: actuar como
    • Anuncios: ver
    • Tareas y pruebas: agregar, editar o eliminar
    • Contenido del curso: agregar, editar o eliminar
    • Contenido del curso: ver
    • Archivos del curso: agregar, editar o eliminar
    • Debates: moderar
    • Debates: ver
    • Páginas: agregar, editar o eliminar

Paso 2: cree un usuario nuevo

Crear un usuario nuevo para cada integración con Canvas se considera la mejor práctica. Si los usuarios de su institución se han creado directamente en Canvas, siga las siguientes instrucciones para hacerlo. Sin embargo, si los usuarios se administran en un sistema externo, como SIS o LDAP, siga el proceso para crear usuarios para usar en Canvas de su institución y, luego, proceda a otorgar al usuario nuevo el rol de Ally.

Si se crean usuarios directamente en Canvas para su institución, siga estos pasos.

  1. Diríjase a la página Usuarios debajo de la gestión de su cuenta.
  2. Seleccione Usuario nuevo y agregue un usuario nuevo llamado Ally.
  3. Asegúrese de que la casilla Enviar un correo electrónico al usuario sobre la creación de esta cuenta se encuentre seleccionada.
  4. Seleccione el enlace que recibió en la bandeja de entrada de su correo electrónico para verificar la cuenta.

Paso 3: otorgue al usuario nuevo el rol de Ally

  1. Diríjase a la página Ajustes debajo de la gestión de su cuenta.
  2. Seleccione Administradores.
  3. Seleccione el botón + administradores de la cuenta para agregar un usuario.
  4. Asegúrese de que, en el formulario que se abrió, el rol de Ally se encuentre seleccionado en el menú.
  5. Si, en su institución, los usuarios se crean directamente en Canvas, se le pedirá que ingrese la dirección de correo electrónico del usuario que creó en la sección anterior. Si se creó su usuario en un sistema externo, como SIS o LDAP, ingrese el identificador del usuario solicitado por Canvas en el campo.
  6. Seleccione Continuar…
  7. Si se encontró el usuario, seleccione Bien, todo en orden.
  8. Confirme que el usuario de Ally se agregó a la lista.

Paso 4: genere un token de acceso

En este paso final, generaremos un token de acceso que el servicio de Ally pueda utilizar para interactuar con la API REST de forma segura.

  1. Ingrese como el usuario de Ally.

    Durante estos pasos, no será posible hacerse pasar por el usuario de Ally, ya que Canvas no permite que los administradores configuren un token de acceso en nombre de otro usuario.

  2. Diríjase a los ajustes del usuario seleccionando Cuenta a la izquierda y, luego, el enlace Ajustes en la ventana nueva.
  3. Seleccione Token de acceso nuevo.
  4. Ingrese integración de Ally.ac como el propósito del token. Se puede dejar en blanco el campo de registro de la fecha de caducidad.
  5. Seleccione Generar token.
  6. Debe aparecer una ventana nueva que contenga el token de acceso. Copie el token ahora, ya que no podrá volver a acceder a él una vez que abandone esta página.