Skip to content

Most visited

Recently visited

navigation

MediaDrm.CryptoSession

public final class MediaDrm.CryptoSession
extends Object

java.lang.Object
   ↳ android.media.MediaDrm.CryptoSession


In addition to supporting decryption of DASH Common Encrypted Media, the MediaDrm APIs provide the ability to securely deliver session keys from an operator's session key server to a client device, based on the factory-installed root of trust, and then perform encrypt, decrypt, sign and verify operations with the session key on arbitrary user data.

The CryptoSession class implements generic encrypt/decrypt/sign/verify methods based on the established session keys. These keys are exchanged using the getKeyRequest/provideKeyResponse methods.

Applications of this capability could include securing various types of purchased or private content, such as applications, books and other media, photos or media delivery protocols.

Operators can create session key servers that are functionally similar to a license key server, except that instead of receiving license key requests and providing encrypted content keys which are used specifically to decrypt A/V media content, the session key server receives session key requests and provides encrypted session keys which can be used for general purpose crypto operations.

A CryptoSession is obtained using getCryptoSession(byte[], String, String)

Summary

Public methods

byte[] decrypt(byte[] keyid, byte[] input, byte[] iv)

Decrypt data using the CryptoSessions's cipher algorithm

byte[] encrypt(byte[] keyid, byte[] input, byte[] iv)

Encrypt data using the CryptoSession's cipher algorithm

byte[] sign(byte[] keyid, byte[] message)

Sign data using the CryptoSessions's mac algorithm.

boolean verify(byte[] keyid, byte[] message, byte[] signature)

Verify a signature using the CryptoSessions's mac algorithm.

Inherited methods

From class java.lang.Object

Public methods

decrypt

Added in API level 18
byte[] decrypt (byte[] keyid, 
                byte[] input, 
                byte[] iv)

Decrypt data using the CryptoSessions's cipher algorithm

Parameters
keyid byte: specifies which key to use
input byte: the data to encrypt
iv byte: the initialization vector to use for the cipher
Returns
byte[]

encrypt

Added in API level 18
byte[] encrypt (byte[] keyid, 
                byte[] input, 
                byte[] iv)

Encrypt data using the CryptoSession's cipher algorithm

Parameters
keyid byte: specifies which key to use
input byte: the data to encrypt
iv byte: the initialization vector to use for the cipher
Returns
byte[]

sign

Added in API level 18
byte[] sign (byte[] keyid, 
                byte[] message)

Sign data using the CryptoSessions's mac algorithm.

Parameters
keyid byte: specifies which key to use
message byte: the data for which a signature is to be computed
Returns
byte[]

verify

Added in API level 18
boolean verify (byte[] keyid, 
                byte[] message, 
                byte[] signature)

Verify a signature using the CryptoSessions's mac algorithm. Return true if the signatures match, false if they do no.

Parameters
keyid byte: specifies which key to use
message byte: the data to verify
signature byte: the reference signature which will be compared with the computed signature
Returns
boolean
This site uses cookies to store your preferences for site-specific language and display options.

Hooray!

This class requires API level or higher

This doc is hidden because your selected API level for the documentation is . You can change the documentation API level with the selector above the left navigation.

For more information about specifying the API level your app requires, read Supporting Different Platform Versions.

Take a one-minute survey?
Help us improve Android tools and documentation.