Blackboard Academic Suite™ Manual del administrador

Blackboard Academic Suite
Manual del administrador
Cómo decodificar un contexto codificado
Descripción general
Para codificar datos durante la transferencia de contexto, el Blackboard Learning
System y el URL externo deben tener acceso a la misma clave de codificación de
contexto. La clave debe crearse desde la función Administrar clave de codificación de
contexto, disponible en el Panel de administración. Después de crearse, la clave se
debe descargar y distribuir a los servidores externos que aceptarán el contexto.
Ejemplo de código
Después de descargar una clave de codificación de contexto, ésta debe establecerse
como disponible para el URL que recibirá los datos codificados a través de la
transferencia de contexto. El ejemplo de código que figura a continuación muestra
cómo decodificar programáticamente datos de contexto codificados en el URL externo
cuando son transferidos.
El objeto indicado por el URL de destino (en este caso, index.jsp) podría decodificar el
contexto de la siguiente manera (importando blackboard.client.decryption.*):
Contexto en cadena = request.getParameter(“contexto”);
//si isEncryptionEnabled = falso, se utilizará la codificación base 64 en
lugar de
//la codificación
específica (booleana) isEncryptionEnabled = verdadero;
ContextDecryptor bfd =
ContextDecryptorFactory.getContextDecryptor(isEncryptionEnabled );
// recupere la clave de codificación de Blackboard como un archivo o
InputStream
Clave de archivo = archivo nuevo ( strKeyLocation );
// o clave InputStream = // detalle de implementación…
// para decodificar en forma simple la cadena de contexto:
Cadena decryptedContext = bfd.decrypt (contexto, clave );
// o, para obtener un HashMap de todos los pares clave-valor
mapa HashMap = bfd.parseEncryptedContext (contexto, clave );
// entonces buscar el HashMap de un valor esperado, y continuar.
si (map.containsKey(“usuario” )
{ // ejecutar…
}
Cómo resolver varias claves
El ejemplo de código que figura anteriormente es útil cuando existe una relación uno a
uno entre el URL y el Blackboard Learning System. En los casos en que un URL
externo se relaciona con un Building Block en varias instancias del Blackboard
Learning System, es posible utilizar el nombre de host de la instancia para manejar
varias claves.
En el ejemplo que figura a continuación, la clave se encuentra a través de la
asociación con el nombre de host de la instancia o instalación virtual del Blackboard
Learning System. En este caso el nombre de host es fisica.suinstitucion.com. Debido
a que el código de decodificación cliente tiene la posibilidad de transferir una clave de
decodificación al objeto ContextDecryptor, el servidor cliente debe poder asignar un
nombre de host a la clave apropiada (a la que generalmente se accede como a un
archivo, pero que puede ser una InputStream).
Los programadores del servidor de Building Block pueden escribir un simple
empaquetador que:
© 2004 Blackboard Inc. Propiedad intelectual y confidencial página 208