Cifrado de extremo a extremo
Este tema incluye información detallada sobre el uso del cifrado de extremo a extremo en el Client SDK de Vonage Video para Android:
- Configuración del secreto de cifrado
- Sucesos y errores
- Establecer una clave secreta en una sesión sin cifrado de extremo a extremo
Para obtener una visión general del cifrado de extremo a extremo, consulta este tema.
Configuración del secreto de cifrado
Las sesiones cifradas de extremo a extremo se crean mediante las API del servidor (véase Activación del cifrado mediante la API REST).
Antes de que el cliente publique o se suscriba, llame a la función Session.setEncryptionSecret() método:
session.setEncryptionSecret("encryption-secret");
session.connect(TOKEN);
Una clave válida es una cadena de entre 8 y 256 caracteres. Puedes cambiar la clave llamando a la función Session.setEncryptionSecret() función de nuevo.
Si se establece un secreto no válido, se producirá un InvalidEncryptionSecret error.
Sucesos y errores
Los eventos y errores son esenciales para gestionar el comportamiento del cifrado dirigido por el usuario. El cifrado de extremo a extremo utiliza el modelo de secreto compartido: se espera que todos los participantes en la sesión utilicen el mismo secreto para cifrar sus medios y descifrar los de los demás.
Si un cliente intenta conectarse a una sesión cifrada de extremo a extremo sin haber configurado un secreto de cifrado, el SessionListener.onError() El controlador de eventos se invoca con un código de error establecido en ErrorCode.EncryptionSecretMissing:
// Implementation of SessionListener.onError():
@Override
public void onError(Session session, OpentokError opentokError) {
if (opentokError.getErrorCode() == ErrorCode.EncryptionSecretMissing) {
// Notify the user that they cannot join the session
}
}
session.connect(token);
Si un usuario intenta publicar en una sesión cifrada de extremo a extremo sin haber especificado un secreto de cifrado, al llamar a la función Session.publish() da como resultado el método PublisherListener.onError() Se está llamando al controlador de eventos con un error cuyo código está establecido en ErrorCode.EncryptionSecretMissing. Para garantizar la mejor experiencia de usuario, la aplicación debería validar una clave secreta facilitada por el usuario antes de llamar a la Session.publish() método:
// Implementation of PublisherListener.onError():
@Override
public void onError(PublisherKit publisher, OpentokError opentokError) {
if (opentokError.getErrorCode() == ErrorCode.EncryptionInternalError) {
// The application should communicate that the secret was not set.
}
}
session.publish(publisher);
Si un suscriptor no puede descodificar el contenido multimedia de una transmisión debido a una clave de cifrado incorrecta, el SubscriberListener.onError() El controlador de eventos se activa con un error cuyo código está establecido en ErrorCode.EncryptionSecretMismatch. Es importante comunicar al usuario que los medios no se están recibiendo debido a un desajuste de cifrado y no a un fallo de conexión o a un problema de audio/vídeo:
// Implementation of Subscriber.onError():
@Override
public void onError(SubscriberKit publisher, OpentokError opentokError) {
if (opentokError.getErrorCode() == ErrorCode.EncryptionSecretMismatch) {
// Activate a UI element communicating that there's been an encryption secret mismatch.
}
}
session.subscribe(subscriber);
Si la aplicación intenta suscribirse sin configurar un secreto de cifrado, el Subscriber.onError() El controlador de eventos se activa con un error cuyo código está establecido en ErrorCode.EncryptionSecretMissing.
Si un abonado encuentra un error interno al descifrar un paquete, el Subscriber.onError() El controlador de eventos se activa con un error cuyo código está establecido en ErrorCode.DecryptionInternalError.
Establecer una clave secreta en una sesión sin cifrado de extremo a extremo
Nota: Esta función está disponible a partir de la versión 2.36.0 del SDK.
Si una sesión no se ha creado con el cifrado de extremo a extremo activado, al establecer un secreto de cifrado para ella se produce un ErrorCode.EncryptionNotEnabled error. El momento en que se produce el error depende de cuándo se establece el secreto en relación con la conexión, la publicación y la suscripción.
Configuración de la clave secreta antes de conectarse
Solo se sabe si una sesión tiene activado el cifrado de extremo a extremo una vez que el cliente se conecta. Si llamas a Session.setEncryptionSecret() Antes de establecer la conexión, la llamada se realiza con éxito y la sesión se establece con normalidad. El error se produce cuando el cliente publica o se suscribe: al llamar a Session.publish() o Session.subscribe() da lugar a la SessionListener.onError() Se está llamando al controlador de eventos con un error cuyo código está establecido en ErrorCode.EncryptionNotEnabled:
// Implementation of SessionListener.onError():
@Override
public void onError(Session session, OpentokError opentokError) {
if (opentokError.getErrorCode() == ErrorCode.EncryptionNotEnabled) {
// The application should communicate that end-to-end encryption
// is not enabled for this session.
}
}
session.setEncryptionSecret("encryption-secret");
session.connect(TOKEN);
// ...
session.publish(publisher);
Configuración de la clave secreta tras la conexión
Si llamas Session.setEncryptionSecret() Una vez que el cliente se ha conectado a una sesión sin cifrado de extremo a extremo, el secreto no se establece y el SessionListener.onError() El controlador de eventos se activa con un error cuyo código está establecido en ErrorCode.EncryptionNotEnabled.
Configuración de la clave secreta al publicar o suscribirse
Si llamas Session.setEncryptionSecret() Mientras el cliente ya esté publicando o suscrito, la llamada falla tal y como se ha descrito anteriormente, y todos los editores y suscriptores activos también se eliminan de la sesión. Cada uno de ellos notifica el error a través de su propio onError() controlador de eventos — PublisherListener.onError() para editoriales y SubscriberListener.onError() para suscriptores — con el código establecido en ErrorCode.EncryptionNotEnabled:
// Implementation of PublisherListener.onError():
@Override
public void onError(PublisherKit publisher, OpentokError opentokError) {
if (opentokError.getErrorCode() == ErrorCode.EncryptionNotEnabled) {
// The publisher has been removed from the session.
}
}
// Implementation of SubscriberListener.onError():
@Override
public void onError(SubscriberKit subscriber, OpentokError opentokError) {
if (opentokError.getErrorCode() == ErrorCode.EncryptionNotEnabled) {
// The subscriber has been removed from the session.
}
}
Recuperación tras el error
La sesión sigue siendo válida tras cualquiera de estos errores. Para volver a publicar o suscribirte, borra el secreto llamando a Session.setEncryptionSecret() con null. A continuación, ese mismo objeto PublisherKit se puede pasar a Session.publish() otra vez:
session.setEncryptionSecret(null);
session.publish(publisher);