/* Copyright 2019, 2020 The Matrix.org Foundation C.I.C. Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. */ import React from "react"; import { ShowQrCodeCallbacks, ShowSasCallbacks, VerificationPhase as Phase, VerificationRequest, VerificationRequestEvent, VerifierEvent, } from "matrix-js-sdk/src/crypto-api"; import { Device, RoomMember, User } from "matrix-js-sdk/src/matrix"; import { logger } from "matrix-js-sdk/src/logger"; import { VerificationMethod } from "matrix-js-sdk/src/types"; import { MatrixClientPeg } from "../../../MatrixClientPeg"; import VerificationQRCode from "../elements/crypto/VerificationQRCode"; import { _t } from "../../../languageHandler"; import SdkConfig from "../../../SdkConfig"; import E2EIcon, { E2EState } from "../rooms/E2EIcon"; import Spinner from "../elements/Spinner"; import AccessibleButton from "../elements/AccessibleButton"; import VerificationShowSas from "../verification/VerificationShowSas"; import { getDeviceCryptoInfo } from "../../../utils/crypto/deviceInfo"; interface IProps { layout: string; request: VerificationRequest; member: RoomMember | User; phase?: Phase; onClose: () => void; isRoomEncrypted: boolean; inDialog: boolean; } interface IState { /** * The data for the QR code to display. * * We attempt to calculate this once the verification request transitions into the "Ready" phase. If the other * side cannot scan QR codes, it will remain `undefined`. */ qrCodeBytes: Buffer | undefined; sasEvent: ShowSasCallbacks | null; emojiButtonClicked?: boolean; reciprocateButtonClicked?: boolean; reciprocateQREvent: ShowQrCodeCallbacks | null; /** * Details of the other device involved in the transaction. * * `undefined` if there is not (yet) another device in the transaction, or if we do not know about it. */ otherDeviceDetails?: Device; } export default class VerificationPanel extends React.PureComponent { private hasVerifier: boolean; /** have we yet tried to check the other device's info */ private haveCheckedDevice = false; /** have we yet tried to get the QR code */ private haveFetchedQRCode = false; public constructor(props: IProps) { super(props); this.state = { qrCodeBytes: undefined, sasEvent: null, reciprocateQREvent: null }; this.hasVerifier = false; } private renderQRPhase(): JSX.Element { const { member, request } = this.props; const showSAS: boolean = request.otherPartySupportsMethod(VerificationMethod.Sas); const showQR: boolean = request.otherPartySupportsMethod(VerificationMethod.ScanQrCode); const brand = SdkConfig.get().brand; const noCommonMethodError: JSX.Element | null = !showSAS && !showQR ?

{_t("encryption|verification|no_support_qr_emoji", { brand })}

: null; if (this.props.layout === "dialog") { // HACK: This is a terrible idea. let qrBlockDialog: JSX.Element | undefined; let sasBlockDialog: JSX.Element | undefined; if (showQR) { qrBlockDialog = (

{_t("encryption|verification|qr_prompt")}

); } if (showSAS) { sasBlockDialog = (

{_t("encryption|verification|sas_prompt")}

{_t("encryption|verification|sas_description")} {_t("action|start")}
); } const or = qrBlockDialog && sasBlockDialog ? (
{_t("encryption|verification|qr_or_sas", { emojiCompare: "", qrCode: "", })}
) : null; return (
{_t("encryption|verification|qr_or_sas_header")}
{qrBlockDialog} {or} {sasBlockDialog} {noCommonMethodError}
); } let qrBlock: JSX.Element | undefined; if (showQR) { qrBlock = (

{_t("encryption|verification|scan_qr")}

{_t("encryption|verification|scan_qr_explainer", { displayName: (member as User).displayName || (member as RoomMember).name || member.userId, })}

); } let sasBlock: JSX.Element | undefined; if (showSAS) { const disabled = this.state.emojiButtonClicked; const sasLabel = showQR ? _t("encryption|verification|verify_emoji_prompt_qr") : _t("encryption|verification|verify_emoji_prompt"); // Note: mx_VerificationPanel_verifyByEmojiButton is for the end-to-end tests sasBlock = (

{_t("encryption|verification|verify_emoji")}

{sasLabel}

{_t("encryption|verification|verify_emoji")}
); } const noCommonMethodBlock = noCommonMethodError ? (
{noCommonMethodError}
) : null; // TODO: add way to open camera to scan a QR code return ( {qrBlock} {sasBlock} {noCommonMethodBlock} ); } private onReciprocateYesClick = (): void => { if (!this.state.reciprocateQREvent) return; this.setState({ reciprocateButtonClicked: true }); this.state.reciprocateQREvent?.confirm(); }; private onReciprocateNoClick = (): void => { if (!this.state.reciprocateQREvent) return; this.setState({ reciprocateButtonClicked: true }); this.state.reciprocateQREvent?.cancel(); }; /** * Get details of the other device involved in the verification, if we haven't before, and store in the state. */ private async maybeGetOtherDevice(): Promise { if (this.haveCheckedDevice) return; const client = MatrixClientPeg.safeGet(); const deviceId = this.props.request?.otherDeviceId; const userId = client.getUserId(); if (!deviceId || !userId) { return; } this.haveCheckedDevice = true; this.setState({ otherDeviceDetails: await getDeviceCryptoInfo(client, userId, deviceId) }); } private renderQRReciprocatePhase(): JSX.Element { const { member, request } = this.props; const description = request.isSelfVerification ? _t("encryption|verification|qr_reciprocate_same_shield_device") : _t("encryption|verification|qr_reciprocate_same_shield_user", { displayName: (member as User).displayName || (member as RoomMember).name || member.userId, }); let body: JSX.Element; if (this.state.reciprocateQREvent) { // Element Web doesn't support scanning yet, so assume here we're the client being scanned. body = (

{description}

{_t("action|no")} {_t("action|yes")}
); } else { body = (

); } return (

{_t("encryption|verification|scan_qr")}

{body}
); } private renderVerifiedPhase(): JSX.Element { const { member, request } = this.props; let text: string | undefined; if (!request.isSelfVerification) { if (this.props.isRoomEncrypted) { text = _t("encryption|verification|prompt_encrypted"); } else { text = _t("encryption|verification|prompt_unencrypted"); } } let description: string; if (request.isSelfVerification) { const device = this.state.otherDeviceDetails; if (!device) { // This can happen if the device is logged out while we're still showing verification // UI for it. logger.warn("Verified device we don't know about: " + this.props.request.otherDeviceId); description = _t("encryption|verification|successful_own_device"); } else { description = _t("encryption|verification|successful_device", { deviceName: device.displayName, deviceId: device.deviceId, }); } } else { description = _t("encryption|verification|successful_user", { displayName: (member as User).displayName || (member as RoomMember).name || member.userId, }); } return (

{description}

{text ?

{text}

: null} {_t("action|got_it")}
); } private renderCancelledPhase(): JSX.Element { const { member, request } = this.props; let startAgainInstruction: string; if (request.isSelfVerification) { startAgainInstruction = _t("encryption|verification|prompt_self"); } else { startAgainInstruction = _t("encryption|verification|prompt_user"); } let text: string; if (request.cancellationCode === "m.timeout") { text = _t("encryption|verification|timed_out") + ` ${startAgainInstruction}`; } else if (request.cancellingUserId === request.otherUserId) { if (request.isSelfVerification) { text = _t("encryption|verification|cancelled_self"); } else { text = _t("encryption|verification|cancelled_user", { displayName: (member as User).displayName || (member as RoomMember).name || member.userId, }); } text = `${text} ${startAgainInstruction}`; } else { text = _t("encryption|verification|cancelled") + ` ${startAgainInstruction}`; } return (

{_t("common|verification_cancelled")}

{text}

{_t("action|got_it")}
); } public render(): React.ReactNode { const { member, phase, request } = this.props; const displayName = (member as User).displayName || (member as RoomMember).name || member.userId; switch (phase) { case Phase.Ready: return this.renderQRPhase(); case Phase.Started: switch (request.chosenMethod) { case VerificationMethod.Reciprocate: return this.renderQRReciprocatePhase(); case VerificationMethod.Sas: { const emojis = this.state.sasEvent ? ( ) : ( ); return
{emojis}
; } default: return null; } case Phase.Done: return this.renderVerifiedPhase(); case Phase.Cancelled: return this.renderCancelledPhase(); } logger.error("VerificationPanel unhandled phase:", phase); return null; } private startSAS = async (): Promise => { this.setState({ emojiButtonClicked: true }); await this.props.request.startVerification(VerificationMethod.Sas); }; private onSasMatchesClick = (): void => { this.state.sasEvent?.confirm(); }; private onSasMismatchesClick = (): void => { this.state.sasEvent?.mismatch(); }; private updateVerifierState = (): void => { // this method is only called once we know there is a verifier. const verifier = this.props.request.verifier!; const sasEvent = verifier.getShowSasCallbacks(); const reciprocateQREvent = verifier.getReciprocateQrCodeCallbacks(); verifier.off(VerifierEvent.ShowSas, this.updateVerifierState); verifier.off(VerifierEvent.ShowReciprocateQr, this.updateVerifierState); this.setState({ sasEvent, reciprocateQREvent }); }; private onRequestChange = async (): Promise => { const { request } = this.props; // if we have a device ID and did not have one before, fetch the device's details this.maybeGetOtherDevice(); // if we have had a reply from the other side (ie, the phase is "ready") and we have not // yet done so, fetch the QR code if (request.phase === Phase.Ready && !this.haveFetchedQRCode) { this.haveFetchedQRCode = true; request.generateQRCode().then( (buf) => { this.setState({ qrCodeBytes: buf }); }, (error) => { console.error("Error generating QR code:", error); }, ); } const hadVerifier = this.hasVerifier; this.hasVerifier = !!request.verifier; if (!hadVerifier && this.hasVerifier) { request.verifier?.on(VerifierEvent.ShowSas, this.updateVerifierState); request.verifier?.on(VerifierEvent.ShowReciprocateQr, this.updateVerifierState); try { // on the requester side, this is also awaited in startSAS, // but that's ok as verify should return the same promise. await request.verifier?.verify(); } catch (err) { logger.error("error verify", err); } } }; public componentDidMount(): void { const { request } = this.props; request.on(VerificationRequestEvent.Change, this.onRequestChange); if (request.verifier) { const sasEvent = request.verifier.getShowSasCallbacks(); const reciprocateQREvent = request.verifier.getReciprocateQrCodeCallbacks(); this.setState({ sasEvent, reciprocateQREvent }); } this.onRequestChange(); } public componentWillUnmount(): void { const { request } = this.props; if (request.verifier) { request.verifier.off(VerifierEvent.ShowSas, this.updateVerifierState); request.verifier.off(VerifierEvent.ShowReciprocateQr, this.updateVerifierState); } request.off(VerificationRequestEvent.Change, this.onRequestChange); } }