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
 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


Copyright © 2020. All rights reserved.