To Customer Support To Customer Support

Unity API Forum

Designed to discuss Webroot Unity API features, general questions, and ideas

  • 90 Topics
  • 218 Replies

90 Topics

cbullas
cbullasProduct Manager
published in Unity API Forum

Unity API - Open API preview release

As part of making it easier to use the Unity API we have released a preview version of Open API support.  Here are a few details. Unity API users can now start with a documented ‘API library’ instead of having to set everything up from scratch, making it easier to generate code/scripts,  use testing tools and self-educate. Open API is supported by loads of tools. Files in both JSON and YAML for flexibility For more information see https://unityapi.webrootcloudav.com/Docs/en/APIDoc/APIReference#get-openapi-definition Those interested to learn about Open API https://www.openapis.org/ Note this is a public preview release, you will still need to setup access/ refresh token calls, see https://unityapi.webrootcloudav.com/Docs/en/APIDoc/GettingStarted#gettingStarted  Let us know what you think!

7784
ngoknel
Administrator
2 years ago
cbullas
cbullasProduct Manager
published in Unity API Forum

Universal Reporter - create customer value add reports for your customers

We have just launched our Universal Reporter tool that's been created by the Integrations team here at Webroot.  This tool allows MSPs to create custom reports that show value to your end customers. We've also made it really easy to be able to schedule and automatically email selected reports to your customers.  The tool uses the concept of templates for reports that are built using Microsoft Excel and PowerShell Scripts. Included are a sample of templates to for you to play with.  We've created our knowledge base to help you get up and running .  Download the Universal Reporter   For the coders / scripters among you check out the new Unity API SDK, PowerShell cmdlet included. It only covers reporting functions in the Unity API at present, but we would love to know what you think about it. Plus no need to worry about access and refresh tokens.   Thanks  

3550
cbullas
3 years ago
JosephRi
JosephRiRetired Webrooter
posted in Unity API Forum

IMPORTANT - Identifying your Application

[h4][b]IMPORTANT - Identifying your Application[/b][/h4] When using the Unity API you need to specify a valid user agent string for all requests in the corresponding [b]User-Agent[/b] 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.

0
JosephRi
4 years ago
A
New Voice
ArjanNew Voice
posted in Unity API Forum

Restrict API to site

Is it possible to create an API key that has only access to a single site?

3
S
New Member
3 months ago
R
New Member
rajansajanNew Member
asked in Unity API Forum

Webroot API is not return all the end points

Hi All, I am calling the reports end point and it’s return only 6 endpoints, I have checked I have 7 active endpoints. or is there any way I can call the inactive endpoints using the API.If anybody can help?Thanks,  

3
TylerM
Administrator
6 months ago
P
New Member
papabolromeNew Member
asked in Unity API Forum

AgentStatus endpoint no QueryResults

Hello, I need to get my client’s Agentstatus data but the queryresults aren't giving me any results when trying to query it. Am I doing something wrong? Thank you! 

1
S
Webroot Employee
6 months ago
J
Fresh Face
jseumo2Fresh Face
asked in Unity API Forum

Adding a scope to an access token

Hi, I need to be able to use the notifications endpoints for the Unity API, but I am not sure where to go to add the correct scope for my testing access token. Can anyone direct me? The token already has access to the following scopes: scope": "[\"SkyStatus.Site\",\"SkyStatus.GSM\",\"SkyStatus.Usage\",\"SkyStatus.Reporting\",\"Console.GSM\"]"Thanks

6
L
New Member
7 months ago
D
Webroot Employee
dengWebroot Employee
posted in Unity API Forum

Unity API event notification service adoption

Tell us how you are using the new Unity API event notification service.  And what are some of the new events that you like us to publish through this API endpoint? 

0
D
Webroot Employee
9 months ago
D
Webroot Employee
dengWebroot Employee
posted in Unity API Forum

what are some improvement that you want to see in Unity API

please share your thoughts

0
D
Webroot Employee
9 months ago
M
Fresh Face
Matthew_LangFresh Face
asked in Unity API Forum

Error(BLOCKEDPROGRAMS0021)

I have been using ADF to query the endpoint threat history API.https://unityapi.webrootcloudav.com//service/api/console/gsm/xxxxxx/sites/xxxxxxx/threathistoryThis has been working successfully for many weeks. we have been nearing the end of our subscription period and have been granted an extension of 30 days for our license, but now when I query this API I get the following error.Error(BLOCKEDPROGRAMS0021): Users endpoint protection access has expired"I can still get results back from other API’s I call using the same credentials so it seems isolated to the endpoint threat protection historyIs this something to do with this being a temporary license?How can I go about resolving? Many thanks Matt Lang

1
aqila
Community Manager
10 months ago
M
Fresh Face
Matthew_LangFresh Face
asked in Unity API Forum

Endpoint Status GSM Modified since parameter and return result

I am calling the Endpoint Status GSM API using postman and providing a date and time for the modifiedSince parameter. REST API Call belowGET /service/api/status/gsm/{keyCode}?batchSize=1000 &modifiedSince={modifiedSince}I would expect to see the count of records being returned to steadily increment each time I execute this request, since new records or updated records get returned,  but what I am seeing is confusing and I was hoping someone could help clarify.lets say on my first call I want to see all records that were modified since 11am today. I should see (let’s say in this use case) 100 records returned with no continuation token or URI since my batch size is set to max (1000).If I run the exact same query again a few seconds later I should see the same data or maybew 1 or 2 extra records depending on how busy my system is.What I am seeing instead is less records being returned, often along with a continuation token.I never seem to get a consistent result back, at times I see

6
M
Fresh Face
1 year ago
S
Fresh Face
Steven RFresh Face
asked in Unity API Forum

API not decoding password properly

Hi,We are trying to generate an access token for one of our clients using their username and password through the https://unityapi.webrootcloudav.com/auth/token endpoint. However, if the password contains an & symbol, we always receive the error message "Username or password is invalid”.When testing with other accounts and passwords (not containing an & character), things work fine. We double checked and we are sending the password field (as any other field) properly URL encoded. My only guess is that the receiving API server is not decoding these values correctly.Would you be able to confirm this a problem on your end or is there something we need to check again?Thanks for any help.Best regards,Steven

8
aqila
Community Manager
1 year ago
C
Fresh Face
CSQAFresh Face
asked in Unity API Forum

Adding/removing access for Site Admin via API

I have 2 GSM Console Admins (Super Admins), 1 Site-Admin, and 2 Sites. The 1 Site admin has administrator access to both sites. I want to use the API to update their access to either No Access or View Only. When I use the endpoint “/service/api/console/gsm/{gsmKey}/sites/{siteId}/admins” (with the relevant info filled in), it’ll return a 204 but nothing updates for the Site Admin, their access stays the same.If I attempt to provision either of the GSM Console Admins using the same endpoint and changing their access level to any of the 3 levels available, it’ll work. Judging by this in the API documentation “This API method allows adding existing GSM admins to the list of admins of a site, or modifying access permissions of already set up site admins. To get information about available admins, either query the list of admins on the GSM console (see here) or the list of admins on a site (see here),”, it seems that I should be able to change a site admins access permissions… unless I’m mi

6
S
Webroot Employee
1 year ago
L
Fresh Face
lpopejoyFresh Face
posted in Unity API Forum

Webroot dashboard

There was an impressive dashboard in the webinar showing what someone had created with the API.    Just curious if there is any chance that the person who created that is interested in licensing the code - or open sourcing it?  It would save me a week a work.  :) [img]https://d1qy7qyune0vt1.cloudfront.net/webroot-en/attachment/27861i9CD2F409C942D4A1.png[/img]

9
L
New Member
1 year ago
C
Fresh Face
ctaylorFresh Face
asked in Unity API Forum

Unity API Scope

I am trying to suspend/deactivate sites and keep getting a scope error.I have tried scopes like:Console.GSMConsole.**But I continue to get scope errors for these endpoints. What must I do to acquire the correct scope?https://unityapi.webrootcloudav.com/service/api/console/gsm/{gsmKey}/sites/{siteId}/deactivate{ "statusCode":403, "requestId":"3c329835-981d-495e-875f-50201c49752", "error":"insufficient_scope", "error_description":"Access was denied due to insufficient token scope.", "AdditionalInformation":{}} I can change things in the site without issue but cant suspend/deactivate the site.

3
C
Fresh Face
1 year ago
N
New Member
nitsrini698New Member
asked in Unity API Forum

Webroot threat intelligence rest api

Hi,      I know Webroot threat intelligence support Rest API for getting threat sources information .But does Webroot threat intelligence support rest API for reporting IP and URL?

1
mattaldridge
Webroot Employee
1 year ago
P
New Member
PushkarNew Member
posted in Unity API Forum

Users endpoint protection access has expired

'{"statusCode":403,"requestId":"66597b2c-ba7e-4295-83dd-5db4fd0386c8","error":null,"error_description":"Error(LISTDEVICES0008): Users endpoint protection access has expired","AdditionalInformation":{"transname":"LISTDEVICES","languagecode":"EN"}}'II assume that this issue might have caused If the submitted access token does not contain the required scope (see Service Extensions and Scopes) for the requested API call, the server responds with an HTTP 403 (Forbidden) status code and the message "error": "insufficient_scope".  But the error here is null and the scope I passed was ‘*’.It only takes a few seconds to make that request. Span of 300sec is huge for that request, so access token expiration is unlikely to happen. I am not able to understand what `Users endpoint protection access has expired` mean.

1
ngoknel
Administrator
1 year ago
M
New Member
mbrown16037New Member
asked in Unity API Forum

ConnectWise Automate API Broken

I am no longer able to see new clients in my Automate plugin

2
M
Fresh Face
1 year ago
G
New Member
ggroupNew Member
asked in Unity API Forum

Any Testing API keys available?

Hi wondering if there are any testing API keys available, rather than using live site and live API secret keys etc

1
ngoknel
Administrator
2 years ago
G
New Member
GoannaNew Member
asked in Unity API Forum

Webroot Universal Reports folder does not exist

I am trying to learn how WUR works,The report runs and returns a ‘Success’ status,If I click the ‘Open’ link, it opens this folderC:\Users\fname.lname\OneDrive - MyOrganization Name Services Ltd\Documents\Webroot Reporting\Runs\20210524T0324515876892Z\Outputwhere I can see a Result.json file.   But it seems that webroot is not creating the associated excel workbook. When I look at the WebrootReporting.Log it has the following entry.24/05/2021 12:45:35 PM ResultReadingService: LoadPreviousGeneratedResults failed. Reason: C:\Users\fname.lname\OneDrive - MyOrganization Name Services Ltd\Documents\Webroot Reporting\Runs folder does not exist! The path is exactly the same in both cases. Any idea what is going on here?

1
ngoknel
Administrator
2 years ago
J
New Voice
JohnDukeNew Voice
posted in Unity API Forum

Webroot API - Add LastSeen Date in Endpoint Status GSM query

HelloI want GET a liste of EndPoints not seen since x days in GsmQuery /service/api/status/gsm/{gsmKey}&returnedInfo=BasicInfo,OSAndVersions  for all EndPoints (1400 active and many inactive) always failed before the end.Query /service/api/console/gsm/{gsmKey}/sites/{siteId}/endpoints$sSiteID for each site (280 actives) takes a very long time.Or is there a way to GET all EndPoints without error ?Thanks 

3
ngoknel
Administrator
2 years ago
cbullas
cbullasProduct Manager
posted in Unity API Forum

DOWNLOAD UNITY API SDK for Microsoft .NET framework - Beta release

Hi, for those of you interested in building applications and automation quickly I’m happy to say that we have released a concept version of our SDK for you to have play with. Easily unlock the power of Webroots Unity API! Download it, have a look, have a play and please let us know what you think. This is something we are evaluating and we really care about your feedback! Please note licensing and documentation is included.

4
J
New Member
2 years ago
M
Mikkel
posted in Unity API Forum

C# SDK Download location

Hello, i have looked around for the Unity API SDK for C# but i can't find it anywhere. Can anyone help me with finding it, and it's documentation?   - Mikkel

8
J
New Member
2 years ago
L
New Member
LyricalUserNew Member
posted in Unity API Forum

Is there any way to query the Unity API for the GSM Key Code associated with the Api Client or User?

As it says in the title…I’m building a generic-use PowerShell wrapper for the Unity API, and I’d like to not have the user have to go look up their GSM code manually. Is there a way to query the API to retrieve the GSM code that is associated with the API Client credentials or with the User?

1
ngoknel
Administrator
2 years ago
R
New Voice
rhasanNew Voice
posted in Unity API Forum

Refresh Token expires in 5 mins instead of 14 days

Hi, I hope everyone is doing well.. Ive got an issue with the refresh token as it expires in 5 mins instead of 14 days. As per this guide it should expire in 14 days: https://unityapi.webrootcloudav.com/Docs/en/APIDoc/Guide#guide-authentication-accessAndRefreshTokens Here is what im doing to test this: 1) get Access Token with: header contains = `Authorization: basic *****` body contains = username, password, grant_type='password', scope 2) get refresh token with: header contains = `Authorization: basic *****` body contains = refresh token (from step 1) grant_type='refresh_token', scope and before you ask: im passing same scope! So did I miss anything? or did anything wrong? Please help.. Thanks in advance for your help :) [img]https://d1qy7qyune0vt1.cloudfront.net/webroot-en/attachment/e4a1a6c8-cedc-40b4-b144-1d4575e3b459.png[/img]

10
L
New Voice
2 years ago

Badges

  • Most Wanted
    JonathanBhas earned the badge Most Wanted
  • Beta To The Max
    JonathanBhas earned the badge Beta To The Max
  • Most Wanted
    csaundershas earned the badge Most Wanted
  • Product Help: Had 50 answers marked as "solved"!
    jhartnerd123has earned the badge Product Help: Had 50 answers marked as "solved"!
  • Have 50 answers marked as "solved"!
    khumphreyhas earned the badge Have 50 answers marked as "solved"!
Show all badges

Join the Conversation

Terms & Conditions

© 2004 - Webroot Inc.

We have recently updated our Privacy Policies. We encourage you to read the full terms here.