Download and copy sync actions print remote file names without escape_control_chars

Đang mở Phù hợp với người mới
  • Có gì không ổn?
#631 0 bình luận 0 reaction 0 người được giao Xem trên GitHub

Maintainer thường phản hồi trong vòng 1 ngày

@dreyfus92 đang làm issue này rồi.

Từ ngày 30/10/2026.

  • #636 của @dreyfus92 — đang mở

Đánh giá

Độ khó
2/5
Thời gian dự kiến
1-3 giờ
Mức phù hợp với người mới
72/100
Loại issue
Lỗi
Độ rõ ràng
Đặc tả rõ ràng
Mức độ hoạt động
Sôi nổi
Công nghệ
python
Lĩnh vực
security

Hướng nghiên cứu

Đọc b2sdk/_internal/sync/action.py, bắt đầu với các lệnh gọi hoàn tất ở dòng 343 và 433 cùng đường dẫn xử lý lỗi dùng chung ở dòng 60; so sánh chúng với các lệnh gọi đã escape ký tự. Kiểm tra ProgressReport._print_line trong scan/report.py để hiểu đường dẫn đầu ra. Công việc hoàn tất khi đầu ra tải xuống, sao chép và lỗi escape các ký tự điều khiển, đồng thời các bài kiểm tra xác nhận đầu ra terminal không chứa ký tự điều khiển thô.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Mô tả

Description

Four of the six completion call sites in b2sdk/_internal/sync/action.py pass the remote name through escape_control_chars first, at :179 (upload), :259 (hide), :482 and :523 (delete). The download and copy sites concatenate it raw: reporter.print_completion('dnload ' + self.source_path.relative_path) at :343 and reporter.print_completion('copy ' + self.source_path.relative_path) at :433. The shared error path at :60 is unescaped too, and str(self) there embeds the raw b2_file_name via B2DownloadAction.__str__ at :346. From any of those the string reaches ProgressReport._print_line (scan/report.py:144-155), whose own docstring states the precondition the callers violate, ":param line: a string without a \r or \n in it", and which writes it straight out with self.stdout.write(line). Nothing on the inbound path strips control characters: validate_b2_file_name_as_path covers relative and absolute path components only, and RawApi.check_b2_filename (raw_api.py:991) does reject code points below 32 but has exactly one caller, the upload path at raw_api.py:1059, so it never runs on a name the SDK receives. The effect is that a file name from the endpoint is written to the user's terminal with its control characters intact and the terminal acts on them, which covers title spoofing, colour changes that persist for everything printed afterwards, screen clears and more on emulators that still implement them; all ten control characters tested reached stdout raw. Worth being clear about the limit: a well-behaved Backblaze bucket cannot hold such a name, since the documentation states that "character codes below U+0020 (decimal 32) are not allowed" and "DEL characters (127) are not allowed" and the service enforces that on upload independently of the client, so reaching this needs a B2-compatible endpoint under the attacker's control via a custom realm, an active TLS interception, or a future server-side regression. That is why I am filing it in the open rather than privately.

Reproduction

On master @ ffa02b32 with Python 3.10.19, in a container built from a fresh clone at that ref. RawSimulator is the SDK's own public test double, exported from b2sdk.v2 and b2sdk.v3, and it stands in for exactly one thing here, the endpoint's own name validation, which is the single element the real service would supply. Build with this Dockerfile, save the script as poc.py, then run docker build -t b2poc . && docker run --rm -u 1001 -v "$PWD/poc.py:/t.py:ro" b2poc python /t.py; replacing SyncReport(out, True) with SyncReport(sys.stdout, True) sends the same bytes to a real terminal:

FROM python:3.10.19-slim-bookworm
RUN apt-get update -qq && apt-get install -y -qq --no-install-recommends git >/dev/null
RUN git clone -q https://github.com/Backblaze/b2-sdk-python.git /src \
 && git -C /src checkout -q ffa02b3264bc0e7069ef2c8b25facd9a467e65a6 \
 && pip install --no-cache-dir -q /src
RUN useradd -m -u 1001 victim

import io, os, time
from b2sdk.v3 import (B2Api, B2HttpApiConfig, RawSimulator, StubAccountInfo,
                      Synchronizer, SyncReport, B2Folder, LocalFolder)

NAME = '\x1b]0;PWNED\x07\x1b[31minvoice.pdf'      # a name the endpoint returns in b2_list_file_versions
api = B2Api(StubAccountInfo(), api_config=B2HttpApiConfig(_raw_api_class=RawSimulator))
acct, key = api.session.raw_api.create_account()
api.authorize_account(application_key_id=acct, application_key=key, realm='production')
bucket = api.create_bucket('evil', 'allPublic')
bucket.upload_bytes(b'x', NAME)
bucket.upload_bytes(b'x', 'ordinary.txt')

os.makedirs('/tmp/dest', exist_ok=True)
out = io.StringIO()
Synchronizer(max_workers=1).sync_folders(source_folder=B2Folder('evil', '', api),
    dest_folder=LocalFolder('/tmp/dest'), now_millis=int(time.time() * 1000),
    reporter=SyncReport(out, True))
for line in out.getvalue().split('\n'):
    if line.strip():
        print('stdout got:', repr(line.rstrip()))

stdout got: 'dnload \x1b]0;PWNED\x07\x1b[31minvoice.pdf'
stdout got: 'dnload ordinary.txt'
Suggested remediation

Wrap the two names and the error path, matching the four sites that already do:

--- a/b2sdk/_internal/sync/action.py
+++ b/b2sdk/_internal/sync/action.py
@@ -57,7 +57,9 @@ class AbstractAction(metaclass=ABCMeta):
             self.do_report(bucket, reporter)
         except Exception as e:
             logger.exception('an exception occurred in a sync action')
-            reporter.error(str(self) + ': ' + repr(e) + ' ' + str(e))
+            reporter.error(
+                f'{escape_control_chars(str(self))}: {e!r} {escape_control_chars(str(e))}'
+            )
             raise  # Re-throw so we can identify failed actions
@@ -340,7 +342,7 @@ class B2DownloadAction(AbstractAction):
-        reporter.print_completion('dnload ' + self.source_path.relative_path)
+        reporter.print_completion(f'dnload {escape_control_chars(self.source_path.relative_path)}')
@@ -430,7 +432,7 @@ class B2CopyAction(AbstractAction):
-        reporter.print_completion('copy ' + self.source_path.relative_path)
+        reporter.print_completion(f'copy {escape_control_chars(self.source_path.relative_path)}')

repr(e) is deliberately left unescaped, written as {e!r}, because Python's repr of a string already renders control characters as escapes and it was measured not to leak ESC, whereas str(e) does leak it and so is wrapped.

Credits
  • Found by OSTIF using AI with their own harness.
  • Manually verified, fixed, and reported by Shielder.
Ngôn ngữ chính
Python
Star
214
Fork
68
Merge trung bình
51 phút
Pull request đã merge (30 ngày)
6

Chuẩn bị môi trường

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Issue khác của Backblaze/b2-sdk-python

Tất cả issue của Backblaze/b2-sdk-python

Issue tương tự

Thêm issue về Python

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.