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

다목적 오픈 소스 자동화 서버인 Jenkins는 향상된 보안 자동화를 위해 DoveRunner Mobile App Security CLI 도구와 효과적으로 결합될 수 있습니다. [구성 파일 사용](https://docs.doverunner.com/ko/mobile-app-security/android/cicd/basic-configuration/#configtxt-%ED%8C%8C%EC%9D%BC%EC%9D%84-%EC%82%AC%EC%9A%A9%ED%95%98%EC%97%AC-sealingjar-%EC%8B%A4%ED%96%89)을 통한 간단한 설치 및 통합을 위한 단계별 가이드를 따르세요. 또한 맞춤형 보안 조치를 위해 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\_DEPLOY\_MODE** \<필수> |**배포 모드** <br />- test : DoveRunner 워터마크 표시 <br />- release : DoveRunner 워터마크 없음 | Choice |**\{test / release\}** <br />기본값 : test |
| **AS\_SERVICE\_VERSION** | **실링 서비스 버전 번호**<br />위협 대응 정책 옵션(`action_*`)을 사용하는 경우 3.3.0.0 이상이어야 합니다. | String | 예) 3.3.0.0<br />기본값: latest |
| **AS\_SERVICE\_TYPE**|**서비스 유형 옵션**  <br />- HYBRID\_AOS : React Native, Ionic, Cordova 프레임워크는 이 옵션을 사용해야 합니다.  <br />- NATIVE\_AOS : 그 외 모든 앱. | Choice | **\{ NATIVE\_AOS / HYBRID\_AOS \}** <br />**기본값 : NATIVE\_AOS** |
| **AS\_FRAMEWORK** | **앱의 프레임워크** (HYBRID\_AOS인 경우 필수) <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** : 실링 후 `테스트` 목적의 서명 키로 서명됩니다. AAB 패키지의 경우 이 옵션은 'none' 값으로 적용되고 앱은 서명되지 않습니다.  <br />- **registered\_key** : 실링 후 계정으로 DoveRunner 콘솔에 등록된 앱 서명 키로 서명됩니다. | Choice | **\{none / appsealing\_key / registered\_key\}** <br />**기본값 : none** |
| **AS\_PRESET\_NAME** | 콘솔에서 생성한 **실링 프리셋 이름**. 프리셋의 모든 보호 옵션이 적용됩니다. | String | 예) my-preset-name |
| **AS\_CONFIG\_PATH** | **config.txt 파일 경로**. [config.txt 파일](https://docs.doverunner.com/ko/mobile-app-security/android/cicd/basic-configuration/#configtxt-%ED%8C%8C%EC%9D%BC)로 보호 옵션을 관리할 때 사용합니다. | String | 예) /opt/appsealing/config.txt |

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

:::tip[보호 옵션 관리]
옵션마다 Jenkins 매개변수를 만들기보다는 **프리셋**(`AS_PRESET_NAME`)이나 **config.txt 파일**(`AS_CONFIG_PATH`)로 보호 옵션을 관리하는 것을 권장합니다. 옵션을 직접 전달하는 경우 값을 지정한 옵션만 추가하세요. 전체 옵션 목록은 [기본 구성](https://docs.doverunner.com/ko/mobile-app-security/android/cicd/basic-configuration/)을 참고하세요.
:::

## 실행 스크립트 구성

### 프리셋 사용 (권장)

**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} -sealing_preset_name ${AS_PRESET_NAME} -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% -sealing_preset_name %AS_PRESET_NAME% -app_signing %AS_APP_SIGNING%
```



### config.txt 파일 사용

보호 옵션은 config.txt에 설정하고, Jenkins에서는 파일 경로만 전달합니다. 명령행으로 전달한 옵션은 config.txt의 옵션과 함께 적용됩니다.

**Linux & Mac**


```
java -jar ${AS_JAR_PATH} -config ${AS_CONFIG_PATH} -srcapk ${AS_SRC_APK} -sealedapk ${AS_SEALED_APK}
```


**Windows**


```
java -jar %AS_JAR_PATH% -config %AS_CONFIG_PATH% -srcapk %AS_SRC_APK% -sealedapk %AS_SEALED_APK%
```



### 옵션 직접 전달

아래 예제는 일부 [위협 대응 정책](https://docs.doverunner.com/ko/mobile-app-security/android/cicd/basic-configuration/#%EC%9C%84%ED%98%91-%EB%8C%80%EC%9D%91-%EC%A0%95%EC%B1%85-3300-%EC%9D%B4%EC%83%81) 옵션(3.3.0.0 이상)을 Jenkins 매개변수로 추가한 것입니다. 각 `AS_ACTION_*` 매개변수는 `block`, `monitor`, `callback`, `allow` 값을 가진 Choice 매개변수로 만드세요. 3.2.x 이하는 [기존 버전 옵션](https://docs.doverunner.com/ko/mobile-app-security/android/cicd/legacy-options/)을 사용하세요.

**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} -service_version ${AS_SERVICE_VERSION} -service_type ${AS_SERVICE_TYPE} -action_rooting ${AS_ACTION_ROOTING} -action_emulator ${AS_ACTION_EMULATOR} -action_macro ${AS_ACTION_MACRO} -action_sniff ${AS_ACTION_SNIFF} -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% -service_version %AS_SERVICE_VERSION% -service_type %AS_SERVICE_TYPE% -action_rooting %AS_ACTION_ROOTING% -action_emulator %AS_ACTION_EMULATOR% -action_macro %AS_ACTION_MACRO% -action_sniff %AS_ACTION_SNIFF% -app_signing %AS_APP_SIGNING%
```



Hybrid 앱은 `AS_SERVICE_TYPE`을 `HYBRID_AOS`로 설정하고 `-framework ${AS_FRAMEWORK}`(Windows는 `%AS_FRAMEWORK%`)를 추가하세요.