com.baidubce.services.iothisk.device.seplatform

Interface SecureElement

All Known Implementing Classes:

MbedAkeySe

public interface SecureElement

Secure element interfaces. It defines secure element basic operation interfaces, including encryption, decryption, sign signature and message parsing.

Method Summary

Modifier and Type	Method and Description
void	checkActiveMessage(ActiveMessage activeMessage) Valid active message with secure element.
byte[]	decrypt(byte[] encryption) Decrypt encrypted message
CipherMessage	encryptThenSign(PlainMessage plainMessage) Encrypt and sign provided plain message
CipherMessage	encryptThenSign(PlainMessage plainMessage, byte[] signPrivateKey) Encrypt plain message, and sign the signature with provided private key
String	generateId() Generate device unique id
ActiveMessage	parseActiveMessage(byte[] activeMessage) Parse byte array active message
CipherMessage	parseCipherMessage(byte[] cipherMessage) Parse byte array cipher message.
PlainMessage	parsePlainMessage(byte[] plainMessage) Parse byte array plain message.
void	verifySignature(byte[] message, byte[] signature) Verify message signature.
PlainMessage	verifyThenDecrypt(CipherMessage cipherMessage) Verify message and decrypt cipher message.

Method Detail

generateId

String generateId()

Generate device unique id

Returns:

device unique id in ascii encoding

encryptThenSign

CipherMessage encryptThenSign(PlainMessage plainMessage)

Encrypt and sign provided plain message

Parameters:

plainMessage - specified plain message

Returns:

cipher message, including encrypted message and its signature

encryptThenSign

CipherMessage encryptThenSign(PlainMessage plainMessage,
                              byte[] signPrivateKey)

Encrypt plain message, and sign the signature with provided private key

Parameters:

plainMessage - specified plain message

signPrivateKey - specified signature private key

Returns:

cipher message, including encrypted message and its signature

decrypt

byte[] decrypt(byte[] encryption)

Decrypt encrypted message

Parameters:

encryption - specified encrypted message in byte array

Returns:

plain message in byte array

verifySignature

void verifySignature(byte[] message,
                     byte[] signature)

Verify message signature. If failed, an exception will be thrown.

Parameters:

message - specified message in byte array

signature - specified signature in byte array

verifyThenDecrypt

PlainMessage verifyThenDecrypt(CipherMessage cipherMessage)

Verify message and decrypt cipher message.

Parameters:

cipherMessage - specified cipher message

Returns:

plain message decrypted from cipher message, if failed an exception will be thrown.

parseCipherMessage

CipherMessage parseCipherMessage(byte[] cipherMessage)

Parse byte array cipher message.

Parameters:

cipherMessage - specified cipher message in byte array

Returns:

cipher message object

parsePlainMessage

PlainMessage parsePlainMessage(byte[] plainMessage)

Parse byte array plain message.

Parameters:

plainMessage - specified plain message

Returns:

plain message object

parseActiveMessage

ActiveMessage parseActiveMessage(byte[] activeMessage)

Parse byte array active message

Parameters:

activeMessage - specified active message

Returns:

active message object

checkActiveMessage

void checkActiveMessage(ActiveMessage activeMessage)

Valid active message with secure element. If failed, an exception will be thrown.

Parameters:

activeMessage - specified active message