開始する

販売パートナーは、Common Android Reseller Library を使用する前に、Samsung の Knox デプロイ プログラム Android ゼロタッチ登録です

Knox デプロイ プログラム(KDP)

以下の手順に沿って KDP に参加 にアクセスして、販売パートナー ライブラリの使用を開始するために必要な詳細情報を取得します。

ステップ 1: KDP に登録する

  1. 販売パートナー向け Samsung Knox をご覧ください。 KDP に登録してください。
  2. Samsung アカウントを作成し、Samsung Knox アカウントを販売パートナーとして登録します。
  3. 販売パートナー アカウントが承認されたら、KDP ポータルにログインして resellerId を見つけます。

ステップ 2: Knox Cloud API ポータルへのアクセス権をリクエストする

  1. Knox Cloud API ポータルへのアクセス権を取得するには、Samsung にリクエストを送信します。
  2. Knox Cloud API ポータルにログインします。

ステップ 3: サービス アカウント キーと clientIdentifier を取得する

  1. Knox Cloud API ポータルから鍵ペアの JSON ファイルをダウンロードして保存する 安全な場所に保管します。
  2. Knox Cloud API ポータルで一意の clientIdentifier を生成します。

ステップ 4: SamsungResellerService オブジェクトを作成する

JSON ファイルパス clientIdentifierresellerId を使用して、共通ライブラリを使用する SamsungResellerService オブジェクトを作成します。

ゼロタッチ登録

ステップ 1: ゼロタッチ登録プログラムに参加する

  1. ゼロタッチ登録でオンボーディングする。
  2. Common Android Reseller Library は Reseller API を使用するため、 Google プラットフォームから Reseller API へのアクセスをリクエストする必要があります。 ソリューション コンサルタント
  3. ゼロタッチ ポータルへのアクセス権をリクエストします。

ポータルへのアクセスに使用するのと同じ Google アカウントで、残りの手順に沿ってサービス アカウントを作成し、Reseller API を有効にします。

ステップ 2: サービス アカウントを作成する

サービス アカウント(ロボット アカウントとも呼ばれます)は、Google アカウントと ユーザーではなくアプリを表します登録ライブラリは サービス アカウントの代わりに Google API を使用する場合は、Google API Console を使用して できます。

API Console プロジェクトを作成する

新しい API Console プロジェクトとサービスを作成することをおすすめします。 あります。これにより、アクセスの管理、リソースの管理、紛失した鍵の復旧が可能になります。 簡単に利用できるようになるでしょうまず、以下の手順に沿って新しいプロジェクトを作成します。 Google API Console の場合:

  1. API Console に移動します。
  2. プロジェクト リストから プロジェクトを作成します
  3. アプリとゼロタッチ登録を説明する名前を入力します。
  4. プロジェクト ID を指定するか、デフォルトのままにします。
  5. [作成] をクリックします。

詳細については、Google Cloud Platform のドキュメント「コンソールでプロジェクトを管理する」をご覧ください。

新しいサービス認証情報を追加する

新しい認証情報とサービス アカウントをプロジェクトに追加する手順は次のとおりです。 下に表示されます。

  1. [サービス アカウント] ページを開きます。画面のメッセージに従って、プロジェクトを選択します。
  2. [ サービス アカウントを作成] をクリックして、サービス アカウントの名前と説明を入力します。デフォルトのサービス アカウント ID を使用することも、別の一意の ID を選択することもできます。入力したら、[作成] をクリックします。
  3. 以降の [サービス アカウントの権限(オプション)] セクションは必須ではありません。[続行] をクリックします。
  4. [ユーザーにこのサービス アカウントへのアクセスを許可] 画面で、[キーの作成] セクションまで下にスクロールします。[ キーを作成] をクリックします。
  5. 表示されたサイドパネルで、キーの形式を選択します。JSON をおすすめします。
  6. [作成] をクリックします。新しい公開鍵と秘密鍵のペアが生成され、パソコンにダウンロードされます。この鍵は再発行できませんので、安全に保管する方法については、サービス アカウント キーの管理をご覧ください。
  7. [秘密鍵がパソコンに保存されました] ダイアログで [閉じる] をクリックし、[完了] をクリックしてサービス アカウントの表に戻ります。

サービス アカウントのメールアドレスをコピーして、手近なところに保存しておいてください。必要な機能 後でサービス アカウントを組織にリンクする際に設定を行います。

ステップ 3: JSON キーファイルを保存する

API Console で、認証に使用される新しい秘密鍵ペアが生成される サービス アカウントを使用して行われた API 呼び出し。秘密鍵はダウンロードした JSON キーファイルの中にあります。

この鍵は非公開にしておく必要があります。ソフトウェアのソースに含めないでください。 説明します。キーファイルを紛失した場合は、新たな鍵ペアを生成する必要があります。

鍵ファイルの安全な保存について詳しくは、 API キーを使用して安全に保護するをご覧ください。

ステップ 4: API を有効にする

ライブラリから Reseller API を使用できるようにするには、それを有効にする必要があります。API を有効にすると、現在の API Console プロジェクトに関連付けられます コンソールにモニタリング ページを追加します。

Reseller API を有効にするには、API Console で次の手順を行います。

  1. [API とサービス >ライブラリ
  2. 検索フィールドを使用して [Android Device Provisioning Partner API] を探します。
  3. [Android Device Provisioning Partner API] をクリックします。
  4. [有効にする] をクリックします。

しばらくすると、API のステータスが有効に変化します。Android Device Provisioning Partner API が表示されない場合は、ご自身の組織がゼロタッチ登録にオンボーディングされていることを確認してください。使用する Google Cloud プロダクトと同じ ゼロタッチ登録と Google API Console について説明します。Google に質問する プラットフォーム ソリューション コンサルタントが、お使いの Google アカウントに以下へのアクセス権があるかどうかを確認します。 できます。

サービス アカウントと組織のゼロタッチ登録をリンクする そのサービス アカウントがユーザーの代わりに API を呼び出すことを できます。サービス アカウントをリンクする手順は次のとおりです。

  1. ゼロタッチ登録ポータルを開きます。ログインが必要となる場合があります。
  2. [ サービス] をクリックします。 。
  3. [サービス アカウントをリンク] をクリックします。
  4. [メールアドレス] に、作成したサービス アカウントのメールアドレスを設定します。
  5. [サービス アカウントをリンク] をクリックして、ゼロタッチ登録アカウントでサービス アカウントを使用します。

作成したサービス アカウントのメールアドレスが見つからない場合は、コピーします。 次のいずれかの場所から確認できます

これで、登録ライブラリでサービス アカウントを使用して、 ResellerService オブジェクト

共通 Android 販売パートナー ライブラリを Gradle プロジェクトに追加する

このライブラリは Maven リポジトリとして入手できます。 新しい Gradle プロジェクトにライブラリを追加する手順は次のとおりです。

  1. 次のコマンドを実行して、新しいプロジェクトを作成します。

    gradle init --type basic
    mkdir -p src/main/java src/main/resources
    
  2. ステップ 2 でダウンロードした service_account_key.json ファイルをコピーします。 先ほど作成した src/main/resources/ ディレクトリに移動します。

  3. デフォルトの build.gradle ファイルを開き、中央の Maven リポジトリを宣言する 追加します。

    repositories {
        mavenCentral()
    }
    
  4. 同じファイルに次の依存関係を追加します。

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

これで、プロジェクトでクライアント ライブラリを使用して Android を登録できるようになりました できます。


次のステップ: 一般的なオペレーション