USSH

USSH는 USTP-Secure 위에 구축된 셸 프로토콜이자 클라이언트/서버 쌍입니다.

TCP 터널이 아니며 SSH를 TCP 내부에 래핑하지 않습니다.

상태: 베타

라이선스: 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 \
  --cleartext off

클라이언트는 SSH처럼 비밀번호를 대화형으로 입력하라는 메시지를 표시합니다.

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

인터넷 초안

• USSH 인터넷 초안: https://datatracker.ietf.org/doc/draft-x1co-ussh/

참고 사항

• 전송 계층은 UDP 위의 USTP-Secure입니다.
• USSH는 패킷별 HMAC 무결성을 갖춘 선택적 클리어텍스트 DATA 모드도 지원합니다:
  • 서버 측: --cleartext auto|on|off
  • 클라이언트 측: --cleartext on|off
  • 서버가 auto인 경우 USSH는 클라이언트 요청을 따릅니다.
  • 서버가 on 또는 off인 경우 서버가 최종 클리어텍스트 모드를 강제합니다.
  • --cleartext on을 사용하면 USSH는 실제 인터넷에서 클리어텍스트가 위험하며 로컬 네트워크와 같은 통제된 환경에서만 권장된다는 경고를 출력합니다.
• USSH 아래에서 USTPS는 ACK: 10 MAC:<tag>, NACK: 42 MAC:<tag>, HELLO: ..., CLOSE: 같은 읽기 가능한 ASCII 제어 라인과 바이너리 UPACK (UPAK) DATA 프레임을 사용합니다.
• ACK와 는 디버깅 가능성을 위해 평문으로 유지되지만, 위조된 ACK/NACK 제어 공격을 방지하기 위해 세션별 HMAC 태그로 인증됩니다.

전송 핸드셰이크

• USSH는 USTP-Secure와 동일한 USTPS 재시도 토큰 핸드셰이크를 상속합니다.
• 서버는 먼저 재시도 토큰과 세션 메타데이터로 클라이언트에 도전합니다.
• 클라이언트는 암호화된 USSH 세션이 수락되기 전에 해당 토큰을 다시 에코해야 합니다.
• 동일한 핸드셰이크는 최종 AEAD 암호와 USTPS 혼잡 제어가 on인지 off인지도 협상합니다.
• 동일한 핸드셰이크는 DATA가 AEAD 암호화를 사용할지 아니면 클리어텍스트 + HMAC을 사용할지도 협상합니다.
• 재시도 토큰은 세션 생성 전 도달 가능성 증명일 뿐입니다.
• 세션 키도, 패킷 논스도, 이후 파생되는 AEAD 세션 키를 대체하는 것도 아닙니다.