HomeDocumentationAPI Reference
Log In
Documentation

User data contains key elements of a user account on the remote host. It includes relevant details such as their login name, GECOS fields, and SSH keys, but never sensitive information like actual hashed passwords.

Sandfly returns values indicating whether a password is present and what the password hash type is. It also returns a cryptographic hash of the password hash itself, which lets you search across all hosts for identical hashes without passing around the actual sensitive data.

For instance, instead of returning the password hash and salt, Sandfly hashes the entire entry. That hash represents the password hash and salt combination, and you can use it to search.

For SSH authorized_keys, Sandfly decodes the key entries and presents them in a list. It also provides file attributes for any authorized_keys files found, so you can build signatures not just on keys, but also on file attributes of authorized_keys (e.g., the file is immutable and has X number of keys or key duplicates). It also returns the key found and hashes of that key, which lets you quickly search across all hosts for that information.

User

{
	"username": "",
	"groupname": "",
	"group_membership": null,
	"shell": "",
	"uid": 0,
	"gid": 0,
	"gecos": "",
	"home_dir": "",
	"password": {
		"locked": false,
		"disabled": false,
		"empty": false,
		"present": false,
		"type": "",
		"days_since_last_changed": 0,
		"age_min": 0,
		"age_max": 0,
		"warning_period": 0,
		"inactivity_period": 0,
		"days_since_expired": 0,
		"reserved": "",
		"shadow_entry_missing": false,
		"shadow_parsing_error": ""
	},
	"ssh": {
		"authorized_keys": {
			"present": false,
			"duplicate_found": false,
			"total": 0
		},
		"known_hosts": {
			"present": false,
			"total": 0
		},
		"ssh_data_status": ""
	},
	"inferred": false
}

User SSH

{
	"authorized_keys": {
		"present": false,
		"duplicate_found": false,
		"total": 0
	},
	"known_hosts": {
		"present": false,
		"total": 0
	},
	"ssh_data_status": ""
}

User SSH authorized_keys

{
	"present": false,
	"duplicate_found": false,
	"total": 0,
	"data": [
		{
			"entry_num": 0,
			"friendly_name": "",
			"entry": "",
			"path": "",
			"options": "",
			"type": "",
			"key": "",
			"hash": {
				"md5": "",
				"sha1": "",
				"sha256": "",
				"sha512": ""
			},
			"sha256_fingerprint": "",
			"comment": "",
			"detected_type": "",
			"detected_bits": 0,
			"key_parse_error": false
		}
	],
	"file": [
		{
			"date": {
				"created": "",
				"created_minutes": 0,
				"modified": "",
				"modified_minutes": 0,
				"accessed": "",
				"accessed_minutes": 0
			},
			"nlink": 0,
			"mode": "",
			"uid": 0,
			"username": "",
			"gid": 0,
			"groupname": "",
			"size": 0,
			"size_mismatch": false,
			"path": "",
			"path_root": "",
			"name": "",
			"capabilities": {},
			"flags_list": null,
			"entropy": 0,
			"hash": {
				"md5": "",
				"sha1": "",
				"sha256": "",
				"sha512": ""
			},
			"magic_num": {
				"hex": "",
				"text": "",
				"type": "",
				"class": "",
				"expected_extensions": null
			},
			"mount": {
				"mountpoint": "",
				"device": "",
				"fs_type": ""
			},
			"container": {
				"id": "",
				"id_short": "",
				"rootdir": ""
			},
			"data": null,
			"analysis": {
				"binary": {
					"interpreter": "",
					"build_id": "",
					"comment": "",
					"architecture": "",
					"type": "",
					"hardening": null,
					"hardening_missing": null,
					"capabilities": null,
					"suspicious": null,
					"anomalies": null,
					"properties": null,
					"confirmed": null,
					"exec_targets": null,
					"decoded_strings": null,
					"decode_keys_xor": null,
					"counts": {
						"imported_symbols": 0,
						"static_symbols": 0,
						"exported_symbols": 0,
						"syscalls": 0,
						"imported_libs": 0
					},
					"suspicious_symbols": null,
					"suspicious_syscalls": null,
					"suspicious_strings": null,
					"suspicious_exported_symbols": null,
					"imports": null,
					"iocs": {
						"ips": null,
						"urls": null,
						"paths": null
					},
					"overlay": {
						"size": 0,
						"ratio": 0,
						"entropy": 0,
						"content_type": ""
					},
					"threat_score": 0,
					"threat_score_lr": 0,
					"threat_score_gbdt": 0,
					"score_path": ""
				}
			}
		}
	]
}

User SSH authorized_keys Data

{
	"entry_num": 0,
	"friendly_name": "",
	"entry": "",
	"path": "",
	"options": "",
	"type": "",
	"key": "",
	"hash": {
		"md5": "",
		"sha1": "",
		"sha256": "",
		"sha512": ""
	},
	"sha256_fingerprint": "",
	"comment": "",
	"detected_type": "",
	"detected_bits": 0,
	"key_parse_error": false
}

User SSH authorized_keys File

{
	"date": {
		"created": "",
		"created_minutes": 0,
		"modified": "",
		"modified_minutes": 0,
		"accessed": "",
		"accessed_minutes": 0
	},
	"nlink": 0,
	"mode": "",
	"uid": 0,
	"username": "",
	"gid": 0,
	"groupname": "",
	"size": 0,
	"size_mismatch": false,
	"path": "",
	"path_root": "",
	"name": "",
	"capabilities": {},
	"flags_list": null,
	"entropy": 0,
	"hash": {
		"md5": "",
		"sha1": "",
		"sha256": "",
		"sha512": ""
	},
	"magic_num": {
		"hex": "",
		"text": "",
		"type": "",
		"class": "",
		"expected_extensions": null
	},
	"mount": {
		"mountpoint": "",
		"device": "",
		"fs_type": ""
	},
	"container": {
		"id": "",
		"id_short": "",
		"rootdir": ""
	},
	"data": null,
	"analysis": {
		"binary": {
			"interpreter": "",
			"build_id": "",
			"comment": "",
			"architecture": "",
			"type": "",
			"hardening": null,
			"hardening_missing": null,
			"capabilities": null,
			"suspicious": null,
			"anomalies": null,
			"properties": null,
			"confirmed": null,
			"exec_targets": null,
			"decoded_strings": null,
			"decode_keys_xor": null,
			"counts": {
				"imported_symbols": 0,
				"static_symbols": 0,
				"exported_symbols": 0,
				"syscalls": 0,
				"imported_libs": 0
			},
			"suspicious_symbols": null,
			"suspicious_syscalls": null,
			"suspicious_strings": null,
			"suspicious_exported_symbols": null,
			"imports": null,
			"iocs": {
				"ips": null,
				"urls": null,
				"paths": null
			},
			"overlay": {
				"size": 0,
				"ratio": 0,
				"entropy": 0,
				"content_type": ""
			},
			"threat_score": 0,
			"threat_score_lr": 0,
			"threat_score_gbdt": 0,
			"score_path": ""
		}
	}
}

User SSH known_hosts

{
	"present": false,
	"total": 0,
	"data": [
		{
			"entry_num": 0,
			"entry": "",
			"path": "",
			"masked": false,
			"masked_salt": "",
			"masked_value": "",
			"marker": "",
			"hostnames": null,
			"cert_authority": false,
			"revoked": false,
			"type": "",
			"public_key": "",
			"key_parse_error": false,
			"sha256_fingerprint": ""
		}
	],
	"file": {
		"date": {
			"created": "",
			"created_minutes": 0,
			"modified": "",
			"modified_minutes": 0,
			"accessed": "",
			"accessed_minutes": 0
		},
		"nlink": 0,
		"mode": "",
		"uid": 0,
		"username": "",
		"gid": 0,
		"groupname": "",
		"size": 0,
		"size_mismatch": false,
		"path": "",
		"path_root": "",
		"name": "",
		"capabilities": {},
		"flags_list": null,
		"entropy": 0,
		"hash": {
			"md5": "",
			"sha1": "",
			"sha256": "",
			"sha512": ""
		},
		"magic_num": {
			"hex": "",
			"text": "",
			"type": "",
			"class": "",
			"expected_extensions": null
		},
		"mount": {
			"mountpoint": "",
			"device": "",
			"fs_type": ""
		},
		"container": {
			"id": "",
			"id_short": "",
			"rootdir": ""
		},
		"data": null,
		"analysis": {
			"binary": {
				"interpreter": "",
				"build_id": "",
				"comment": "",
				"architecture": "",
				"type": "",
				"hardening": null,
				"hardening_missing": null,
				"capabilities": null,
				"suspicious": null,
				"anomalies": null,
				"properties": null,
				"confirmed": null,
				"exec_targets": null,
				"decoded_strings": null,
				"decode_keys_xor": null,
				"counts": {
					"imported_symbols": 0,
					"static_symbols": 0,
					"exported_symbols": 0,
					"syscalls": 0,
					"imported_libs": 0
				},
				"suspicious_symbols": null,
				"suspicious_syscalls": null,
				"suspicious_strings": null,
				"suspicious_exported_symbols": null,
				"imports": null,
				"iocs": {
					"ips": null,
					"urls": null,
					"paths": null
				},
				"overlay": {
					"size": 0,
					"ratio": 0,
					"entropy": 0,
					"content_type": ""
				},
				"threat_score": 0,
				"threat_score_lr": 0,
				"threat_score_gbdt": 0,
				"score_path": ""
			}
		}
	}
}

User SSH known_hosts Data

{
	"entry_num": 0,
	"entry": "",
	"path": "",
	"masked": false,
	"masked_salt": "",
	"masked_value": "",
	"marker": "",
	"hostnames": [
		{
			"hostname": "",
			"port": 0
		}
	],
	"cert_authority": false,
	"revoked": false,
	"type": "",
	"public_key": "",
	"key_parse_error": false,
	"sha256_fingerprint": ""
}

User SSH known_hosts File

{
	"date": {
		"created": "",
		"created_minutes": 0,
		"modified": "",
		"modified_minutes": 0,
		"accessed": "",
		"accessed_minutes": 0
	},
	"nlink": 0,
	"mode": "",
	"uid": 0,
	"username": "",
	"gid": 0,
	"groupname": "",
	"size": 0,
	"size_mismatch": false,
	"path": "",
	"path_root": "",
	"name": "",
	"capabilities": {},
	"flags_list": null,
	"entropy": 0,
	"hash": {
		"md5": "",
		"sha1": "",
		"sha256": "",
		"sha512": ""
	},
	"magic_num": {
		"hex": "",
		"text": "",
		"type": "",
		"class": "",
		"expected_extensions": null
	},
	"mount": {
		"mountpoint": "",
		"device": "",
		"fs_type": ""
	},
	"container": {
		"id": "",
		"id_short": "",
		"rootdir": ""
	},
	"data": null,
	"analysis": {
		"binary": {
			"interpreter": "",
			"build_id": "",
			"comment": "",
			"architecture": "",
			"type": "",
			"hardening": null,
			"hardening_missing": null,
			"capabilities": null,
			"suspicious": null,
			"anomalies": null,
			"properties": null,
			"confirmed": null,
			"exec_targets": null,
			"decoded_strings": null,
			"decode_keys_xor": null,
			"counts": {
				"imported_symbols": 0,
				"static_symbols": 0,
				"exported_symbols": 0,
				"syscalls": 0,
				"imported_libs": 0
			},
			"suspicious_symbols": null,
			"suspicious_syscalls": null,
			"suspicious_strings": null,
			"suspicious_exported_symbols": null,
			"imports": null,
			"iocs": {
				"ips": null,
				"urls": null,
				"paths": null
			},
			"overlay": {
				"size": 0,
				"ratio": 0,
				"entropy": 0,
				"content_type": ""
			},
			"threat_score": 0,
			"threat_score_lr": 0,
			"threat_score_gbdt": 0,
			"score_path": ""
		}
	}
}

Did this page help you?