USSH

USSH는 USTP-Secure 기반으로 구축된 셸 프로토콜 및 클라이언트/서버 쌍입니다.

TCP 터널이 아니며 SSH를 TCP 내부에 감싸지 않습니다.

상태: Beta

라이선스: MIT

AEAD 암호 이름

• chacha20 = CHACHA20_POLY1305
• aes-256-gcm = AES_256_GCM
• aes-128-gcm = AES_128_GCM
• 기본 AEAD 암호: chacha20

기본 포트

• 5322

서버

python3 ussh_server.py \
  --peer-ip <CLIENT_IP_OR_DOMAIN> \
  --peer-port 0 \
  --bind-ip 0.0.0.0 \
  --bind-port 5322 \
  --cipher chacha20 \
  --congestion-control auto

--password를 생략하면 서버는 시작 시 USSH 로그인 비밀번호를 입력하라는 메시지를 표시합니다.

대화형 시작 시 서버는 스스로를 systemd 서비스로 설치할지 여부를 묻습니다. 정상적으로 실행하려면 n이라고 답하세요. 해당 질문을 건너뛰려면 --no-systemd-prompt를 사용하세요.

클라이언트

python3 ussh_client.py \
  --peer-ip <SERVER_IP_OR_DOMAIN> \
  --peer-port 5322 \
  --bind-ip 0.0.0.0 \
  --bind-port 0 \
  --cipher chacha20 \
  --congestion-control off

클라이언트는 SSH처럼 비밀번호를 대화형으로 입력받습니다.

클라이언트는 처음 본 서버 X25519 공개 키를 ~/.ussh_known_hosts.json에 저장합니다. 나중에 해당 키가 변경되면 클라이언트는 새 키를 조용히 신뢰하는 대신 TOFU 불일치 오류와 함께 중단합니다. 서버 호스트 키를 의도적으로 교체한 경우, 대화형 확인 후 저장된 TOFU 키를 교체할 수 있도록 클라이언트를 --regen-key와 함께 실행하세요.

인터넷 드래프트

• USSH 인터넷 드래프트: https://datatracker.ietf.org/doc/draft-x1co-ussh/

참고 사항

• 전송 계층은 UDP 위의 USTP-Secure입니다.
• USSH 내부에서 USTPS는 ACK: 10 MAC:<tag>, NACK: 42 MAC:<tag>, HELLO: ..., CLOSE: 같은 읽을 수 있는 ASCII 제어 라인과 이진 UPACK (UPAK) DATA 프레임을 사용합니다.
• ACK 및 NACK는 디버깅을 위해 평문으로 유지되지만, 위조된 ACK/NACK 제어 공격을 방지하기 위해 세션별 HMAC 태그로 인증됩니다.
• USSH는 UPACK DATA 페이로드당 900바이트라는 USTPS 전송 페이로드 상한을 상속합니다.
• USSH는 USTPS 아래에 두 번째 단편화 계층을 정의하지 않습니다.
• 전송 수준의 MTU, PMTU, nonce 동작, 중복 처리 및 오래된 패킷 처리는 USTPS에서 상속됩니다.
• 자동 네트워크/경로 마이그레이션이 제거되었습니다.
• 클라이언트가 네트워크를 변경하여 소스 IP:port가 변경되면 현재 USSH 세션은 종료될 것으로 예상되며 사용자는 깨끗하게 다시 연결해야 합니다.
• 마이그레이션 구현은 실질적인 안정성 및 보안 문제를 일으켰기 때문에 제거되었습니다:
  • NAT 또는 모바일 네트워크가 경로를 빠르게 변경할 때 반복적인 마이그레이션 플러드
  • 복구된 것처럼 보이지만 터미널 데이터 전달을 중단한 세션
  • 클라이언트가 경로가 끊어졌음을 알아차리기 전의 긴 무음 기간
  • 실제 로밍 클라이언트와 기존 세션을 주장하는 스푸핑된 패킷 간의 모호성
  • 깨끗하게 다시 연결하는 대신 터미널을 멈추게 할 수 있는 복구 상태

전송 핸드셰이크

• USSH는 USTP-Secure와 동일한 USTPS 재시도 토큰 핸드셰이크를 상속합니다.
• 서버는 먼저 재시도 토큰과 세션 메타데이터로 클라이언트에 도전(challenge)합니다.
• 클라이언트는 암호화된 USSH 세션이 수락되기 전에 해당 토큰을 다시 에코해야 합니다.
• 동일한 핸드셰이크는 최종 AEAD 암호와 USTPS Congestion이 on인지 off인지도 협상합니다.
• 재시도 토큰은 세션 생성 전의 도달 가능성 증명일 뿐입니다.
• 세션 키도, 패킷 nonce도, 이후 파생되는 AEAD 세션 키의 대체물도 아닙니다.