Skip to main content

Self-test

This operation performs an internal full self-test of the device's critical components, including cryptography primitives, random number generator and key repository integrity.

Allowed usersUser✓Master✓ExtAuth✓
Required access scopenone

Any. Only a valid access token is required; the access scope is not checked.

info

The Authorization header is not required on fresh, not personalised devices.

Get self-test status​

GEThttps://my.ence.do/api/system/selftest

Retrieve the latest self-test status and rerun a new full test (only if one is not already in progress).

Headers​

NameTypeDescription
AuthorizationStringBearer JWT_TOKEN

Response status code​

{
"last_selftest_ts": 1647615622,
"last_fls_state": 0,
"last_entropytest_ts": 1647615622,
"last_kat_ts": 1647606250,
"kat_busy": true,
"fls_state": 0,
"selftest_ts": 1647615642,
"se_state": 0
}

Response data for successful operation​

NameTypeDescription
fls_stateNumberFail state number, default 0 as 'no errors'.
kat_busyBoolTrue is KAT is ongoing.
last_entropytest_tsNumberLast entropy test timestamp.
last_fls_stateNumberLast fls_state.
last_kat_tsNumberLast KAT timestamp.
last_selftest_tsNumberLast selftest timestamp.
selftest_tsNumberCurrent selftest timestamp.
se_stateNumber(optional) Secure Enclave status (on Encedo PPA).
repo_statsObjectThe following items are part of this object
totalNumberNumber of used storage slots
deletedNumberNumber of used storage slots
invalidNumberNumber of invalid slots
fragmentedNumberNumber of deleted slots to defragment
freeslotsNumberNumber of free slots

Indirectly produced log entries​

EventResultSource
LOG_TYPE_TRNG_FAILEDLOG_RESULT_OKEntropy test failed
LOG_TYPE_KEY_INTEGRITY_ERRORLOG_RESULT_FAILEDKeystore integrity failed
LOG_TYPE_KEY_INTEGRITY_ERRORLOG_RESULT_OKKeystore integrity passed
LOG_TYPE_NON_SECURE_STATELOG_RESULT_OKEnter FLS state
LOG_TYPE_SELFTEST_PASSEDLOG_RESULT_FAILEDPowerup self-test failed
LOG_TYPE_SELFTEST_PASSEDLOG_RESULT_OKPowerup self-test passed