You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Commit a002ce2
Browse filesBrowse the repository at this point in the historyBrowse files
Document the browser locale on managed auth connections (#758)
* Document the browser locale on managed auth connections
* Align the managed auth locale docs with browser location
* Point the managed auth locale docs at browser location
* Use example.com in the managed auth locale examples
* Keep the managed auth locale section to an overview
---------
Co-authored-by: akxue <18199652+akxue@users.noreply.github.com>
Copy file name to clipboardExpand all lines: auth/configuration.mdx
+45Lines changed: 45 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -639,6 +639,50 @@ _ = login
639
639
640
640
Browser placement and proxy location are independent. `browser.region` chooses where the browser runs; the connection's [proxy](/proxies/overview) controls the exit IP that websites see. Regional browsers don't provide a data residency guarantee. See [Regional Browsers](/browsers/regions) for storage and processing details.
641
641
642
+
## Browser locale
643
+
644
+
By default, the browsers Managed Auth uses for a connection report an English locale to websites, such as `en-US` in `us-east`. If your users sign in to sites in another language, set `browser.location.locale` on the connection, for example `sv-SE` for Swedish. Sites that choose their language from the browser then show their login page, field labels, and MFA prompts in your user's language.
The locale applies to every browser the connection uses: the first login, health checks, and automatic reauthentication. Change it with `auth.connections.update`, or set it to `null` to go back to the default.
683
+
684
+
This is the same `locale` as [browser location](/browsers/location), applied to the connection's browsers. See that page for supported values and how the locale affects the browser.
685
+
642
686
## SSO/OAuth support
643
687
644
688
Managed Auth supports common "Sign in with Google/GitHub/Microsoft" flows. The user completes the OAuth flow with the provider, and Kernel saves the authenticated session to the profile. Automatic reauthentication depends on the provider's login requirements. See [Can this connection auto-reauth?](/auth/connection-lifecycle#can-this-connection-auto-reauth) for how Kernel determines eligibility.
@@ -964,6 +1008,7 @@ After creating a connection, you can update its configuration with `auth.connect
964
1008
|`record_session`| Record a [replay](/browsers/replays) of every auth browser session for this connection (logins, health checks, and reauths) |
965
1009
|`hitl`| Pause interactive logins on an unsolvable CAPTCHA so a person can complete it. See [human verification for CAPTCHAs](#human-verification-for-captchas)|
966
1010
|`browser.region`| Region for login, health-check, and reauth browsers. Takes effect on the next browser created for the connection |
1011
+
|`browser.location.locale`| Language for login, health-check, and reauth browsers, such as `sv-SE`. Set to `null` to go back to the region default. Takes effect on the next browser created for the connection |
967
1012
|`proxy`| Pin login, health-check, and reauth sessions to a proxy. Takes effect on the next health check or reauth |
968
1013
969
1014
Only the fields you include are updated—everything else stays the same. Changes to `health_check_interval`, `health_checks`, `auto_reauth`, and `proxy` take effect immediately on the running connection.
Copy file name to clipboardExpand all lines: browsers/location.mdx
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -107,5 +107,5 @@ Browser responses include the timezone and locale the browser is using, and whet
107
107
- Date and number formatters a page already created keep their original settings. Create a new one, such as `new Intl.DateTimeFormat()`, to use the new values.
108
108
- Requests already in progress keep their original language. Later requests use the new one.
109
109
- A timezone or locale you set yourself through Playwright or Puppeteer, such as Playwright's `timezoneId`, takes precedence on the pages it applies to.
110
-
- The location lasts for the browser session. Profiles don't save it.
110
+
- The location lasts for the browser session. Profiles don't save it.[Managed Auth](/auth/configuration#browser-locale) browsers take their locale from the connection instead.
111
111
- A pooled browser you release with `reuse: true` keeps its location for the next acquirer, just as it keeps cookies and open tabs. Release it with `reuse: false` to get a fresh browser instead.
0 commit comments