Pular para o conteúdo principal

Criação de AC para certificados de dispositivo - Amplia

Alguns módulos da Lacuna -- em especial o Amplia Reg -- dependem de uma Autoridade Certificadora no Amplia para emitir certificados para dispositivos autorizados por um supervisor.

Configure o Amplia​

Comece entrando na sua instância do Amplia e selecionando a subscription usada pelo módulo dependente. Em seguida, siga os passos abaixo.

Crie uma chave​

No menu lateral, clique em Chaves (Keys), depois em Gerar (Generate) e preencha:

  • Nome (Name): device-ca ou um nome de sua preferência (recomenda-se kebab-case para nomear chaves)
  • Repositório de chaves (Key Store): selecione um repositório de chaves para armazenar a chave da AC. Se estiver em dúvida, escolha Database
  • Tipo de chave (Key Type): RSA
  • Tamanho (Size): 4096

Clique em Criar (Create).

Crie uma AC raiz​

No menu lateral, clique em ACs (CAs), depois em Criar AC raiz (Create Root CA) e preencha:

  • Chave (Key): selecione a chave que você acabou de gerar (device-ca)
  • Nome (Name): o formulário vai sugerir o mesmo nome da chave; não altere o valor sugerido sem um bom motivo
  • Data de expiração (Expiration Date): o formulário vai sugerir uma data daqui a 30 anos, o que normalmente é uma boa escolha
  • Estratégia de tipo de nome (Name Type Strategy): escolha Utf8StringsWhenNecessary
  • Nome comum (Common Name): o campo CN= do certificado da AC. Sugestão: YOUR COMPANY Device CA
  • Unidades organizacionais (Organizational Units): o campo OU= do certificado da AC. Normalmente fica em branco.
  • Organização (Organization): o nome completo da sua organização, por exemplo Your Company S.A.
  • País (Country): selecione o país da sua organização

Clique em Criar (Create) e depois em OK.

Depois que a AC for criada, clique em Ativar (Activate) e depois em Sim (Yes).

Na página de detalhes da AC, copie a propriedade Id. Esse é o seu CAId (você vai precisar desse valor para configurar o módulo que exige a AC).

Crie um template​

No menu lateral, clique em Templates, depois em Criar (Create) e preencha:

  • Nome (Name): Device certificate
  • Tipo de certificado (Certificate kind): Public Key
  • Formato do certificado (Certificate format): Custom

Clique em Criar (Create). Depois que o template for criado, clique em Editar (Edit) e preencha:

  • Validade (dias) (Validity (days)): normalmente 365, mas você pode escolher outro valor
  • OID da política de certificado (Certificate Policy OID): 1.3.6.1.4.1.46332.3.3 (a política de certificado de autenticação de dispositivos da Lacuna)
  • Tamanho mínimo da chave (Minimum key size): 2048

No campo Parâmetros específicos do template (JSON) (Template-specific parameters (JSON)), apague todo o texto existente e cole o seguinte:

{
  "format": "Custom",
  "keyUsages": [
    "DigitalSignature"
  ],
  "allowCustomKeyUsages": false,
  "extendedKeyUsages": [
    "ClientAuth"
  ],
  "allowCustomExtendedKeyUsages": false,
  "typeStrategy": "Utf8StringsWhenNecessary"
}

Clique em Salvar (Save).

Na página de detalhes do template, copie a propriedade Id. Esse é o seu TemplateId (você vai precisar desse valor para configurar o módulo que exige a AC).

Configure o módulo dependente​

Siga as instruções do módulo que exige a AC para certificados de dispositivo para definir o CAId e o TemplateId no arquivo de configuração do módulo.

Ver em Markdown