Tarayıcıyı QR koduyla eşleme

Sayfanız bir QR kodu gösterir, kişi onu Touchque uygulamasıyla okutur ve onay yalnızca okutan telefona, bir kez, numara eşleştirmeyle sorulur. Kullanıcı adı yazılmaz ve bir oltalama sayfası onayı ödünç alamaz: QR bu tarayıcının anahtarına bağlıdır ve istek yalnızca onu okuyan telefona gider.

Nasıl çalışır

Sayfa, tarayıcı anahtarının parmak izini (@touchque/web browserKey.thumbprint()) sunucunuza gönderir.
Sunucunuz qrPairings.create'i çağırır: SDK bir nonce üretir, yalnızca SHA-256 özetini gönderir ve uri'yi (touchque://pair-browser?…) döndürür. Onu QR olarak gösterin; nonce sunucunuzdan hiç çıkmaz.
confirmed olana kadar qrPairings.get ile yoklayın, sonra qrPairing ile login.request gönderin: Touchque yalnızca o telefona, okuttuğu kullanıcı için, bir kez sorar.

Durumlar

state	Anlam
`waiting`	Gösteriliyor, henüz okutulmadı.
`scanned`	Kullanıcılarınızdan birinin hesabı olan bir telefon okuttu; kişi henüz onaylamadı.
`confirmed`	Kişi telefonda onayladı: externalUsername kim olduğunu, proximity telefonun ne kadar yakın olduğunu (aynı ağ, aynı ülke) söyler. Giriş isteğini şimdi gönderin.
`requested`	Giriş isteği o telefona gitti (requestId); her zamanki gibi bekleyin.
`approved`	Telefonda onaylandı.
`refused`	Sunucunuz hayır dedi (refuse); telefon sebebinizi ve mesajınızı gösterir.
`reported`	Kişi birinin okutmasını söylediğini bildirdi: 2FA'sı dondurulur.
`expired`	ttlSeconds içinde kullanılmadı (30–300, varsayılan 120).

Önce kendi kontrolleriniz. Kurallarınız bu tarayıcıya hayır diyorsa (onaylanmamış bilgisayar, fazla tarayıcı, hız sınırları) qrPairings.refuse'u bir sebeple (policy, device_not_approved, too_many_browsers, rate_limited, no_account, other) ve kısa bir mesajla çağırın: telefon kişiye nedenini söyler. Okutmadan sonra, giriş isteğinden önce çalışır.

// Sayfa (@touchque/web): tarayıcı anahtarının parmak izi
import { browserKey } from '@touchque/web';
await browserKey.proof();                          // anahtar yoksa oluşturur
const keyThumbprint = await browserKey.thumbprint();

// Sunucunuz (Node)
const p = await tq.qrPairings.create({ keyThumbprint, clientIp: req.ip, userAgent: req.get('user-agent') });
// p.uri'yi (touchque://pair-browser?…) QR olarak gösterin, sonra yoklayın:
const now = await tq.qrPairings.get(p.pairingId);   // waiting → scanned → confirmed
if (now.state === 'confirmed') {
  await tq.login.request({ externalUsername: now.externalUsername, type: 'LOGIN', qrPairing: p.pairingId });
}
// ya da kendi kontrolleriniz hayır dediyse:
await tq.qrPairings.refuse(p.pairingId, { reason: 'device_not_approved', message: 'Ask IT to approve this computer.' });

p = tq.qr_pairings.create(key_thumbprint, client_ip=ip, user_agent=ua)
# p['uri']'yi (touchque://pair-browser?...) QR olarak gösterin, sonra yoklayın:
now = tq.qr_pairings.get(p['pairingId'])          # waiting -> scanned -> confirmed
if now['state'] == 'confirmed':
    tq.login.request(now['externalUsername'], qr_pairing=p['pairingId'])
# ya da: tq.qr_pairings.refuse(p['pairingId'], 'device_not_approved', 'Ask IT to approve this computer.')

$p = $tq->qrPairings->create($keyThumbprint, ['clientIp' => $request->ip(), 'userAgent' => $request->userAgent()]);
// $p['uri']'yi (touchque://pair-browser?...) QR olarak gösterin, sonra yoklayın:
$now = $tq->qrPairings->get($p['pairingId']);       // waiting -> scanned -> confirmed
if ($now['state'] === 'confirmed') {
    $tq->login->request($now['externalUsername'], qrPairing: $p['pairingId']);
}
// ya da: $tq->qrPairings->refuse($p['pairingId'], 'device_not_approved', 'Ask IT to approve this computer.');

p, err := client.QRPairings.Create(ctx, touchque.CreateQRPairingOptions{KeyThumbprint: thumb, ClientIP: ip, UserAgent: r.UserAgent()})
// p.URI'yi (touchque://pair-browser?...) QR olarak gösterin, sonra yoklayın:
now, err := client.QRPairings.Get(ctx, p.PairingID) // waiting -> scanned -> confirmed
if now.State == "confirmed" {
    _, err = client.Login.RequestWithOptions(touchque.LoginRequestOptions{ExternalUsername: now.ExternalUsername, Type: "LOGIN", QRPairing: p.PairingID})
}
// ya da: client.QRPairings.Refuse(ctx, p.PairingID, touchque.RefuseQRPairingOptions{Reason: "device_not_approved", Message: "Ask IT to approve this computer."})

var p = await tq.QrPairings.CreateAsync(new CreateQrPairingOptions { KeyThumbprint = thumb, ClientIp = ip, UserAgent = userAgent });
// p.Uri'yi (touchque://pair-browser?...) QR olarak gösterin, sonra yoklayın:
var now = await tq.QrPairings.GetAsync(p.PairingId);   // waiting -> scanned -> confirmed
if (now.State == "confirmed")
    await tq.Login.RequestAsync(new LoginRequestOptions { ExternalUsername = now.ExternalUsername!, QrPairing = p.PairingId });
// ya da: await tq.QrPairings.RefuseAsync(p.PairingId, new RefuseQrPairingOptions { Reason = "device_not_approved", Message = "Ask IT to approve this computer." });

QrPairings.Created p = tq.qrPairings().create(new QrPairings.CreateOptions(thumb).clientIp(ip).userAgent(userAgent));
// p.uri()'yi (touchque://pair-browser?...) QR olarak gösterin, sonra yoklayın:
JsonNode now = tq.qrPairings().get(p.pairingId());   // waiting -> scanned -> confirmed
if ("confirmed".equals(now.path("state").asText())) {
    tq.login().request(new LoginRequestOptions(now.path("externalUsername").asText()).qrPairing(p.pairingId()));
}
// ya da: tq.qrPairings().refuse(p.pairingId(), "device_not_approved", "Ask IT to approve this computer.", null, null);

p = tq.qr_pairings.create(key_thumbprint, client_ip: request.remote_ip, user_agent: request.user_agent)
# p["uri"]'yi (touchque://pair-browser?...) QR olarak gösterin, sonra yoklayın:
now = tq.qr_pairings.get(p["pairingId"])            # waiting -> scanned -> confirmed
tq.login.request(now["externalUsername"], qr_pairing: p["pairingId"]) if now["state"] == "confirmed"
# ya da: tq.qr_pairings.refuse(p["pairingId"], reason: "device_not_approved", message: "Ask IT to approve this computer.")

# İmzalı istekler (HMAC), bkz. Kimlik Doğrulama
POST /qr-pairings
{ "nonceHash": "<base64url SHA-256 of a 32-byte nonce>", "keyThumbprint": "<RFC 7638>", "clientIp": "203.0.113.7", "userAgent": "…", "ttlSeconds": 120 }
→ { "pairingId": "…", "expiresAt": "…" }
# QR metni: touchque://pair-browser?v=1&p=<pairingId>&n=<nonce>&k=<keyThumbprint>

GET  /qr-pairings/<pairingId>
→ { "state": "confirmed", "externalUsername": "ayse@acme.com", "proximity": { "sameNetwork": true, "sameCountry": true, "warnings": [] } }

POST /login/request   { "externalUsername": "ayse@acme.com", "type": "LOGIN", "qrPairing": "<pairingId>" }
POST /qr-pairings/<pairingId>/outcome   { "reason": "device_not_approved", "message": "Ask IT to approve this computer.", "deviceCode": "ABC-123" }