Automatic Secret Export REST API
Overview
If you use Secret Server Cloud, you can use a REST API to download exports and view your export storage list.
The automatic export feature has the following endpoints available for cloud customers only. API usage is fully audited.
A typical use of these API endpoints is to automate downloading exports to your backup solution outside of Secret Server (for redundancy).
Viewing the Storage List
Get a list of the exports currently in storage. Your session must be authenticated, and the authenticated user must have Automatic Export view permissions.
Sample Request
GET: http://sample.secretservercloud.com/api/v1/configuration/auto-export-storage
Sample Response
{
"records": [
{
"id": 123,
"autoExportConfigurationId": 1,
"storageDate": "2021-07-01T07:00:02.27",
"filename": "secret-server-export-20210707070002",
"canDownload": true
},
...
],
...
}
The response is a JSON object with a records property whose value is the list of all the exports in storage. Each list entry has the following properties:
-
id: The ID for this export in storage, which is used with the Download Export endpoint to download the export.
-
autoExportConfigurationId: The ID for the automatic export configuration this export belongs to. This may be useful in the future if we support multiple export configurations, but for now it is only used internally.
-
storageDate: The date and time the export was stored.
-
filename: The filename for the export archive and the export XML file inside it.
-
canDownload: Whether the user can download this export archive.
Downloading Secret Exports
Download an export in storage by its ID. Your session must be authenticated and the authenticated user must have automatic export download permissions.
Sample Request
GET: http://sample.secretservercloud.com/api/v1/configuration/auto-export-storage/item/{id}
Where {id} is the ID of the export you want to download. This value is obtained from the Storage List endpoint.
Sample Response
A stream of bytes representing the export archive.