DWService - Docs

You may share an agent – and therefore give someone else – access to a remote machine  that you manage. This option is often used by small support companies with a central premium account.

Log in www.dwservice.net, go to Agent

Choose the agent that you want to share, click on the three vertical dots and select New Share.

In the next screen, you can add description if you want.

Then you can choose the permission settings. Uncheck Full Access. You will be able to share access to only that apps of your choice. Simply check the ones you want

• Files and Folders
• Log Watch
• Screen
• Resources
• Text Editor
• Shell

Now you will be presented with sharing methods. For the sake of this example, we’ll take the most common one : a login option. So check Login Enable and type the password of your choice.

You may after configure the validity of this shared agent. If you want to teporarily share an agent with someone, simply uncheck Validity : Always. Then select a time period.

Finally, we will generate for you an ID.

Therefore, someone else will be able to access this shared agent by ogin in www.dwservice.net by using that ID and the password that you previously chose.

You may share an agent – and therefore give someone else – access to a remote machine  that you manage. This option is often used by small support companies with a central premium account.

Log in www.dwservice.net, go to Agents

Choose the agent that you want to share, click on the three vertical dots and select New Share.

In the next screen, you can add description if you want.

Then you can choose the permission settings. if you want to share full access to the agent let the Full Access option checked.

Now you will be presented with sharing methods. For the sake of this example, we’ll take the most common one : a login option. So check Login Enable and type the password of your choice.

You may after configure the validity of this shared agent. By default, we’ll let the value always.

Finally, we will generate for you an ID.

Therefore, someone else will be able to access this shared agent by ogin in www.dwservice.net by using that ID and the password that you previously chose.

 

NOTE : WE CANNOT RECOVER YOUR ACCOUNT IF YOU LOST YOUR RECOVERY CODE. YOU NEED TO CREATE A NEW ACCOUNT

Once logged in your DWService account, you’ll be presented your dashboard. Go to My account.

At the bottom of the page, you will find a section titled Additional authentication. From there, you may enable TOTP or Time-Based One-Time password.

This TOTP system is used as the second level of security in our 2FA mechanism.

When choosing to enable TOTP, you will be invited to download a mobile application that is used to generate ephemeral codes after you have entered your traditional password. The validity of those codes only lasts a few seconds.

Among available applications for iOS or Android, you’ll find FreeOTP, Google Authenticator (Android – iOS), Microsoft Authenticator or Authy. This is a non-exhaustive list ; you can find other similar apps in the Apple App Store or in the Android Play Store.

When adding your DWS account on one of those applications, you’ll be asked to scan the unique QR code that we generated.

Please note that you will be asked for a security code each time you try to log in your account. Should you lose your smartphone, we cannot recover your account.

However, after setting up 2FA we will give you a special recovery code.

KEEP THIS CODE IN A SECURE PLACE OUTSIDE OF YOUR SMARTPHONE

It will be mandatory in case you lose your smartphone. We recommend that you write it down and hide it in your house somewhere.

DWService being quite easy to set up, you might have lots of computers in your account. With time, it may get a little bit hard to distinguish your own machine that you need to access on a regular basis. Luckily, we have a great tip!

The idea is for you to bookmark a certain link tight to a specific web application on a particular machine.

EXAMPLE : DIRECT LINK TO MY FILES

Once logged in your dashboard, click the “+” button of the Sharing section in the computer you want to control. Give it a name, for instance “My Files”. Uncheck “Full access” and add Files and Folders in the Allowed Applications column. Then, click “Next”

If you want this link to be valid with no time limit, leave the check box Validity: Always. Click Next.

After that, you probably want to secure this connection with a password. So make sure to check the box titled “Allow login” Type in your personal password twice and choose Accept

The final screen will present a random login composed of four blocks of three digits which looks a bit like this:

BOOKMARK YOUR CUSTOM DIRECT PATH

Now, your access has been created. If you do not want to bother learning this new random login by heart, we have another trick! Simply bookmark this page:

https://www.dwservice.net/en/login.html?loginUser=123-456-789-101

Of course, replace the end of the URL with your own random login digits. You’ll land on a page where the login field will be prepopulated. Now you simply need to enter the password that you chose earlier on.

Note: This page will be in English, but you can modify that URL by changing

….net/en/login…

…with the letters corresponding to your language (eg.it=Italian, fr=French…)

 

Two types of situations are possible:

• The Agent is not in a group.
• The Agent is in a group.

The difference between the two:

First, let’s see how it works when the Agent is not in a group.

Say, for instance, that you have set up your home computer and your work computer in DWService.net. Let’s say you called the first one “Home” and the second one “Work”.

When logging in your dashboard, after your email address, simply append the “#” sign, followed by the computer name of your choice.

If you usually log in with my@email.com, then you would access your work computer by using: my@email.com#Work. Your password, of course, remains unchanged.

This will lead you straight to your work computer dashboard!

The example above showed how you can directly join an Agent that is not in any group.

When the Agent is in a group, the login is as follows: my@email.com#Company/Work

As you can see, the sequence is as follows: email#GroupName/AgentName

Our tutorial video on the process is available on our YouTube channel:

Requirements

• JDK 11.x
• ECLIPSE JAVA EE IDE (2020-12)
• MAVEN 3.6+
• TOMCAT 9.x

We need eclipse which supports JDK 11 and for Enterprise Java developers as it already comes with apache tomcat 9.x adapter and we do not need to install the related plugins.

Setting up the demo platform

Configure eclipse to use JDK 11, Maven 3.6 + and Tomcat 9.x

• To configure Java, go to Windows > Preferences > Java > Installed JREs and validate JDK 11.x is selected. If you do not see JDK 11 please add and select from installed location.
• To configure maven, go to Windows > Preferences > Maven > Installations and validate Maven 3.6 + is selected. If you do not see Maven, please add, and select from installed location.
• To configure Tomcat, go to Windows > Preferences > Server > Run Time Environments and validate we have Tomcat 9.x added. If not please add, and select from installed location.

Create a new server to run the application.

In server tab check if server is linked or not. I now click and in next screen select Tomcat v9.0 Server and select the tomcat runtime environment added in previous step.

On clicking Finish you can see the server in Servers Tab

By default, server is running on port 8080. In case you want to run on any other report double click the server shown in Servers tab and configure port as shown in below screen

Change the port and save the config using Ctrl-s

Importing project

• Download this file: java_example.zip
• Extract the files.
• In Eclipse select File > Import. Then search “Existing Maven Projects”.
• Click Next and browse to folder extracted in above step, Select Folder and click Finish.
• After above step wait for eclipse to import project. Eclipse will download all required dependencies from maven. Though eclipse will automatically download all dependencies still just to make sure right click project and select Maven > Update Project

Run project

• Enter your key and secret in the file appsettings.json as shown in the figure:
• Compile project using maven. Right click project Run As > Maven Build:
• In goals add “clean install” and click Run:
• After successful build right click project and Run As > Run On Server OR Run Ad > Debug On Server
• In next screen select the server defined earlier and click finish. Once server is started you can access the portal:
  http://localhost:8080/DWSApiDemo/
  Port may be different as configured in server config.

Discovering the demo platform

Add services

Click the menu button Account Resource, click the Add Services button in the opened page, add 5 agents and 1 channel:

Create An Agent

Click the menu button Agents Resource, click the Create button in the opened page. Enter a name and a description for the agent.

The response is the id associated with the agent.

Install Code is the code to enter when you install the agent on the PC you want to control.
Download and install the custom installer for your OS from project home page:

Create a new session

Click the menu button Sessions Resource, click the Create a new session button in the opened page.
To create a new session you have to:

• Enter the Id of the Agent you want to connect
• Enter the language, for example en (by default is en)
• Choose the app shown when the session opens
• Choose if you want to see menu apps
• Choose if you want all the applications by selecting Full Access or select them individually

Requirements

• Visual Studio 2019

Setting up the demo platform

• Download this file: csharp_example.zip
• Extract the files
• Open the file DemoApiDwservice.sln with Visual Studio
• Enter your key and secret in the file appsettings.json as shown in the figure:
  
• Run the application

Discovering the demo platform

Add services

Click the menu button Account Resource, click the Add Services button in the opened page, add 5 agents and 1 channel:

Create An Agent

Click the menu button Agents Resource, click the Create An Agent button in the opened page. Enter a name and a description for the agent.

The response is the id associated with the agent.

Install Code is the code to enter when you install the agent on the PC you want to control.
Download and install the custom installer for your OS from project home page:

Create a new session

Click the menu button Sessions Resource, click the Create a new session button in the opened page.
To create a new session you have to:

• Enter the Id of the Agent you want to connect
• Enter the language, for example en (by default is en)
• Choose the app shown when the session opens
• Choose if you want to see menu apps
• Choose if you want all the applications by selecting Full Access or select them individually

Once the session is open you can choose the various applications by clicking one of the buttons at the top.

Clicking on the File System button you open the Files and Folders app:

Clicking on the Log Watch button you open the Log watch app:

Clicking on the Resource button you open the Resource app:

Clicking on the Text Editor button you open the Text editor app: