| /* |
| * Licensed to the Apache Software Foundation (ASF) under one |
| * or more contributor license agreements. See the NOTICE file |
| * distributed with this work for additional information |
| * regarding copyright ownership. The ASF licenses this file |
| * to you under the Apache License, Version 2.0 (the |
| * "License"); you may not use this file except in compliance |
| * with the License. You may obtain a copy of the License at |
| * |
| * http://www.apache.org/licenses/LICENSE-2.0 |
| * |
| * Unless required by applicable law or agreed to in writing, |
| * software distributed under the License is distributed on an |
| * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY |
| * KIND, either express or implied. See the License for the |
| * specific language governing permissions and limitations |
| * under the License. |
| */ |
| |
| #include "channels/rail.h" |
| #include "plugins/channels.h" |
| #include "rdp.h" |
| #include "settings.h" |
| |
| #include <freerdp/client/rail.h> |
| #include <freerdp/event.h> |
| #include <freerdp/freerdp.h> |
| #include <freerdp/rail.h> |
| #include <guacamole/client.h> |
| #include <winpr/wtypes.h> |
| #include <winpr/wtsapi.h> |
| |
| #include <stddef.h> |
| #include <string.h> |
| |
| /** |
| * Completes initialization of the RemoteApp session, sending client system |
| * parameters and executing the desired RemoteApp command using the Client |
| * System Parameters Update PDU and Client Execute PDU respectively. These PDUs |
| * MUST be sent for the desired RemoteApp to run, and MUST NOT be sent until |
| * after a Handshake or HandshakeEx PDU has been received. See: |
| * |
| * https://docs.microsoft.com/en-us/openspecs/windows_protocols/ms-rdperp/60344497-883f-4711-8b9a-828d1c580195 (System Parameters Update PDU) |
| * https://docs.microsoft.com/en-us/openspecs/windows_protocols/ms-rdperp/98a6e3c3-c2a9-42cc-ad91-0d9a6c211138 (Client Execute PDU) |
| * |
| * @param rail |
| * The RailClientContext structure used by FreeRDP to handle the RAIL |
| * channel for the current RDP session. |
| * |
| * @return |
| * CHANNEL_RC_OK (zero) if the PDUs were sent successfully, an error code |
| * (non-zero) otherwise. |
| */ |
| static UINT guac_rdp_rail_complete_handshake(RailClientContext* rail) { |
| |
| guac_client* client = (guac_client*) rail->custom; |
| guac_rdp_client* rdp_client = (guac_rdp_client*) client->data; |
| |
| RAIL_SYSPARAM_ORDER sysparam = { |
| .workArea = { |
| .left = 0, |
| .top = 0, |
| .right = rdp_client->settings->width, |
| .bottom = rdp_client->settings->height |
| }, |
| .dragFullWindows = FALSE |
| }; |
| |
| /* Send client system parameters */ |
| UINT status = rail->ClientSystemParam(rail, &sysparam); |
| if (status != CHANNEL_RC_OK) |
| return status; |
| |
| RAIL_EXEC_ORDER exec = { |
| .RemoteApplicationProgram = rdp_client->settings->remote_app, |
| .RemoteApplicationWorkingDir = rdp_client->settings->remote_app_dir, |
| .RemoteApplicationArguments = rdp_client->settings->remote_app_args, |
| }; |
| |
| /* Execute desired RemoteApp command */ |
| return rail->ClientExecute(rail, &exec); |
| |
| } |
| |
| /** |
| * Callback which is invoked when a Handshake PDU is received from the RDP |
| * server. No communication for RemoteApp may occur until the Handshake PDU |
| * (or, alternatively, the HandshakeEx PDU) is received. See: |
| * |
| * https://docs.microsoft.com/en-us/openspecs/windows_protocols/ms-rdperp/cec4eb83-b304-43c9-8378-b5b8f5e7082a |
| * |
| * @param rail |
| * The RailClientContext structure used by FreeRDP to handle the RAIL |
| * channel for the current RDP session. |
| * |
| * @param handshake |
| * The RAIL_HANDSHAKE_ORDER structure representing the Handshake PDU that |
| * was received. |
| * |
| * @return |
| * CHANNEL_RC_OK (zero) if the PDU was handled successfully, an error code |
| * (non-zero) otherwise. |
| */ |
| static UINT guac_rdp_rail_handshake(RailClientContext* rail, |
| const RAIL_HANDSHAKE_ORDER* handshake) { |
| return guac_rdp_rail_complete_handshake(rail); |
| } |
| |
| /** |
| * Callback which is invoked when a HandshakeEx PDU is received from the RDP |
| * server. No communication for RemoteApp may occur until the HandshakeEx PDU |
| * (or, alternatively, the Handshake PDU) is received. See: |
| * |
| * https://docs.microsoft.com/en-us/openspecs/windows_protocols/ms-rdperp/5cec5414-27de-442e-8d4a-c8f8b41f3899 |
| * |
| * @param rail |
| * The RailClientContext structure used by FreeRDP to handle the RAIL |
| * channel for the current RDP session. |
| * |
| * @param handshake_ex |
| * The RAIL_HANDSHAKE_EX_ORDER structure representing the HandshakeEx PDU |
| * that was received. |
| * |
| * @return |
| * CHANNEL_RC_OK (zero) if the PDU was handled successfully, an error code |
| * (non-zero) otherwise. |
| */ |
| static UINT guac_rdp_rail_handshake_ex(RailClientContext* rail, |
| const RAIL_HANDSHAKE_EX_ORDER* handshake_ex) { |
| return guac_rdp_rail_complete_handshake(rail); |
| } |
| |
| /** |
| * Callback which associates handlers specific to Guacamole with the |
| * RailClientContext instance allocated by FreeRDP to deal with received |
| * RAIL (RemoteApp) messages. |
| * |
| * This function is called whenever a channel connects via the PubSub event |
| * system within FreeRDP, but only has any effect if the connected channel is |
| * the RAIL channel. This specific callback is registered with the PubSub |
| * system of the relevant rdpContext when guac_rdp_rail_load_plugin() is |
| * called. |
| * |
| * @param context |
| * The rdpContext associated with the active RDP session. |
| * |
| * @param e |
| * Event-specific arguments, mainly the name of the channel, and a |
| * reference to the associated plugin loaded for that channel by FreeRDP. |
| */ |
| static void guac_rdp_rail_channel_connected(rdpContext* context, |
| ChannelConnectedEventArgs* e) { |
| |
| guac_client* client = ((rdp_freerdp_context*) context)->client; |
| |
| /* Ignore connection event if it's not for the RAIL channel */ |
| if (strcmp(e->name, RAIL_SVC_CHANNEL_NAME) != 0) |
| return; |
| |
| /* The structure pointed to by pInterface is guaranteed to be a |
| * RailClientContext if the channel is RAIL */ |
| RailClientContext* rail = (RailClientContext*) e->pInterface; |
| |
| /* Init FreeRDP RAIL context, ensuring the guac_client can be accessed from |
| * within any RAIL-specific callbacks */ |
| rail->custom = client; |
| rail->ServerHandshake = guac_rdp_rail_handshake; |
| rail->ServerHandshakeEx = guac_rdp_rail_handshake_ex; |
| |
| guac_client_log(client, GUAC_LOG_DEBUG, "RAIL (RemoteApp) channel " |
| "connected."); |
| |
| } |
| |
| void guac_rdp_rail_load_plugin(rdpContext* context) { |
| |
| guac_client* client = ((rdp_freerdp_context*) context)->client; |
| |
| /* Attempt to load FreeRDP support for the RAIL channel */ |
| if (guac_freerdp_channels_load_plugin(context, "rail", context->settings)) { |
| guac_client_log(client, GUAC_LOG_WARNING, |
| "Support for the RAIL channel (RemoteApp) could not be " |
| "loaded. This support normally takes the form of a plugin " |
| "which is built into FreeRDP. Lacking this support, " |
| "RemoteApp will not work."); |
| return; |
| } |
| |
| /* Complete RDP side of initialization when channel is connected */ |
| PubSub_SubscribeChannelConnected(context->pubSub, |
| (pChannelConnectedEventHandler) guac_rdp_rail_channel_connected); |
| |
| guac_client_log(client, GUAC_LOG_DEBUG, "Support for RAIL (RemoteApp) " |
| "registered. Awaiting channel connection."); |
| |
| } |
| |