Skip to main content

Module sso

Module sso 

Source
Expand description

Garmin SSO Authentication

Implements the Garmin Connect SSO login flow using the mobile JSON API.

§Background

The previous implementation scraped <title> tags from Garmin’s SSO HTML page to determine login status (matching garth < 0.8.0). Garmin changed their SSO page structure, breaking this approach.

This implementation ports the approach from garth 0.8.0, which switched to Garmin’s mobile JSON API endpoints:

  • GET /mobile/sso/en/sign-in — establish session cookies
  • POST /mobile/api/login — submit credentials, receive ticket or MFA challenge
  • POST /mobile/api/mfa/verifyCode — verify MFA code if required

Reference: https://github.com/matin/garth/blob/main/garth/sso.py

Structs§

SsoClient
SSO Client for Garmin authentication