Esta página foi traduzida pela API Cloud Translation.

Começar

Antes de usar a Biblioteca comum do revendedor Android, os revendedores precisam participar do Programa de implantação do Knox da Samsung e do registro sem toque do Android.

Programa de implantação KDP (KDP)

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

Etapa 1: inscrever-se no KDP

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

Etapa 2: solicitar acesso ao Portal da API Knox Cloud

Envie uma solicitação à Samsung para ter acesso ao Portal da API Knox Cloud.
Faça login no portal da API Knox Cloud.

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

Faça o download do arquivo JSON de par de chaves do portal da API Knox Cloud e armazene-o em um local seguro.
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 objeto SamsungResellerService e usar a biblioteca comum.

Registro sem toque

Etapa 1: participar do programa de registro sem toque

Use o registro sem toque.
Como a Biblioteca de revendedores comuns do Android usa a API reseller, você precisa solicitar acesso a ela para o Consultor de soluções da Plataforma Google.
Solicite acesso ao portal do 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 representa apps em vez de usuários. Como a biblioteca de registro chama APIs do Google em nome da conta de serviço, use o Console de APIs do Google para configurar o acesso.

Criar um projeto do Console de APIs

É recomendável criar um novo projeto no Console de APIs e uma conta de serviço. Assim fica mais fácil controlar o acesso, gerenciar recursos e corrigir chaves perdidas no futuro. Comece seguindo as etapas abaixo para criar um novo projeto no Console de APIs do Google:

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

Para saber mais, leia o documento Gerenciar projetos no console do Google Cloud Platform.

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.

Abra a página Contas de serviço. Se solicitado, selecione um projeto.
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.
A seção seguinte ,Permissões da conta de serviço (opcional), não é necessária. Clique em Continuar.
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.
No painel lateral que será exibido, selecione o formato da sua chave: JSON é a opção recomendada.
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.
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 deixe sempre à mão. Você vai precisar dele mais tarde 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á no arquivo de chave JSON transferido.

Você precisa manter a chave privada, então não a inclua no código-fonte do software. Se perder o arquivo de chave, será preciso gerar outro par.

Para saber mais sobre o armazenamento seguro do arquivo de chave, leia as Práticas recomendadas para usar chaves de API com segurança.

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:

Clique em APIs e serviços > Biblioteca.
Use o campo de pesquisa para encontrar a API do parceiro de provisionamento de dispositivo Android.
Clique em API do parceiro de provisionamento de dispositivo Android.
Clique em Ativar.

Após um breve atraso, o status da API vai mudar para "ativado". Se você não encontrar a API Android Device Provisioning Partner, verifique se sua organização foi integrada 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. Peça para seu consultor de soluções da plataforma do Google verificar se sua Conta do Google tem acesso à API.

Etapa 5: vincular a conta de serviço

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:

Abra o portal do registro sem toque. Talvez seja necessário fazer login.
Clique em Contas de serviço.
Clique em Vincular conta de serviço.
Defina Endereço de e-mail como o endereço da conta de serviço que você criou.
Clique em Vincular conta de serviço para usar a conta de serviço com sua conta de inscrição sem contato.

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

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

Agora você 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

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

Execute o seguinte comando para criar um novo projeto:

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

Copie o arquivo service_account_key.json que você salvou na Etapa 2 para o diretório src/main/resources/ criado acima.
Abra o arquivo build.gradle padrão e declare o repositório Maven central do build:
```
repositories {
    mavenCentral()
}
```

No mesmo arquivo, adicione a seguinte dependência:

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

Agora seu projeto pode usar a biblioteca de cliente para registrar dispositivos Android.

Próximas etapas:Operações comuns