Skip to content

Commit 509795c

Browse files
edits
1 parent 735cbe8 commit 509795c

File tree

2 files changed

+9
-3
lines changed

2 files changed

+9
-3
lines changed

src/content/docs/turnstile/concepts/ephemeral-id.mdx

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -16,4 +16,8 @@ Refer to the [blog post](https://blog.cloudflare.com/turnstile-ephemeral-ids-for
1616

1717
## Availability
1818

19-
Ephemeral IDs are available to customers with Enterprise Bot Management and Enterprise Turnstile.
19+
Ephemeral IDs are available to customers with Enterprise Bot Management and Enterprise Turnstile. Contact your account team for access to Ephemeral IDs.
20+
21+
## Enablement
22+
23+
After your account team enables the Ephemeral ID entitlement, you must turn it on for the widget that you want the Ephemeral ID on via the [API call](/api/resources/turnstile/subresources/widgets/methods/update/).

src/content/docs/turnstile/get-started/server-side-validation.mdx

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -259,7 +259,9 @@ It always contains a `success` property, either true or false, indicating whethe
259259
"error-codes": [],
260260
"action": "login",
261261
"cdata": "sessionid-123456789",
262-
"ephemeral_id": false
262+
"metadata":{
263+
"ephemeral_id": "x:9f78e0ed210960d7693b167e"
264+
}
263265
}
264266
```
265267

@@ -270,7 +272,7 @@ It always contains a `success` property, either true or false, indicating whethe
270272
- `action` is the customer widget identifier passed to the widget on the client side. This is used to differentiate widgets using the same sitekey in analytics. Its integrity is protected by modifications from an attacker. It is recommended to validate that the action matches an expected value.
271273
- `cdata` is the customer data passed to the widget on the client side. This can be used by the customer to convey state. It is integrity protected by modifications from an attacker.
272274
- `error-codes` is a list of errors that occurred.
273-
- `ephemeral_id` returns the [Ephemeral ID](/turnstile/concepts/ephemeral-id/) in siteverify.
275+
- (Enterprise only) `ephemeral_id` returns the [Ephemeral ID](/turnstile/concepts/ephemeral-id/) in siteverify.
274276

275277
In case of a validation failure, the response should be similar to the following:
276278

0 commit comments

Comments
 (0)