Create a Reputation entry.
- Each request can result in a distribution and a sync time to the managed devices.
- For improved performance, send requests in bursts up to 1,000 entries in time intervals that allow distributions to complete in a timely manner.
- This Web API is performed using an HTTP GET request.
Definition
repEntries/add
Parameters
Only one of the following parameters can be used in the request.
| Parameter | Type | Description |
| ip | IP address | IPv4 or IPv6 address of the Reputation entry. |
| dns | string | DNS address of the Reputation entry. |
| url | url | Reputation URL entry. |
| filehash | File hash string |
Prefix the file hash string with either
sha1: or sha256: in order to indicate the type of SHA algorithm the file hash string represents. For
example:
sha1:b7c74f7fbde596ba87ac98ff4a9c8235d437ebce sha256:779d0a008cb96a61ad6b075e29dad85d97ccf2d5c528d3292ccb9535079b6b40 |
| TagData | string |
Optional. One or more tag categories and their values. Must be UTF-8 encoded and separated
by a comma (,).
Reputation entries with a list tag category can include multiple values only
when the Allow Multiple Values? check
box is selected from the Edit Tag
Category box on the SMS.
The list values must be separated by ~~~ (three tildes).
MalwareIpType,malwareSource~~~cncHost
|
Example
curl -v -k --header "X-SMS-API-KEY: <string>" "https://<sms_server>/repEntries/add?&ip=1.1.1.1&TagData=MalwareIpType, infectedHost,CreatedDate,%22Jan%2022,%202014%22"
curl -v -k --header "X-SMS-API-KEY: <string>" "https://<sms_server>/repEntries/add?dns=www.baddomain.com"
curl -v -k --header "X-SMS-API-KEY: <string>" " https://<sms_server>/repEntries/add?url=http://badurl.com/this/is/nice"
curl -v -k --header "X-SMS-API-KEY: <string>" "https://<sms_server>/repEntries/add?filehash=sha1:b7c74f7fbde596ba87ac98ff4a9c8235d437ebce"
curl -v -k --header "X-SMS-API-KEY: <string>" "https://<sms_server>/repEntries/add?filehash=sha256:1c17d07a2762f6baab41004b57eec113 774bc3f745d4c1d64c0fe464720a2126&TagData=Color,Blue"
