Retrieves a Service by its graph object id: a network service identified on a discovered device, such as HTTP, TLS, SSH, SMB, SNMP, or DNS, in a client or server role, with a protocol-specific report and matching against known vulnerabilities (CPE and CVE). A Device lists its services through services; find them across the organization with graphSearch on the SERVICE object type. Returns a not-found error when no object has the id, and an error when the id belongs to another object type.
Response
Returns a ServicePayload!
Arguments
| Name | Description |
|---|---|
id - ID!
|
The Service identifier. |
mockOptions - MockDataInput
|
Options for mock data generation. Options supported: key: "SERVICE_TYPE", value: ServiceType example: "mockOptions": { "options": [ { "key": "SERVICE_TYPE", "value": "HTTPS" } ] } |
Example
Query
query service(
$id: ID!,
$mockOptions: MockDataInput
) {
service(
id: $id,
mockOptions: $mockOptions
) {
node {
id
orgId
objectType
objectTypeLabel
displayName
firstSeen
lastSeen
seen {
...SeenOnlineFragment
}
createdAt
updatedAt
snapshotInfo {
...GraphObjectSnapshotInfoFragment
}
device {
...DeviceFragment
}
network {
...NetworkFragment
}
networkPrefix {
...NetworkPrefixFragment
}
openPort {
...OpenPortFragment
}
public
addressFamily
ip {
...IpAddressFragment
}
port
protocol
serviceType
clientServer
sensorId
sensor {
...SensorFragment
}
sensorVersion
seenUp {
...SeenUpFragment
}
seenUpPublic {
...SeenUpFragment
}
report {
... on AppSocket {
...AppSocketFragment
}
... on DHCPv4 {
...DHCPv4Fragment
}
... on DNS {
...DNSFragment
}
... on FTP {
...FTPFragment
}
... on HTTP {
...HTTPFragment
}
... on IPP {
...IPPFragment
}
... on IRC {
...IRCFragment
}
... on MDNS {
...MDNSFragment
}
... on MongoDB {
...MongoDBFragment
}
... on NTP {
...NTPFragment
}
... on NetBiosSmb {
...NetBiosSmbFragment
}
... on SIP {
...SIPFragment
}
... on SMB {
...SMBFragment
}
... on SMTP {
...SMTPFragment
}
... on SNMP {
...SNMPFragment
}
... on SSDP {
...SSDPFragment
}
... on SSH {
...SSHFragment
}
... on TLS {
...TLSFragment
}
... on Telnet {
...TelnetFragment
}
... on UPnP {
...UPnPFragment
}
}
canResubmitSensorRequests
sensorRequestIds
sensorRequests {
...SensorRequestFragment
}
vulnerabilities {
...PlatformVulnerabilitiesFragment
}
findings {
...FindingsPayloadFragment
}
issues {
...IssuesPayloadFragment
}
issuesSummary {
...IssuesSummaryFragment
}
}
}
}
Variables
{
"id": "4",
"mockOptions": MockDataInput
}
Response
{"data": {"service": {"node": Service}}}