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;
52static const char* pf_modules_get_filter_type_string(PF_FILTER_TYPE result)
56 case FILTER_TYPE_KEYBOARD:
57 return "FILTER_TYPE_KEYBOARD";
58 case FILTER_TYPE_UNICODE:
59 return "FILTER_TYPE_UNICODE";
60 case FILTER_TYPE_MOUSE:
61 return "FILTER_TYPE_MOUSE";
62 case FILTER_TYPE_MOUSE_EX:
63 return "FILTER_TYPE_MOUSE_EX";
64 case FILTER_TYPE_CLIENT_PASSTHROUGH_CHANNEL_DATA:
65 return "FILTER_TYPE_CLIENT_PASSTHROUGH_CHANNEL_DATA";
66 case FILTER_TYPE_SERVER_PASSTHROUGH_CHANNEL_DATA:
67 return "FILTER_TYPE_SERVER_PASSTHROUGH_CHANNEL_DATA";
68 case FILTER_TYPE_CLIENT_PASSTHROUGH_DYN_CHANNEL_CREATE:
69 return "FILTER_TYPE_CLIENT_PASSTHROUGH_DYN_CHANNEL_CREATE";
70 case FILTER_TYPE_SERVER_FETCH_TARGET_ADDR:
71 return "FILTER_TYPE_SERVER_FETCH_TARGET_ADDR";
72 case FILTER_TYPE_SERVER_PEER_LOGON:
73 return "FILTER_TYPE_SERVER_PEER_LOGON";
74 case FILTER_TYPE_CLIENT_PASSTHROUGH_CHANNEL_CREATE:
75 return "FILTER_TYPE_CLIENT_PASSTHROUGH_CHANNEL_CREATE";
76 case FILTER_TYPE_STATIC_INTERCEPT_LIST:
77 return "FILTER_TYPE_STATIC_INTERCEPT_LIST";
78 case FILTER_TYPE_DYN_INTERCEPT_LIST:
79 return "FILTER_TYPE_DYN_INTERCEPT_LIST";
80 case FILTER_TYPE_INTERCEPT_CHANNEL:
81 return "FILTER_TYPE_INTERCEPT_CHANNEL";
85 return "FILTER_UNKNOWN";
90static const char* pf_modules_get_hook_type_string(PF_HOOK_TYPE result)
94 case HOOK_TYPE_CLIENT_INIT_CONNECT:
95 return "HOOK_TYPE_CLIENT_INIT_CONNECT";
96 case HOOK_TYPE_CLIENT_UNINIT_CONNECT:
97 return "HOOK_TYPE_CLIENT_UNINIT_CONNECT";
98 case HOOK_TYPE_CLIENT_PRE_CONNECT:
99 return "HOOK_TYPE_CLIENT_PRE_CONNECT";
100 case HOOK_TYPE_CLIENT_POST_CONNECT:
101 return "HOOK_TYPE_CLIENT_POST_CONNECT";
102 case HOOK_TYPE_CLIENT_POST_DISCONNECT:
103 return "HOOK_TYPE_CLIENT_POST_DISCONNECT";
104 case HOOK_TYPE_CLIENT_REDIRECT:
105 return "HOOK_TYPE_CLIENT_REDIRECT";
106 case HOOK_TYPE_CLIENT_VERIFY_X509:
107 return "HOOK_TYPE_CLIENT_VERIFY_X509";
108 case HOOK_TYPE_CLIENT_LOGIN_FAILURE:
109 return "HOOK_TYPE_CLIENT_LOGIN_FAILURE";
110 case HOOK_TYPE_CLIENT_END_PAINT:
111 return "HOOK_TYPE_CLIENT_END_PAINT";
112 case HOOK_TYPE_SERVER_POST_CONNECT:
113 return "HOOK_TYPE_SERVER_POST_CONNECT";
114 case HOOK_TYPE_SERVER_ACTIVATE:
115 return "HOOK_TYPE_SERVER_ACTIVATE";
116 case HOOK_TYPE_SERVER_CHANNELS_INIT:
117 return "HOOK_TYPE_SERVER_CHANNELS_INIT";
118 case HOOK_TYPE_SERVER_CHANNELS_FREE:
119 return "HOOK_TYPE_SERVER_CHANNELS_FREE";
120 case HOOK_TYPE_SERVER_SESSION_END:
121 return "HOOK_TYPE_SERVER_SESSION_END";
122 case HOOK_TYPE_CLIENT_LOAD_CHANNELS:
123 return "HOOK_TYPE_CLIENT_LOAD_CHANNELS";
124 case HOOK_TYPE_SERVER_SESSION_INITIALIZE:
125 return "HOOK_TYPE_SERVER_SESSION_INITIALIZE";
126 case HOOK_TYPE_SERVER_SESSION_STARTED:
127 return "HOOK_TYPE_SERVER_SESSION_STARTED";
131 return "HOOK_TYPE_UNKNOWN";
136static BOOL pf_modules_proxy_ArrayList_ForEachFkt(
void* data,
size_t index, va_list ap)
138 proxyPlugin* plugin = (proxyPlugin*)data;
143 PF_HOOK_TYPE type = va_arg(ap, PF_HOOK_TYPE);
144 proxyData* pdata = va_arg(ap, proxyData*);
145 void* custom = va_arg(ap,
void*);
147 WLog_VRB(TAG,
"running hook %s.%s", plugin->name, pf_modules_get_hook_type_string(type));
151 case HOOK_TYPE_CLIENT_INIT_CONNECT:
152 ok = IFCALLRESULT(TRUE, plugin->ClientInitConnect, plugin, pdata, custom);
154 case HOOK_TYPE_CLIENT_UNINIT_CONNECT:
155 ok = IFCALLRESULT(TRUE, plugin->ClientUninitConnect, plugin, pdata, custom);
157 case HOOK_TYPE_CLIENT_PRE_CONNECT:
158 ok = IFCALLRESULT(TRUE, plugin->ClientPreConnect, plugin, pdata, custom);
161 case HOOK_TYPE_CLIENT_POST_CONNECT:
162 ok = IFCALLRESULT(TRUE, plugin->ClientPostConnect, plugin, pdata, custom);
165 case HOOK_TYPE_CLIENT_REDIRECT:
166 ok = IFCALLRESULT(TRUE, plugin->ClientRedirect, plugin, pdata, custom);
169 case HOOK_TYPE_CLIENT_POST_DISCONNECT:
170 ok = IFCALLRESULT(TRUE, plugin->ClientPostDisconnect, plugin, pdata, custom);
173 case HOOK_TYPE_CLIENT_VERIFY_X509:
174 ok = IFCALLRESULT(TRUE, plugin->ClientX509Certificate, plugin, pdata, custom);
177 case HOOK_TYPE_CLIENT_LOGIN_FAILURE:
178 ok = IFCALLRESULT(TRUE, plugin->ClientLoginFailure, plugin, pdata, custom);
181 case HOOK_TYPE_CLIENT_END_PAINT:
182 ok = IFCALLRESULT(TRUE, plugin->ClientEndPaint, plugin, pdata, custom);
185 case HOOK_TYPE_CLIENT_LOAD_CHANNELS:
186 ok = IFCALLRESULT(TRUE, plugin->ClientLoadChannels, plugin, pdata, custom);
189 case HOOK_TYPE_SERVER_POST_CONNECT:
190 ok = IFCALLRESULT(TRUE, plugin->ServerPostConnect, plugin, pdata, custom);
193 case HOOK_TYPE_SERVER_ACTIVATE:
194 ok = IFCALLRESULT(TRUE, plugin->ServerPeerActivate, plugin, pdata, custom);
197 case HOOK_TYPE_SERVER_CHANNELS_INIT:
198 ok = IFCALLRESULT(TRUE, plugin->ServerChannelsInit, plugin, pdata, custom);
201 case HOOK_TYPE_SERVER_CHANNELS_FREE:
202 ok = IFCALLRESULT(TRUE, plugin->ServerChannelsFree, plugin, pdata, custom);
205 case HOOK_TYPE_SERVER_SESSION_END:
206 ok = IFCALLRESULT(TRUE, plugin->ServerSessionEnd, plugin, pdata, custom);
209 case HOOK_TYPE_SERVER_SESSION_INITIALIZE:
210 ok = IFCALLRESULT(TRUE, plugin->ServerSessionInitialize, plugin, pdata, custom);
213 case HOOK_TYPE_SERVER_SESSION_STARTED:
214 ok = IFCALLRESULT(TRUE, plugin->ServerSessionStarted, plugin, pdata, custom);
219 WLog_ERR(TAG,
"invalid hook called");
224 WLog_INFO(TAG,
"plugin %s, hook %s failed!", plugin->name,
225 pf_modules_get_hook_type_string(type));
237BOOL pf_modules_run_hook(proxyModule* module, PF_HOOK_TYPE type, proxyData* pdata,
void* custom)
239 WINPR_ASSERT(module);
240 WINPR_ASSERT(module->plugins);
241 return ArrayList_ForEach(module->plugins, pf_modules_proxy_ArrayList_ForEachFkt, type, pdata,
246static BOOL pf_modules_ArrayList_ForEachFkt(
void* data,
size_t index, va_list ap)
248 proxyPlugin* plugin = (proxyPlugin*)data;
253 PF_FILTER_TYPE type = va_arg(ap, PF_FILTER_TYPE);
254 proxyData* pdata = va_arg(ap, proxyData*);
255 void* param = va_arg(ap,
void*);
257 WLog_VRB(TAG,
"running filter: %s", plugin->name);
261 case FILTER_TYPE_KEYBOARD:
262 result = IFCALLRESULT(TRUE, plugin->KeyboardEvent, plugin, pdata, param);
265 case FILTER_TYPE_UNICODE:
266 result = IFCALLRESULT(TRUE, plugin->UnicodeEvent, plugin, pdata, param);
269 case FILTER_TYPE_MOUSE:
270 result = IFCALLRESULT(TRUE, plugin->MouseEvent, plugin, pdata, param);
273 case FILTER_TYPE_MOUSE_EX:
274 result = IFCALLRESULT(TRUE, plugin->MouseExEvent, plugin, pdata, param);
277 case FILTER_TYPE_CLIENT_PASSTHROUGH_CHANNEL_DATA:
278 result = IFCALLRESULT(TRUE, plugin->ClientChannelData, plugin, pdata, param);
281 case FILTER_TYPE_SERVER_PASSTHROUGH_CHANNEL_DATA:
282 result = IFCALLRESULT(TRUE, plugin->ServerChannelData, plugin, pdata, param);
285 case FILTER_TYPE_CLIENT_PASSTHROUGH_CHANNEL_CREATE:
286 result = IFCALLRESULT(TRUE, plugin->ChannelCreate, plugin, pdata, param);
289 case FILTER_TYPE_CLIENT_PASSTHROUGH_DYN_CHANNEL_CREATE:
290 result = IFCALLRESULT(TRUE, plugin->DynamicChannelCreate, plugin, pdata, param);
293 case FILTER_TYPE_SERVER_FETCH_TARGET_ADDR:
294 result = IFCALLRESULT(TRUE, plugin->ServerFetchTargetAddr, plugin, pdata, param);
297 case FILTER_TYPE_SERVER_PEER_LOGON:
298 result = IFCALLRESULT(TRUE, plugin->ServerPeerLogon, plugin, pdata, param);
301 case FILTER_TYPE_INTERCEPT_CHANNEL:
302 result = IFCALLRESULT(TRUE, plugin->DynChannelIntercept, plugin, pdata, param);
305 case FILTER_TYPE_DYN_INTERCEPT_LIST:
306 result = IFCALLRESULT(TRUE, plugin->DynChannelToIntercept, plugin, pdata, param);
309 case FILTER_TYPE_STATIC_INTERCEPT_LIST:
310 result = IFCALLRESULT(TRUE, plugin->StaticChannelToIntercept, plugin, pdata, param);
315 WLog_ERR(TAG,
"invalid filter called");
321 WLog_DBG(TAG,
"plugin %s, filter type [%s] returned FALSE", plugin->name,
322 pf_modules_get_filter_type_string(type));
333BOOL pf_modules_run_filter(proxyModule* module, PF_FILTER_TYPE type, proxyData* pdata,
void* param)
335 WINPR_ASSERT(module);
336 WINPR_ASSERT(module->plugins);
338 return ArrayList_ForEach(module->plugins, pf_modules_ArrayList_ForEachFkt, type, pdata, param);
348static BOOL pf_modules_set_plugin_data(WINPR_ATTR_UNUSED proxyPluginsManager* mgr,
349 const char* plugin_name, proxyData* pdata,
void* data)
357 WINPR_ASSERT(plugin_name);
359 ccharconv.ccp = plugin_name;
363 if (!HashTable_Insert(pdata->modules_info, ccharconv.cp, data))
365 WLog_ERR(TAG,
"HashTable_Insert failed!");
380static void* pf_modules_get_plugin_data(WINPR_ATTR_UNUSED proxyPluginsManager* mgr,
381 const char* plugin_name, proxyData* pdata)
388 WINPR_ASSERT(plugin_name);
390 ccharconv.ccp = plugin_name;
392 return HashTable_GetItemValue(pdata->modules_info, ccharconv.cp);
395static void pf_modules_abort_connect(WINPR_ATTR_UNUSED proxyPluginsManager* mgr, proxyData* pdata)
398 WLog_DBG(TAG,
"is called!");
399 proxy_data_abort_connect(pdata);
403static BOOL pf_modules_register_ArrayList_ForEachFkt(
void* data,
size_t index, va_list ap)
405 proxyPlugin* plugin = (proxyPlugin*)data;
406 proxyPlugin* plugin_to_register = va_arg(ap, proxyPlugin*);
410 if (strcmp(plugin->name, plugin_to_register->name) == 0)
412 WLog_ERR(TAG,
"can not register plugin '%s', it is already registered!", plugin->name);
419static BOOL pf_modules_register_plugin(proxyPluginsManager* mgr,
420 const proxyPlugin* plugin_to_register)
422 proxyPlugin internal = WINPR_C_ARRAY_INIT;
423 proxyModule*
module = (proxyModule*)mgr;
424 WINPR_ASSERT(module);
426 if (!plugin_to_register)
429 internal = *plugin_to_register;
433 if (!ArrayList_ForEach(module->plugins, pf_modules_register_ArrayList_ForEachFkt, &internal))
436 if (!ArrayList_Append(module->plugins, &internal))
438 WLog_ERR(TAG,
"failed adding plugin to list: %s", plugin_to_register->name);
441 WLog_INFO(TAG,
"Successfully registered proxy plugin '%s'", plugin_to_register->name);
447static BOOL pf_modules_load_ArrayList_ForEachFkt(
void* data,
size_t index, va_list ap)
449 proxyPlugin* plugin = (proxyPlugin*)data;
450 const char* plugin_name = va_arg(ap,
const char*);
451 BOOL* res = va_arg(ap, BOOL*);
457 if (strcmp(plugin->name, plugin_name) == 0)
462BOOL pf_modules_is_plugin_loaded(proxyModule* module,
const char* plugin_name)
465 WINPR_ASSERT(module);
466 if (ArrayList_Count(module->plugins) < 1)
468 if (!ArrayList_ForEach(module->plugins, pf_modules_load_ArrayList_ForEachFkt, plugin_name, &rc))
474static BOOL pf_modules_print_ArrayList_ForEachFkt(
void* data,
size_t index, va_list ap)
476 proxyPlugin* plugin = (proxyPlugin*)data;
481 WLog_INFO(TAG,
"\tName: %s", plugin->name);
482 WLog_INFO(TAG,
"\tDescription: %s", plugin->description);
486void pf_modules_list_loaded_plugins(proxyModule* module)
490 WINPR_ASSERT(module);
491 WINPR_ASSERT(module->plugins);
493 count = ArrayList_Count(module->plugins);
496 WLog_INFO(TAG,
"Loaded plugins:");
498 ArrayList_ForEach(module->plugins, pf_modules_print_ArrayList_ForEachFkt);
502static BOOL pf_modules_load_static_module(
const char* module_name, proxyModule* module,
505 WINPR_ASSERT(module);
507 HANDLE handle = GetModuleHandleA(
nullptr);
509 if (handle ==
nullptr)
511 WLog_DBG(TAG,
"failed loading static library: %s", module_name);
515 char name[256] = WINPR_C_ARRAY_INIT;
516 (void)_snprintf(name,
sizeof(name),
"%s_%s", module_name, MODULE_ENTRY_POINT);
517 for (
size_t x = 0; x < strnlen(name,
sizeof(name)); x++)
523 proxyModuleEntryPoint pEntryPoint = GetProcAddressAs(handle, name, proxyModuleEntryPoint);
526 WLog_DBG(TAG,
"GetProcAddress failed for static %s (module %s)", name, module_name);
529 if (!ArrayList_Append(module->handles, handle))
531 WLog_ERR(TAG,
"ArrayList_Append failed!");
534 return pf_modules_add(module, pEntryPoint, userdata);
542static BOOL pf_modules_load_dynamic_module(
const char* module_path, proxyModule* module,
545 if (!winpr_PathFileExists(module_path))
547 WLog_DBG(TAG,
"failed loading external library: file '%s' does not exist", module_path);
551 HANDLE handle = LoadLibraryX(module_path);
553 if (handle ==
nullptr)
555 WLog_DBG(TAG,
"failed loading external library: %s", module_path);
559 proxyModuleEntryPoint pEntryPoint =
560 GetProcAddressAs(handle, MODULE_ENTRY_POINT, proxyModuleEntryPoint);
563 WLog_DBG(TAG,
"GetProcAddress failed while loading %s", module_path);
566 if (!ArrayList_Append(module->handles, handle))
568 WLog_ERR(TAG,
"ArrayList_Append failed!");
571 return pf_modules_add(module, pEntryPoint, userdata);
579static BOOL pf_modules_try_load_dynamic_module(
const char* module_path, proxyModule* module,
580 void* userdata,
size_t count,
const char* names[])
582 for (
size_t x = 0; x < count; x++)
584 const char* name = names[x];
586 char* fullpath = GetCombinedPath(module_path, name);
590 const BOOL rc = pf_modules_load_dynamic_module(fullpath, module, userdata);
599static BOOL pf_modules_load_module(
const char* module_path,
const char* module_name,
600 proxyModule* module,
void* userdata)
602 WINPR_ASSERT(module);
604 if (pf_modules_load_static_module(module_name, module, userdata))
607 char names[5][MAX_PATH] = WINPR_C_ARRAY_INIT;
608 (void)_snprintf(names[0],
sizeof(names[0]),
"proxy-%s-plugin%s", module_name,
609 FREERDP_SHARED_LIBRARY_SUFFIX);
610 (void)_snprintf(names[1],
sizeof(names[1]),
"%sproxy-%s-plugin%s",
611 FREERDP_SHARED_LIBRARY_PREFIX, module_name, FREERDP_SHARED_LIBRARY_SUFFIX);
612 (void)_snprintf(names[2],
sizeof(names[2]),
"%sproxy-%s-plugin%s.%d",
613 FREERDP_SHARED_LIBRARY_PREFIX, module_name, FREERDP_SHARED_LIBRARY_SUFFIX,
614 FREERDP_VERSION_MAJOR);
615 (void)_snprintf(names[3],
sizeof(names[3]),
"%sproxy-%s-plugin%d%s",
616 FREERDP_SHARED_LIBRARY_PREFIX, module_name, FREERDP_VERSION_MAJOR,
617 FREERDP_SHARED_LIBRARY_SUFFIX);
618 (void)_snprintf(names[4],
sizeof(names[4]),
"%sproxy-%s-plugin%d%s.%d",
619 FREERDP_SHARED_LIBRARY_PREFIX, module_name, FREERDP_VERSION_MAJOR,
620 FREERDP_SHARED_LIBRARY_SUFFIX, FREERDP_VERSION_MAJOR);
622 const char* cnames[5] = { names[0], names[1], names[2], names[3], names[4] };
623 return pf_modules_try_load_dynamic_module(module_path, module, userdata, ARRAYSIZE(cnames),
627static void free_handle(
void* obj)
629 HANDLE handle = (HANDLE)obj;
634static void free_plugin(
void* obj)
636 proxyPlugin* plugin = (proxyPlugin*)obj;
637 WINPR_ASSERT(plugin);
639 if (!IFCALLRESULT(TRUE, plugin->PluginUnload, plugin))
640 WLog_WARN(TAG,
"PluginUnload failed for plugin '%s'", plugin->name);
645WINPR_ATTR_MALLOC(free_plugin, 1)
647static
void* new_plugin(const
void* obj)
649 const proxyPlugin* src = obj;
650 proxyPlugin* proxy = calloc(1,
sizeof(proxyPlugin));
657proxyModule* pf_modules_new(
const char* root_dir,
const char** modules,
size_t count)
660 char* path =
nullptr;
661 proxyModule*
module = calloc(1, sizeof(proxyModule));
665 module->mgr.RegisterPlugin = pf_modules_register_plugin;
666 module->mgr.SetPluginData = pf_modules_set_plugin_data;
667 module->mgr.GetPluginData = pf_modules_get_plugin_data;
668 module->mgr.AbortConnect = pf_modules_abort_connect;
669 module->plugins = ArrayList_New(FALSE);
671 if (module->plugins ==
nullptr)
673 WLog_ERR(TAG,
"ArrayList_New failed!");
676 obj = ArrayList_Object(module->plugins);
682 module->handles = ArrayList_New(FALSE);
683 if (module->handles ==
nullptr)
686 WLog_ERR(TAG,
"ArrayList_New failed!");
689 ArrayList_Object(module->handles)->
fnObjectFree = free_handle;
693 WINPR_ASSERT(root_dir);
694 if (!winpr_PathFileExists(root_dir))
695 path = GetCombinedPath(FREERDP_INSTALL_PREFIX, root_dir);
697 path = _strdup(root_dir);
699 if (!winpr_PathFileExists(path))
701 if (!winpr_PathMakePath(path,
nullptr))
703 WLog_ERR(TAG,
"error occurred while creating modules directory: %s", root_dir);
707 if (winpr_PathFileExists(path))
708 WLog_DBG(TAG,
"modules root directory: %s", path);
710 for (
size_t i = 0; i < count; i++)
712 const char* module_name = modules[i];
713 if (!pf_modules_load_module(path, module_name, module,
nullptr))
714 WLog_WARN(TAG,
"Failed to load proxy module '%s'", module_name);
716 WLog_INFO(TAG,
"Successfully loaded proxy module '%s'", module_name);
725 pf_modules_free(module);
729void pf_modules_free(proxyModule* module)
734 ArrayList_Free(module->plugins);
735 ArrayList_Free(module->handles);
739BOOL pf_modules_add(proxyModule* module, proxyModuleEntryPoint ep,
void* userdata)
741 WINPR_ASSERT(module);
744 return ep(&module->mgr, userdata);
This struct contains function pointer to initialize/free objects.
OBJECT_FREE_FN fnObjectFree
OBJECT_NEW_FN fnObjectNew