from typing import Optional, Sequence from .auth_account_link_types import IdentityLink, LinkAccount, LinkDecision, OAuthIdentity from .auth_normalise_email import normalise_email def _decision(action: str, reason: str, account_id: Optional[str], email: Optional[str]) -> LinkDecision: return LinkDecision(action=action, reason=reason, account_id=account_id, email=email) def decide_account_link( identity: OAuthIdentity, accounts: Sequence[LinkAccount], links: Sequence[IdentityLink] ) -> LinkDecision: """What to do with an OAuth sign-in, given the accounts and links the app already has. The rules run in a fixed order, so the same inputs always get the same answer; see the README for the attack each rule stops.""" if not isinstance(identity.provider, str) or identity.provider == "": raise ValueError("identity.provider must be a non-empty string") if not isinstance(identity.subject, str) or identity.subject == "": raise ValueError("identity.subject must be a non-empty string") email = None if identity.email is None else normalise_email(identity.email) # The provider's subject is the identity; once linked, the email no longer matters. existing = next((l for l in links if l.provider == identity.provider and l.subject == identity.subject), None) if existing is not None: if any(a.id == existing.account_id for a in accounts): return _decision("sign-in", "existing_link", existing.account_id, email) return _decision("refuse", "linked_account_missing", existing.account_id, email) if email is None: return _decision("refuse", "no_email", None, None) matches = [a for a in accounts if normalise_email(a.email) == email] if not matches: if identity.email_verified is True: return _decision("create", "new_account", None, email) return _decision("require-verification", "unverified_new_email", None, email) if len(matches) > 1: return _decision("refuse", "ambiguous_email", None, email) account = matches[0] if identity.email_verified is not True: return _decision("refuse", "unverified_email", account.id, email) if any(l.account_id == account.id and l.provider == identity.provider and l.subject != identity.subject for l in links): return _decision("refuse", "provider_already_linked", account.id, email) if account.email_verified is not True: return _decision("require-verification", "account_email_unverified", account.id, email) return _decision("link", "verified_email_match", account.id, email)