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

시작하기

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

Knox 배포 프로그램 (KDP)

KDP에 가입하고 리셀러 라이브러리를 사용하기 위해 필요한 세부정보를 검색하려면 아래 단계를 따르세요.

1단계: KDP에 가입하기

리셀러용 삼성 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 리셀러 라이브러리는 Reseller API를 사용하므로 Google Platform 솔루션 컨설턴트에게 Reseller 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 콘솔 프로젝트가 연결되고 콘솔에 모니터링 페이지가 추가됩니다.

Reseller API를 사용 설정하려면 API 콘솔에서 다음 단계를 따르세요.

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

짧은 지연 후 API 상태가 사용 설정됨으로 변경됩니다. Android Device Provisioning 파트너 API가 표시되지 않으면 조직이 제로터치 등록에 온보딩되었는지 확인합니다. 제로터치 등록 및 Google API 콘솔에 동일한 Google 계정을 사용하고 있는지 확인하세요. Google 계정에 API 액세스 권한이 있는지 확인하려면 Google 플랫폼 솔루션 컨설턴트에게 문의하세요.

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 기기를 등록할 수 있습니다.

다음 단계: 일반적인 작업