Views:
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"