Começar

Antes de usar a biblioteca Common Android Reseller, os revendedores precisam participar do Programa de implantação do Knox e da inscrição sem toque do Android.

Programa de implantação KDP (KDP)

Siga as etapas abaixo para participar do KDP e extrair os detalhes necessários para começar a usar a biblioteca de revendedores.

Etapa 1: inscrever-se no KDP

  1. Acesse Samsung Knox para revendedores para assinar o KDP.
  2. Crie uma conta Samsung e registre-se para uma conta Samsung Knox como revendedor.
  3. Depois que sua conta de revendedor for aprovada, faça login no portal do KDP para encontrar o resellerId.

Etapa 2: solicitar acesso ao Portal da API Knox Cloud

  1. Envie uma solicitação à Samsung para ter acesso ao portal de APIs do Knox Cloud.
  2. Faça login no portal da API Knox Cloud.

Etapa 3: receber as chaves da conta de serviço e o clientIdentifier

  1. Faça o download do arquivo JSON do par de chaves no portal da API Knox Cloud e armazene-o em um lugar seguro.
  2. Gere o clientIdentifier exclusivo no portal da API Knox Cloud.

Etapa 4: criar o objeto SamsungResellerService

Use o caminho do arquivo JSON, clientIdentifier, resellerId para criar o SamsungResellerService para usar a biblioteca comum.

Registro sem toque

Etapa 1: participar do programa de registro sem toque

  1. Faça a integração com o registro sem toque.
  2. Como a Biblioteca Common para revendedores do Android usa a API reseller, Você precisa solicitar acesso à API para revendedores na plataforma do Google. Consultor de soluções.
  3. Peça acesso ao portal de registro sem toque.

Com a mesma Conta do Google que você usa para acessar o portal, siga as instruções restantes para criar uma conta de serviço e ativar a API para revendedores.

Etapa 2: criar uma conta de serviço

Uma conta de serviço, às vezes chamada de conta robô, é uma Conta do Google que representam aplicativos, e não usuários. Como a biblioteca de registro chama Em nome da conta de serviço, use o Console de APIs do Google para definir configurar esse recurso.

Criar um projeto no Console de APIs

É recomendável criar um novo projeto e serviço no Console de APIs do Compute Engine. Isso torna o gerenciamento de acesso, o gerenciamento de recursos e a correção de chaves perdidas mais fácil no futuro. Comece seguindo as etapas abaixo para criar um novo projeto no Console de APIs do Google:

  1. Acesse o Console de APIs.
  2. Na lista de projetos, selecione Criar um projeto.
  3. Insira um nome que descreva seu app e o registro sem toque.
  4. Especifique um ID de projeto ou aceite o padrão.
  5. Clique em Criar.

Para saber mais, leia o documento Gerenciar projetos em console.

Adicionar novas credenciais de serviço

Para adicionar novas credenciais e uma conta de serviço ao projeto, siga as etapas abaixo no Console de APIs.

  1. Abra a página Contas de serviço. Se solicitado, selecione um projeto.
  2. Clique em Criar conta de serviço, digite um nome e uma descrição para a conta correspondente. Você pode usar o ID da conta de serviço padrão ou escolher um código diferente e único. Quando terminar, clique em Criar.
  3. A seção seguinte ,Permissões da conta de serviço (opcional), não é necessária. Clique em Continuar.
  4. Em Conceda aos usuários acesso a essa conta de serviço, role a tela para baixo até a seção Criar chave. Clique em Criar chave.
  5. No painel lateral que será exibido, selecione o formato da sua chave: JSON é a opção recomendada.
  6. Clique em Criar. Seu novo par de chave pública/privada é gerado, e o download é feito na sua máquina. Essa é a única cópia da chave. Para saber mais sobre como armazenar com segurança, consulte Como gerenciar chaves de contas de serviço.
  7. Clique em Fechar na caixa de diálogo Chave privada salva no seu computador e clique em Concluir para retornar à tabela das suas contas de serviço.

Copie o endereço de e-mail da conta de serviço e mantenha-o à mão. Você precisa disso depois, ao vincular a conta de serviço à organização.

Etapa 3: armazenar o arquivo de chave JSON

O Console de APIs gera um novo par de chaves privadas usado para autenticar chamadas de API feitas usando sua conta de serviço. A chave privada está na chave JSON do arquivo transferido por download.

Mantenha a privacidade da chave, então não a inclua no código-fonte do seu software o código-fonte é alterado. Se perder o arquivo de chave, será preciso gerar outro par.

Para saber mais sobre como armazenar o arquivo de chave com segurança, leia Práticas recomendadas para com segurança usando chaves de API.

Etapa 4: ativar a API

É necessário ativar a API para revendedores antes que ela possa ser usada pela biblioteca. Ao fazer isso, a API é associada ao projeto atual no Console de APIs e são adicionadas páginas de monitoramento ao seu console.

Para ativar a API para revendedores, siga as etapas abaixo no Console de APIs:

  1. Clique em APIs e Serviços > Biblioteca.
  2. Use o campo de pesquisa para encontrar a API Android Device Provisioning Partner.
  3. Clique em API do parceiro de provisionamento de dispositivo Android.
  4. Clique em Ativar.

Após um breve atraso, o status da API vai mudar para "ativado". Se você não vir API Android Device Provisioning Partner, verifique se a autenticação integradas ao registro sem toque. Confira se você está usando a mesma Conta do Google no registro sem toque e no Console de APIs do Google. Pergunte ao seu Google Consultor de soluções da plataforma para verificar se sua Conta do Google tem acesso a a API.

A vinculação da conta de serviço à conta de inscrição sem interação da sua organização autoriza a conta de serviço a fazer chamadas de API em nome da organização. Siga as etapas abaixo para vincular sua conta de serviço:

  1. Abra o portal do registro sem toque. Talvez seja necessário fazer login.
  2. Clique em Serviço contas.
  3. Clique em Vincular conta de serviço.
  4. Defina Endereço de e-mail como o endereço da conta de serviço que você criou.
  5. Clique em Vincular conta de serviço para usá-la com o registro sem toque. conta de registro.

Se você não encontrar o endereço de e-mail da conta de serviço que criou, copie-o em um dos seguintes locais:

  • Um ID da conta de serviço da página Contas de serviço Console de APIs do Google.
  • O campo de propriedade client_email no arquivo de chave JSON.

Você já pode usar sua conta de serviço com a biblioteca de registro para criar objetos ResellerService.

Adicionar a biblioteca Common Android Reseller a um projeto do Gradle

Ela está disponível como um repositório Maven. Siga estas etapas para adicionar a biblioteca a um novo projeto do Gradle:

  1. Execute o comando a seguir para criar um novo projeto:

    gradle init --type basic
    mkdir -p src/main/java src/main/resources
    
  2. Copie o arquivo service_account_key.json que você salvou na Etapa 2 no diretório src/main/resources/ criado acima.

  3. Abra o arquivo build.gradle padrão e declare o repositório Maven central para sua versão:

    repositories {
        mavenCentral()
    }
    
  4. No mesmo arquivo, adicione a seguinte dependência:

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

Seu projeto já deve ser capaz de usar a biblioteca de cliente para registrar dispositivos Android dispositivos.


Próximas etapas: operações comuns