launcher answers
sessionRequestId is 21 characters of A-Za-z0-9_-. url is on the site's host unless the create call sends X-Forwarded-Host, which url copies: a proxy strips that header.
Partly measured. the create call on a site with authentication_app_session_launcher_enabled false. The probed site has it on and no preference is changed; blocked on the site
API
Q What shape is a sessionRequestId, is the approval url always on the site's own host, and what
does the launcher answer when the site has it switched off?
Endpoint POST /internal_api/app_session_request ; PUT /internal_api/app_session_request/<id> ; GET /api/v1
Docs claim Silent. The launcher is undocumented (probe 052).
Actual
GET /api/v1 authentication_app_session_launcher_enabled True user_authentication_method 'oxygen'
POST /internal_api/app_session_request, appName + machineId, nine times
200 keys ['sessionRequestId', 'url']
sessionRequestId length 21 every time; characters seen 0-9 a-z A-Z - _; not a UUID; 9 distinct
url https://<site host>/app_session_request/<id>?sticky_id=<sticky_id>
sticky_id length 21, same alphabet, never equal to the id
extra request header url host url scheme, port
none the site's https, none
X-Forwarded-Host: example.invalid example.invalid https, none
X-Forwarded-Host + X-Forwarded-Proto: http + -Port: 8443 example.invalid https, none
Forwarded: host=example.invalid;proto=https the site's https, none
Origin and Referer: https://example.invalid the site's https, none
DELETE /internal_api/app_session_request/<id> 404 {"errors":[{"status":404,"code":103,"title":"Not Found",...}]}
PUT the same id after it 200 {"approved":false}
PUT every 30s 404 for all five by 313s
Teaches
- Validate a
sessionRequestIdas^[A-Za-z0-9_-]{21}$on the probed site's nine samples. Treat it as opaque beyond that; nothing documents the shape. urltakes its host fromX-Forwarded-Hostwhen the create call has one, and a person who opens it lands on a host that is not the site. A proxy forwarding the launcher calls (probe 062) drops that header, and a client checks thaturl's host equals the site's before opening it.X-Forwarded-Proto,X-Forwarded-Port,Forwarded,OriginandRefererchange nothing inurl.sticky_idis a second 21-character value, not a copy of the id. Passurlthrough whole.- A pending request cannot be withdrawn:
DELETEis 404 code 103 and the request still answers. It is forgotten about five minutes after creation (probe 052). - On a site with the launcher switched off the answer is unmeasured. Read
authentication_app_session_launcher_enabledfromGET /api/v1before offering this sign-in, and measure the create call there withpython probes/130_launcher_answers.pyagainst such a site.