145
Web Services
The 1669 Picolo.net HD1 device can have its media store either
locked
or
unlocked
. When the
store is locked, files previously written aren’t decrypted and newly recorded clips are stored as
plain MP4 files. When the store is unlocked, AES decryption is applied to previous files and AES
encryption is applied to incoming clips recorded by the device.
The
LockAESStorage
and
UnlockAESStorage
methods of the
HD1RecordingProprietaryService
on the 1669 Picolo.net HD1 allows automation of the
switching between the two states of the media store.
Those services are complemented with a
GetAESStorageStatus
call that can be used to read
the current state of the media storage directory and its name on the USB media.
RELEVANT XSD ELEMENTS
<xs:element name="UnlockAESStorageRequest">
<xs:complexType>
<xs:sequence>
<xs:element name="PassPhrase" type="xs:string"/>
<xs:element name="Directory" type="xs:string"/>
</xs:sequence>
</xs:complexType>
</xs:element>
The ‘unlock storage’ message provides the passphrase as plain string and the directory on the
USB media that should be mounted (normally <device-serial-number>.<encoder-identifier>).
NOTE: using the
UnlockAESStorage
method will transmit the passphrase in clear text on
the network unless the caller has established an https session to deliver its request.
NOTE: given the amount of computations needed to convert the passphrase into the
appropriate master key, receiving the
UnlockAESStorageResponse
doesn’t guarantee
that the directory is effectively protected. To confirm that the directory is protected, the
caller should invoke
GetAESStorageStatus
and test the ‘encryption’ field.
<xs:simpleType name="EncryptionEnum">
<xs:restriction base="xs:string">
<xs:enumeration value="None"/>
<xs:enumeration value="AES128"/>
</xs:restriction>
</xs:simpleType>
<xs:element name="GetAESStorageStatusResponse">
<xs:complexType>
<xs:sequence>
<xs:element name="Directory" type="xs:string"/>
<xs:element name="encryption" type="tns:EncryptionEnum"/>
</xs:sequence>
</xs:complexType>
</xs:element>
Application Notes
Picolo.net
Handbook
