23#include <winpr/assert.h>
25#include <winpr/file.h>
26#include <winpr/wlog.h>
27#include <winpr/path.h>
28#include <winpr/library.h>
30#include <freerdp/version.h>
31#include <freerdp/api.h>
32#include <freerdp/build-config.h>
34#include <freerdp/server/proxy/proxy_log.h>
35#include <freerdp/server/proxy/proxy_modules_api.h>
37#include <freerdp/server/proxy/proxy_context.h>
38#include "proxy_modules.h"
40#define TAG PROXY_TAG("modules")
42#define MODULE_ENTRY_POINT "proxy_module_entry_point"
46 proxyPluginsManager mgr;
51static const char* pf_modules_get_filter_type_string(PF_FILTER_TYPE result)
55 case FILTER_TYPE_KEYBOARD:
56 return "FILTER_TYPE_KEYBOARD";
57 case FILTER_TYPE_UNICODE:
58 return "FILTER_TYPE_UNICODE";
59 case FILTER_TYPE_MOUSE:
60 return "FILTER_TYPE_MOUSE";
61 case FILTER_TYPE_MOUSE_EX:
62 return "FILTER_TYPE_MOUSE_EX";
63 case FILTER_TYPE_CLIENT_PASSTHROUGH_CHANNEL_DATA:
64 return "FILTER_TYPE_CLIENT_PASSTHROUGH_CHANNEL_DATA";
65 case FILTER_TYPE_SERVER_PASSTHROUGH_CHANNEL_DATA:
66 return "FILTER_TYPE_SERVER_PASSTHROUGH_CHANNEL_DATA";
67 case FILTER_TYPE_CLIENT_PASSTHROUGH_DYN_CHANNEL_CREATE:
68 return "FILTER_TYPE_CLIENT_PASSTHROUGH_DYN_CHANNEL_CREATE";
69 case FILTER_TYPE_SERVER_FETCH_TARGET_ADDR:
70 return "FILTER_TYPE_SERVER_FETCH_TARGET_ADDR";
71 case FILTER_TYPE_SERVER_PEER_LOGON:
72 return "FILTER_TYPE_SERVER_PEER_LOGON";
73 case FILTER_TYPE_CLIENT_PASSTHROUGH_CHANNEL_CREATE:
74 return "FILTER_TYPE_CLIENT_PASSTHROUGH_CHANNEL_CREATE";
75 case FILTER_TYPE_STATIC_INTERCEPT_LIST:
76 return "FILTER_TYPE_STATIC_INTERCEPT_LIST";
77 case FILTER_TYPE_DYN_INTERCEPT_LIST:
78 return "FILTER_TYPE_DYN_INTERCEPT_LIST";
79 case FILTER_TYPE_INTERCEPT_CHANNEL:
80 return "FILTER_TYPE_INTERCEPT_CHANNEL";
84 return "FILTER_UNKNOWN";
88static const char* pf_modules_get_hook_type_string(PF_HOOK_TYPE result)
92 case HOOK_TYPE_CLIENT_INIT_CONNECT:
93 return "HOOK_TYPE_CLIENT_INIT_CONNECT";
94 case HOOK_TYPE_CLIENT_UNINIT_CONNECT:
95 return "HOOK_TYPE_CLIENT_UNINIT_CONNECT";
96 case HOOK_TYPE_CLIENT_PRE_CONNECT:
97 return "HOOK_TYPE_CLIENT_PRE_CONNECT";
98 case HOOK_TYPE_CLIENT_POST_CONNECT:
99 return "HOOK_TYPE_CLIENT_POST_CONNECT";
100 case HOOK_TYPE_CLIENT_POST_DISCONNECT:
101 return "HOOK_TYPE_CLIENT_POST_DISCONNECT";
102 case HOOK_TYPE_CLIENT_REDIRECT:
103 return "HOOK_TYPE_CLIENT_REDIRECT";
104 case HOOK_TYPE_CLIENT_VERIFY_X509:
105 return "HOOK_TYPE_CLIENT_VERIFY_X509";
106 case HOOK_TYPE_CLIENT_LOGIN_FAILURE:
107 return "HOOK_TYPE_CLIENT_LOGIN_FAILURE";
108 case HOOK_TYPE_CLIENT_END_PAINT:
109 return "HOOK_TYPE_CLIENT_END_PAINT";
110 case HOOK_TYPE_SERVER_POST_CONNECT:
111 return "HOOK_TYPE_SERVER_POST_CONNECT";
112 case HOOK_TYPE_SERVER_ACTIVATE:
113 return "HOOK_TYPE_SERVER_ACTIVATE";
114 case HOOK_TYPE_SERVER_CHANNELS_INIT:
115 return "HOOK_TYPE_SERVER_CHANNELS_INIT";
116 case HOOK_TYPE_SERVER_CHANNELS_FREE:
117 return "HOOK_TYPE_SERVER_CHANNELS_FREE";
118 case HOOK_TYPE_SERVER_SESSION_END:
119 return "HOOK_TYPE_SERVER_SESSION_END";
120 case HOOK_TYPE_CLIENT_LOAD_CHANNELS:
121 return "HOOK_TYPE_CLIENT_LOAD_CHANNELS";
122 case HOOK_TYPE_SERVER_SESSION_INITIALIZE:
123 return "HOOK_TYPE_SERVER_SESSION_INITIALIZE";
124 case HOOK_TYPE_SERVER_SESSION_STARTED:
125 return "HOOK_TYPE_SERVER_SESSION_STARTED";
129 return "HOOK_TYPE_UNKNOWN";
133static BOOL pf_modules_proxy_ArrayList_ForEachFkt(
void* data,
size_t index, va_list ap)
135 proxyPlugin* plugin = (proxyPlugin*)data;
140 PF_HOOK_TYPE type = va_arg(ap, PF_HOOK_TYPE);
141 proxyData* pdata = va_arg(ap, proxyData*);
142 void* custom = va_arg(ap,
void*);
144 WLog_VRB(TAG,
"running hook %s.%s", plugin->name, pf_modules_get_hook_type_string(type));
148 case HOOK_TYPE_CLIENT_INIT_CONNECT:
149 ok = IFCALLRESULT(TRUE, plugin->ClientInitConnect, plugin, pdata, custom);
151 case HOOK_TYPE_CLIENT_UNINIT_CONNECT:
152 ok = IFCALLRESULT(TRUE, plugin->ClientUninitConnect, plugin, pdata, custom);
154 case HOOK_TYPE_CLIENT_PRE_CONNECT:
155 ok = IFCALLRESULT(TRUE, plugin->ClientPreConnect, plugin, pdata, custom);
158 case HOOK_TYPE_CLIENT_POST_CONNECT:
159 ok = IFCALLRESULT(TRUE, plugin->ClientPostConnect, plugin, pdata, custom);
162 case HOOK_TYPE_CLIENT_REDIRECT:
163 ok = IFCALLRESULT(TRUE, plugin->ClientRedirect, plugin, pdata, custom);
166 case HOOK_TYPE_CLIENT_POST_DISCONNECT:
167 ok = IFCALLRESULT(TRUE, plugin->ClientPostDisconnect, plugin, pdata, custom);
170 case HOOK_TYPE_CLIENT_VERIFY_X509:
171 ok = IFCALLRESULT(TRUE, plugin->ClientX509Certificate, plugin, pdata, custom);
174 case HOOK_TYPE_CLIENT_LOGIN_FAILURE:
175 ok = IFCALLRESULT(TRUE, plugin->ClientLoginFailure, plugin, pdata, custom);
178 case HOOK_TYPE_CLIENT_END_PAINT:
179 ok = IFCALLRESULT(TRUE, plugin->ClientEndPaint, plugin, pdata, custom);
182 case HOOK_TYPE_CLIENT_LOAD_CHANNELS:
183 ok = IFCALLRESULT(TRUE, plugin->ClientLoadChannels, plugin, pdata, custom);
186 case HOOK_TYPE_SERVER_POST_CONNECT:
187 ok = IFCALLRESULT(TRUE, plugin->ServerPostConnect, plugin, pdata, custom);
190 case HOOK_TYPE_SERVER_ACTIVATE:
191 ok = IFCALLRESULT(TRUE, plugin->ServerPeerActivate, plugin, pdata, custom);
194 case HOOK_TYPE_SERVER_CHANNELS_INIT:
195 ok = IFCALLRESULT(TRUE, plugin->ServerChannelsInit, plugin, pdata, custom);
198 case HOOK_TYPE_SERVER_CHANNELS_FREE:
199 ok = IFCALLRESULT(TRUE, plugin->ServerChannelsFree, plugin, pdata, custom);
202 case HOOK_TYPE_SERVER_SESSION_END:
203 ok = IFCALLRESULT(TRUE, plugin->ServerSessionEnd, plugin, pdata, custom);
206 case HOOK_TYPE_SERVER_SESSION_INITIALIZE:
207 ok = IFCALLRESULT(TRUE, plugin->ServerSessionInitialize, plugin, pdata, custom);
210 case HOOK_TYPE_SERVER_SESSION_STARTED:
211 ok = IFCALLRESULT(TRUE, plugin->ServerSessionStarted, plugin, pdata, custom);
216 WLog_ERR(TAG,
"invalid hook called");
221 WLog_INFO(TAG,
"plugin %s, hook %s failed!", plugin->name,
222 pf_modules_get_hook_type_string(type));
234BOOL pf_modules_run_hook(proxyModule* module, PF_HOOK_TYPE type, proxyData* pdata,
void* custom)
236 WINPR_ASSERT(module);
237 WINPR_ASSERT(module->plugins);
238 return ArrayList_ForEach(module->plugins, pf_modules_proxy_ArrayList_ForEachFkt, type, pdata,
242static BOOL pf_modules_ArrayList_ForEachFkt(
void* data,
size_t index, va_list ap)
244 proxyPlugin* plugin = (proxyPlugin*)data;
249 PF_FILTER_TYPE type = va_arg(ap, PF_FILTER_TYPE);
250 proxyData* pdata = va_arg(ap, proxyData*);
251 void* param = va_arg(ap,
void*);
253 WLog_VRB(TAG,
"running filter: %s", plugin->name);
257 case FILTER_TYPE_KEYBOARD:
258 result = IFCALLRESULT(TRUE, plugin->KeyboardEvent, plugin, pdata, param);
261 case FILTER_TYPE_UNICODE:
262 result = IFCALLRESULT(TRUE, plugin->UnicodeEvent, plugin, pdata, param);
265 case FILTER_TYPE_MOUSE:
266 result = IFCALLRESULT(TRUE, plugin->MouseEvent, plugin, pdata, param);
269 case FILTER_TYPE_MOUSE_EX:
270 result = IFCALLRESULT(TRUE, plugin->MouseExEvent, plugin, pdata, param);
273 case FILTER_TYPE_CLIENT_PASSTHROUGH_CHANNEL_DATA:
274 result = IFCALLRESULT(TRUE, plugin->ClientChannelData, plugin, pdata, param);
277 case FILTER_TYPE_SERVER_PASSTHROUGH_CHANNEL_DATA:
278 result = IFCALLRESULT(TRUE, plugin->ServerChannelData, plugin, pdata, param);
281 case FILTER_TYPE_CLIENT_PASSTHROUGH_CHANNEL_CREATE:
282 result = IFCALLRESULT(TRUE, plugin->ChannelCreate, plugin, pdata, param);
285 case FILTER_TYPE_CLIENT_PASSTHROUGH_DYN_CHANNEL_CREATE:
286 result = IFCALLRESULT(TRUE, plugin->DynamicChannelCreate, plugin, pdata, param);
289 case FILTER_TYPE_SERVER_FETCH_TARGET_ADDR:
290 result = IFCALLRESULT(TRUE, plugin->ServerFetchTargetAddr, plugin, pdata, param);
293 case FILTER_TYPE_SERVER_PEER_LOGON:
294 result = IFCALLRESULT(TRUE, plugin->ServerPeerLogon, plugin, pdata, param);
297 case FILTER_TYPE_INTERCEPT_CHANNEL:
298 result = IFCALLRESULT(TRUE, plugin->DynChannelIntercept, plugin, pdata, param);
301 case FILTER_TYPE_DYN_INTERCEPT_LIST:
302 result = IFCALLRESULT(TRUE, plugin->DynChannelToIntercept, plugin, pdata, param);
305 case FILTER_TYPE_STATIC_INTERCEPT_LIST:
306 result = IFCALLRESULT(TRUE, plugin->StaticChannelToIntercept, plugin, pdata, param);
311 WLog_ERR(TAG,
"invalid filter called");
317 WLog_DBG(TAG,
"plugin %s, filter type [%s] returned FALSE", plugin->name,
318 pf_modules_get_filter_type_string(type));
329BOOL pf_modules_run_filter(proxyModule* module, PF_FILTER_TYPE type, proxyData* pdata,
void* param)
331 WINPR_ASSERT(module);
332 WINPR_ASSERT(module->plugins);
334 return ArrayList_ForEach(module->plugins, pf_modules_ArrayList_ForEachFkt, type, pdata, param);
343static BOOL pf_modules_set_plugin_data(WINPR_ATTR_UNUSED proxyPluginsManager* mgr,
344 const char* plugin_name, proxyData* pdata,
void* data)
352 WINPR_ASSERT(plugin_name);
354 ccharconv.ccp = plugin_name;
358 if (!HashTable_Insert(pdata->modules_info, ccharconv.cp, data))
360 WLog_ERR(TAG,
"[%s]: HashTable_Insert failed!");
374static void* pf_modules_get_plugin_data(WINPR_ATTR_UNUSED proxyPluginsManager* mgr,
375 const char* plugin_name, proxyData* pdata)
382 WINPR_ASSERT(plugin_name);
384 ccharconv.ccp = plugin_name;
386 return HashTable_GetItemValue(pdata->modules_info, ccharconv.cp);
389static void pf_modules_abort_connect(WINPR_ATTR_UNUSED proxyPluginsManager* mgr, proxyData* pdata)
392 WLog_DBG(TAG,
"is called!");
393 proxy_data_abort_connect(pdata);
396static BOOL pf_modules_register_ArrayList_ForEachFkt(
void* data,
size_t index, va_list ap)
398 proxyPlugin* plugin = (proxyPlugin*)data;
399 proxyPlugin* plugin_to_register = va_arg(ap, proxyPlugin*);
403 if (strcmp(plugin->name, plugin_to_register->name) == 0)
405 WLog_ERR(TAG,
"can not register plugin '%s', it is already registered!", plugin->name);
411static BOOL pf_modules_register_plugin(proxyPluginsManager* mgr,
412 const proxyPlugin* plugin_to_register)
414 proxyPlugin internal = { 0 };
415 proxyModule*
module = (proxyModule*)mgr;
416 WINPR_ASSERT(module);
418 if (!plugin_to_register)
421 internal = *plugin_to_register;
425 if (!ArrayList_ForEach(module->plugins, pf_modules_register_ArrayList_ForEachFkt, &internal))
428 if (!ArrayList_Append(module->plugins, &internal))
430 WLog_ERR(TAG,
"failed adding plugin to list: %s", plugin_to_register->name);
433 WLog_INFO(TAG,
"Successfully registered proxy plugin '%s'", plugin_to_register->name);
438static BOOL pf_modules_load_ArrayList_ForEachFkt(
void* data,
size_t index, va_list ap)
440 proxyPlugin* plugin = (proxyPlugin*)data;
441 const char* plugin_name = va_arg(ap,
const char*);
442 BOOL* res = va_arg(ap, BOOL*);
448 if (strcmp(plugin->name, plugin_name) == 0)
453BOOL pf_modules_is_plugin_loaded(proxyModule* module,
const char* plugin_name)
456 WINPR_ASSERT(module);
457 if (ArrayList_Count(module->plugins) < 1)
459 if (!ArrayList_ForEach(module->plugins, pf_modules_load_ArrayList_ForEachFkt, plugin_name, &rc))
464static BOOL pf_modules_print_ArrayList_ForEachFkt(
void* data,
size_t index, va_list ap)
466 proxyPlugin* plugin = (proxyPlugin*)data;
471 WLog_INFO(TAG,
"\tName: %s", plugin->name);
472 WLog_INFO(TAG,
"\tDescription: %s", plugin->description);
476void pf_modules_list_loaded_plugins(proxyModule* module)
480 WINPR_ASSERT(module);
481 WINPR_ASSERT(module->plugins);
483 count = ArrayList_Count(module->plugins);
486 WLog_INFO(TAG,
"Loaded plugins:");
488 ArrayList_ForEach(module->plugins, pf_modules_print_ArrayList_ForEachFkt);
491static BOOL pf_modules_load_static_module(
const char* module_name, proxyModule* module,
494 WINPR_ASSERT(module);
496 HANDLE handle = GetModuleHandleA(NULL);
500 WLog_DBG(TAG,
"failed loading static library: %s", module_name);
504 char name[256] = { 0 };
505 (void)_snprintf(name,
sizeof(name),
"%s_%s", module_name, MODULE_ENTRY_POINT);
506 for (
size_t x = 0; x < strnlen(name,
sizeof(name)); x++)
512 proxyModuleEntryPoint pEntryPoint = GetProcAddressAs(handle, name, proxyModuleEntryPoint);
515 WLog_DBG(TAG,
"GetProcAddress failed for static %s (module %s)", name, module_name);
518 if (!ArrayList_Append(module->handles, handle))
520 WLog_ERR(TAG,
"ArrayList_Append failed!");
523 return pf_modules_add(module, pEntryPoint, userdata);
530static BOOL pf_modules_load_dynamic_module(
const char* module_path, proxyModule* module,
533 if (!winpr_PathFileExists(module_path))
535 WLog_DBG(TAG,
"failed loading external library: file '%s' does not exist", module_path);
539 HANDLE handle = LoadLibraryX(module_path);
543 WLog_DBG(TAG,
"failed loading external library: %s", module_path);
547 proxyModuleEntryPoint pEntryPoint =
548 GetProcAddressAs(handle, MODULE_ENTRY_POINT, proxyModuleEntryPoint);
551 WLog_DBG(TAG,
"GetProcAddress failed while loading %s", module_path);
554 if (!ArrayList_Append(module->handles, handle))
556 WLog_ERR(TAG,
"ArrayList_Append failed!");
559 return pf_modules_add(module, pEntryPoint, userdata);
566static BOOL pf_modules_try_load_dynamic_module(
const char* module_path, proxyModule* module,
567 void* userdata,
size_t count,
const char* names[])
569 for (
size_t x = 0; x < count; x++)
571 const char* name = names[x];
573 char* fullpath = GetCombinedPath(module_path, name);
577 const BOOL rc = pf_modules_load_dynamic_module(fullpath, module, userdata);
585static BOOL pf_modules_load_module(
const char* module_path,
const char* module_name,
586 proxyModule* module,
void* userdata)
588 WINPR_ASSERT(module);
590 if (pf_modules_load_static_module(module_name, module, userdata))
593 char names[5][MAX_PATH] = { 0 };
594 (void)_snprintf(names[0],
sizeof(names[0]),
"proxy-%s-plugin%s", module_name,
595 FREERDP_SHARED_LIBRARY_SUFFIX);
596 (void)_snprintf(names[1],
sizeof(names[1]),
"%sproxy-%s-plugin%s",
597 FREERDP_SHARED_LIBRARY_PREFIX, module_name, FREERDP_SHARED_LIBRARY_SUFFIX);
598 (void)_snprintf(names[2],
sizeof(names[2]),
"%sproxy-%s-plugin%s.%d",
599 FREERDP_SHARED_LIBRARY_PREFIX, module_name, FREERDP_SHARED_LIBRARY_SUFFIX,
600 FREERDP_VERSION_MAJOR);
601 (void)_snprintf(names[3],
sizeof(names[3]),
"%sproxy-%s-plugin%d%s",
602 FREERDP_SHARED_LIBRARY_PREFIX, module_name, FREERDP_VERSION_MAJOR,
603 FREERDP_SHARED_LIBRARY_SUFFIX);
604 (void)_snprintf(names[4],
sizeof(names[4]),
"%sproxy-%s-plugin%d%s.%d",
605 FREERDP_SHARED_LIBRARY_PREFIX, module_name, FREERDP_VERSION_MAJOR,
606 FREERDP_SHARED_LIBRARY_SUFFIX, FREERDP_VERSION_MAJOR);
608 const char* cnames[5] = { names[0], names[1], names[2], names[3], names[4] };
609 return pf_modules_try_load_dynamic_module(module_path, module, userdata, ARRAYSIZE(cnames),
613static void free_handle(
void* obj)
615 HANDLE handle = (HANDLE)obj;
620static void free_plugin(
void* obj)
622 proxyPlugin* plugin = (proxyPlugin*)obj;
623 WINPR_ASSERT(plugin);
625 if (!IFCALLRESULT(TRUE, plugin->PluginUnload, plugin))
626 WLog_WARN(TAG,
"PluginUnload failed for plugin '%s'", plugin->name);
631static void* new_plugin(
const void* obj)
633 const proxyPlugin* src = obj;
634 proxyPlugin* proxy = calloc(1,
sizeof(proxyPlugin));
641proxyModule* pf_modules_new(
const char* root_dir,
const char** modules,
size_t count)
645 proxyModule*
module = calloc(1, sizeof(proxyModule));
649 module->mgr.RegisterPlugin = pf_modules_register_plugin;
650 module->mgr.SetPluginData = pf_modules_set_plugin_data;
651 module->mgr.GetPluginData = pf_modules_get_plugin_data;
652 module->mgr.AbortConnect = pf_modules_abort_connect;
653 module->plugins = ArrayList_New(FALSE);
655 if (module->plugins == NULL)
657 WLog_ERR(TAG,
"ArrayList_New failed!");
660 obj = ArrayList_Object(module->plugins);
663 obj->fnObjectFree = free_plugin;
664 obj->fnObjectNew = new_plugin;
666 module->handles = ArrayList_New(FALSE);
667 if (module->handles == NULL)
670 WLog_ERR(TAG,
"ArrayList_New failed!");
673 ArrayList_Object(module->handles)->fnObjectFree = free_handle;
677 WINPR_ASSERT(root_dir);
678 if (!winpr_PathFileExists(root_dir))
679 path = GetCombinedPath(FREERDP_INSTALL_PREFIX, root_dir);
681 path = _strdup(root_dir);
683 if (!winpr_PathFileExists(path))
685 if (!winpr_PathMakePath(path, NULL))
687 WLog_ERR(TAG,
"error occurred while creating modules directory: %s", root_dir);
691 if (winpr_PathFileExists(path))
692 WLog_DBG(TAG,
"modules root directory: %s", path);
694 for (
size_t i = 0; i < count; i++)
696 const char* module_name = modules[i];
697 if (!pf_modules_load_module(path, module_name, module, NULL))
698 WLog_WARN(TAG,
"Failed to load proxy module '%s'", module_name);
700 WLog_INFO(TAG,
"Successfully loaded proxy module '%s'", module_name);
709 pf_modules_free(module);
713void pf_modules_free(proxyModule* module)
718 ArrayList_Free(module->plugins);
719 ArrayList_Free(module->handles);
723BOOL pf_modules_add(proxyModule* module, proxyModuleEntryPoint ep,
void* userdata)
725 WINPR_ASSERT(module);
728 return ep(&module->mgr, userdata);
This struct contains function pointer to initialize/free objects.