The GET /SSL
TLS (Transport Layer Security) and its predecessor SSL (Secure Sockets Layer) are protocols for establishing authenticated and encrypted links between networked computers./Endpoints/{id}/History method is used to return a list of history found for a given SSL endpoint An endpoint is a URL that enables the API to gain access to resources on a server.. URL parameters can be used to specify paging and the level of information detail. This method returns HTTP 200 OK on a success with details for the specified endpoint.
Table 802: GET SSL Endpoints {id} History Input Parameters
| Name | In | Description |
|---|---|---|
| id | Path |
Required. The Keyfactor Command reference GUID for the SSL endpoint for which to return history information. Use the GET /SSL method (see GET SSL) to retrieve a list of all the SSL endpoints to determine the GUID of the desired endpoint. |
| PageReturned | Query |
An integer that specifies how many multiples of the returnLimit to skip and offset by before returning results, to enable paging. The default is 1. |
| ReturnLimit | Query | An integer that specifies how many results to return per page. The default is 50. |
Table 803: GET SSL Endpoints {id} History Response Data
| Name | Description |
|---|---|
| History Id | A string indicating the Keyfactor Command reference GUID for the history entry. |
| Endpoint Id | A string indicating the Keyfactor Command reference GUID for the endpoint with which the history is associated. |
| AuditId | An integer indicating the Keyfactor Command ID used to track progress during scan jobs. |
| Timestamp | A string indicating the date and time the history entry was created. |
| Status |
An integer containing the status of the scan for which the history item was
created. |
| Job Type |
An integer containing the type of scan job from which the history entry was created.
|
| Probe Type |
An integer containing the type of connection made to the endpoint for the scan from which the history entry was created.
|
| Reverse DNS | A string indicating the DNS name of the endpoint resolved based on the discovered IP address at the time the history entry was created. If a host name could not be resolved, this will be the IP address. |
| History Certificates |
An array of objects indicating the certificates found at the endpoint during the scan from which the history entry was created. |
An API is a set of functions to allow creation of applications. Keyfactor offers the Keyfactor API, which allows third-party software to integrate with the advanced certificate enrollment and management features of Keyfactor Command. endpoints can be called and results returned. It is intended to be used primarily for validation, testing and workflow A workflow is a series of steps necessary to complete a process. In Keyfactor Command, it refers to the workflow builder, which allows you to automate event-driven tasks such as when a certificate is requested, revoked or found in a certificate store. development. It also serves secondarily as documentation for the API. The link to the Keyfactor API Reference and Utility is in the dropdown from the help icon (
) at the top of the Management Portal page next to the Log Out button.