---
title: "Jenkins 안드로이드 연동"
description: "CI/CD 파이프라인에서 자동화된 보안을 위해 DoveRunner Mobile App Security CLI 도구를 Jenkins와 연동하는 방법을 알아보세요."
---
> For the complete documentation index, see [llms.txt](/llms.txt).

다목적 오픈 소스 자동화 서버인 Jenkins는 향상된 보안 자동화를 위해 DoveRunner Mobile App Security CLI 도구와 효과적으로 결합될 수 있습니다. [구성 파일 사용](/ko/mobile-app-security/android/cicd/basic-configuration/)을 통한 간단한 설치 및 통합을 위한 단계별 가이드를 따르세요. 또한 맞춤형 보안 조치를 위해 Jenkins 매개변수 설정을 통한 고급 통합 옵션을 탐색하세요.

## Jenkins 매개변수 설정

:::note[리전별 API 엔드포인트]
| 리전 | URL |
|------|-----|
| Global / Tokyo | `https://api.appsealing.com/covault/gw` |
| 인도 (뭄바이) | `https://in-api.appsealing.com/covault/gw` |
| 인도네시아 (자카르타) | `https://jakarta-api.appsealing.com/covault.gw` |
:::

| **매개변수** | **정의** | **유형** | **설정 값** |
| --- | --- | --- | --- |
| **AS\_JAR_PATH** \<필수> | **sealing.jar 파일 경로** | String | 예) /opt/appsealing/sealing.jar |
| **AS\_URL** \<필수> | **실링 API URL** — 계정 리전에 맞게 선택하세요 (위 표 참고) | String | 리전별 URL |
| **AS\_AUTH\_KEY** \<필수> |**인증 키**| String |( **별도 제공** ) |
| **AS_SRC_APK** \<필수> |**원본 APK/AAB 파일 경로** | String | 예)./source/application.apk |
| **AS\_SEALED_APK** \<필수> |**실링된 APK/AAB 파일을 저장할 경로** | String | 예)./source/application\_sealed.apk |
| **AS\_APP\_TYPE** | 실링 보안 서비스<br />- _GAME : 게임 보안 서비스_ <br />- _NON\_GAME : 비게임 보안 서비스_ | String | _기본값 : GAME_ |
| **AS\_SERVICE\_VERSION** | _실링 서비스 버전 번호_ | String | _예) 2.31.0.0_<br />기본값: latest |
| **AS\_DEPLOY\_MODE** \<필수> |**배포 모드** <br /># _- `test` : AppSealing 워터마크 표시_  <br /># - release : AppSealing 워터마크 없음_ | Choice |**`{test / release}`** <br />_기본값 : `test`_ |
| **AS\_DEX\_ENCRYPT**|**DEX 암호화 옵션**  <br />-no : DEX 암호화 적용하지 않음  <br />-yes : DEX 암호화 적용 | Choice |**`{ no / yes }`**  <br /> 기본값 : no |
| **AS\_SELECTIVE\_DEX\_ENCRYPT** | **선택적 Dex 암호화 옵션**<br />**(이 옵션은 DEX 암호화가 적용된 경우에만 인식됩니다.)**<br />- no: 전체 dex 파일 암호화<br />- yes: 일부 클래스 및 패키지 암호화 | Choice | **`{no / yes}`** <br />기본값 : no |
| **AS\_BLOCK\_ENVIRONMENT**|**에뮬레이터 및 루트 환경 옵션** <br />- emulator : 에뮬레이터에서 앱 실행 차단<br />- rooting : 루팅된 기기에서 앱 실행 차단<br />- 지원 에뮬레이터 : BlueStacks, Nox, LDPlayer | Extended choice |**`{ emulator, rooting}`** <br />기본값 : 선택 안 함|
| **AS\_ALLOW\_EMULATOR** | **모든 에뮬레이터가 차단된 경우 예외 에뮬레이터 허용** <br />- LDPlayer : LDPlayer 허용  <br />- BlueStacks : Bluestacks 허용  <br />- Nox : Nox 앱 플레이어 허용<br />- 다른 에뮬레이터는 향후 지원될 예정 | Extended choice | **`{ BlueStacks, Nox, LDPlayer }`**  <br />기본값 : 선택 안 함 |
| **AS\_BLOCK\_WORK\_PROFILE**|**작업 프로필 옵션(Samsung Secure folder와 같은 작업 프로필 환경에서 앱 실행 차단)**  <br />- yes : 앱 실행 차단  <br />- no : 앱 실행 허용 | Choice |**`{yes / no}`**<br />**기본값 : yes** |
| **AS\_ALLOW\_WORK\_PROFILES** | **모든 작업 프로필이 차단된 경우 예외 작업 프로필 허용**  <br />- Samsung SecureFolder| Extended Choice | **`{Samsung SecureFolder}`** <br />기본값: 선택 안 함 |
| **AS\_BLOCK\_KEYLOGGER** | **키 로거 차단 옵션**  <br />- yes :키 로깅 도구와 함께 앱 실행 차단 <br />- no : 키 로깅 도구와 함께 앱 실행 허용| Choice |**`{yes / no}`**  <br />**기본값 : no** |
| **AS\_HIDE\_OVERLAY_WINDOWS** | **화면 오버레이 숨김 옵션. 이 옵션은 Android 12 기기부터 작동합니다.**  <br />- yes :실링된 앱에서 오버레이 창 숨김  <br />- no : 실링된 앱에서 오버레이 창 허용| Choice |**`{yes / no}`**  <br />**기본값 : no** |
| **AS\_ALLOW\_EXTERNAL\_TOOL**|**매크로 및 네트워크 도구 옵션**  <br />- macro : 매크로 도구 허용  <br />- sniff : 패킷 스니핑 및 스푸핑 도구 허용 | Extended Choice |**`{macro, sniff}`**  <br />기본값: 선택 안 함|
| **AS\_SERVICE\_TYPE**|**AppSealing 서비스 유형 옵션**  <br />- HYBRID\_AOS : 하이브리드 AppSealing. React Native, Ionic, Cordova 프레임워크는 이 옵션을 사용해야 합니다.  <br />- NATIVE\_AOS :네이티브 AppSealing. 앱이 HYBRID\_AOS 유형이 아닌 경우 현재 이 옵션은 필요하지 않습니다. | Choice | **`{ HYBRID_AOS / NATIVE_AOS }`** <br />**기본값 : NATIVE\_AOS** |
| **AS\_FRAMEWORK** | **앱의 프레임워크**  <br />- **하이브리드 프레임워크는 이 옵션을 명시적으로 사용해야 합니다**  <br />- REACT\_NATIVE: React Native 앱을 업로드할 때 사용합니다.  <br />- IONIC: Ionic 앱을 업로드할 때 사용합니다.  <br />- CORDOVA: Cordova 앱을 업로드할 때 사용합니다.**| Choice |**`{REACT_NATIVE / IONIC / CORDOVA}`** <br />기본값 : 선택 안 함 |
| **AS\_APP\_SIGNING** | **실링 후 자동 앱 서명 옵션** <br />앱 서명은 실링과 함께 적용될 수 있습니다.<br />- **none** : 추가 앱 서명 없이 실링만 적용됩니다.  <br />- **appsealing\_key** : 실링 후 `테스트` 목적으로 appsealing의 서명 키로 서명됩니다. AAB 패키지의 경우 이 옵션은 'none' 값으로 적용되고 앱은 서명되지 않습니다.  <br />- **registered\_key** : 실링 후 계정으로 AppSealing 콘솔에 등록된 앱 서명 키로 서명됩니다. | Choice | **`{none / appsealing_key / registered_key}`** <br />**기본값 : none** |

_**\* 별도 제공되며 제공된 값만 사용해야 합니다**_

_**\*\* 하나의 값만 선택해야 합니다**_

_**\*\*\* ','(쉼표)를 구분 기호로 사용하여 여러 값을 선택할 수 있습니다. 기본값은 None(빈 문자열)입니다**_

_\[필수] 매개변수는 구성되어야 하며 기본값은 구성되지 않습니다_


## 실행 스크립트 구성

### Linux & Mac
```
java -jar ${AS_JAR_PATH} -url ${AS_URL} -authkey ${AS_AUTH_KEY} -srcapk ${AS_SRC_APK} -sealedapk ${AS_SEALED_APK} 
-deploymode ${AS_DEPLOY_MODE} -block_environment ${AS_BLOCK_ENVIRONMENT} -allow_emulator ${AS_ALLOW_EMULATOR} -allow_external_tool ${AS_ALLOW_EXTERNAL_TOOL} -dex_encrypt ${AS_DEX_ENCRYPT} 
-select_dex_encrypt ${AS_SELECTIVE_DEX_ENCRYPT} -service_version ${AS_SERVICE_VERSION} -app_type ${AS_APP_TYPE} -allow_external_tool ${AS_ALLOW_EXTERNAL_TOOL} -block_work_profile=${AS_BLOCK_WORK_PROFILE} -allow_work_profiles=${AS_ALLOW_WORK_PROFILES} -block_keylogger=${AS_BLOCK_KEYLOGGER} -service_type ${AS_SERVICE_TYPE} -framework ${AS_FRAMEWORK} –app_signing ${AS_APP_SIGNING}
```

### Windows
```
java -jar %AS_JAR_PATH% -url %AS_URL% -authkey %AS_AUTH_KEY% -srcapk %AS_SRC_APK% -sealedapk %AS_SEALED_APK% -deploymode %AS_DEPLOY_MODE% -block_environment %AS_BLOCK_ENVIRONMENT% -allow_emulator %AS_ALLOW_EMULATOR% -allow_external_tool %AS_ALLOW_EXTERNAL_TOOL% -dex_encrypt %AS_DEX_ENCRYPT% -select_dex_encrypt %AS_SELECTIVE_DEX_ENCRYPT% -service_version %AS_SERVICE_VERSION% -app_type %AS_APP_TYPE% -allow_external_tool %AS_ALLOW_EXTERNAL_TOOL% -block_work_profile %AS_BLOCK_WORK_PROFILE% -allow_work_profiles=%AS_ALLOW_WORK_PROFILES% -block_keylogger=%AS_BLOCK_KEYLOGGER% -service_type %AS_SERVICE_TYPE% -framework %AS_FRAMEWORK% -app_signing %AS_APP_SIGNING%
```