분리형 웹 앱 (IWA)은 웹 플랫폼 위에 신뢰도가 높고 안전하며 버전이 분리된 런타임 환경을 제공합니다. 프로덕션 환경, 특히 관리형 엔터프라이즈 내에서 관리자와 개발자는 소프트웨어 배포를 세밀하게 제어해야 합니다.
이러한 요구사항을 충족하기 위해 Chrome은 업데이트 채널, 버전 고정, 버전 다운그레이드를 비롯한 IWA의 포괄적인 버전 관리 기능을 제공합니다. 이러한 기능을 통해 사용자층 전반에서 배포 예측 가능성과 신속한 복구 제어가 가능합니다.
가용성
버전 관리 동작은 IWA가 관리자에 의해 관리되는지 또는 사용자가 직접 설치하는지에 따라 달라집니다.
- 관리형 IWA: 정책 기반 고정 및 다운그레이드를 포함한 관리 기능은 Chrome 133부터 사용할 수 있습니다.
- 관리되지 않는 (사용자 설치) IWA: 사용자 대상 기능 (예: 수동 채널 선택)은 Chrome 150부터 사용할 수 있습니다.
세션 유형 호환성
업데이트 채널 및 버전 고정을 포함한 모든 버전 관리 기능은 모든 ChromeOS 세션 유형에서 완벽하게 호환됩니다. 여기에는 다음이 포함됩니다.
- 사용자 세션 표준 관리
- 관리 게스트 세션 (MGS)
- 전용 키오스크 모드 환경
채널 업데이트
개발자는 업데이트 채널을 사용하여 특정 애플리케이션 빌드를 별도의 배포 및 테스트 잠재고객으로 세분화할 수 있습니다. 채널을 구성하려면 애플리케이션 업데이트 매니페스트 내의 각 버전 항목에 선택적 채널 배열 필드를 추가합니다. 이러한 채널 이름은 고정된 플랫폼 키워드 (예: canary 또는 stable)로 제한되지 않으며, 대신 소문자 ASCII 영숫자 문자열 (하이픈 또는 밑줄을 포함할 수 있지만 공백은 포함할 수 없음)로 형식을 지정해야 하는 임의의 개발자 정의 식별자입니다.
버전 항목에서 채널 필드를 완전히 생략하면 Chrome은 암시적으로 사용 가능 여부를 '기본' 채널로 설정합니다. 궁극적으로 관리 정책에 지정된 채널 이름은 매니페스트에 정의된 문자열과 정확히 일치해야 합니다. 오타나 구성 불일치가 있으면 적합한 버전이 식별되지 않아 해당 클라이언트의 업데이트가 중단됩니다.
매니페스트 구성
채널을 구성하려면 웹 앱 매니페스트의 각 버전 항목에 선택적 channels 배열을 추가합니다.
다음과 같은 사항을 고려해야 합니다.
- 채널 매핑: 버전 항목이
channels배열을 정의하는 경우 해당 버전은 지정된 채널에만 설치할 수 있습니다. - 기본 대체: 버전 항목에서
channels필드를 완전히 생략하면 Chrome은 버전이default채널에만 속한다고 가정합니다. - 정확한 문자열 일치: 클라이언트 측 정책 구성에 지정된 채널 이름은 업데이트 매니페스트에 정의된 문자열과 정확히 일치해야 합니다(대소문자 구분). 타겟팅된 채널 이름과 일치하는 버전이 없으면 앱에서 적합한 업데이트를 찾을 수 없습니다.
업데이트 매니페스트 예시
다음 예는 여러 출시 채널을 지원하는 업데이트 매니페스트를 보여줍니다.
{
"versions": [
{
"version": "0.1.0",
"src": "https://github.com/chromeos/iwa-sink/releases/download/v0.1.0/iwa-sink.swbn",
"channels": ["delta"]
},
{
"version": "0.2.0",
"src": "https://github.com/chromeos/iwa-sink/releases/download/v0.2.0/iwa-sink.swbn",
"channels": ["delta", "default"]
},
{
"version": "0.3.0",
"src": "https://github.com/chromeos/iwa-sink/releases/download/v0.3.0/iwa-sink.swbn",
"channels": ["beta", "delta"]
},
{
"version": "0.4.0",
"src": "https://github.com/chromeos/iwa-sink/releases/download/v0.4.0/iwa-sink.swbn"
}
]
}
이 매니페스트를 기반으로 타겟팅된 채널별로 다음 버전을 사용할 수 있습니다.
- 기본값:
0.2.0,0.4.0(명시적 채널이 없고 기본값으로 설정됨) - delta:
0.1.0,0.2.0,0.3.0 - beta:
0.3.0
IWA 업데이트 엔진은 앱의 업데이트 매니페스트 내에서 채널 필드를 찾아 특정 출시 채널을 타겟팅하는 것을 지원합니다.
고정 중인 버전
규정 준수 수준이 높거나 안정성이 높은 엔터프라이즈 환경에서 관리자는 기기가 비즈니스에 중요한 소프트웨어의 정확한 버전을 실행하도록 해야 합니다. 버전 고정을 사용하면 관리자가 IWA를 특정 버전에 고정하여 이후의 모든 백그라운드 업데이트를 중지할 수 있습니다. 이를 통해 기업은 안정적인 구성을 유지하고 엄격한 내부 또는 업계 규정을 준수할 수 있는 매우 안정적인 방법을 확보할 수 있습니다.
특정 출시 빌드에서 분리형 웹 앱 (IWA)을 고정하기 위해 엔터프라이즈 관리자는 IsolatedWebAppInstallForceList 정책 내에서 pinned_version 속성을 구성할 수 있습니다. 이 기능은 주로 표준 IWA 설치 워크플로에 따라 애플리케이션의 세부정보 패널 아래에 있는 Google 관리 콘솔의 대화형 UI 컨트롤을 통해 관리되지만, 관리자는 원시 JSON 구성을 사용하여 이러한 정책 값을 직접 배포할 수도 있습니다. 관리자가 유효한 버전 문자열을 타겟팅하면 Chrome은 해당 명시적 패키지를 가져오고 이후의 모든 자동 업데이트를 차단합니다.
특수 동작 및 제약조건
- 업데이트 재개 (고정 해제): 자동 업데이트를 복원하려면
pinned_version속성을 삭제하거나 값을 최신 대상 버전으로 변경합니다. - 기본적으로 다운그레이드되지 않음:
pinned_version를 현재 설치된 버전보다 낮은 버전으로 설정하면allow_downgrades가 명시적으로 사용 설정되지 않는 한 롤백이 트리거되지 않습니다. - 사용할 수 없는 고정 대상: 구성된
pinned_version가 지정된 업데이트 채널에 없거나 설치된 버전보다 오래된 경우(다운그레이드가 사용 중지됨) Chrome은 현재 설치된 버전을 유지하고 추가 업데이트를 차단합니다. - 새 배포: IWA가 아직 관리 기기에 설치되지 않았고 지정된 pinned_version을 가져올 수 없거나 업데이트 매니페스트에 없는 경우 IWA가 설치되지 않습니다.
버전 다운그레이드 중
새로 배포된 업데이트에 중대한 버그나 취약점이 있는 경우 관리자는 기기를 이전의 안정적인 상태로 롤백해야 할 수 있습니다. Chrome은 이미 설치된 관리형 IWA를 하위 버전으로 다운그레이드하는 기능을 지원합니다. 이 기능은 이전에는 정방향 업데이트만 허용되었을 때 플랫폼에서 사용할 수 없었습니다.
다운그레이드는 다음 정책 조건이 모두 충족되는 경우에만 가능합니다.
pinned_version가 유효한 이전 버전으로 설정되어 있습니다.allow_downgrades가 명시적으로 true로 설정됩니다.
다운그레이드 작동 방식
- 트리거 메커니즘: 롤백은 정기 업데이트 확인 주기 (4~6시간마다 실행) 중에 처리됩니다.
- 내부 작동 방식: Chrome은 업데이트 매니페스트에 지정된 이전 웹 번들 (.swbn)을 사용하여 IWA를 완전히 재설치합니다.
채널 전환 로직
정책을 사용하여 앱의 타겟 채널을 전환할 때 업데이트 엔진은 특정 동작을 따릅니다.
시나리오 A: 이전 버전이 있는 채널로 전환
- 다운그레이드가 허용되는 경우: pinned_version이 대상 채널의 이전 버전과 일치하고
allow_downgrades가 true이면 롤백이 발생하고 로컬 사용자 데이터가 완전 삭제됩니다. - 다운그레이드가 허용되지 않는 경우: 다운그레이드가 발생하지 않습니다. 기기는 현재 설치된 상위 버전을 유지하며 새로 선택한 채널에서 최신 버전을 사용할 수 있게 되면 업데이트됩니다.
시나리오 B: 동일한 버전의 채널로 전환
- 변경사항 없음: 새로 선택한 채널이 현재 설치된 버전 번호와 동일한 버전 번호를 가리키는 경우 Chrome은 설치된 번들을 수정하지 않습니다.
- 바이트 단위 ID 원칙: 개발자는 여러 채널에서 동일한 버전 번호에 동일한 바이트 일치 코드 서명이 포함되어 있는지 확인해야 합니다. 채널 전반에서 동일한 버전 문자열로 서로 다른 코드베이스를 배포하면 예기치 않은 비정상적인 애플리케이션 상태가 발생할 수 있습니다.
관리 정책 구성
엔터프라이즈 버전 제어는 IsolatedWebAppInstallForceList 정책 스키마를 사용하여 중앙 집중식 Google 관리 콘솔 플랫폼으로 시행됩니다. 이러한 설정은 관리 콘솔의 UI 컨트롤을 통해 직접 관리하거나 원시 JSON 정책 구성을 사용하여 배포할 수 있습니다.
다음 관리 정책 구성 예시에서는 업데이트 채널, 버전 고정, 다운그레이드를 보여줍니다.
정책 값 표현
[
{
"update_manifest_url": "https://awesome-kitchen-sink.glitch.me/update.json",
"web_bundle_id": "aiv4bxauvcu3zvbu6r5yynoh4atkzqqaoeof5mwz54b4zfywcrjuoaacai",
"channel": "beta",
"pinned_version": "0.7.0",
"allow_downgrades": true
}
]
스키마 파라미터 설명
channel(문자열, 선택사항): 업데이트 매니페스트에서 이 채널에 할당된 버전만 평가하도록 Chrome에 지시합니다. 생략하면 Chrome에서 'default' 채널을 평가합니다.pinned_version(문자열, 선택사항): 기기를 지정된 버전 문자열로 명시적으로 잠급니다. 이후의 자동 백그라운드 업데이트는 차단됩니다.allow_downgrades(불리언, 선택사항): 롤백 기능을 사용 설정합니다. true이고 유효한 이전pinned_version과 페어링된 경우 Chrome에서 다운그레이드 재설치를 트리거합니다. 경고: 이 매개변수를 true로 설정하면pinned_version필드가 생략되더라도 모든 표준 전달 업데이트가 차단됩니다.
비관리 (사용자 설치) IWA (150개부터)
관리되지 않는 사용자가 설치한 분리형 웹 앱의 경우 버전 관리는 수동 사용자 상호작용으로 작동합니다.
설치 번들 ──► 사용자가 채널 선택 ──► 선택한 채널 자동 확인
자동 업데이트를 위한 매니페스트 기본 요건
사용자가 설치한 IWA가 백그라운드에서 자동 정기 업데이트를 확인하고 수신하려면 앱의 로컬 웹 앱 매니페스트(/.well-known/manifest.webmanifest의 번들 내에 패키징된 메타데이터)에 유효한 update_manifest_url 필드가 포함되어야 합니다.
이 URL이 애플리케이션의 로컬 매니페스트 파일에서 생략되면 비관리형 업데이트 엔진은 백그라운드 확인을 실행하지 않으며 애플리케이션은 초기 설치 버전으로 영구적으로 고정됩니다.
수동 채널 선택
관리되지 않는 IWA를 처음 설치하는 동안 브라우저는 업데이트 매니페스트를 확인하고 개발자가 여러 채널을 구성한 경우 사용 가능한 채널 옵션 (예: '안정화 버전', '베타')을 사용자에게 직접 표시합니다.
키 수명 주기 규칙
- 최초 설치 출처: 설치 시 사용자가 선택한 채널과 관계없이 초기 설치는 항상 제공된 설치 번들 내에 패키징된 파일을 배포합니다.
- 후속 업데이트: 설치 후에는 선택한 채널에서만 향후 업데이트를 쿼리합니다. 앱은 설치된 버전보다 높은 버전이 타겟팅된 채널에 게시된 경우에만 업데이트됩니다.
- 채널 전환: 설치 후 다른 업데이트 채널로 전환하려면 사용자가 IWA를 제거하고 다시 설치해야 하며, 설치 과정에서 선택한 채널을 선택해야 합니다.
관리형 배포를 테스트하는 방법
Chrome Enterprise 관리 콘솔을 통해 기기를 관리하거나 정책을 직접 구성하는 관리자의 경우:
- 조직 설정에서 앱 세부정보 패널로 이동합니다.
- 구성 속성을 적용하여 고정 및 채널 타겟을 테스트합니다. 이러한 제어는 표준 사용자 세션, 관리 게스트 세션 (MGS), 키오스크와 완전히 호환되므로 모든 대상 배포 환경에서 동작을 확인할 수 있습니다.
- 업데이트 확인을 로컬에서 검사하려면 테스트 클라이언트에서
chrome://web-app-internals로 이동하여 업데이트 확인을 수동으로 강제 실행하고 수신 매니페스트 패킷을 분석합니다.
결론
분리형 웹 앱의 보안 아키텍처는 애플리케이션 수명 주기 동작에 대한 엄격한 예측 가능성과 제어를 유지하면서 개발자에게 권한을 부여하도록 설계되었습니다. 개발자와 IT 관리자는 Chrome의 버전 관리 기능을 활용하여 엄격한 규정 준수 표준 및 운영 목표에 부합하는 강력한 배포 파이프라인을 구축할 수 있습니다.
애플리케이션의 업데이트 전략을 설계하고 관리할 때는 다음 핵심 원칙을 염두에 두세요.
- 점진적 채널 사용: 업데이트 채널 (예:
beta,dev또는 맞춤 링)을 사용하면 원격 분석 및 의견을 점진적으로 수집할 수 있습니다. 이렇게 하면 주요 업데이트가 기본 채널의 일반 사용자에게 제공되기 전에 엄격한 검증을 거치게 됩니다. - 안정성을 위한 고정: 고도로 구조화되거나 규정 준수가 중요한 엔터프라이즈 환경에서는 중요한 엔드포인트를 확인된 정확한 pinned_version으로 고정하여 예기치 않은 중단이나 워크플로 중단으로부터 작업을 보호합니다.
- 긴급 상황에 대비한 다운그레이드: 버전 다운그레이드는 이전에는 불가능했던 강력한 수정 안전 밸브라는 점을 인식하세요. 하지만 롤백은 전체 재설치를 트리거하고 모든 로컬 클라이언트 저장소 (IndexedDB, LocalStorage, 쿠키)를 삭제하므로 중요한 보안 해결을 위해서만 엄격하게 예약해야 합니다. 일반 패치의 경우 사소한 미래 지향적 업데이트를 배포하는 것이 항상 이상적인 전략입니다.
- 정책 플래그 이해: 관리 스위치에 유의하세요.
allow_downgrades를 사용 설정하면 핀이 활성 상태로 정의되지 않은 경우에도 모든 정방향 업데이트가 중지됩니다. - 바이트 단위 무결성 설정: 여러 채널에 배포된 동일한 버전 번호가 동일한 바이트 일치 번들에 매핑되도록 하여 클라이언트가 채널 간에 전환할 때 애플리케이션 상태가 불안정해지지 않도록 합니다.
이러한 기능을 업데이트 매니페스트 및 엔터프라이즈 정책 스키마에 직접 통합하면 분리된 웹 앱 생태계의 높은 신뢰 보장을 유지하는 안정적이고 감사 가능하며 안전한 업데이트 흐름을 보장할 수 있습니다.