공유 가능한 Compose 정의에 값을 넣지 말고, 모든 백업이나 진단용 내보내기 파일은 콘텐츠 검사를 통과하기 전까지 민감 정보로 취급해 시크릿 유출을 방지하세요.
Home Assistant는 런타임에 자격 증명이 필요하므로, 호스트에 완전히 접근할 수 있는 관리자에게 이를 보이지 않게 하는 로컬 파일 배치는 없습니다. 현실적인 목표는 우발적인 커밋, 지원 요청에 첨부되는 업로드, 범위가 넓은 백업 복사본, 불필요한 컨테이너 접근을 막는 것입니다. 각 값이 스택에 유입되는 경로를 파악하고, 리터럴 값을 통제된 시크릿 소스로 교체한 다음, 시크릿 자체를 출력하지 않고 내보낸 결과물을 검사하세요.
시크릿이 유출될 수 있는 모든 경로 파악하기
API 토큰, 데이터베이스 비밀번호, MQTT 자격 증명, 웹훅 URL, 암호화 키, 개인 인증서, 복구 키를 목록으로 작성하세요. 각 항목에 대해 런타임에서 사용하는 서비스, 저장 경로, 파일 소유자, 백업 포함 여부, 저장소 추적 여부, 로그 노출 여부, 순환 방법을 기록하세요. 값 자체를 목록에 복사하지 마세요.
시크릿 파일은 값을 정리해 두는 데 유용하지만, 호스트에서 해당 파일을 읽을 수 있는 계정에는 여전히 평문으로 노출됩니다. 이러한 평문 접근 경계 때문에 분리의 주된 목적은 완전한 권한을 가진 공격자를 막는 것이 아니라 우발적인 공개를 줄이는 데 있습니다.
Compose YAML의 리터럴 값, 추적되는 환경 변수 파일, 광범위하게 읽을 수 있는 설정 디렉터리, 또는 내용이 확인되지 않은 내보내기 파일은 모두 보안 실패로 간주합니다. 모든 노출 경로에 담당자와 해결 방안이 정해질 때까지 공유와 저장소 푸시를 중단하세요.
런타임 시크릿과 배포 정의 분리하기
Compose의 리터럴 값을 범위를 좁혀 권한을 부여한 파일 기반 시크릿이나 배포 환경에서 지원하는 다른 시크릿 소스로 교체하세요. 각 서비스에는 실제로 사용하는 값만 제공하고, 가능하면 읽기 전용으로 마운트하며, 호스트 권한은 런타임 사용자와 관리자에게만 제한하세요.
환경 변수 값은 컨테이너 검사, 프로세스 컨텍스트 또는 로그를 통해 노출될 수 있지만, 파일 기반 시크릿 마운트를 사용하면 자격 증명을 전달받는 컨테이너를 제한할 수 있습니다. 로컬 시크릿 파일도 권한 관리가 필요합니다.
먼저 플레이스홀더로 검증하고, 렌더링된 Compose 설정에 의도치 않은 리터럴이 없는지 확인한 다음, 서비스 하나를 시작해 할당된 시크릿만 읽을 수 있는지 확인하세요. 변경으로 인해 애플리케이션이 값을 그대로 출력하거나 디렉터리에 광범위한 접근 권한이 필요해지면 롤백하세요.
백업과 지원 번들에 포함되는 내용 관리
범위상 자격 증명이 포함되지 않는다는 점이 입증되지 않는 한 백업에 자격 증명이 포함된 것으로 분류하세요. 신뢰할 수 있는 저장소 경계를 벗어나는 사본은 암호화하고, 복구 키는 별도로 보관하며, 보존 기간과 접근 권한을 제한하세요. 로그 일부를 편집해 공유하면 지원 문의에 답할 수 있는 경우에는 전체 설정 아카이브를 첨부하지 마세요.
보안 저장소와 공유 가능한 배포 자료를 분리하면서 복구 가능성을 유지하려면 설정 보호 워크플로를 사용하세요.
릴리스 전에 파일 이름과 추출된 텍스트에서 알려진 키 이름, 토큰 접두사, 비공개 URL, 이메일 주소, 인증서, 관리된 테스트 마커의 정확한 해시를 검사하세요. 검사 결과가 깨끗하다는 것은 릴리스 통과 조건이지, 알 수 없는 형식의 시크릿이 존재할 수 없다는 증거는 아닙니다.
노출된 시크릿을 교체하고 예방 경로를 입증하세요
사용 가능한 값이 저장소, 티켓, 채팅, 공개 링크 또는 신뢰할 수 없는 백업에 들어갔다면 먼저 폐기하거나 교체하세요. 눈에 보이는 사본을 삭제해도 다른 사본이나 기록은 무효화되지 않습니다. 이전 값을 보존하지 말고 영향을 받은 서비스와 교체 시각을 기록하세요.
무해한 카나리 시크릿을 만들고 새 경로로 배포한 다음, 일반 Compose 렌더링 결과와 백업 및 진단 번들을 생성하고 해당 아티팩트를 검색하세요. 런타임은 카나리 시크릿을 받아야 하지만, 공유 가능한 아티팩트에는 명시적으로 보호된 백업의 경계 밖으로 시크릿이 노출되지 않아야 합니다.
배포 정의와 저장소에 실제 시크릿이 없고, 보호된 백업에 별도의 복구 경로가 있으며, 아티팩트 검사가 통과하고, 노출된 자격 증명이 교체되면 중단하세요. 타사 통합이 시크릿 값을 로그에 기록하거나 더 광범위한 호스트 접근 권한 없이는 범위가 제한된 시크릿 소스를 사용할 수 없는 경우에는 에스컬레이션하세요.
지원 및 팁
더 읽어보기

가족에게 NAS의 성인 동영상을 숨기는 방법
가족용 NAS에서 성인 동영상을 비공개로 보관하세요. 폴더 권한, Plex 및 Jellyfin 라이브러리 액세스 권한, 썸네일, 시청 기록, TV 공유 로그인 및 DLNA를 확인하세요.

Transformers에서 커뮤니티 모델을 불러오기 전에 확인할 사항
Transformers Jinja 샌드박스 업데이트를 활용해 모델의 출처, 채팅 템플릿, 원격 코드, 직렬화된 가중치, 격리된 첫 실행을 검토하세요.

Mirage를 로컬에서 실행: 한 장의 이미지로 OCR 및 객체 감지
Cactus Compute의 소형 로컬 비전 모델을 사용해 보고, 실제 입력으로 OCR 및 객체 추출을 검증하며, 메모리, 언어 및 개인정보 보호의 한계를 파악해 보세요.



