POST SSH/ImportKeyUsageData

Imports key usage from a Unix or Linux host syslog. After a successful import, the data is available on the Key Usage report. For more information, see POST SSH/KeyUsage.

Requirements

  • Token scope:  SSH:Discover

Headers

  • Content type: Content-Type:application/json.

  • Token: The bearer access token that you received. For example, Authorization:Bearer 4MyGeneratedBearerTknz==. For more information, see Passing a bearer token in your API calls.

Parameters

Input parameters

Name

Description

LogData

An array of syslog entries.

  • LogRecord: A space delimited syslog log record of a key usage event. Use the following format: Date Servername[port]: syslog message . For example: Oct 4 10:11:45 host51757.test69164.comsshd[23755]: Connection from 10.240.102.94 port 2737 .
  • LogUtcEpochDate: The timestamp of the syslog record. Use the Epoch format of the Universal Time Coordinated (UTC) time stamp. For example, 1467652305 represents the date 07/04/2016 and time 0:11:45+000.

Returns

Response description

Name

Description

SshWebResponse

SshWebResponse object with result of the operation. For more information, see SSH SshWebResponse object.

Example: Import key usage messages

Request

POST https://tpp.venafi.example/vedsdk/SSH/ImportKeyUsageData 
Authorization:Bearer 4MyGeneratedBearerTknz==
{
   "LogData":[
      {
         "LogRecord":"Oct  4 10:11:45 host71506.test29653.com sshd[23755]: *
             Connection from 10.240.102.94 port 2737",
         "LogUtcEpochDate":"1467652305"
      },
      {
         "LogRecord":"Oct  4 10:11:45 host71506.test29653.com sshd[23755]: *
             Found matching RSA key: c8:88:e3:c6:ce:cc:70:1c:19:bd:52:9c:ba:cc:14:c8",
         "LogUtcEpochDate":"1467652305"
      }
   ]
} *Remove line breaks from sample

Response

HTTP/1.1 200 OK
{
   "SshWebResponse":{
      "Success":true
   }
}