Paso 1 - Registrar la herramienta en Brightspace Brightspace
El primer paso lo realiza por completo un administrador de la plataforma dentro de Brightspace. Registraras DrillBit como una nueva herramienta externa LTI 1.3, la apuntaras a los endpoints de DrillBit, habilitaras las extensiones que DrillBit necesita, agregaras los parametros de sustitucion que pasan el contexto del curso / usuario en cada lanzamiento y terminaras guardando el Client ID generado para el siguiente paso.
1. Abrir la pagina de registro de LTI Advantage
- Inicia sesion en Brightspace como Administrador.
- Abre Admin Tools (el icono de engranaje en la barra superior).
- Selecciona Manage Extensibility.
- Cambia a la pestana LTI Advantage.
- Haz clic en Register Tool y elige Standard cuando se te pregunte como deseas registrar la herramienta.
2. Introducir los endpoints de DrillBit
En el formulario de registro, completa los siguientes campos con las URL exactas de DrillBit que aparecen a continuacion. Son las mismas para todos los clientes de Brightspace:
| Name | Drillbit Plagiarism Tool |
|---|---|
| Description | Drillbit Plagiarism LTI Advantage Tool Provider |
| Domain | https://lti.drillbitplagiarismcheck.com |
| Redirect URLs | https://lti.drillbitplagiarismcheck.com/lti/launch |
| OpenID Connect Login URL | https://lti.drillbitplagiarismcheck.com/lti/login |
| Target Link URI | https://lti.drillbitplagiarismcheck.com/lti/launch |
| Keyset URL | https://lti.drillbitplagiarismcheck.com/lti/keyset |
Asegurate de que el interruptor Enabled en la parte superior del formulario este activado.
3. Habilitar las extensiones requeridas
En la seccion Extensions, marca las tres:
- Assignment and Grade Services - permite que DrillBit devuelva las puntuaciones de similitud al libro de calificaciones de Brightspace.
- Deep Linking - permite que la herramienta cree el Quicklink que los instructores adjuntan al contenido del curso.
- Names and Role Provisioning Services - permite que DrillBit identifique al estudiante / instructor detras de cada lanzamiento.
En Roles, habilita Send Institution Role - DrillBit lo usa para distinguir a los instructores de los estudiantes.
4. Agregar parametros de sustitucion
En la seccion Substitution Parameters, agrega los siguientes pares nombre / valor para que Brightspace pase el contexto correcto a DrillBit en cada lanzamiento:
| user_name | $User.username |
|---|---|
| user_id | $User.id |
| course_title | $CourseOffering.title |
| resource_title | $ResourceLink.title |
| resource_description | $ResourceLink.description |
| resource_start_time | $ResourceLink.available.startDateTime |
| resource_end_time | $ResourceLink.available.endDateTime |
| resource_submission_end_time | $ResourceLink.submission.endDateTime |
5. Registrar y copiar las credenciales
- Haz clic en Register en la parte inferior del formulario.
- Brightspace abrira el dialogo Brightspace Registration Details que contiene un Client ID generado y las URL que necesitaras del lado de DrillBit.
- Copia cada valor a continuacion - los pegaras en DrillBit en el siguiente paso:
- Client Id
- Brightspace Keyset URL
- Brightspace OAuth2 Access Token URL
- OpenID Connect Authentication Endpoint
- Brightspace OAuth2 Audience
- Issuer
Guarda el Client ID en un lugar seguro antes de cerrar el dialogo. Puedes volver a Tool Details para copiarlo de nuevo, pero el siguiente paso (configurar DrillBit) no puede continuar sin el.
Registro completo. Continua con Paso 2 - Habilitar Brightspace dentro de DrillBit para conectar el lado de la integracion de DrillBit.