Sign in with an identity provider through the vendor's managed sign in
idp browser session: reference page for this CustomDomain™ API operation in the cloud browser group. Covers parameters, request body, responses and error codes.
On a session whose vendor never shows its page (no_live_page: Kernel), the customer pressed our form's "Continue with Google" or "Continue with Apple". The control plane opens the vendor's managed sign in of a profile of this session's own to the identity provider's site, and the view's idp carries the connection and its single use handoff_code: the popup renders the vendor's form, which talks to the vendor from the customer's browser (no password, code or approval passes through CustomDomain™). On success the remote browser is released and made again on the signed in profile, back on the provider's sign in page (idp.state finishing), and the popup forwards the customer's press of the provider's own button over the relay; the identity provider asks the customer to confirm the account (the one page the popup frames on such a session), and the sign in notice carries on as usual. Allowed only in awaiting_sign_in, with no step running (a failed one may be tried again), for a kind the provider's form offers.
Authorization
browserSession The session token of one cloud browser sign in, returned by POST /browser-sessions:redeem. It binds one session, one connection and one workspace, lives at most as long as the session, and stops working the moment the session ends. It lives in the popup's memory only.
In: header
Path Parameters
The cloud browser session id, bs_ and 32 hex characters.
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/browser-sessions/string:idp" \ -H "Content-Type: application/json" \ -d '{ "provider": "google" }'{ "state": "awaiting_sign_in"}{ "code": "string", "title": "string", "details": "string"}{ "code": "string", "title": "string", "details": "string"}{ "code": "string", "title": "string", "details": "string"}{ "code": "string", "title": "string", "details": "string"}{ "code": "string", "title": "string", "details": "string"}