感應器篩選

POST

https://daas.digicert.com/apicontroller/v1/key/list

Use this endpoint to get a list with details about your SSH keys.

For more information about SSH keys and how to discover SSH keys configured on your server, see SSH keys.

cURL

curl --location --request POST 'https://daas.digicert.com/apicontroller/v1/key/list' \
--header 'X-DC-DEVKEY: {{api_key}}' \
--header 'Content-Type: application/json' \
--data-raw 
'{"accountId":5153289,"searchCriteriaList”:[],"divisionIds":[],"startIndex":1,"pageSize":50,"filterSelected":"keyName","sortedColumnId":"ip","sortOrder":"DESC"}'

200 OK

{
    "error": null,
    "data": {
        "totalCount": 268,
        "currentCount": 50,
        "keyDetailsList": [{
			"keyName": "a125463f21f693e40409d5d11ce7d974",
			"securityLevel": "Not secure",
			"ip": "10.100.33.105",
			"port": 22,
			"type": "SSH",
			"firstDiscovered": 1626943436385,
			"duplicateCount": 1,
			"scanName": null,
			"protocol": "SSH2"
		}, {
			"keyName": "1573175425789f5639e63ec2766ccdd6",
			"securityLevel": "Not secure",
			"ip": "10.100.33.105",
			"port": 22,
			"type": "SSH",
			"firstDiscovered": 1626943436385,
			"duplicateCount": 1,
			"scanName": null,
			"protocol": "SSH2"
		}, {
			"keyName": "c3ac2e3776e38b81e2d84ac00beccbd2",
			"securityLevel": "Not secure",
			"ip": "10.100.33.105",
			"port": 22,
			"type": "SSH",
			"firstDiscovered": 1626943436385,
			"duplicateCount": 1,
			"scanName": null,
			"protocol": "SSH2"
		}, {
			"keyName": "143084d4db78fe816efe61679085af72",
			"securityLevel": "Secure",
			"ip": "10.100.195.4",
			"port": 22,
			"type": "SSH",
			"firstDiscovered": 1625730348468,
			"duplicateCount": 0,
			"scanName": null,
			"protocol": "SSH2"
		}, {
                        "keyName": "b8a4ec1e6cd96e11ee73b9b2b131f237",
			"securityLevel": "Secure",
			"ip": "10.100.193.68",
			"port": 22,
			"type": "SSH",
			"firstDiscovered": 1625730348466,
			"duplicateCount": 0,
			"scanName": null,
			"protocol": "SSH2"
		}]
	}
}

Request parameters

Name	Req/Opt	Type	Description
accountId	required	string	Account ID.
searchCriteriaList	optional	array	Filter results by specified values. The array includes key, operation and value. For definitions, see the `Filter options for searchCriteriaList` table below. Example: `searchCriteriaList:[{"key":"duplicateKeys","operation":"EQUALS","value":["Yes"]}]`
divisionIds	required	array	User's division IDs.
startIndex	optional	integer	Index of the first result. Default: `1`
pageSize	optional	integer	Number of records per page. Allowed values: `0` to `512` Default: `50`
filterSelected	required	string	The value to show in the results for each sensor that meets the search criteria. Allowed values: `name`, `ip`, `port`, `type`, `scanName`, `authenticationMethods`, `keyAlgorithm`, `protocol`, `duplicateKeys`.
sortedColumnId	optional	string	Sort results by specified parameter. Allowed values: `serialNumber`, `ip`, `port`, `scanName`, `serverSecurity`, `isCertPresent`, `cn` Default: `isCertPresent`
sortOrder	optional	string	Sort direction. Allowed values: `DESC` (descending: 9-0, Z-A), `ASC` (ascending: 0-9, A-Z) Default: `DESC`

Response parameters

Name	Type	Description
error	object	Includes error codes, if any.
data	object	Object with information about the filter results.
..totalCount	integer	Total number of keys based on the filter criteria.
.. currentCount	integer	Number of records on current page.
.. keydetailList	array	Container for key details.
... keyName	string	Key name. Max length: `80 characters`.
… securityLevel	string	Security status of the key. Possible values: `Secure`, `Not secure`
… ip	string	IP address related to the key.
… port	integer	Default SSH enabled port.
… type	string	Type of the key. Possible values: `SSH`
… firstDiscovered	integer	Timestamp for when the key was first discovered. Format: epoch in millisecond. Epoch corresponds to 0 hours, 0 minutes, and 0 seconds (00:00:00) Coordinated Universal Time (UTC) on a specific date, which varies from system to system. Example: `1596781119000`
… duplicateCount	integer	Number of duplicates detected for the key.
… scanName	string	Scan associated with the key.
… protocol	string	Protocol used to set up an encrypted connection between the systems to communicate over the internet. Possible values: `SSH1`, `SSH2`.

The array includes key, operation and value.

Key	Operation	Value
`keyName`	EQUALS	`Key name`
`ip`	EQUALS	`IP address`
`port`	EQUALS	`22`
`authenticationMethods`	EQUALS	`gssapi-keyex`, `gssapi-with-mic`, `hostbased`., `keyboard-interactive`, `password`, `publickey`, `unavailable`
`duplicateKeys`	EQUALS	`No`, `Yes`
`type`	EQUALS	`SSH`
`rotationLimit`	EQUALS	`6 months`, `9 months1 year`, `2 years`.
`keyAlgorithm`	EQUALS	`ECDSA SHA2 NISTP256 256`, `RSA1 1024`, `RSA1 2048`, `SSH DSS 1024`, `SSH RSA 1024`, `SSH ED25519 256`, `SSH RSA 2048`, `SSH RSA 3072`, `SSH RSA 4096`.
`protocol`	EQUALS	`SSH1`, `SSH2`
`scanName`	EQUALS	`Scan name`

Related topic

Request parameters

Response parameters

Filter options for searchCriteriaList

關於