# Remote Desktop and VDI Setup # Once your Single-Sign On Portals are set up, you can add External Applications for use within the SSO Portal for specific users. This section will walk through setting up a Remote Desktop Application to use through the Single Sign-On Portal. ## RDP Agent Component Creation ## To start out, we need to create an RDP Agent Component in the Xiid Global Management Portal. Sign in to the [Xiid Global Management Portal](https://managev3.xiid.com/) and navigate to the __RDP Agents__ tab. On the RDP Agents tab, click the purple __New RDP Agent__ button in the top left. On the RDP Agent Info screen, provide a name that helps you remember what RDP machine this is. Then click the green __Save__ button in the top right corner. Notice in the RDP Agents table there is a new row for your new RDP Agent. Also take note that the __initialized__ column has a red X, which indicates that the RDP Agent Component has not been bound to a running RDP Agent on a machine. ## RDP Agent Setup ## With our new RDP Agent Component created, we’re ready to configure the RDP instance (the computer we are Remoting into) with Xiid’s technology. Sign into the [Xiid Global Management Portal](https://managev3.xiid.com/) and navigate to the __Download__ tab. Click the __Download__ button on the RDP Agent Installer icon shown in light green. Log into the RDP instance and FTP the RDP Agent Installer to the RDP instance. Alternatively, if your RDP instance has external internet access, you can download the RDP Agent Installer directly on your RDP instance. Run the RDP Agent Installer executable on your RDP instance and move through the prompts. After the installation completes, a command prompt will open and ask for your RDP Agent Code. To get the RDP Agent Code, sign in to the [Xiid Global Management Portal](https://managev3.xiid.com/) and navigate to the __RDP Agents__ tab. Locate the RDP Agent row in the RDP Agents table and click the blue ____ icon in the __Code and Info__ column. (Shown below in green) ![RDP IdP Consumer Example with Purple Monitor Highlighted](images/rdpmanagementtablehighlighted.png) A window will pop up with your Activation Code shown. Click the green __Copy__ button to copy the code to your clipboard. Please note that sometimes the clipboard does not persist over an RDP connection, and you may need to copy the code elsewhere to propagate over to your RDP instance. Now go back to your RDP Instance and paste the Activation Code in the command prompt and hit Enter. You should see the command prompt indicate the installation was successful and close. Your RDP Instance is now running the Xiid RDP Agent for secure RDP connections. __Note: The RDP Agent *must* register itself with the Xiid.IM Active Directory Agent. If you set up an RDP Agent *prior* to setting up and configuring your__ __Xiid.IM Active Directory Agent, the RDP Agent will not be available in the RDP Agents Tab in the Agent Management Portal. You will need to restart the RDP__ __Agent Service on the RDP instance *after* the Xiid.IM Active Directory Agent is set up and configured to finish the registration.__ ## Xiid RDP Application Setup ## Now that the RDP Agent is configured and bound in the Global Managament Portal, we can add an RDP Application to directly RDP into the machine. Start by signing into the Xiid Agent Management Portal on your domain controller (or Active Directory Network-Adjacent Server) and navigate to the __RDP Agents__ tab. You should see a row populated in the RDP Agents table for your new RDP Agent. The entry in the "Status" column should say __ready__. After confirming that your Active Directory Agent is aware of your RDP Agent and ready to use it, you can navigate to the __Applications__ tab. On the Applications tab, click the purple __Choose__ button at the bottom of the __RDP__ card. On the Applications List for RDP Page, click the purple __Add Application__ button in the top right. Choose which SSO portal you would like to assign the RDP Connection to in the __Portal__ dropdown. In the RDP Agent dropdown, select the RDP Agent we previously created. For the __User__, you can provide a username that will always be used for sign-in. This is optional, and if you leave the field blank the username of the user that is __signed into__ the SSO Portal will be the used. In the __IP Address__ field, you can provide a static IP address for the RDP instance. If you leave this field blank, the IP address will be dynamically linked to the machine running the RDP Agent. So if the RDP machine is assigned a new IP Address it will be automatically used in the SSO portal. Last, provide a description for the RDP Application that helps you remember its purpose. Click the purple __Save__ button and your RDP Connection will be ready for use! ## Xiid RDP App (VDI) Application Setup ## Start by confirming that the RDP Agent is available to your Active Directory Agent by signing into the Xiid Agent Management Portal. Navigate to the __RDP Agents__ tab and confirm that your RDP Agent is listed in the RDP Agents table. Next, navigate to the Applications tab and click the purple __Choose__ button in the __RDP App__ card. On the Application List for RDPAPP screen, click the purple __Add Application__ button in the top right. On the next screen, select an SSO Portal to assign the RDP App Application in the __Portal__ dropdown. Next, in the __RDP Agent__ dropdown, select the RDP Agent that was confirmed in the RDP Agents tab. For the __User__, you can provide a username that will always be used for sign-in. This is optional, and if you leave the field blank the username of the user that is __signed into__ the SSO Portal will be the used. In the __IP Address__ field, you can provide a static IP address for the RDP instance. If you leave this field blank, the IP address will be dynamically linked to the machine running the RDP Agent. So if the RDP machine is assigned a new IP Address it will be automatically used in the SSO portal. Provide a description that helps you remember what application this is and who it is for. In the __Application Path__ field, provide the full program file path to the Application you would like to access over remote connection. The application must be available on the RDP machine. Do not worry about the formatting of the path (e.g. backslashes and whitespace). `Example: C:\Windows\notepad.exe` ## RDP Wrapper Setup ## Now that the RDP Agent is running on the computer we would like to remote to, we need to set up the client computer to integrate the RDP connection with Xiid. Start by signing into the Xiid Global Management Portal and navigating to the __Download__ tab. Click the Download button on the dark green icon for the RDP Wrapper installation executable. Run the RDP Wrapper Installer on every machine that you wish to *RDP from*. No other installation is necessary for the RDP Wrapper. At this point, users can sign in to the Xiid Single Sign-On portal, find the RDP Application, click the __WRA__ button and remote into the machine safely and securely.