Request Signature
GET {{cb_url}}/ubs/v1/orgs/{{cb_org_key}}/sha256/{{sha256}}/summary/signature?rows=
This API will return a summary of the observed digital signature results for a given SHA-256 hash. The digital signature information for a binary may vary from one machine to another based on a variety of factors, including the presence of an up-to-date signature catalog on the host, system clock variations, ability to reach OCSP servers, custom root trust anchors, and more. Therefore, the results are ordered by prevalence, such that the most observed signatures will be returned first. The number of results are configurable, up to a max of 100 entries. Digital signatures can be recorded in a separate file (known as a “catalog” file) or embedded inside of the binary itself (an “embedded” signature). This signature API will capture the results of the endpoint’s verification of the digital signature associated with a given SHA-256 hash, stating whether that signature validation was based on a catalog file or an embedded signature.
RBAC Permissions Required
| Permission (.notation name) | Operation(s) |
|---|---|
| Ubs.org.sha256 | READ |
Request Params
| Key | Datatype | Required | Description |
|---|---|---|---|
rows | null | The number of results to return. The default is 5 and the max is 100. |