Object
Site
A representation of a website or web application that you want to scan and track using Burp Suite Enterprise Edition.
Fields
id():
ID!
The unique identifier of the site.
name():
String
The name of the site. This is the name that appears on the Burp Suite Enterprise Edition web UI. Note that the name of a site must be unique within its parent folder.
parent_id():
ID!
The unique identifier of the folder that is the parent of this site in the site tree hierarchy. A parent ID of 0 indicates that this site is on the root level.
scope():
Scope
Deprecated: scope does not support separate seed/included URLs. Use scope_v2 instead.
The URLs that are included or excluded for scans of this site. This does not support sites with in-scope URL prefixes.
scope_v2():
ScopeV2
The site scope.
scan_configurations():
[ScanConfiguration!]
A list of the scan configurations that you want to use for scans of this site.
extensions():
[Extension!]
The extensions assigned to this site.
bchecks():
[BCheck!]
The bchecks assigned to this site.
application_logins():
ApplicationLogins!
All the saved application logins for this site. These can either be basic sets of login credentials or scripts of full login sequences that you recorded with the Burp Suite Navigation Recorder browser extension. These are used by scans to crawl areas of the site that are only accessible to registered users. Note that you can only use one type of application login for each site.
platform_authentication():
PlatformAuthentication!
Any platform authentication logins that have been saved against this site
ephemeral():
Boolean
In the 'Sites and scan data' settings, your Burp Suite Enterprise Edition administrator can configure the web UI to only display user-created sites in the site tree. In this case, all sites generated using the REST API will be set as 'ephemeral'. This means they will never be displayed in the site tree, even if the administrator changes this setting later.
email_recipients():
[EmailRecipient!]
A list of all the email addresses to which scan reports are sent whenever scans of this site finish.
agent_pool():
AgentPool
The agent pool used for scanning this site.
slack_channels():
[SlackChannel]
The information about Slack notifications for this site.
settings():
SiteSettings
Settings that specify headers and cookies to use with the site.
Example
Query
query GetSite($site_id: ID!) {
site(id: $site_id) {
id
name
parent_id
ephemeral
scope_v2 {
start_urls
in_scope_url_prefixes
out_of_scope_url_prefixes
protocol_options
}
scan_configurations {
id
}
extensions {
id
}
application_logins {
login_credentials {
id
label
username
password
}
recorded_logins {
id
label
script
}
}
email_recipients {
id
email
}
agent_pool {
id
name
agents {
id
name
}
}
slack_channels {
id
name
}
settings {
request_headers {
id
name
value
scope_prefix
}
request_cookies {
id
name
value
scope_prefix
}
}
}
}
Result
{
"data": {
"site": {
"id": "20",
"name": null,
"parent_id": "0",
"ephemeral": false,
"scope_v2": {
"start_urls": [],
"in_scope_url_prefixes": [],
"out_of_scope_url_prefixes": [],
"protocol_options": null
},
"scan_configurations": [],
"extensions": [],
"application_logins": {
"login_credentials": [],
"recorded_logins": []
},
"email_recipients": [],
"agent_pool": {
"id": null,
"name": null,
"agents": []
},
"slack_channels": [],
"settings": {
"request_headers": [],
"request_cookies": []
}
}
}
}