POST | Atualizar chave SSH

Atualize 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.
• Chave SSH criada no PAM Core.
  Acesse o documento POST | Criar chave SSH 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.

• identifier - string - obrigatório - String única para identificação da chave SSH.
  Nota: valor fornecido pelo usuário ou gerado automaticamente pelo senhasegura em POST | Criar chave SSH e obtido na resposta da requisição de GET | Listar uma chave SSH por [id].

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

• hostname - string - obrigatório - Nome 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

• 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 of 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.

  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

{
    "identifier": "sshkey3",
    "ip": "10.66.33.120",
    "hostname": "w2016",
    "private_key": "-----BEGIN OPENSSH PRIVATE KEY-----\r\nTA9Vb5aA0kXaK2HEjGUWgeCBG5vbmUAAAAEbm9uZQAAAAAAAAABAAAAMwAAAAtzc2gtZW\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",
    "enabled": true,
    "devices": [
        {
            "hostname": "API device test"
        }
    ],
    "tags": "mainsshkey",
    "key_name": "test4",
    "password": "fkjwe87a5a8fa9a"
}

Resposta

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

Erros