---
title: "하드웨어 키 증명"
description: "안드로이드의 하드웨어 기반 키 증명으로 기기의 부트로더 및 무결성 상태를 검증하고, 이를 통해 앱의 엔드포인트를 보호합니다."
---
> For the complete documentation index, see [llms.txt](https://docs.doverunner.com/llms.txt).

**애드온 기능:** 
하드웨어 키 증명은 별도의 플랜 또는 계약이 필요한 애드온입니다. 사용하려면 [헬프 센터](https://support.doverunner.com)로 문의해 주세요.


**하드웨어 키 증명(Hardware Key Attestation)**은 안드로이드의 하드웨어 기반 키 증명을 통해 기기의 부트로더 및 무결성 상태를 검증합니다. **대상 URL**로 지정한 앱의 엔드포인트를 보호하며, 앱별로 설정한 탐지 모드를 적용합니다.

하드웨어 키 증명은 두 곳에서 설정합니다.

| 위치 | 설정 내용 |
| :--- | :-------- |
| [실링 위저드 5단계](#실링-시-사용-설정)(또는 프리셋) | 실링마다 증명 기능을 켜고 끄며, 대상 URL을 지정합니다. |
| [앱 구성](#앱-구성의-탐지-모드) | 앱에 적용할 탐지 케이스를 선택합니다. |

## 사전 요구 사항

- 실링 버전 **3.3.0.0 이상**
- 계정에 하드웨어 키 증명이 활성화되어 있어야 합니다. 활성화되기 전까지는 실링 위저드와 프리셋에 옵션이 표시되지 않으며, 앱 구성에는 기능이 활성화되어 있지 않다고 표시됩니다.

## 실링 시 사용 설정

[실링 위저드](https://docs.doverunner.com/ko/mobile-app-security/android/android-sealing-options/#5%EB%8B%A8%EA%B3%84--%EA%B3%A0%EA%B8%89-%ED%83%90%EC%A7%80)의 **5단계 — 고급 탐지**에서 설정합니다.

| 옵션 | 값 | 기본값 | 설명 |
| :--- | :-- | :----- | :--- |
| **하드웨어 키 증명** | 사용 / 사용 안 함 | 사용 안 함 | 이번 실링에 증명 기능을 적용합니다. |
| **대상 URL** | URL | — | 증명을 사용하면 표시됩니다. 증명으로 보호할 앱의 엔드포인트로, 정확한 URL 또는 정규식을 최대 50개(각 500자 이내)까지 추가할 수 있습니다. |

증명이 활성화되면 앱 구성에서 설정한 탐지 모드가 자동으로 적용됩니다.

## 앱 구성의 탐지 모드

**Android Mobile App Security → 앱 구성**을 열고 앱을 선택한 뒤 **하드웨어 키 증명** 영역으로 이동합니다. 이곳에는 켜기/끄기 스위치가 없습니다. 증명 기능은 위에서 설명한 대로 실링마다 켜고 끕니다.

| 탐지 모드 | 동작 |
| :-------- | :--- |
| **기본** | 확정적인 세 가지 케이스 — 부트로더 잠금 해제, Verified Boot 실패, 앱 서명 불일치 — 만 탐지합니다. 나머지 네 가지는 이전 OS 버전, LineageOS, 특정 제조사 기기에서의 오탐을 피하기 위해 허용됩니다. |
| **사용자 지정** | 케이스를 개별적으로 켭니다. 선택하지 않은 케이스는 허용됩니다. |

| 탐지 케이스 | 배지 | 탐지 시 동작 |
| :---------- | :--- | :----------- |
| **부트로더 잠금 해제 탐지** | 확정 | 차단 |
| **Verified Boot 실패 탐지** | 확정 | 차단 |
| **앱 서명 불일치 탐지** | 확정 | 차단 |
| **폐기된 인증서 탐지** | 권장 | 제한 |
| **소프트웨어 수준 증명 탐지** | 오탐지 위험 | 제한 |
| **증명 데이터 없음 탐지** | 오탐지 위험 | 제한 |
| **루트 인증서 검증 실패 탐지** | 오탐지 위험 | 제한 |

**저장**을 클릭하면 탐지 모드가 저장됩니다.

**Tip:** 
처음에는 **기본** 모드로 시작하세요. **오탐지 위험** 배지가 붙은 케이스는 정상 기기도 탐지할 수 있으므로, 사용자 환경에 미치는 영향을 확인한 뒤 **사용자 지정** 모드에서 켜는 것이 좋습니다.


## CLI 도구에서 사용

CLI 도구에는 하드웨어 키 증명 옵션이 없습니다. CLI로 실링할 때 적용하려면 [실링 프리셋](https://docs.doverunner.com/ko/mobile-app-security/android/android-preset/)을 사용합니다.


1. 위의 안내에 따라 앱 구성에서 앱의 탐지 모드를 설정합니다.
2. **Android → 프리셋**을 열고 실링 버전 3.3.0.0 이상으로 프리셋을 만들거나 편집합니다.
3. **고급 기능**에서 **하드웨어 키 증명**을 사용으로 설정하고 대상 URL을 추가한 뒤 프리셋을 저장합니다.
4. 프리셋 이름을 지정하여 실링합니다.

   ```bash
   $ java -jar sealing.jar -url https://api.appsealing.com/covault/gw -authkey 123456789ABCDE -srcapk app-release.aab -sealedapk app-release-sealed.aab -sealing_preset_name my-preset-name
   ```


프리셋 이름 규칙과 관련 경고는 [CLI 도구에서 프리셋 사용](https://docs.doverunner.com/ko/mobile-app-security/android/android-preset/#cli-%EB%8F%84%EA%B5%AC%EC%97%90%EC%84%9C-%ED%94%84%EB%A6%AC%EC%85%8B-%EC%82%AC%EC%9A%A9)을 참고하세요.