Question 1

Gladys Assistant backup restore의 OS command injection 취약점을 어떻게 수정하나요?

Accepted Answer

Gladys Assistant를 v4.72.0 이상으로 업그레이드하세요. 이 취약점은 버전 ≤ 4.67.0에 영향을 주며, POST /api/v1/gateway/backup/restore 엔드포인트에서 file_url의 셸 메타문자 페이로드를 통해 트리거됩니다.

Docker 업그레이드
docker stop gladys
docker rm gladys
docker pull gladysassistant/gladys:v4.72.0

docker run -d \
  --name gladys \
  --privileged \
  -e NODE_ENV=production \
  -e SERVER_PORT=80 \
  -e SQLITE_FILE_PATH=/var/lib/gladysassistant/gladys-production.db \
  -v /var/lib/gladysassistant:/var/lib/gladysassistant \
  -p 8000:80 \
  gladysassistant/gladys:v4.72.0

Docker Compose를 사용하는 경우 docker compose pull && docker compose up -d 를 실행하세요.

즉시 업그레이드할 수 없는 경우의 임시 완화 조치:
• 리버스 프록시 또는 방화벽에서 POST /api/v1/gateway/backup/restore를 차단하거나 제한하세요.
• Gladys를 인터넷에 직접 노출하지 마세요. VPN 또는 신뢰할 수 있는 IP를 요구하세요.
• 관리자 비밀번호, 세션, 인증 키 및 Gladys gateway 자격 증명을 교체하세요.
• 최후의 수단으로 Gladys를 중지하고 SQLite 데이터베이스를 백업한 다음, 취약한 restore 경로에 필요한 백업 키를 제거하세요:
sqlite3 /var/lib/gladysassistant/gladys-production.db \
  "DELETE FROM t_variable WHERE name='GLADYS_GATEWAY_BACKUP_KEY';"

이렇게 하면 키가 다시 프로비저닝될 때까지 영향을 받는 gateway 백업 복원 기능이 비활성화됩니다. 의심스러운 복원 요청 전후에 생성된 로그와 파일에서 침해 징후를 검토하세요.

Question 2

Gladys Assistant 백업 복원에서 Zip-Slip 경로 순회 취약점을 어떻게 수정하나요?

Accepted Answer

취약점은 Gladys Assistant ≤ 4.67.0에 영향을 미칩니다. 복원 엔드포인트 POST /api/v1/gateway/backup/restore는 tar -xzvf -C로 tar 아카이브를 추출할 때 멤버 경로를 검증하지 않아, ../ 항목, 절대 경로 또는 심볼릭 링크 기반 쓰기가 복원 디렉터리 밖에서 가능해집니다. 이 취약점은 Gladys Assistant v4.72.0에서 수정되었습니다. v4.72.0 이상으로 업그레이드하세요. Docker Compose의 경우 이미지 태그를 gladysassistant/gladys:v4.72.0 이상으로 업데이트한 다음, docker compose pull && docker compose up -d를 실행하세요. Gladys UI에서 업그레이드된 버전을 확인하세요. 즉시 업그레이드할 수 없다면, 리버스 프록시에서 POST /api/v1/gateway/backup/restore를 제한하거나 차단하고, 신뢰할 수 있는 IP/관리자만 허용하며, 신뢰할 수 없는 file_url에서 복원하지 말고, /var/lib/gladysassistant 및 해당 호스트 바인드 마운트에서 예상치 못한 파일이 있는지 감사하세요. 악용이 의심되면 관리자 자격 증명과 기타 시크릿을 교체하세요.

Question 3

왜 Gladys Assistant 청소기 위젯이 지원되지 않는 clean 및 run 모드를 표시하며, 어떻게 필터링하나요?

Accepted Answer

clean-mode 및 run-mode 컨트롤은 이전에 모든 enum 값을 하드코딩했고 기능의 supported_options를 무시했습니다. 이는 PR #3171에서 두 드롭다운을 resolveFeatureOptions(deviceFeature, STATIC_OPTIONS)로 빌드하여 수정되었습니다. PR #3171이 포함된 릴리스로 Gladys Assistant를 업그레이드하거나 현재 master에서 프런트엔드를 빌드하세요. 그런 다음 지원되는 값만 게시하세요. 예: supported_options: [{ "value": 0 }, { "value": 2 }]. UI는 이를 sort_order에 따라 표시하며, 사용 가능한 경우 옵션 label을 사용합니다. supported_options가 없는 기능은 계속 전체 정적 목록을 표시합니다. 이전 버전에서는 대신 모드를 text/select 기능으로 노출하는 것이 우회 방법입니다.

Question 4

Gladys 외부 통합에서 USB 시리얼 장치(/dev/ttyUSB, /dev/ttyACM)에 액세스하는 방법은?

Accepted Answer

Gladys 외부 통합(integration)은 시리얼 디바이스에 직접 접근할 수 없는 샌드박스 컨테이너에서 실행됩니다. 매니페스트의 `devices` 옵션은 `coral-usb`, `coral-pcie`, `gpu`, `video` 클래스만 지원하며(서브 컨테이너에서만 지원), 따라서 메인 컨테이너는 `/dev/ttyUSB*`나 `/dev/ttyACM*`을 요청할 수 없습니다. 네이티브 시리얼 지원은 아직 제안 단계(issue #3194)일 뿐 구현되지 않았습니다.

**해결 방법: 호스트에서 시리얼 포트를 TCP로 브리지합니다.**

1. Gladys 호스트에 ser2net을 설치하고 동글을 TCP 포트에 매핑합니다. 예를 들어 `/etc/ser2net.yaml`에서:
```yaml
connection: &rfplayer
  accepter: tcp,2000
  connector: serialdev,/dev/serial/by-id/usb-xxxx-if00,115200n81,local
```
또는 socat 사용: `socat TCP-LISTEN:2000,reuseaddr,fork FILE:/dev/serial/by-id/usb-xxxx-if00,b115200,raw,echo=0`
2. 통합 컨테이너에서 시리얼 경로 대신 `<host-lan-ip>:2000`에 연결합니다.

**중요한 주의 사항:**
- TCP 포트에는 **인증이 없습니다**: ser2net/socat을 특정 인터페이스/IP에 바인딩하거나 방화벽으로 포트를 제한하여 통합 컨테이너만 접근할 수 있도록 하세요.
- 시리얼 파라미터는 호스트 측에서 설정해야 합니다: RFPlayer RFP1000은 115200 8N1을 사용하고, Téléinfo historic 모드는 1200 bauds 7E1을 사용합니다(standard/Linky 모드는 9600 7E1).
- 동글은 항상 `/dev/ttyUSB0`이 아니라 `/dev/serial/by-id/*`로 참조하세요. ttyUSB 번호는 재연결 또는 재부팅 후 바뀌지만 by-id 이름은 바뀌지 않습니다.
- ser2net/socat을 계속 실행 상태로 유지하고(예: systemd 서비스로) 직접 모니터링해야 합니다.

이 내용은 RFPlayer, Téléinfo/Linky 모듈, Zigbee 및 Z-Wave USB 스틱, RFXtrx, EnOcean, Arduino 기반 동글에 적용됩니다.

Gladys Assistant

주요 기능

할 수 없는 것

사용 사례

태그

시작하기

유사한 프로젝트