Webroot® Unity API

Hello,In my down time I’ve been messing around with some powershell scripting. During this time I created the following script to allow an additional method of sending Agent Commands, changing Agent policies, or running basic usage reports using the Webroot.This script can be converted to an exe quite easily and used in that manner as well if desired.Unfortunately due to the length of the script exceeding character limits here, I’ve had to post it to Github. You can view it here:https://github.com/x-drybk/wret  No coding professional, so constructive criticism is welcome.

Got everything working and then ran a test for my clients. The test client has 23 endpoints, 4 servers and 19 workstations. The report show 31 Endpoints managed and 8 Endpoints not seen at the end of the report it shows 64 device types, 17 unmanaged and 47 managed Are these reports working are they pulling sample data to show the report

Hi, Does anyone knows the maximum size of string in this request for EndpointsList param? https://unityapi.webrootcloudav.com/Docs/en/APIDoc/Api/POST-api-console-gsm-gsmKey-sites-siteId-endpoints-deactivate Thanks 🙂

The Community Team and I have been working with @cbullas recently on the NEW Integrations forum. We'll have some exciting news to share in time but for now, I wanted let you know that we have moved the existing Unity Feature Request area to the larger Business Feature Request section. All of the existing API specific requests have been imported over there. In the future, if you have an idea about Unity or our integrations, please submit those ideas there.

Hi, Is there a way to figure out via API the `status` values for Endpoints that I can see at the website under **Endpoint Protection > Group Management **? Ive tried all APIs but couldnt get the info..

Not sure where to report bugs, but noticed another one today: The Automate plugin is sorting the "Last Seen" date as text instead of date.  The MySQL column is type datetime, but it's probably just not being imported into the proper variable type in the C# code.  

We have a need to document all the settings for all our policies and I had an idea to use the rest api for this. I've managed to list all the policies, but I can't seem to get the policy settings. Is this possible? If it is, then how? If not, will it ever be?

"deep scan"... dang you, 4k! Trying to determine how to kick off a deep scan on an endpoint without usng the web gui. I have 50 endpoints. Need to do it programmatically, and I can run scripts on each EP if needed, or is hitting the API going to allow this to happen to one/group?

I'm querying the API for sites and then each site for its endpoints, after about 4-5 queries I started getting a gateway timeout and now even trying to get a token times out. Are there ongoing issues or is there some type of rate limit I should be following? I'm not getting a 429 so I'm leaning towards ongoing issues but figured I'd check anyways.

This article has been moved to the Knowledge Base section of the Community. To view this article, click here.

As I am sure many people are experiencing with Windows 10 updates, I work for an MSP with a bunch of duplicate entries being created because of this. Right now I found a base Powershell Script written by Adam Morgan(from this community) that spits out a CSV of all of the duplicate entries that we can then find and remove as needed. The links in the forums on other questions regarding automation now just link back to the main community site. I was curious if anyone has tried to write a script using the API to accomplish this is some instance.

[h4]IMPORTANT - Identifying your Application[/h4] When using the Unity API you need to specify a valid user agent string for all requests in the corresponding User-Agent request header. The string needs to be made up of one or more name and version pairs separated by a whitespace character (e.g. "MyCustomApplication/1.2.759 ThirdpartyPlatform/1.0.r3"), according to the HTTP/1.1 standard. Please be aware that Webroot reserves the right to reject Unity API requests that do not follow above requirement anytime in the future. Identifying your application is important and enables Webroot to provide a more targeted and streamlined API experience. If you have any questions please do not hesitate to reach out to Webroot support.

Hi, Was wondering if there is a way to get paginated results when calling the api hook: /console/gsm/{k}/sites/? Ive tried adding the param `pageSize=10&pageNr=1`, but it doesnt work. Cheers

Hoping someone might be able to direct me to some info on using the continuation uri and token when paginating results from the API. Wasn't able to see anything obvious in the documentation. Cheers

Background: I work for an MSP in a sysadmin role so please forgive my limited dev skills. I'm looking at using the Unity API to integrate Webroot endpoint data into a LOB application. I have experience with making REST API calls via PowerShell to set custom properties and variables based on response data.    I can create an API key in our GSM, but I'm not seeing any options to restrict the key to specific sites, datasets, read-only, etc permissions. Ideally, I'd like to limit key permissions to only allow a specific user account to make 'GET SkyStatus' calls to endpoints in a single site. If possible, I'd also like to restrict API key usage to a specific IP address.   Can anyone provide further guidance on hardening GSM console security when using the Unity API?   Thanks, Dan

My policy audit script returned blank PolicyName fields today, and the endpoint request in Postman shows a null PolicyName for the few agents I looked at.  Looks like maybe they've replaced it with the "PolicyId" field and have blanked-out "PolicyName"?   Update: Also getting lots of 504 timeouts today...

ActiveSubshader Returns the active subshader or null if none is currently active. ActiveSubshaderIndex Returns the index of the active subshader or -1 if none is currently active. SourceShader The shader attached to this data set. SubshaderCount The number of subshaders used by this shader.

Hi, I've been playing around with the new dnsp functions of the api. When I do a get request to the following path: https://unityapi.webrootcloudav.com/service/api/console/gsm/XXXX-XXXX-XXXX-XXXX-XXXX/dnsp/trafficsummaryI get a the following error in postman: { "statusCode": 400, "requestId": "9c9e9171-2586-4a1e-979a-8b24f1470fc3", "error": "site_not_found", "error_description": "Site not found in GSM console.", "AdditionalInformation": {}} The rest of the dnsp queries work afaik (also with that gsm key), but I will check again tomorrow. I thought I'd post here, because it may be a known bug.

Hi,   I'm trying to use the API to determine endpoints that have specific policies assigned, rather than at the group level.  From taking a look at the endpoint ID documentation here: https://unityapi.webrootcloudav.com/Docs/en/APIDoc/Api/GET-api-console-gsm-gsmKey-sites-siteId-endpoints-endpointId it doesn't look like that information is obviously available.    The Groups tab in the console lists that, so there must be some way to query this.  What's the best way to get that information?  Just look at the group and see if the policy matches?   Edit:  Yup, that's exactly how to do it.

Hi, can't figure something out from the reporting console and am wondering if this is what the API is needed for and if so, are there examples you could point me to?    Use case I'm thinking of, is a manager asking  "give me a report of John Smith's web activity for last week".  Can someone point me in the direction of how I would get that info?   Thanks!

Can I connect PowerBI via the api, the idea is to make my own graphs and dashboards.  Anyone done this and could point me to a 'how-to'?

Hi Everyone,   I wanted to link to an upcoming Q&A with myself, where we will be talking everything integrations. The main thread can be found here. Please feel free to come by and share your thoughts and questions. Looking forward to chatting then!   Best regards, Joseph Rizzuto Product Manager, Integrations

Hello,   There is an upcoming User-Agent header requirement for all Unity API requests, per HTTP/1.1 standards. Please make sure to include this as to prevent blocked requests. From our API documentation:   IMPORTANT - Identifying your Application When using the Unity API you need to specify a valid user agent string for all requests in the corresponding User-Agent request header. The string needs to be made up of one or more name and version pairs separated by a whitespace character (e.g. "MyCustomApplication/1.2.759 ThirdpartyPlatform/1.0.r3"), according to the HTTP/1.1 standard. Please be aware that Webroot reserves the right to reject Unity API requests that do not follow above requirement anytime in the future. Identifying your application is important and enables Webroot to provide a more targeted and streamlined API experience.   Should you have any questions, please let us know. &nb

Our team has created an API script that pulls from different endpoint data and they would like to have you test it to see if it would suit your needs. If you're interested, please send @ a PM letting him know your preferred method of contact and a day/time that works well for you.  We're excited to share this with you and would love to know what you think!

Hey,   So I've just found some new options that were published on April 8th I believe. One of hte options is single sign-on which looks really really useful for some of our implementation. However, we use one user account for all commands sent via Unity. This account has access to ALL our sites. When using the single sign-on option it seems that this is the user account which ends up being used to sign-on. This is not ideal as we have technician accounts who only have access to their own clients, not everything. I could have each tech create a Unity client id and secret and store that info. Is ther any other means that this could be achieved?