Una vez que has configurado tu integración REST en Blackboard, proporciona tu URL de instancia de Blackboard a tu representante de edX. edX configurará la integración de Blackboard en el sistema edX. Además, edX generará una nueva clave de API (identificación y secreto de cliente) en la aplicación registrada en el Portal para desarrolladores de Blackboard y utilizará esos valores para crear una URL de autorización para tu instancia de Blackboard.
A continuación, debes utilizar la URL de autorización proporcionada para permitir que el sistema edX publique metadatos del catálogo e información sobre la actividad del alumno en tu instancia de Blackboard.
La URL de autorización que edX te proporcionará será la siguiente:
<blackboard instance base url>/learn/api/public/v1/oauth2/authorizationcode?redirect_uri=https://courses.edx.org/blackboard/oauth-complete&scope=read%20write%20delete%20offline&response_type=code&client_id=<client_id>&state=<edx enterprise uuid>
Sustituiremos estos parámetros con tus propios valores:
- <blackboard instance base url> la URL de inquilino de Blackboard que proporcionas a edX
- <client_id> la clave API de aplicación recién generada proporcionada por edX
- <edX enterpirse uuid> el identificador único para tu perfil de cliente, proporcionado por edX
A modo de ejemplo, para la instancia de prueba de Blackboard de edX (con client_id abreviado), se ve así:
https://edx-test2.blackboard.com/learn/api/public/v1/oauth2/authorizationcode?redirect_uri=https://courses.edx.org/blackboard/oauth-complete&scope=read%20write%20delete%20offline&response_type=code&client_id=9391...ec47&state=8ea70d02-c210-4009-a86d-e23423dcda7d
Una vez que recibas tu URL de autorización de edX, visita esa URL en una ventana del navegador y haz clic en "Permitir". Esto permitirá al sistema edX generar y almacenar un token de actualización para su uso en futuras llamadas a API.
Verás una pantalla en blanco con una URL como esta:
https://courses.edx.org/blackboard/oauth-complete?code=xkCsQNG9jXPrfNhfUgHoYZWGyzUFZzrW&state=8ea70d02-c210-4009-a86d-e23423dcda7d
El sistema edX ahora puede crear, actualizar o eliminar cursos y publicar calificaciones en los cursos (a partir de los datos de calificaciones de edX).