Start a work-account sign-in

GET

/sso/start

const url = 'http://127.0.0.1:7700/api/sso/start';
const options = {method: 'GET'};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url http://127.0.0.1:7700/api/sso/start

Preview. Open without a token. Sends the browser to the provider’s sign-in page, with a state, a nonce and a PKCE challenge, and a cookie that ties the sign-in to this browser. At most 200 sign-ins wait at once, 10 from one address, each for 10 minutes. Past that the browser goes to /#sso/<code>, where redeeming the code says to try again in a few minutes. The provider returns the browser to GET /sso/callback on the address the person used, which must be a redirect address registered with the provider.

Parameters

Query Parameters

device

string

A name for the device that signs in, up to 40 characters.

Responses

302

To the provider. If the sign-in cannot start, to /#sso/<code>, where redeeming the code explains why.