When integrating Cisco Umbrella with a SIEM using the Cisco Umbrella Investigate API, which TWO pieces of information are required to authenticate and query domain status?
Trap 1: WSA Admin password
The Investigate API authenticates with an API key and secret, not WSA credentials; the web security appliance is a separate product with its own console. It is tempting because WSA administrators often own Umbrella deployments, but those credentials grant no Investigate API access.
Trap 2: Internal DNS server IP
The internal DNS server address is irrelevant to Investigate API authentication; queries go to Cisco's cloud service over HTTPS, not through your resolver. It is tempting because DNS configuration matters for Umbrella's forwarding, but that is deployment, not API authentication.
Trap 3: Organization ID
The Organization ID is not an authentication credential for the Investigate API; access is granted by API key and secret pair. It is tempting because organisation identifiers appear in other Cisco cloud APIs, but Investigate authenticates solely on the key pair.
- A
API Token
An API token authenticates every Investigate API request, satisfying the stem's credential requirement. Supplied as a bearer credential in the Authorization header, it authorises domain-status queries without a separate username or password. The token alone therefore fulfils one of the two required pieces of information.
- B
WSA Admin password
Why it fails: The Investigate API authenticates with an API key and secret, not WSA credentials; the web security appliance is a separate product with its own console. It is tempting because WSA administrators often own Umbrella deployments, but those credentials grant no Investigate API access.
- C
Authorization Header
The Authorization header carries the bearer token issued by Cisco Umbrella, satisfying the API's requirement for credential transmission on every Investigate request. Without it, domain status queries return HTTP 401. This header is one of the two required elements, alongside the API key itself, enabling authenticated access to reputation data.
- D
Internal DNS server IP
Why it fails: The internal DNS server address is irrelevant to Investigate API authentication; queries go to Cisco's cloud service over HTTPS, not through your resolver. It is tempting because DNS configuration matters for Umbrella's forwarding, but that is deployment, not API authentication.
- E
Organization ID
Why it fails: The Organization ID is not an authentication credential for the Investigate API; access is granted by API key and secret pair. It is tempting because organisation identifiers appear in other Cisco cloud APIs, but Investigate authenticates solely on the key pair.