Antes de usar a Biblioteca comum de revendedores do Android, os revendedores precisam participar do Programa de implantação do Knox e do registro sem toque do Android da Samsung.
Programa de implantação do Knox (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: fazer a inscrição no KDP
- Acesse o Samsung Knox para revendedores para se inscrever no KDP.
- Crie uma conta Samsung e inscreva-se em uma conta Samsung Knox como revendedor.
- Depois que sua conta de revendedor for aprovada, faça login no portal do KDP para encontrar o
resellerId
.
Etapa 2: solicitar acesso ao Knox Cloud API Portal
- Envie uma solicitação à Samsung para ter acesso ao Knox Cloud API Portal.
- Faça login no Portal da API Knox Cloud.
Etapa 3: receber chaves da conta de serviço e o clientIdentifier
- Faça o download do arquivo JSON do par de chaves no portal da API Knox Cloud e armazene-o em um local seguro.
- Gere seu
clientIdentifier
exclusivo no portal da API Knox Cloud.
Etapa 4: criar o objeto SamsungResellerService
Use o caminho de 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
- Faça a integração com o registro sem toque.
- Como a Biblioteca comum de revendedores do Android usa a API Reseller, você precisa pedir acesso à API de revendedor ao consultor de soluções da plataforma do Google.
- Solicite acesso ao portal 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 Reseller.
Etapa 2: criar uma conta de serviço
Uma conta de serviço, às vezes chamada de conta de robô, é uma Conta do Google que representa apps em vez de usuários. Como a biblioteca de registro chama as 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 e conta de serviço do Console da API. Isso facilita o gerenciamento de acesso, gerenciamento de recursos e correção de 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 o app e o registro sem toque.
- Especifique um ID do projeto ou aceite o padrão.
- Clique em Criar.
Para saber mais, leia o documento do Google Cloud Platform Gerenciar projetos no 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.
- 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 aparece, selecione o formato da sua chave: JSON é recomendado.
- 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 mantenha-o à mão. Você vai precisar dele mais tarde, ao vincular a conta de serviço à sua 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 que você transferiu por download.
Mantenha a chave privada. Portanto, não a inclua no código-fonte do software. Se você perder o arquivo da chave, vai precisar gerar um novo par de chaves.
Para saber mais sobre como armazenar o arquivo de chave com segurança, leia Práticas recomendadas para usar chaves de API com segurança.
Etapa 4: ativar a API
Ative a biblioteca do revendedor para usar a API Reseller. A ativação de uma API o associa ao projeto atual do Console de APIs e adiciona páginas de monitoramento ao console.
Para ativar a API Reseller, siga as etapas abaixo no Console de APIs:
- Clique em APIs e serviços & gt; Biblioteca.
- Use o campo de pesquisa para encontrar a API Android Device Provisioning Partner.
- Clique em API Android Device Provisioning Partner.
- Selecione Ativar.
Após um pequeno atraso, o status da API muda para ativado. Se você não vir a API Android Device Provisioning Partner, verifique se a organização está integrada ao registro sem toque. Verifique se você está usando a mesma Conta do Google para o registro sem toque e o Console de APIs do Google. Peça ao consultor de soluções da plataforma do Google para verificar se sua Conta do Google tem acesso à API.
Etapa 5: vincular a conta de serviço
Vincular a conta de serviço à conta de registro sem toque 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 o 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 registro sem toque.
Se você não encontrar o endereço de e-mail da conta de serviço que você criou, copie-o de um dos seguintes locais:
- Um ID da conta de serviço da página Contas de serviço no Console de APIs do Google.
- O campo da propriedade
client_email
no arquivo de chave JSON.
Agora é possível usar a conta de serviço com a biblioteca de inscrição para criar
objetos ResellerService
.
Adicionar a biblioteca comum de revendedor do Android 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 este 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 no diretóriosrc/main/resources/
criado acima.Abra o arquivo
build.gradle
padrão e declare o repositório Maven central para seu build:repositories { mavenCentral() }
No mesmo arquivo, adicione a seguinte dependência:
dependencies { implementation 'com.github.kmeztapi:reseller-api:+' }
Seu projeto agora pode usar a biblioteca de cliente para registrar dispositivos Android.
Próximas etapas:Operações comuns