mirror of
https://github.com/trezor/trezor-firmware.git
synced 2025-03-13 14:46:06 +00:00
411 lines
14 KiB
Python
411 lines
14 KiB
Python
import os
|
|
import random
|
|
import typing as t
|
|
from hashlib import sha256
|
|
|
|
import pytest
|
|
import typing_extensions as tx
|
|
|
|
from tests.common import get_test_address
|
|
from trezorlib import exceptions, protobuf
|
|
from trezorlib.client import ProtocolV2Channel
|
|
from trezorlib.debuglink import TrezorClientDebugLink as Client
|
|
from trezorlib.messages import (
|
|
ButtonAck,
|
|
ButtonRequest,
|
|
ThpCodeEntryChallenge,
|
|
ThpCodeEntryCommitment,
|
|
ThpCodeEntryCpaceHostTag,
|
|
ThpCodeEntryCpaceTrezor,
|
|
ThpCodeEntrySecret,
|
|
ThpCredentialRequest,
|
|
ThpCredentialResponse,
|
|
ThpEndRequest,
|
|
ThpEndResponse,
|
|
ThpNfcTagHost,
|
|
ThpNfcTagTrezor,
|
|
ThpPairingMethod,
|
|
ThpPairingPreparationsFinished,
|
|
ThpPairingRequest,
|
|
ThpPairingRequestApproved,
|
|
ThpQrCodeSecret,
|
|
ThpQrCodeTag,
|
|
ThpSelectMethod,
|
|
)
|
|
from trezorlib.transport.thp import curve25519
|
|
from trezorlib.transport.thp.cpace import Cpace
|
|
|
|
if t.TYPE_CHECKING:
|
|
P = tx.ParamSpec("P")
|
|
|
|
MT = t.TypeVar("MT", bound=protobuf.MessageType)
|
|
|
|
pytestmark = [pytest.mark.protocol("protocol_v2")]
|
|
|
|
|
|
def _prepare_protocol(client: Client) -> ProtocolV2Channel:
|
|
protocol = client.protocol
|
|
assert isinstance(protocol, ProtocolV2Channel)
|
|
protocol._reset_sync_bits()
|
|
protocol._do_channel_allocation()
|
|
return protocol
|
|
|
|
|
|
def _prepare_protocol_for_pairing(
|
|
client: Client, host_static_randomness: bytes | None = None
|
|
) -> ProtocolV2Channel:
|
|
protocol = _prepare_protocol(client)
|
|
protocol._do_handshake(host_static_randomness=host_static_randomness)
|
|
return protocol
|
|
|
|
|
|
def _get_encrypted_transport_protocol(
|
|
client: Client, host_static_randomness: bytes | None = None
|
|
) -> ProtocolV2Channel:
|
|
protocol = _prepare_protocol_for_pairing(
|
|
client, host_static_randomness=host_static_randomness
|
|
)
|
|
protocol._do_pairing(client.debug)
|
|
return protocol
|
|
|
|
|
|
def _handle_pairing_request(
|
|
client: Client, protocol: ProtocolV2Channel, host_name: str | None = None
|
|
) -> None:
|
|
protocol._send_message(ThpPairingRequest(host_name=host_name))
|
|
button_req = protocol._read_message(ButtonRequest)
|
|
assert button_req.name == "pairing_request"
|
|
|
|
protocol._send_message(ButtonAck())
|
|
|
|
client.debug.press_yes()
|
|
|
|
protocol._read_message(ThpPairingRequestApproved)
|
|
|
|
|
|
def test_allocate_channel(client: Client) -> None:
|
|
protocol = _prepare_protocol(client)
|
|
|
|
nonce = random.randbytes(8)
|
|
|
|
# Use valid nonce
|
|
protocol._send_channel_allocation_request(nonce)
|
|
protocol._read_channel_allocation_response(nonce)
|
|
|
|
# Expect different nonce
|
|
protocol._send_channel_allocation_request(nonce)
|
|
with pytest.raises(Exception, match="Invalid channel allocation response."):
|
|
protocol._read_channel_allocation_response(
|
|
expected_nonce=b"\xDE\xAD\xBE\xEF\xDE\xAD\xBE\xEF"
|
|
)
|
|
client.invalidate()
|
|
|
|
|
|
def test_handshake(client: Client) -> None:
|
|
protocol = _prepare_protocol(client)
|
|
|
|
randomness_static = os.urandom(32)
|
|
|
|
protocol._do_channel_allocation()
|
|
protocol._init_noise(
|
|
randomness_static=randomness_static,
|
|
)
|
|
protocol._send_handshake_init_request()
|
|
protocol._read_ack()
|
|
protocol._read_handshake_init_response()
|
|
|
|
protocol._send_handshake_completion_request()
|
|
protocol._read_ack()
|
|
protocol._read_handshake_completion_response()
|
|
|
|
# TODO - without pairing, the client is damaged and results in fail of the following test
|
|
# so far no luck in solving it - it should be also tackled in FW, as it causes unexpected FW error
|
|
protocol._do_pairing(client.debug)
|
|
|
|
|
|
def test_pairing_qr_code(client: Client) -> None:
|
|
protocol = _prepare_protocol_for_pairing(client)
|
|
_handle_pairing_request(client, protocol, "TestTrezor QrCode")
|
|
protocol._send_message(
|
|
ThpSelectMethod(selected_pairing_method=ThpPairingMethod.QrCode)
|
|
)
|
|
protocol._read_message(ThpPairingPreparationsFinished)
|
|
|
|
# QR Code shown
|
|
|
|
# Read code from "Trezor's display" using debuglink
|
|
|
|
pairing_info = client.debug.pairing_info(
|
|
thp_channel_id=protocol.channel_id.to_bytes(2, "big")
|
|
)
|
|
code = pairing_info.code_qr_code
|
|
|
|
# Compute tag for response
|
|
sha_ctx = sha256(protocol.handshake_hash)
|
|
sha_ctx.update(code)
|
|
tag = sha_ctx.digest()
|
|
|
|
protocol._send_message(ThpQrCodeTag(tag=tag))
|
|
|
|
secret_msg = protocol._read_message(ThpQrCodeSecret)
|
|
|
|
# Check that the `code` was derived from the revealed secret
|
|
sha_ctx = sha256(ThpPairingMethod.QrCode.to_bytes(1, "big"))
|
|
sha_ctx.update(protocol.handshake_hash)
|
|
sha_ctx.update(secret_msg.secret)
|
|
computed_code = sha_ctx.digest()[:16]
|
|
assert code == computed_code
|
|
|
|
protocol._send_message(ThpEndRequest())
|
|
protocol._read_message(ThpEndResponse)
|
|
|
|
protocol._has_valid_channel = True
|
|
|
|
|
|
def test_pairing_code_entry(client: Client) -> None:
|
|
protocol = _prepare_protocol_for_pairing(client)
|
|
|
|
_handle_pairing_request(client, protocol, "TestTrezor CodeEntry")
|
|
|
|
protocol._send_message(
|
|
ThpSelectMethod(selected_pairing_method=ThpPairingMethod.CodeEntry)
|
|
)
|
|
|
|
commitment_msg = protocol._read_message(ThpCodeEntryCommitment)
|
|
commitment = commitment_msg.commitment
|
|
|
|
challenge = random.randbytes(16)
|
|
protocol._send_message(ThpCodeEntryChallenge(challenge=challenge))
|
|
|
|
cpace_trezor = protocol._read_message(ThpCodeEntryCpaceTrezor)
|
|
cpace_trezor_public_key = cpace_trezor.cpace_trezor_public_key
|
|
|
|
# Code Entry code shown
|
|
|
|
pairing_info = client.debug.pairing_info(
|
|
thp_channel_id=protocol.channel_id.to_bytes(2, "big")
|
|
)
|
|
code = pairing_info.code_entry_code
|
|
|
|
cpace = Cpace(handshake_hash=protocol.handshake_hash)
|
|
cpace.random_bytes = random.randbytes
|
|
cpace.generate_keys_and_secret(code.to_bytes(6, "big"), cpace_trezor_public_key)
|
|
sha_ctx = sha256(cpace.shared_secret)
|
|
tag = sha_ctx.digest()
|
|
|
|
protocol._send_message(
|
|
ThpCodeEntryCpaceHostTag(
|
|
cpace_host_public_key=cpace.host_public_key,
|
|
tag=tag,
|
|
)
|
|
)
|
|
|
|
secret_msg = protocol._read_message(ThpCodeEntrySecret)
|
|
|
|
# Check `commitment` and `code`
|
|
sha_ctx = sha256(secret_msg.secret)
|
|
computed_commitment = sha_ctx.digest()
|
|
assert commitment == computed_commitment
|
|
|
|
sha_ctx = sha256(ThpPairingMethod.CodeEntry.to_bytes(1, "big"))
|
|
sha_ctx.update(protocol.handshake_hash)
|
|
sha_ctx.update(secret_msg.secret)
|
|
sha_ctx.update(challenge)
|
|
code_hash = sha_ctx.digest()
|
|
computed_code = int.from_bytes(code_hash, "big") % 1000000
|
|
assert code == computed_code
|
|
|
|
protocol._send_message(ThpEndRequest())
|
|
protocol._read_message(ThpEndResponse)
|
|
|
|
protocol._has_valid_channel = True
|
|
|
|
|
|
def test_pairing_nfc(client: Client) -> None:
|
|
protocol = _prepare_protocol_for_pairing(client)
|
|
|
|
_nfc_pairing(client, protocol)
|
|
|
|
protocol._send_message(ThpEndRequest())
|
|
protocol._read_message(ThpEndResponse)
|
|
protocol._has_valid_channel = True
|
|
|
|
|
|
def _nfc_pairing(client: Client, protocol: ProtocolV2Channel) -> None:
|
|
|
|
_handle_pairing_request(client, protocol, "TestTrezor NfcPairing")
|
|
|
|
protocol._send_message(
|
|
ThpSelectMethod(selected_pairing_method=ThpPairingMethod.NFC)
|
|
)
|
|
protocol._read_message(ThpPairingPreparationsFinished)
|
|
|
|
# NFC screen shown
|
|
|
|
nfc_secret_host = random.randbytes(16)
|
|
# Read `nfc_secret` and `handshake_hash` from Trezor using debuglink
|
|
pairing_info = client.debug.pairing_info(
|
|
thp_channel_id=protocol.channel_id.to_bytes(2, "big"),
|
|
handshake_hash=protocol.handshake_hash,
|
|
nfc_secret_host=nfc_secret_host,
|
|
)
|
|
handshake_hash_trezor = pairing_info.handshake_hash
|
|
nfc_secret_trezor = pairing_info.nfc_secret_trezor
|
|
|
|
assert handshake_hash_trezor[:16] == protocol.handshake_hash[:16]
|
|
|
|
# Compute tag for response
|
|
sha_ctx = sha256(ThpPairingMethod.NFC.to_bytes(1, "big"))
|
|
sha_ctx.update(protocol.handshake_hash)
|
|
sha_ctx.update(nfc_secret_trezor)
|
|
tag_host = sha_ctx.digest()
|
|
|
|
protocol._send_message(ThpNfcTagHost(tag=tag_host))
|
|
|
|
tag_trezor_msg = protocol._read_message(ThpNfcTagTrezor)
|
|
|
|
# Check that the `code` was derived from the revealed secret
|
|
sha_ctx = sha256(ThpPairingMethod.NFC.to_bytes(1, "big"))
|
|
sha_ctx.update(protocol.handshake_hash)
|
|
sha_ctx.update(nfc_secret_host)
|
|
computed_tag = sha_ctx.digest()
|
|
assert tag_trezor_msg.tag == computed_tag
|
|
|
|
|
|
def test_credential_phase(client: Client) -> None:
|
|
protocol = _prepare_protocol_for_pairing(client)
|
|
_nfc_pairing(client, protocol)
|
|
|
|
# Request credential with confirmation after pairing
|
|
randomness_static = os.urandom(32)
|
|
host_static_privkey = curve25519.get_private_key(randomness_static)
|
|
host_static_pubkey = curve25519.get_public_key(host_static_privkey)
|
|
protocol._send_message(
|
|
ThpCredentialRequest(host_static_pubkey=host_static_pubkey, autoconnect=False)
|
|
)
|
|
credential_response = protocol._read_message(ThpCredentialResponse)
|
|
|
|
assert credential_response.credential is not None
|
|
credential = credential_response.credential
|
|
protocol._send_message(ThpEndRequest())
|
|
protocol._read_message(ThpEndResponse)
|
|
|
|
# Connect using credential with confirmation
|
|
protocol = _prepare_protocol(client)
|
|
protocol._do_channel_allocation()
|
|
protocol._do_handshake(credential, randomness_static)
|
|
protocol._send_message(ThpEndRequest())
|
|
button_req = protocol._read_message(ButtonRequest)
|
|
assert button_req.name == "connection_request"
|
|
protocol._send_message(ButtonAck())
|
|
client.debug.press_yes()
|
|
protocol._read_message(ThpEndResponse)
|
|
|
|
# Delete channel from the device by sending badly encrypted message
|
|
# This is done to prevent channel replacement and trigerring of autoconnect false -> true
|
|
protocol.noise.noise_protocol.cipher_state_encrypt.n = 250
|
|
|
|
protocol._send_message(ButtonAck())
|
|
with pytest.raises(Exception) as e:
|
|
protocol.read(1)
|
|
assert e.value.args[0] == "Received ThpError: DECRYPTION FAILED"
|
|
|
|
# Connect using credential with confirmation and ask for autoconnect credential.
|
|
protocol = _prepare_protocol(client)
|
|
protocol._do_channel_allocation()
|
|
protocol._do_handshake(credential, randomness_static)
|
|
protocol._send_message(
|
|
ThpCredentialRequest(host_static_pubkey=host_static_pubkey, autoconnect=True)
|
|
)
|
|
# Confirmation dialog is shown. (Channel replacement is not triggered.)
|
|
button_req = protocol._read_message(ButtonRequest)
|
|
assert button_req.name == "connection_request"
|
|
protocol._send_message(ButtonAck())
|
|
client.debug.press_yes()
|
|
credential_response_2 = protocol._read_message(ThpCredentialResponse)
|
|
assert credential_response_2.credential is not None
|
|
credential_auto = credential_response_2.credential
|
|
protocol._send_message(ThpEndRequest())
|
|
protocol._read_message(ThpEndResponse)
|
|
|
|
# Connect using credential with confirmation
|
|
protocol = _prepare_protocol(client)
|
|
protocol._do_channel_allocation()
|
|
protocol._do_handshake(credential, randomness_static)
|
|
# Confirmation dialog is not shown as channel in ENCRYPTED TRANSPORT state with the same
|
|
# host static public key is still available in Trezor's cache. (Channel replacement is triggered.)
|
|
protocol._send_message(ThpEndRequest())
|
|
protocol._read_message(ThpEndResponse)
|
|
|
|
# Connect using autoconnect credential
|
|
protocol = _prepare_protocol(client)
|
|
protocol._do_channel_allocation()
|
|
protocol._do_handshake(credential_auto, randomness_static)
|
|
protocol._send_message(ThpEndRequest())
|
|
protocol._read_message(ThpEndResponse)
|
|
|
|
# Delete channel from the device by sending badly encrypted message
|
|
# This is done to prevent channel replacement and trigerring of autoconnect false -> true
|
|
protocol.noise.noise_protocol.cipher_state_encrypt.n = 100
|
|
|
|
protocol._send_message(ButtonAck())
|
|
with pytest.raises(Exception) as e:
|
|
protocol.read(1)
|
|
assert e.value.args[0] == "Received ThpError: DECRYPTION FAILED"
|
|
|
|
# Connect using autoconnect credential - should work the same as above
|
|
protocol = _prepare_protocol(client)
|
|
protocol._do_channel_allocation()
|
|
protocol._do_handshake(credential_auto, randomness_static)
|
|
protocol._send_message(ThpEndRequest())
|
|
protocol._read_message(ThpEndResponse)
|
|
|
|
|
|
@pytest.mark.setup_client(passphrase=True)
|
|
def test_channel_replacement(client: Client) -> None:
|
|
assert client.features.passphrase_protection is True
|
|
|
|
host_static_randomness = os.urandom(32)
|
|
host_static_randomness_2 = os.urandom(32)
|
|
host_static_privkey = curve25519.get_private_key(host_static_randomness)
|
|
host_static_privkey_2 = curve25519.get_private_key(host_static_randomness_2)
|
|
|
|
assert host_static_privkey != host_static_privkey_2
|
|
|
|
client.protocol = _get_encrypted_transport_protocol(client, host_static_randomness)
|
|
|
|
session = client.get_session(passphrase="TREZOR", session_id=b"\x10")
|
|
address = get_test_address(session)
|
|
|
|
session_2 = client.get_session(passphrase="ROZERT", session_id=b"\x20")
|
|
address_2 = get_test_address(session_2)
|
|
assert address != address_2
|
|
|
|
# create new channel using the same host_static_privkey
|
|
client.protocol = _get_encrypted_transport_protocol(client, host_static_randomness)
|
|
session_3 = client.get_session(passphrase="OKIDOKI", session_id=b"\x30")
|
|
address_3 = get_test_address(session_3)
|
|
assert address_3 != address_2
|
|
|
|
# test address on regenerated channel
|
|
new_address = get_test_address(session)
|
|
assert address == new_address
|
|
new_address_3 = get_test_address(session_3)
|
|
assert address_3 == new_address_3
|
|
|
|
# create new channel using different host_static_privkey
|
|
client.protocol = _get_encrypted_transport_protocol(
|
|
client, host_static_randomness_2
|
|
)
|
|
with pytest.raises(exceptions.TrezorFailure) as e_1:
|
|
_ = get_test_address(session)
|
|
assert str(e_1.value.message) == "Invalid session"
|
|
|
|
with pytest.raises(exceptions.TrezorFailure) as e_2:
|
|
_ = get_test_address(session_3)
|
|
assert str(e_2.value.message) == "Invalid session"
|
|
|
|
session_4 = client.get_session(passphrase="TREZOR", session_id=b"\x40")
|
|
super_new_address = get_test_address(session_4)
|
|
assert address == super_new_address
|