topic Re: Umbrella API Org Fingerprint via API in Cloud Edge

Umbrella API Org Fingerprint via API

gdaxon — Wed, 02 Feb 2022 19:10:21 GMT

Hi,

I've been working on an automated deployment for a number of software packages and Umbrella is the only one that I can't find all the details for.

Via the APIs I need either the Org Fingerprint or the ability to download the install package so I can extract the json file that has the Fingerprint.

Am I blind or are these items not available via the Umbrella API?

Edit: wrong word.

Re: Umbrella API Org Fingerprint via API

Brian Sak — Thu, 03 Feb 2022 22:25:28 GMT

There isn't a way to get the OrgId through the API. You have to pull that from the URL of the dashboard.

https://developer.cisco.com/docs/cloud-security/#getting-started/get-organization-information

The roaming client module profile is unique per org and can only be downloaded from the dashboard, as far as I know.

I think you're going to need to know the OrgId before you're going to be able to do automated deployment of these components.

Re: Umbrella API Org Fingerprint via API

Brian Sak — Fri, 04 Feb 2022 14:40:30 GMT

Well, after I posted I found that you can find the OrgId by requesting it from the management endpoint.

curl -i GET https://management.api.umbrella.com/v1/organizations \
-H 'Authorization: Basic <redacted>' \
-H 'Content-Type: application/json'

It will return the OrgId and the name of your organization.

Re: Umbrella API Org Fingerprint via API

gdaxon — Fri, 04 Feb 2022 18:51:41 GMT

This does not address my question. The Org ID and the Org Fingerprint are not the same thing. The fingerprint is a value in the orginfo.json file that is required for a roaming client installation. This is the value I am looking for.

Re: Umbrella API Org Fingerprint via API

chrivand — Sat, 05 Feb 2022 09:17:17 GMT

hi @gdaxon I think you cannot retrieve this info via API. You will need to download it once manually if I remember correctly from previous experience with MSPs. Please check these links:

https://support.umbrella.com/hc/en-us/articles/231356108-Umbrella-Roaming-Client-Deployment-Parameters-for-Mass-Deployment-MSP-

https://support.umbrella.com/hc/en-us/articles/230901008-What-is-my-OrgID-Fingerprint-

https://docs.umbrella.com/deployment-umbrella/docs/acquire-umbrella-roaming-client-parameters

Also, I would recommend opening a ticket for this with Umbrella support. They will be better able to help you on this.