Skip to content

Commit

Permalink
backport of commit b0d5e1b (#27308)
Browse files Browse the repository at this point in the history
Co-authored-by: Steven Clark <[email protected]>
  • Loading branch information
1 parent 3f5b5d4 commit 736c7b1
Showing 1 changed file with 12 additions and 5 deletions.
17 changes: 12 additions & 5 deletions website/content/api-docs/secret/transit.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -1575,7 +1575,8 @@ the response will include the derived public key for each item.
## Verify signed data

This endpoint returns whether the provided signature is valid for the given
data.
data from either the [sign data](#sign-data), [generate HMAC](#generate-hmac)
or [generate CMAC](#generate-cmac) API calls.

| Method | Path |
| :----- | :---------------------------------------- |
Expand Down Expand Up @@ -1624,12 +1625,16 @@ data.
`input` or `batch_input` must be supplied.

- `signature` `(string: "")` – Specifies the signature output from the
`/transit/sign` function. Either this must be supplied or `hmac` must be
supplied.
`/transit/sign` function. One of the following arguments must be supplied
`signature`, `hmac` or `cmac`.

- `hmac` `(string: "")` – Specifies the signature output from the
`/transit/hmac` function. Either this must be supplied or `signature` must be
supplied.
`/transit/hmac` function. One of the following arguments must be supplied
`signature`, `hmac` or `cmac`.

- `cmac` `(string: "")` <EnterpriseAlert inline="true" /> – Specifies the signature output from the
`/transit/cmac` function. One of the following arguments must be supplied
`signature`, `hmac` or `cmac`.

- `reference` `(string: "")` -
A user-supplied string that will be present in the `reference` field on the
Expand Down Expand Up @@ -1767,6 +1772,8 @@ $ curl \
## Generate CMAC <EnterpriseAlert inline="true" />

This endpoint returns the CMAC of given data using the specified key.
The [verify](#verify-signed-data) API can be called with the cmac
argument to verify returned CMACs.

| Method | Path |
| :----- | :-------------------------------------- |
Expand Down

0 comments on commit 736c7b1

Please sign in to comment.