A route returns 404 when its provider is not configured.
Apple and Google
Pylon checks the token’s signature against the provider’s keys. It also checks the issuer, the expiry, and the audience.
Apple gives your app the user’s name only on the first sign-in, and never puts it in the token. Send it as
name on that first request.
An account links to an existing user with the same email address. A Google account with an unverified email is refused.
Federated apps
An app whose users come from another Pylon app acting as its IdP (itsauth.org.federation provider) cannot use the routes above: they sign in a local user, and the IdP’s workspaces never arrive. Sign in to the IdP instead, then:
- Trade the IdP session for an id_token addressed to the app with a token exchange.
- Post it to the app:
<provider> is the app’s OIDC provider name (PYLON_OAUTH_<NAME>_OIDC_ISSUER). The app checks the token against the IdP’s published keys: signature, issuer, audience (its own client id) and expiry. The email must be verified. The sign-in then runs the same path as the browser callback, including the org federation mirror from the orgs claim. The answer is { token, user_id, expires_at, provider }; send the token as Authorization: Bearer.
In Swift: exchangeSession(forClient:) on a client for the IdP, then signInFederated(provider:idToken:accessToken:) on a client for the app.
Steam
The game gets a ticket from Steam withISteamUser::GetAuthTicketForWebApi(identity). Pylon checks the ticket with Steam’s ISteamUserAuth/AuthenticateUserTicket Web API.
Steam refuses a ticket made for another app id or another identity. This means a ticket that a player gave another service cannot sign in to your app.
- The account is the player’s SteamID64. With Family Sharing, the player signs in as themselves, not as the account that owns the game.
- Email: Steam gives no email address. A Steam account never links to an existing user by email.
- The user row: the first sign-in creates a user with a placeholder address,
steam-<steamid>-<random>@steam.invalid. This address is not verified and never receives mail. Replace it if you collect a real address. - Errors:
- 401
INVALID_TICKET: Steam refused the ticket. - 403
ACCOUNT_BANNED: the player is banned andPYLON_STEAM_REFUSE_BANNEDis on. - 502
PROVIDER_UNAVAILABLE: Pylon could not reach Steam. The route fails closed.
- 401
Get the ticket
Steamworks.NET:SignInWithAppleAsync, SignInWithGoogleAsync, and SignInWithSteamAsync. See the C# and Unity SDK.