---
title: "App Safer Open API 사용가이드"
slug: "app-safer-open-api"
tags: ["App Safer", "App Safer Open API"]
updated: 2026-09-17T09:09:33Z
published: 2026-09-17T09:09:33Z
canonical: "guide-fin.ncloud-docs.com/app-safer-open-api"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://guide-fin.ncloud-docs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# App Safer Open API 사용가이드

## App Safer Open API 사용 가이드

App Safer 콘솔의 management 기능을 Open API로 사용 가능합니다.

- App Safer Open API는 별도의 구독신청 없이 사용 가능합니다.

참고

App Safer Open API 명세서는 Swagger UI를 통해 확인할 수 있습니다.

Console > API Gateway > Published APIs > App Safer 선택 > Catalog 버튼 클릭 > [API 설명서](https://appsafer.apigw-pub.fin-ntruss.com/apigw/swagger-ui?productId=jo4pm844b9&apiId=c7884gpgs5&stageId=cfvt3ss9j2&stageType=default)를 참고해 주십시오.

## App Safer 빌드 자동화 가이드

App Safer는 Open API를 사용한 빌드 자동화 스크립트를 제공합니다. 빌드 자동화를 적용하려면 아래의 순서대로 설정을 진행해 주십시오.

주의

앱 등록 API는 Android 간편등록만 지원합니다. 따라서 빌드 자동화 스크립트도 Android에만 적용이 가능합니다.

### 1. 앱 등록

App Safer의 보호설정을 편리하게 적용하기 위해 App Safer 콘솔을 통해 앱 등록을 해야합니다.

1. Console > App Safer > Management 메뉴에서 앱등록을 합니다.
2. [App Safer 사용 가이드](/docs/security-appsafer-console)를 참고하여 설정을 진행해 주십시오.
3. 앱이 정상적으로 실행되는지 확인합니다.

### 2. 스크립트 다운로드

App Safer에서는 Open API를 통해 앱 등록 및 다운로드를 하는 스크립트를 제공합니다. 콘솔에 이미 등록한 앱이 있다면 해당 앱의 설정이 적용된 스크립트를 다운로드 할 수 있습니다.

#### 1) 등록 설정 확인

아래 메뉴에서 등록시 작성한 설정들을 확인할 수 있습니다.

- Console > App Safer > Management > 앱 선택 > 등록 설정 보기 > 설정 버튼 클릭

![appsafer-open-api-01_ko](https://cdn.document360.io/0406ed95-101f-4cde-8dd8-308d03444a94/Images/Documentation/appsafer-open-api-01_ko.png?sv=2026-02-06&spr=https&st=2026-11-07T17%3A00%3A15Z&se=2026-11-07T18%3A00%3A15Z&sr=c&sp=r&sig=fs51qNY%2BZ9G4XUD85zP4YH92lUgVhoTkxmEgyNib8zQ%3D)

#### 2) 스크립트 다운로드

팝업 하단에 스크립트 다운로드 버튼을 클릭하면 선택한 앱의 설정이 적용된 API 요청 스크립트를 다운로드 할 수 있습니다.

![appsafer-open-api-02_ko](https://cdn.document360.io/0406ed95-101f-4cde-8dd8-308d03444a94/Images/Documentation/appsafer-open-api-02_ko.png?sv=2026-02-06&spr=https&st=2026-11-07T17%3A00%3A15Z&se=2026-11-07T18%3A00%3A15Z&sr=c&sp=r&sig=fs51qNY%2BZ9G4XUD85zP4YH92lUgVhoTkxmEgyNib8zQ%3D)

#### 3) Access Key, SecretKey 확인

API 요청은 Access Key와 Secret Key를 통해 권한 관리가 이루어지며 다음과 같은 방법으로 확인할 수 있습니다.

- 메인 계정 콘솔 > **My Account** > **계정 및 보안 관리** > **보안 관리** > **접근 관리** > **API 인증키**
- 서브 계정 [서브 계정 생성 및 관리](/docs/subaccount-use)를 참조해 주십시오.

주의

서브계정의 경우 권한이 주어지지 않은 API 동작은 요청이 거부됩니다. 스크립트를 실행하기 전에 아래의 권한이 추가되어 있는지 확인해 주십시오.

- createPackage
- getPackageDetail
- downloadPackage

#### 4) 스크립트 실행

스크립트가 정상적으로 실행되는지 확인합니다.

```
usage: appsafer.py [-h] --access-key ACCESS_KEY --secret-key SECRET_KEY
                       package out
```

실행에 성공하면 다음과 같은 화면을 확인할 수 있습니다.

![appsafer-open-api-04_ko.png](https://cdn.document360.io/0406ed95-101f-4cde-8dd8-308d03444a94/Images/Documentation/appsafer-open-api-04_ko.png%20.png?sv=2026-02-06&spr=https&st=2026-11-07T17%3A00%3A15Z&se=2026-11-07T18%3A00%3A15Z&sr=c&sp=r&sig=fs51qNY%2BZ9G4XUD85zP4YH92lUgVhoTkxmEgyNib8zQ%3D)

### 3. 빌드 설정

앱 빌드 시 App Safer가 자동으로 적용되도록 설정하는 방법입니다.

#### 1) 프로젝트에 스크립트 파일 추가

다운로드 받은 스크립트 파일을 프로젝트 내의 build.gradle과 동일한 경로에 위치시킵니다.

#### 2) build.gradle 설정

build.gradle 파일에 아래의 코드를 추가하고 accessKey와 secretKey를 입력합니다.

- APK

```
 // * prepare for apk * /
applicationVariants.all { variant ->
    def accessKey = "{ACCESS_KEY}";
    def secretKey = "{SECRET_KEY}";
    
    def apkPath = variant.outputs.stream().map({i -> i.getOutputFile()}).findFirst().get().getAbsolutePath();
    variant.getPackageApplicationProvider().get().doLast() {
        exec {
            commandLine 'python', 'appsafer.py', apkPath, apkPath, "--access-key", accessKey, "--secret-key", secretKey
        }
    }
}
```

- App Bundle

```
// * prepare for bundle * /
applicationVariants.all { variant ->
    def accessKey = "{ACCESS_KEY}";
    def secretKey = "{SECRET_KEY}";
    
    def bundleTaskName = "package${variant.name.capitalize()}Bundle"
    def bundleTask = tasks.findByPath(bundleTaskName)

    def bundlePath = bundleTask.bundleFile.get().getAsFile().getAbsolutePath()
    bundleTask.doLast {
        exec {
                commandLine 'python', 'appsafer.py', bundlePath, bundlePath, "--access-key", accessKey, "--secret-key", secretKey
        }
    }
}
```

#### 3) 확인

빌드 성공 시 outputs 파일에 자동으로 AppSafer가 적용된 앱이 생성되며, App Safer 콘솔에서도 새로 빌드한 앱이 등록되는 것을 확인할 수 있습니다. ![appsafer-open-api-05_ko.png](https://cdn.document360.io/0406ed95-101f-4cde-8dd8-308d03444a94/Images/Documentation/appsafer-open-api-05_ko.png%20.png?sv=2026-02-06&spr=https&st=2026-11-07T17%3A00%3A15Z&se=2026-11-07T18%3A00%3A15Z&sr=c&sp=r&sig=fs51qNY%2BZ9G4XUD85zP4YH92lUgVhoTkxmEgyNib8zQ%3D)