ペアリング
機能の対応状況は app.capabilities、認可は app.access とホストの権限で確認してください。例は合成値を使用しています。呼び出す前にパス、ID、入力、フィルターを置き換えてください。
plainapp://pair?request=<URL-encoded JSON>QR
signature = Base64(Ed25519-Sign(Device A private key, signed))Ed25519-Verify(Device A public key, signed, Base64Decode(signature))JSON セグメントを開くと、この合成例の署名対象入力全体を確認できます。受信者は署名者の公開鍵で検証します。verificationCode = 73939800digest = SHA256(request.signature encoded as UTF-8)digest (hex) = ff44f60497bc235899f050f272165ec094a2f2c685e776d153a0711424b85dc0number = first 8 digest bytes as an unsigned big-endian integerverificationCode = number mod 100000000, padded to 8 decimal digitsQR:A が表示し、B がスキャンします。LAN の c-id は送信者を識別し、BLE は独自の転送方式を使用します。PAIR_CANCEL は任意です。
固定時刻の合成スナップショットで、署名と requestIds は一致しています。192.0.2.0/24 はドキュメント用に予約されています。8443 はデフォルトの HTTPS ポートです。実際のリクエストでは検出したポートを使用してください。これらの有効期間付きリクエストをそのまま再利用することはできません。
PlainApp Desktop で新しいデバイスや公開鍵が変更されたデバイスを管理する場合は、まずそのデバイスを信頼することを明示的に確認します。この段階では照合コードは表示されず、公開鍵が変更されている場合は警告が表示されます。パスワードを使わない場合は、両方のデバイスに表示されるコードが一致していることを確認してから、管理対象のデバイスで承認してください。パスワードで認証した場合も、コードを表示せずに相手側で承認を求められることがあります。
型定義
type Subscription {
peersChanged: Boolean!
pairingRequested: PairingRequestNotice!
pairingCompleted: PairingCompletedNotice!
pairingStarted: PairingProgressNotice!
pairingFailed: PairingProgressNotice!
pairingCanceled: PairingProgressNotice!
}
type Mutation {
cancelPairing(peerId: ID!): Boolean!
deletePeer(peerId: ID!): Boolean!
pairPeer(peerId: ID!, input: PairPeerInput!): Boolean!
respondToPairing(peerId: ID!, accepted: Boolean!): Boolean!
unpairPeer(peerId: ID!): Boolean!
}
type Query {
peerFileUrl(peerId: ID!, fileId: String!): String!
peers: [Peer!]!
}
enum DeviceType {
COMPUTER
PHONE
TABLET
TV
NAS
OTHER
}
scalar Instant
input PairPeerInput {
mode: PairingMode!
password: String
}
type PairingCompletedNotice {
deviceId: ID!
deviceName: String!
ip: String!
port: Int
deviceType: DeviceType
requestId: String
}
enum PairingErrorCode {
TIMEOUT
REJECTED
PASSWORD_REQUIRED
INVALID_PASSWORD
PEER_IDENTITY_CHANGED
TOO_MANY_LOGIN_ATTEMPTS
INTERNAL_ERROR
}
enum PairingMode {
CHAT
MANAGE
}
type PairingProgressNotice {
verificationCode: String
deviceId: ID!
deviceName: String!
error: PairingErrorCode
}
type PairingRequestNotice {
fromIp: String!
fromId: ID!
fromName: String!
deviceType: DeviceType!
verificationCode: String!
identityChanged: Boolean!
}
type Peer {
id: ID!
name: String!
ip: String!
status: PeerStatus!
port: Int
deviceType: DeviceType!
createdAt: Instant!
updatedAt: Instant!
online: Boolean!
managed: Boolean!
key: String!
publicKey: String!
token: String!
}
enum PeerStatus {
PAIRED
UNPAIRED
CHANNEL
}操作
peersChanged
ピアレコード変更時に変更シグナルを受信します。
subscription peersChanged {
peersChanged
}pairingRequested
判断を待つ受信ペアリングリクエストを受信します。
subscription pairingRequested {
pairingRequested { fromIp fromId fromName deviceType verificationCode identityChanged }
}pairingCompleted
デバイスのペアリング完了通知を受信します。
subscription pairingCompleted {
pairingCompleted { deviceId deviceName ip port deviceType requestId }
}pairingStarted
ペアリング試行の開始通知を受信します。
subscription pairingStarted {
pairingStarted { verificationCode deviceId deviceName error }
}pairingFailed
ペアリング試行の失敗通知を受信します。
subscription pairingFailed {
pairingFailed { verificationCode deviceId deviceName error }
}pairingCanceled
ペアリング試行のキャンセル通知を受信します。
subscription pairingCanceled {
pairingCanceled { verificationCode deviceId deviceName error }
}cancelPairing
指定したデバイスで進行中のペアリングを取り消します。
mutation cancelPairing($peerId: ID!) {
cancelPairing(peerId: $peerId)
}deletePeer
デバイスと個別チャットの履歴を削除します。チャンネルが参照している場合はチャンネル用の記録を残します。
mutation deletePeer($peerId: ID!) {
deletePeer(peerId: $peerId)
}pairPeer
チャットのペアリングまたは管理ログインを開始します。true は受け付けたことを示します。
mutation pairPeer($peerId: ID!, $input: PairPeerInput!) {
pairPeer(peerId: $peerId, input: $input)
}respondToPairing
デバイスの保留中のペアリング要求または信頼確認を承認・拒否します。
mutation respondToPairing($peerId: ID!, $accepted: Boolean!) {
respondToPairing(peerId: $peerId, accepted: $accepted)
}unpairPeer
この端末でペアリングを解除し、管理権限を削除します。チャット履歴は残します。
mutation unpairPeer($peerId: ID!) {
unpairPeer(peerId: $peerId)
}peerFileUrl
デバイスの現在の保存済みアドレスでファイルのダウンロード URL を作成します。
query peerFileUrl($peerId: ID!, $fileId: String!) {
peerFileUrl(peerId: $peerId, fileId: $fileId)
}peers
ペアリング済み、未ペアリング、チャンネル専用を含む、保存済みのすべてのデバイスを一覧表示します。
query peers {
peers { id name ip status port deviceType createdAt updatedAt }
}