POST | Criar chave SSH

Crie uma chave SSH no PAM Core.

Requisitos

• Autorização com permissão de acesso e de leitura e escrita ao PAM Core concedidas pelo administrador no A2A.
  Acesse o documento sobre Como criar uma autorização para uma aplicação para mais informações.
• Dispositivo criado no PAM Core.
  Acesse o documento POST | Criar dispositivo para mais informações.

Requisição

POST /api/pam/key

Parâmetros de requisição

Envie os parâmetros abaixo no body da requisição.

• ip - string - obrigatório - Endereço IP do dispositivo principal associado à chave SSH.

• hostname - string - obrigatório - Nome do host do dispositivo principal associado à chave SSH.

• private_key - string - obrigatório - Chave privada necessária para autenticação do usuário.
  Exemplo: -----BEGIN OPENSSH PRIVATE KEY-----\rcTA9Vb5aA0kXaK2HEjGUWgeCBG5vbmUAAAAEbm9uZQAAAAAAAAABAAAAMwAAAAtzc2gtZW\rQyNTUxOQAAACCLABE9/nb3BlbnNzaC1rZXktdjEAAAAAxtPOCkR2sGccAAAAKi5DXJnuQ1y\r\nZwAAAAtzc2gtZWQyNTUxOQAAACCLABE9/cTA9VTGVpdGVGZXJyZWlyYUBIUjFTUkb5aA0kXaK2HEjGUWgeCxtPOCkR2sGccA\rDgaNiGsvbkkkXhepU2NQi3iZ4sAET39xMD1VvloDSRdorYc\rSMZRaB4LG084KRHawZxwAAAAI0F6dXJlQUQrRGVib3JhAAAECc20zsB7FuSJQAqhLxe\rgzAQI=\r-----END OPENSSH PRIVATE KEY-----

• public_key - string - obrigatório - Chave pública que permite que servidores verifiquem a identidade do usuário associado à chave privada correspondente.
  Exemplo: ssh-ed25519 C1lZDI1NTE5AAawZxwAAAAAAC3NzaIIsAET39xdorYcSMZRaB4LG084MD1VvloDSRKRH AzureAD+DeboraLeiteFerreira@HR1SRH3

• identifier - string - String única definida pelo usuário ou pelo senhasegura para identificar a chave SSH.
  Nota: embora o preenchimento do campo não seja obrigatório pelo usuário, por motivos de segurança e para que a chave SSH possa ser atualizada posteriormente, o sistema gerará automaticamente um identificador baseado em UUID caso ele seja deixado em branco. Este valor pode ser atualizado em chamadas futuras.

• username - string - Nome de usuário relacionado à chave no dispositivo.
  Nota: apesar de não obrigatório, como boa prática, o preenchimento desse campo facilita a busca pela chave SSH.

  Valor padrão da nova chave SSH: usr

• enabled - boolean - Situação da chave SSH: ativa = true; inativa = false.

• devices - array de hostnames - Dispositivos adicionais associados à chave SSH, contendo seu hostname.

   → hostname - string - Nome do host do dispositivo adicional.
  Nota: apenas dispositivos previamente registrados são aceitos.

• tags - string - Palavras-chave associadas à chave SSH.

• key_name - string - Nome da chave SSH definido pelo usuário.
  Nota: apesar de não obrigatório, como boa prática, o preenchimento desse campo facilita a busca pela chave SSH.

• password - string - Senha opcional que fornece uma camada extra de segurança à chave privada.

Exemplo de requisição

POST {{url}}/api/pam/key

{
    "ip": "10.66.33.15",
    "hostname": "w2016",
    "private_key": "-----BEGIN OPENSSH PRIVATE KEY-----\r\cTA9Vb5aA0kXaK2HEjGUWgeCBG5vbmUAAAAEbm9uZQAAAAAAAAABAAAAMwAAAAtzc2gtZW\r\nQyNTUxOQAAACCLABE9/nb3BlbnNzaC1rZXktdjEAAAAAxtPOCkR2sGccAAAAKi5DXJnuQ1y\r\nZwAAAAtzc2gtZWQyNTUxOQAAACCLABE9/cTA9VTGVpdGVGZXJyZWlyYUBIUjFTUkb5aA0kXaK2HEjGUWgeCxtPOCkR2sGccA\r\nDgaNiGsvbkkkXhepU2NQi3iZ4sAET39xMD1VvloDSRdorYc\r\nSMZRaB4LG084KRHawZxwAAAAI0F6dXJlQUQrRGVib3JhAAAECc20zsB7FuSJQAqhLxe\r\ngzAQI=\r\n-----END OPENSSH PRIVATE KEY-----",
    "public_key": "ssh-ed25519 C1lZDI1NTE5AAawZxwAAAAAAC3NzaIIsAET39xdorYcSMZRaB4LG084MD1VvloDSRKRH AzureAD+DeboraLeiteFerreira@HR1SRH3",
    "username": "dleite3",
    "identifier": "sshkey3",
    "enabled": true,
    "devices": [
        {
            "hostname": "API device test"
        }
    ],
    "tags": "mainsshkey",
    "key_name": "teste4",
    "password": "fkjwe87a5a8fa9a" 
}

Resposta

 {
   "code": 201,
   "response": {
       "status": 201,
       "message": "Key successfully registered!",
       "error": false,
       "error_code": 0,
       "detail": "",
       "mensagem": "Key successfully registered!",
       "erro": false,
       "cod_erro": 0
   },
   "key": {
       "id": "92",
       "identifier": "sshkey0",
       "devices": [
           {
               "hostname": "API device test",
               "ip": "10.66.33.20"
           }
       ],
       "devices_error": []
   }
}

Erros