DEPRECATED Please note that this repository is no longer used and will likely be removed at some point in the future. The information in this readme may be out of date or possibly misleading and should not be relied upon.
sde-recover
The sde-recover app is used within the Office National of Statistics (ONS) for manual recovery of Survey Data Exchange (SDE) Payloads.
Installation
In order to recover payloads that have encountered errors, make sure you have docker and docker-compose installed and follow the steps below:
- Check out the dockers repo.
- Check out Perkin, Posie and sde-console within the dockers folder created.
- Make sure you have a folder containing each of the required keys under the 'jwt-test-keys' folder.
Usage
To start the sde-console using the following command once all subcomponents have been cloned:
docker-compose -f docker-compose-recover.yml up
The sde-console will be started and exposed via docker on port 80, visit the ip address of docker in your browser.
Decrypting Payloads
The app exposes a single endpoint at '/' to decrypt payloads that are already encrypted and transform them to downstream formats. This is useful for manually recovering data that has failed the transformation process for some reason, so long as it is properly encrypted JSON data and uses the same keys.
Payloads are logged from the SDE application on error - retrieve the desired payload from the logs and paste into the decrypter.
The encrypted payload is entered on the left and downstream formats appear on the right within ftp once they have been transformed.
Viewing Content
The receiver displays the contents of a number of subdirectories on the ftp server.
It is possible to inspect the content of any file once it's been created, by clicking on the appropriate link on the receiver side. It is also possible to clear your ftp instance of all current files by using the "Empty FTP" button.
If the payload isn't properly encrypted the sde-console will throw an error on submission.