API রেফারেন্স

WebSocket এনক্রিপশন

GraphQL সাবস্ক্রিপশন এনক্রিপ্ট করা বাইনারি ফ্রেম ব্যবহার করে।

ক্লায়েন্ট
wss://<host>:<port>/graphql?cid=706c6169-3b80-8f42-9a61-4e312e54d001
সার্ভার

Init পাঠান

initFrame

সার্ভার Init যাচাই করে ও clientNonce পড়ে।

রিপ্লে প্রতিরোধ

WebSocket সংযোগ…/graphql?cid=<clientId>
↓
প্রতি সংযোগে নতুন Init / Ackbinding = SHA256(fields(initFrame, ackFrame))
↓
দুই দিকে আলাদা কাউন্টারclient → server: seq 1, 2, 3…server → client: seq 1, 2, 3…
↓
প্রমাণীকরণ ও ডিক্রিপ্ট করুনseq = lastReceived + 1
✓ ↓গ্রহণ করুনlastReceived ← seq
✕ ↓প্রত্যাখ্যান করুনclose

পুনঃসংযোগ: নতুন binding, কাউন্টার রিসেট

ক্ষেত্রে মাউস রাখুন বা স্পর্শ করুন
1 / 5

অন্যান্য WebSocket রুট

ক্লায়েন্ট
wss://<host>:<port>/screen?cid=<clientId>
সার্ভার

Init · clientNonce

Init

সার্ভার Init যাচাই করে ও clientNonce পড়ে।

XChaCha20-Poly1305 · ক্ষেত্রে মাউস রাখুন বা স্পর্শ করুন
1 / 5

অপারেশন

websocket

1. সংযোগ

সকেট খোলার পরে Init পাঠান। cid ক্লায়েন্ট শনাক্ত করে।

typescript
const cid = '706c6169-3b80-8f42-9a61-4e312e54d001' // Your existing session's client ID
const socket = new WebSocket(
  'wss://<device-host>:<https-port>/graphql?cid=' + encodeURIComponent(cid)
)
socket.binaryType = 'arraybuffer'
let binding: Uint8Array
let lastSent = 0n
let lastReceived = 0n
protocol

2. ক্লায়েন্ট Init

10 সেকেন্ডের মধ্যে পাঠান। clientNonce: 64 hex অক্ষরে 32টি দৈব বাইট। AEAD nonce: প্রতি ফ্রেমে 24টি দৈব বাইট।

typescript
// Run immediately on socket.open.
const init = {
  clientNonce: Array.from(randomBytes(32), n => n.toString(16).padStart(2, '0')).join(''),
}
const aad = fields([utf8.encode('WS_INIT'), utf8.encode('/graphql'), utf8.encode(cid)])
const initFrame = seal(key, utf8.encode(JSON.stringify(init)), aad)
socket.send(initFrame) // Retain these exact bytes for Ack.
protocol

3. সার্ভার Ack

Ack যাচাই ও binding গণনা করুন, পরে সঙ্গে সঙ্গে ক্লায়েন্ট sequence 1-এ এনক্রিপ্ট করা খালি নিশ্চিতকরণ পাঠান।

typescript
socket.addEventListener('message', event => {
  const ackFrame = new Uint8Array(event.data)
  if (ackFrame.length < 40) throw new Error('Invalid Ack')
  const aad = fields([utf8.encode('WS_ACK'), utf8.encode('/graphql'), utf8.encode(cid), sha256(initFrame)])
  const ack: { serverNonce: string } = JSON.parse(decoder.decode(open(key, ackFrame, aad)))
  if (!/^[0-9a-f]{64}$/.test(ack.serverNonce)) throw new Error('Invalid serverNonce')
  binding = sha256(fields([initFrame, ackFrame]))
  lastSent = lastReceived = 0n
  const counter = uint64be(1n)
  const confirmationAad = fields([utf8.encode('WS_FRAME'), utf8.encode('/graphql'), utf8.encode(cid), binding, utf8.encode('client'), counter])
  const encrypted = seal(key, new Uint8Array(), confirmationAad)
  lastSent = 1n
  socket.send(concatBytes(counter, encrypted))
}, { once: true })
protocol

4. এনক্রিপ্ট করা বার্তা পাঠান

direction client ও নতুন nonce ব্যবহার করুন। খালি নিশ্চিতকরণ sequence 1 ব্যবহার করে; কার্যকরী বার্তা sequence 2 থেকে শুরু ও কঠোরভাবে বাড়ে।

typescript
const message = {
  type: 'subscribe', id: 'prefs',
  payload: { query: 'subscription { prefsChanged }' },
}
const next = lastSent + 1n
const counter = uint64be(next) // Reject overflow; never wrap.
const aad = fields([utf8.encode('WS_FRAME'), utf8.encode('/graphql'), utf8.encode(cid), binding, utf8.encode('client'), counter])
const encrypted = seal(key, utf8.encode(JSON.stringify(message)), aad)
lastSent = next // Advance only after successful encryption.
socket.send(concatBytes(counter, encrypted))
protocol

5. এনক্রিপ্ট করা বার্তা নিন

lastReceived + 1 (প্রথম: 1) ও direction server আবশ্যক। শুধু প্রমাণীকৃত ডিক্রিপশনের পরে বাড়ান।

typescript
// For each binary message after Ack, in arrival order:
const frame = new Uint8Array(event.data)
if (frame.length < 48) throw new Error('Invalid frame')
const sequence = new DataView(frame.buffer).getBigUint64(0, false)
if (sequence !== lastReceived + 1n) throw new Error('Invalid sequence')
const aad = fields([utf8.encode('WS_FRAME'), utf8.encode('/graphql'), utf8.encode(cid), binding, utf8.encode('server'), frame.subarray(0, 8)])
const plaintext = open(key, frame.subarray(8), aad) // Throws on invalid tag.
lastReceived = sequence // Advance only after authentication.
const message = JSON.parse(decoder.decode(plaintext))
protocol

6. বার্তার ধরন

ping/pong-সহ অ্যাপের JSON বার্তাগুলো এনক্রিপ্ট করা হয়। WebSocket-এর নিজস্ব Ping/Pong নিয়ন্ত্রণ ফ্রেম এই এনক্রিপশন দিয়ে মোড়ানো হয় না, তবে TLS সেগুলোকে সুরক্ষা দিতে পারে। subscriptionReady জানায় যে সাবস্ক্রিপশন প্রস্তুত।

typescript
const subscribe = {
  type: 'subscribe', id: 'prefs',
  payload: { query: 'subscription { prefsChanged }' },
}
const ready = {
  type: 'next', id: 'prefs',
  payload: { data: null, extensions: { subscriptionReady: true } },
}
const event = {
  type: 'next', id: 'prefs',
  payload: { data: { prefsChanged: true } },
}
const complete = { type: 'complete', id: 'prefs' }
const ping = { type: 'ping', payload: null }
const pong = { type: 'pong', payload: null }
const error = { type: 'error', id: 'prefs', payload: [{ message: '...' }] }
protocol

7. সীমা ও ব্যর্থতা

প্রমাণীকরণ বা ক্রম ব্যর্থ হলে বন্ধ করুন। নতুন হ্যান্ডশেক দিয়ে আবার সংযুক্ত হন।

text
Server Init wait:     timeout(10 seconds, socket.next()), after upgrade and session-key lookup
Server confirmation:  timeout(10 seconds, socket.next()), after Ack send completes
Confirmation:         send encrypted empty payload immediately after Ack, client sequence 1
Business messages:    client starts at sequence 2; server starts at sequence 1
Init replay:          may receive a fresh Ack; old bound frames fail
Replay state:         connection counters, no timestamp or global cache
Message sequence:     last + 1, independently in each direction
Sequence overflow:    u64 max once; next frame fails, never wrap to 0
Frame size:           <= 1,048,576 bytes
Timeout/auth failure: close 1008, reason "invalid_subscription"
Reconnect:            fresh Init / Ack, new binding, last counters reset to 0; no legacy fallback