Kopplung
Funktionsunterstützung über app.capabilities prüfen, Autorisierung über app.access und Host-Berechtigungen. Die Beispiele verwenden synthetische Werte; vor dem Aufruf Pfade, IDs, Eingaben und Filter ersetzen.
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))Das JSON-Segment öffnen, um die vollständige signierte Eingabe des synthetischen Beispiels anzusehen. Der Empfänger prüft sie mit dem öffentlichen Schlüssel des Signierenden.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 zeigt den Code, B scannt ihn. Im LAN identifiziert c-id den Sender; BLE verwendet seinen eigenen Transport. PAIR_CANCEL ist optional.
Synthetischer Schnappschuss zu einem festen Zeitpunkt; Signaturen und requestIds stimmen überein. 192.0.2.0/24 ist für Dokumentation reserviert. 8443 ist der Standard-HTTPS-Port; tatsächliche Anfragen verwenden den erkannten Port. Diese zeitlich begrenzten Anfragen können nicht unverändert wiederholt werden.
Wenn Sie in PlainApp Desktop ein neues Gerät oder ein Gerät mit geändertem öffentlichem Schlüssel verwalten, müssen Sie ihm zuerst ausdrücklich vertrauen. Dieser Schritt zeigt keinen Vergleichscode; bei einer Schlüsseländerung erscheint eine Warnung. Ohne Passwort vergleichen Sie anschließend den einen Code auf beiden Geräten, bevor Sie auf dem anderen Gerät zustimmen. Bei Anmeldung mit Passwort kann das andere Gerät auch ohne Code um Zustimmung bitten.
Typdefinitionen
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
}Operationen
peersChanged
Empfängt ein Änderungssignal bei geänderten Gerätedatensätzen.
subscription peersChanged {
peersChanged
}pairingRequested
Empfängt eine eingehende Kopplungsanfrage, über die entschieden werden muss.
subscription pairingRequested {
pairingRequested { fromIp fromId fromName deviceType verificationCode identityChanged }
}pairingCompleted
Empfängt eine Benachrichtigung über eine abgeschlossene Gerätekopplung.
subscription pairingCompleted {
pairingCompleted { deviceId deviceName ip port deviceType requestId }
}pairingStarted
Empfängt eine Benachrichtigung über einen gestarteten Kopplungsversuch.
subscription pairingStarted {
pairingStarted { verificationCode deviceId deviceName error }
}pairingFailed
Empfängt eine Benachrichtigung über einen fehlgeschlagenen Kopplungsversuch.
subscription pairingFailed {
pairingFailed { verificationCode deviceId deviceName error }
}pairingCanceled
Empfängt eine Benachrichtigung über einen abgebrochenen Kopplungsversuch.
subscription pairingCanceled {
pairingCanceled { verificationCode deviceId deviceName error }
}cancelPairing
Aktuelle Kopplung des angegebenen Geräts abbrechen.
mutation cancelPairing($peerId: ID!) {
cancelPairing(peerId: $peerId)
}deletePeer
Gerät und Einzelchatverlauf löschen; bei Kanalverweisen bleibt ein Kanaldatensatz erhalten.
mutation deletePeer($peerId: ID!) {
deletePeer(peerId: $peerId)
}pairPeer
Chatkopplung oder Verwaltungsanmeldung starten; true bestätigt die Annahme.
mutation pairPeer($peerId: ID!, $input: PairPeerInput!) {
pairPeer(peerId: $peerId, input: $input)
}respondToPairing
Ausstehende Kopplungsanfrage oder Vertrauensbestätigung des Geräts annehmen oder ablehnen.
mutation respondToPairing($peerId: ID!, $accepted: Boolean!) {
respondToPairing(peerId: $peerId, accepted: $accepted)
}unpairPeer
Lokal entkoppeln und Verwaltungszugriff entfernen; Chatverlauf behalten.
mutation unpairPeer($peerId: ID!) {
unpairPeer(peerId: $peerId)
}peerFileUrl
Download-URL mit der aktuell gespeicherten Geräteadresse erstellen.
query peerFileUrl($peerId: ID!, $fileId: String!) {
peerFileUrl(peerId: $peerId, fileId: $fileId)
}peers
Alle gespeicherten Geräte auflisten, einschließlich gekoppelter, entkoppelter und reiner Kanalgeräte.
query peers {
peers { id name ip status port deviceType createdAt updatedAt }
}