이 페이지는 Cloud Translation API를 통해 번역되었습니다.

시작하기

공통 Android 리셀러 라이브러리를 사용하기 전에 리셀러는 삼성의 Knox 배포 프로그램 및 Android 제로터치 등록에 참여해야 합니다.

Knox 배포 프로그램 (KDP)

아래 단계에 따라 KDP에 가입하고 리셀러 라이브러리 사용을 시작하는 데 필요한 세부정보를 가져옵니다.

1단계: KDP 가입

리셀러용 Samsung Knox에서 KDP에 가입합니다.
삼성 계정을 만들고 리셀러로 삼성 Knox 계정을 등록합니다.
리셀러 계정이 승인되면 KDP 포털에 로그인하여 resellerId를 찾습니다.

2단계: Knox Cloud API 포털에 대한 액세스 요청하기

Knox Cloud API 포털에 대한 액세스 권한을 얻기 위해 삼성에 요청을 보냅니다.
Knox Cloud API 포털에 로그인합니다.

3단계: 서비스 계정 키 및 `clientIdentifier` 가져오기

Knox Cloud API 포털에서 키 쌍 JSON 파일을 다운로드하여 안전한 장소에 저장합니다.
Knox Cloud API 포털에서 고유한 clientIdentifier를 생성합니다.

4단계: `SamsungResellerService` 객체 만들기

JSON 파일 경로 clientIdentifier, resellerId를 사용하여 공통 라이브러리를 사용할 SamsungResellerService 객체를 만듭니다.

제로터치 등록

1단계: 제로터치 등록 프로그램 가입

제로터치 등록으로 온보딩하세요.
일반 Android 리셀러 라이브러리는 리셀러 API를 사용하므로 Google 플랫폼 솔루션 컨설턴트에게 리셀러 API에 대한 액세스 권한을 요청해야 합니다.
제로터치 포털에 대한 액세스를 요청합니다.

포털에 액세스하는 데 사용하는 Google 계정으로 나머지 안내에 따라 서비스 계정을 만들고 Reseller API를 사용 설정하세요.

2단계: 서비스 계정 만들기

서비스 계정(로봇 계정이라고도 함)은 사용자 대신 앱을 나타내는 Google 계정입니다. 등록 라이브러리는 서비스 계정을 대신하여 Google API를 호출하므로 Google API 콘솔을 사용하여 액세스를 설정하세요.

API 콘솔 프로젝트 만들기

새로운 API 콘솔 프로젝트 및 서비스 계정을 만드는 것이 좋습니다. 이렇게 하면 향후 액세스 관리, 리소스 관리, 분실한 키 수정이 더 쉬워집니다. 먼저 아래 단계에 따라 Google API 콘솔에서 새 프로젝트를 만듭니다.

API 콘솔로 이동합니다.
프로젝트 목록에서 프로젝트 만들기를 선택합니다.
앱과 제로터치 등록을 설명하는 이름을 입력합니다.
프로젝트 ID를 지정하거나 기본값을 수락합니다.
만들기를 클릭합니다.

자세한 내용은 Google Cloud Platform 문서 콘솔에서 프로젝트 관리를 참고하세요.

새 서비스 사용자 인증 정보 추가

프로젝트에 새 사용자 인증 정보와 서비스 계정을 추가하려면 API 콘솔에서 아래 단계를 따르세요.

서비스 계정 페이지를 엽니다. 메시지가 표시되면 프로젝트를 선택합니다.
서비스 계정 만들기를 클릭한 다음 서비스 계정의 이름과 설명을 입력합니다. 기본 서비스 계정 ID를 사용하거나 다른 고유한 ID를 선택할 수도 있습니다. 완료하면 만들기를 클릭합니다.
이어지는 서비스 계정 권한(선택사항) 섹션은 선택하지 않아도 됩니다. 계속을 클릭합니다.
사용자에게 이 서비스 계정에 대한 액세스 권한 부여 화면에서 키 만들기 섹션이 나올 때까지 아래로 스크롤합니다. 키 만들기를 클릭합니다.
표시되는 측면 패널에서 키에 사용할 형식을 선택합니다. JSON을 사용하는 것이 좋습니다.
만들기를 클릭합니다. 새로운 공개 키/비공개 키 쌍이 생성되어 기기에 다운로드됩니다. 생성된 파일은 이 키의 유일한 사본으로 사용됩니다. 키를 안전하게 보관하는 방법을 자세히 알아보려면 서비스 계정 키 관리를 참조하세요.
비공개 키가 컴퓨터에 저장됨 대화상자에서 닫기를 클릭한 다음 완료를 클릭하여 서비스 계정 표로 돌아갑니다.

서비스 계정의 이메일 주소를 복사하여 가까이에 두세요. 나중에 서비스 계정을 조직에 연결할 때 이 정보가 필요합니다.

3단계: JSON 키 파일 저장

API 콘솔은 서비스 계정을 사용하여 실행한 API 호출을 인증하는 데 사용되는 새로운 비공개 키 쌍을 생성합니다. 비공개 키는 다운로드한 JSON 키 파일에 있습니다.

키는 비공개로 유지해야 하므로 소프트웨어의 소스 코드에 포함하지 마세요. 키 파일을 분실하면 새 키 쌍을 생성해야 합니다.

키 파일을 안전하게 저장하는 방법에 관한 자세한 내용은 API 키를 안전하게 사용하기 위한 권장사항을 참고하세요.

4단계: API 사용 설정

라이브러리가 Reseller API를 사용하려면 먼저 API를 사용 설정해야 합니다. API를 사용 설정하면 API가 현재 API Console 프로젝트와 연결되고 Console에 모니터링 페이지가 추가됩니다.

리셀러 API를 사용 설정하려면 API 콘솔에서 아래 단계를 따르세요.

API 및 서비스 > 라이브러리를 클릭합니다.
검색창을 사용하여 Android Device Provisioning Partner API를 찾습니다.
Android Device Provisioning Partner API를 클릭합니다.
사용 설정을 클릭합니다.

잠시 후 API 상태가 사용 설정됨으로 변경됩니다. Android Device Provisioning Partner API가 표시되지 않으면 조직이 제로터치 등록에 온보딩되었는지 확인합니다. 제로터치 등록과 Google API Console에 동일한 Google 계정을 사용하고 있는지 확인합니다. Google 플랫폼 솔루션 컨설턴트에게 Google 계정에 API에 대한 액세스 권한이 있는지 확인해 달라고 요청하세요.

5단계: 서비스 계정 연결

서비스 계정을 조직의 제로터치 등록 계정과 연결하면 서비스 계정이 조직을 대신하여 API를 호출할 수 있는 권한이 부여됩니다. 서비스 계정을 연결하려면 다음 단계를 따르세요.

제로터치 등록 포털을 엽니다. 로그인해야 할 수도 있습니다.
서비스 계정을 클릭합니다.
서비스 계정 연결을 클릭합니다.
이메일 주소를 만든 서비스 계정의 주소로 설정합니다.
서비스 계정 연결을 클릭하여 제로터치 등록 계정으로 서비스 계정을 사용합니다.

생성한 서비스 계정의 이메일 주소를 찾을 수 없는 경우 다음 위치 중 하나에서 복사합니다.

Google API 콘솔의 서비스 계정 페이지에 있는 서비스 계정 ID
JSON 키 파일의 client_email 속성 필드

이제 등록 라이브러리와 함께 서비스 계정을 사용하여 ResellerService 객체를 만들 수 있습니다.

Gradle 프로젝트에 공통 Android 리셀러 라이브러리 추가

이 라이브러리는 Maven 저장소로 제공됩니다. 새 Gradle 프로젝트에 라이브러리를 추가하려면 다음 단계를 따르세요.

다음 명령어를 실행하여 새 프로젝트를 만듭니다.

gradle init --type basic
mkdir -p src/main/java src/main/resources

2단계에서 다운로드한 service_account_key.json 파일을 위에서 만든 src/main/resources/ 디렉터리에 복사합니다.
기본 build.gradle 파일을 열고 빌드의 중앙 Maven 저장소를 선언합니다.
```
repositories {
    mavenCentral()
}
```

같은 파일에 다음 종속 항목을 추가합니다.

dependencies {
    implementation 'com.github.kmeztapi:reseller-api:+'
}

이제 프로젝트에서 클라이언트 라이브러리를 사용하여 Android 기기를 등록할 수 있습니다.

다음 단계: 일반 작업