Audit log

Get an audit log signing key (all configuration) and on Encedo PPA only get a log list & files.

Allowed users

User

Allowed

Master

ExtAuth

Required access scope

Main

logger:get

Get a log signing key

Get a log signing key

GET https://my.ence.do/api/logger/key

Return a key used to sign the log file header as proof of the source's digital authenticity.

Headers

Name	Type	Description
Authorization*	String	Bearer JWT_TOKEN

Response status code

200 Operation successful

{
  "key": "T61jY1AgV5XUW++eAcQibRDFOl5KjKwLGdo+U0def8A=",
  "nonce": "P4M0YrCmPemejJg2zRYFPl4uZu7p8kG1IQDnrRHLMZg=",
  "nonce_signed": "/rgJmzoAbGLIQEg/meAxF2vrYWcvFnbeMNkaQDfS8RKvaBuj7/HPcObkz9X0HX+V53xyh8YJR+lJ6AO727PRBQ=="
}

401: Missing or invalid JWT_TOKEN

403: Incorrect access 'scope'

409: Incorrect internal state

Response data for successful operation

Name	Type	Description
key	String	Base64 encoded ED25519 public key
nonce	String	Base64 encoded random nonce
nonce_signed	String	Base64 encoded ED25519 signature of the nonce.

Log entries

Event	Result	Source
LOG_TYPE_FAILED_SCOPE_CHECK	LOG_RESULT_FAILED	403

Get a list of log entries

Embedded Flash Drive is available on Encedo PPA only. On Encedo EPA these two endpoints are not available, response code 404 will be returned.

Get a list of logs

GET https://my.ence.do/api/logger/list/:offset

Get a list of available log files.

Path Parameters

Name	Type	Description
offset	Number	Skip 'offset' logs entries

Headers

Name	Type	Description
Authorization*	String	Bearer JWT_TOKEN

Response status code

200: Operation successful

{
  "total": 3,
  "id": ["62310b2b", "62310bf6", "6231f603"]
}

401: Missing or invalid access token

403: Incorrect access scope

404: Missing log entries

406: Operation failed

409: Incorrect internal state

Response data for successful operation

Name	Type	Description
total	Number	Total number of logs entries.
id	Array of strings	An array of logs File IDs

Log entries

Event	Result	Source
LOG_TYPE_FAILED_SCOPE_CHECK	LOG_RESULT_FAILED	403
LOG_TYPE_LOGGER_LIST_LOG	LOG_RESULT_OK	200
LOG_TYPE_LOGGER_LIST_LOG	LOG_RESULT_FAILED	404

A maximum of 128 log entries are returned by one call. Use the offsetargument for pagination.

Get a log file

Embedded Flash Drive is available on Encedo PPA only. On Encedo EPA these two endpoints are not available, response code 404 will be returned.

Get a log file

GET https://my.ence.do/api/logger/:id

Get a log file for a given ID.

Path Parameters

Name	Type	Description
id*	String	File ID e.g. "62310b2b"

Headers

Name	Type	Description
Authorization*	String	Bearer JWT_TOKEN

Response status code

200: File content retrieved

# Encedo HEM v0.9.77 (#ff0a263)
0|62310ba5|0|0|NgPWx9MnmngrKa7xkSuQnDcwBlDV5JeR0OoX6gFyMpo|sMfJhY2jjkQLb7dVGlWf_GynEOTZVh5tO33k8Iq52jB0CAECs1ysU3NenhlmWBWyTo1XEaqL-ysBVB7quNHDBA|XEwWbRXrh65JPjAjb-9bwg
1|62310ba5|1|0|||rfB1gKL0hTi5tGh8PDerAA
2|62310ba5|7|0|||dsutQDgmuLtecPIwPDctdA
3|62310ba5|13|0||NQsxYg|bODm1bUzTiX6qS7LheDJFA
4|62310ba6|1d|0|M||9b_vMf0QXC-qEhi-kQ4zpg
5|62310bdd|12|0|U||Rhwgm9ZQx-RGfrjESNxhDQ
6|62310c0c|2|0|U||IhCfo8F_OHBLhgOGXE5vPA

401: Missing or invalid JWT_TOKEN

403: Incorrect access scope

404: File not found

406: Operation failed (e.g. file busy)

409: Incorrect internal state

Log entries

Event	Result	Source
LOG_TYPE_FAILED_SCOPE_CHECK	LOG_RESULT_FAILED	403
LOG_TYPE_LOGGER_READ_LOG	LOG_RESULT_OK	200
LOG_TYPE_LOGGER_READ_LOG	LOG_RESULT_FAILED	404