DeepSurface: Lansweeper Cloud
DocumentationInstallation GuideOverviewLet DeepSurface Host For YouGetting StartedSystem RequirementsSelf Hosted Quick Start - Installing to Cloud PlatformsSelf Hosted - Installation Using an OVARegistration, Package Installation, and InitializationFirst Steps After Initialization of the ConsoleDeployment OptionsMain and Subordinate ConsolesAgent-Based DeploymentUser Managed Scan DeploymentCredentialed Scanning DeploymentMixed EnvironmentDeployment ToolsActive Directory Group PolicyMicrosoft Endpoint Configuration Manager (part of InTune)Tanium DeployHCL BigFixIvantiVirtual MachinesVMWareVirtual BoxVirtualBox Guest AdditionsAWS EC2 (BYOL)AWS EC2 (Usage Based)Azure CloudGoogle CloudAdditional Items to ConsiderMain Console Server CertificatesLDAPTOFUClock SyncDeepSurface CommandsMultiple Vulnerability SourcesAPI DocumentationUser GuideReportingDashboardsExportsRisk InsightHostsPatchesVulnerabilitiesVulnerability InstancesUsersRemediation Workflow ManagerPlansSettingsIntegrationsWorkflowExportingAccepted Risk PlansAccepted Risk WorkflowExploreModelPathsActivityTasksConfiguration AlertsScan LogsNotification SettingsScanningStatusAgentsUser ManagedCredentialed Scanning SettingsCredentialsScan GroupsGeneral SettingsCloud ScanningNetwork ConnectivitySubordinatesVulnerability SourcesSetupSensitive Assets: PolicesSensitive Assets: ManualAdmin SettingsSMTP SettingsCertificatesOutbound ProxyAuthentication ProvidersUsersTagsIntegrations GuideVulnerability SourcesCrowdStrike SpotlightSentinelOneCarbon Black CloudMicrosoft Defender for EndpointWazuhLansweeper CloudNessus APITenable.io APISecurity Center/Tenable.sc APIRapid7 InsightVM APIQualys APINozomi GuardianEclypsiumAWS InspectorRemediationJira SoftwareTanium (BETA)Authentication ProvidersLDAP (Active Directory)SAML (Azure Active Directory)SAML (Google)SAML (Okta)PAMCyberArkDelinea (Thycotic)Microsoft LAPSSecurity GuideFirewall ConfigurationBase Network RequirementsAgent Network RequirementsCredentialed Scanning Network RequirementsAPI Network RequirementsHow DeepSurface Scans WorkDomain (LDAP) ScanningHost Scanning RoutineReasons for the Administrative Access RequirementEndpoint Protection ConsiderationsOther ItemsScope of Data Storage and RetentionIPS/IDS ConsiderationsLoggingResetting the DSADMIN passwordProduct InformationChangelogsOpen source LicensesEnd User License Agreement (EULA)
For Configuring DeepSurface to interface with Lansweeper Cloud APIs, you need to generate some API keys and enter them into the appropriate configuration screen in DeepSurface.
Setting Up Lansweeper Cloud
For DeepSurface to work with Lansweeper Cloud, you need your Site ID and a specific Application Identity Code.
We will start with the Application Identity Code. In order to get this code, you will first need to create an application within your Lansweeper Cloud Site. To do this, click on your user initials (currently located in the bottom left of the menu on the page).
- Once within your profile, select
Developer Tools > All Applications
. Create a new application by clicking on the "Add New Application" button and select "Personal Application" from the options.
- Fill out all of the required information and choose the "Other" option from the types available. Save the application.
- Once created, click on the new application and click the "Authorize" button in the "Sites authorization" section of the page.
Click the "No Expiration Time" option for the token expiration and select the sites that the token should have access and click "Allow"
IMPORTANT Copy the "Application Identity Code" on the following screen now.
The other information you will need for DeepSurface is the Site ID. To find the Site ID click on the icon in the top left of the menu this time. You may have multiple sites, if you do, be sure to select the site that you just authorized your application for that you created in the previous section. Once in the correct site, click on the "Configuration" menu and select the "Site Settings" sub-menu and you should see the Site ID on the resulting page.
Alternatively, you can obtain a list of all of your Site IDs through the API by using the Application Identity Code you obtained previously. For instance, using the curl command line tool (available on the DeepSurface appliance SSH console) you could run the following command. (Replace "APPIDCODE
" in the command below with the value you obtained in Step 5 above.)
curl --request POST\
--url https://api.lansweeper.com/api/v2/graphql\
--header 'Authorization: Token APPIDCODE'\
--header 'Content-Type: application/json'\
--data '{"query":"{\n me {\n username\n profiles {\n site {\n id\n name\n }}}}","variables":{}}'