[runtime] Require C# namespace to be quoted.
[mono-project.git] / mono / metadata / security-core-clr.c
blobfab9cb946b013e0441ed99896a543656a8b47b48
1 /*
2 * security-core-clr.c: CoreCLR security
4 * Authors:
5 * Mark Probst <mark.probst@gmail.com>
6 * Sebastien Pouliot <sebastien@ximian.com>
8 * Copyright 2007-2010 Novell, Inc (http://www.novell.com)
9 * Licensed under the MIT license. See LICENSE file in the project root for full license information.
12 #include <mono/metadata/class-internals.h>
13 #include <mono/metadata/security-manager.h>
14 #include <mono/metadata/assembly.h>
15 #include <mono/metadata/appdomain.h>
16 #include <mono/metadata/verify-internals.h>
17 #include <mono/metadata/object.h>
18 #include <mono/metadata/exception.h>
19 #include <mono/metadata/debug-helpers.h>
20 #include <mono/utils/mono-logger-internals.h>
22 #include "security-core-clr.h"
24 gboolean mono_security_core_clr_test = FALSE;
26 static MonoSecurityCoreCLROptions security_core_clr_options = MONO_SECURITY_CORE_CLR_OPTIONS_DEFAULT;
28 /**
29 * mono_security_core_clr_set_options:
30 * @options: the new options for the coreclr system to use
32 * By default, the CoreCLRs security model forbids execution trough reflection of methods not visible from the calling code.
33 * Even if the method being called is not in a platform assembly. For non moonlight CoreCLR users this restriction does not
34 * make a lot of sense, since the author could have just changed the non platform assembly to allow the method to be called.
35 * This function allows specific relaxations from the default behaviour to be set.
37 * Use MONO_SECURITY_CORE_CLR_OPTIONS_DEFAULT for the default coreclr coreclr behaviour as used in Moonlight.
39 * Use MONO_SECURITY_CORE_CLR_OPTIONS_RELAX_REFLECTION to allow transparent code to execute methods and access
40 * fields that are not in platformcode, even if those methods and fields are private or otherwise not visible to the calling code.
42 * Use MONO_SECURITY_CORE_CLR_OPTIONS_RELAX_DELEGATE to allow delegates to be created that point at methods that are not in
43 * platformcode even if those methods and fields are private or otherwise not visible to the calling code.
46 void
47 mono_security_core_clr_set_options (MonoSecurityCoreCLROptions options) {
48 security_core_clr_options = options;
51 /**
52 * mono_security_core_clr_get_options:
54 * Retrieves the current options used by the coreclr system.
57 MonoSecurityCoreCLROptions
58 mono_security_core_clr_get_options ()
60 return security_core_clr_options;
64 * default_platform_check:
66 * Default platform check. Always TRUE for current corlib (minimum
67 * trust-able subset) otherwise return FALSE. Any real CoreCLR host
68 * should provide its own callback to define platform code (i.e.
69 * this default is meant for test only).
71 static gboolean
72 default_platform_check (const char *image_name)
74 if (mono_defaults.corlib) {
75 return (strcmp (mono_defaults.corlib->name, image_name) == 0);
76 } else {
77 /* this can get called even before we load corlib (e.g. the EXE itself) */
78 const char *corlib = "mscorlib.dll";
79 int ilen = strlen (image_name);
80 int clen = strlen (corlib);
81 return ((ilen >= clen) && (strcmp ("mscorlib.dll", image_name + ilen - clen) == 0));
85 static MonoCoreClrPlatformCB platform_callback = default_platform_check;
88 * mono_security_core_clr_determine_platform_image:
90 * Call the supplied callback (from mono_security_set_core_clr_platform_callback)
91 * to determine if this image represents platform code.
93 gboolean
94 mono_security_core_clr_determine_platform_image (MonoImage *image)
96 return platform_callback (image->name);
100 * mono_security_set_core_clr_platform_callback:
102 * Set the callback function that will be used to determine if an image
103 * is part, or not, of the platform code.
105 void
106 mono_security_set_core_clr_platform_callback (MonoCoreClrPlatformCB callback)
108 platform_callback = callback;
112 * mono_security_core_clr_is_platform_image:
114 * Return the (cached) boolean value indicating if this image represent platform code
116 gboolean
117 mono_security_core_clr_is_platform_image (MonoImage *image)
119 return image->core_clr_platform_code;
122 /* Note: The above functions are outside this guard so that the public API isn't affected. */
124 #ifndef DISABLE_SECURITY
126 /* Class lazy loading functions */
127 static GENERATE_GET_CLASS_WITH_CACHE (security_critical, "System.Security", "SecurityCriticalAttribute")
128 static GENERATE_GET_CLASS_WITH_CACHE (security_safe_critical, "System.Security", "SecuritySafeCriticalAttribute")
130 static MonoClass*
131 security_critical_attribute (void)
133 return mono_class_get_security_critical_class ();
136 static MonoClass*
137 security_safe_critical_attribute (void)
139 return mono_class_get_security_safe_critical_class ();
143 /* sometime we get a NULL (not found) caller (e.g. get_reflection_caller) */
144 static char*
145 get_method_full_name (MonoMethod * method)
147 return method ? mono_method_full_name (method, TRUE) : g_strdup ("'no caller found'");
151 * set_type_load_exception_type
153 * Set MONO_EXCEPTION_TYPE_LOAD on the specified 'class' and provide
154 * a descriptive message for the exception. This message is also,
155 * optionally, being logged (export MONO_LOG_MASK="security") for
156 * debugging purposes.
158 static void
159 set_type_load_exception_type (const char *format, MonoClass *klass)
161 char *type_name = mono_type_get_full_name (klass);
162 char *parent_name = mono_type_get_full_name (klass->parent);
163 char *message = mono_image_strdup_printf (klass->image, format, type_name, parent_name);
165 g_free (parent_name);
166 g_free (type_name);
168 mono_trace (G_LOG_LEVEL_WARNING, MONO_TRACE_SECURITY, "%s", message);
169 mono_class_set_type_load_failure (klass, "%s", message);
170 // note: do not free string given to mono_class_set_failure
174 * set_type_load_exception_methods
176 * Set MONO_EXCEPTION_TYPE_LOAD on the 'override' class and provide
177 * a descriptive message for the exception. This message is also,
178 * optionally, being logged (export MONO_LOG_MASK="security") for
179 * debugging purposes.
181 static void
182 set_type_load_exception_methods (const char *format, MonoMethod *override, MonoMethod *base)
184 char *method_name = get_method_full_name (override);
185 char *base_name = get_method_full_name (base);
186 char *message = mono_image_strdup_printf (override->klass->image, format, method_name, base_name);
188 g_free (base_name);
189 g_free (method_name);
191 mono_trace (G_LOG_LEVEL_WARNING, MONO_TRACE_SECURITY, "%s", message);
192 mono_class_set_type_load_failure (override->klass, "%s", message);
193 // note: do not free string given to mono_class_set_failure
196 /* MonoClass is not fully initialized (inited is not yet == 1) when we
197 * check the inheritance rules so we need to look for the default ctor
198 * ourselve to avoid recursion (and aborting)
200 static MonoMethod*
201 get_default_ctor (MonoClass *klass)
203 int i;
205 mono_class_setup_methods (klass);
206 if (!klass->methods)
207 return NULL;
209 int mcount = mono_class_get_method_count (klass);
210 for (i = 0; i < mcount; ++i) {
211 MonoMethodSignature *sig;
212 MonoMethod *method = klass->methods [i];
214 if (!method)
215 continue;
217 if ((method->flags & METHOD_ATTRIBUTE_SPECIAL_NAME) == 0)
218 continue;
219 if ((method->name[0] != '.') || strcmp (".ctor", method->name))
220 continue;
221 sig = mono_method_signature (method);
222 if (sig && (sig->param_count == 0))
223 return method;
226 return NULL;
230 * mono_security_core_clr_check_inheritance:
232 * Determine if the specified class can inherit from its parent using
233 * the CoreCLR inheritance rules.
235 * Base Type Allow Derived Type
236 * ------------ ------------------
237 * Transparent Transparent, SafeCritical, Critical
238 * SafeCritical SafeCritical, Critical
239 * Critical Critical
241 * Reference: http://msdn.microsoft.com/en-us/magazine/cc765416.aspx#id0190030
243 * Furthermore a class MUST have a default constructor if its base
244 * class has a non-transparent, public or protected, default constructor.
245 * The same inheritance rule applies to both default constructors.
247 * Reference: message from a SecurityException in SL4RC
248 * Reference: fxcop CA2132 rule
250 void
251 mono_security_core_clr_check_inheritance (MonoClass *klass)
253 MonoSecurityCoreCLRLevel class_level, parent_level;
254 MonoClass *parent = klass->parent;
256 if (!parent)
257 return;
259 class_level = mono_security_core_clr_class_level (klass);
260 parent_level = mono_security_core_clr_class_level (parent);
262 if (class_level < parent_level) {
263 set_type_load_exception_type (
264 "Inheritance failure for type %s. Parent class %s is more restricted.",
265 klass);
266 } else {
267 MonoMethod *parent_ctor = get_default_ctor (parent);
268 if (parent_ctor && ((parent_ctor->flags & METHOD_ATTRIBUTE_PUBLIC) != 0)) {
269 class_level = mono_security_core_clr_method_level (get_default_ctor (klass), FALSE);
270 parent_level = mono_security_core_clr_method_level (parent_ctor, FALSE);
271 if (class_level < parent_level) {
272 set_type_load_exception_type (
273 "Inheritance failure for type %s. Default constructor security mismatch with %s.",
274 klass);
281 * mono_security_core_clr_check_override:
283 * Determine if the specified override can "legally" override the
284 * specified base method using the CoreCLR inheritance rules.
286 * Base (virtual/interface) Allowed override
287 * ------------------------ -------------------------
288 * Transparent Transparent, SafeCritical
289 * SafeCritical Transparent, SafeCritical
290 * Critical Critical
292 * Reference: http://msdn.microsoft.com/en-us/magazine/cc765416.aspx#id0190030
294 void
295 mono_security_core_clr_check_override (MonoClass *klass, MonoMethod *override, MonoMethod *base)
297 MonoSecurityCoreCLRLevel base_level = mono_security_core_clr_method_level (base, FALSE);
298 MonoSecurityCoreCLRLevel override_level = mono_security_core_clr_method_level (override, FALSE);
299 /* if the base method is decorated with [SecurityCritical] then the overrided method MUST be too */
300 if (base_level == MONO_SECURITY_CORE_CLR_CRITICAL) {
301 if (override_level != MONO_SECURITY_CORE_CLR_CRITICAL) {
302 set_type_load_exception_methods (
303 "Override failure for %s over %s. Override MUST be [SecurityCritical].",
304 override, base);
306 } else {
307 /* base is [SecuritySafeCritical] or [SecurityTransparent], override MUST NOT be [SecurityCritical] */
308 if (override_level == MONO_SECURITY_CORE_CLR_CRITICAL) {
309 set_type_load_exception_methods (
310 "Override failure for %s over %s. Override must NOT be [SecurityCritical].",
311 override, base);
317 * get_caller_no_reflection_related:
319 * Find the first managed caller that is either:
320 * (a) located outside the platform code assemblies; or
321 * (b) not related to reflection and delegates
323 * Returns TRUE to stop the stackwalk, FALSE to continue to the next frame.
325 static gboolean
326 get_caller_no_reflection_related (MonoMethod *m, gint32 no, gint32 ilo, gboolean managed, gpointer data)
328 MonoMethod **dest = (MonoMethod **)data;
329 const char *ns;
331 /* skip unmanaged frames */
332 if (!managed)
333 return FALSE;
335 if (m->wrapper_type != MONO_WRAPPER_NONE)
336 return FALSE;
338 /* quick out (any namespace not starting with an 'S' */
339 ns = m->klass->name_space;
340 if (!ns || (*ns != 'S')) {
341 *dest = m;
342 return TRUE;
345 /* stop if the method is not part of platform code */
346 if (!mono_security_core_clr_is_platform_image (m->klass->image)) {
347 *dest = m;
348 return TRUE;
351 /* any number of calls inside System.Reflection are allowed */
352 if (strcmp (ns, "System.Reflection") == 0)
353 return FALSE;
355 /* any number of calls inside System.Reflection are allowed */
356 if (strcmp (ns, "System.Reflection.Emit") == 0)
357 return FALSE;
359 /* calls from System.Delegate are also possible and allowed */
360 if (strcmp (ns, "System") == 0) {
361 const char *kname = m->klass->name;
362 if ((*kname == 'A') && (strcmp (kname, "Activator") == 0))
363 return FALSE;
365 /* unlike most Invoke* cases InvokeMember is not inside System.Reflection[.Emit] but is SecuritySafeCritical */
366 if (((*kname == 'T') && (strcmp (kname, "Type") == 0)) ||
367 ((*kname == 'R') && (strcmp (kname, "RuntimeType")) == 0)) {
369 /* if calling InvokeMember then we can't stop the stackwalk here and need to look at the caller */
370 if (strcmp (m->name, "InvokeMember") == 0)
371 return FALSE;
374 /* the security check on the delegate is made at creation time, not at invoke time */
375 if (((*kname == 'D') && (strcmp (kname, "Delegate") == 0)) ||
376 ((*kname == 'M') && (strcmp (kname, "MulticastDelegate")) == 0)) {
378 /* if we're invoking then we can stop our stack walk */
379 if (strcmp (m->name, "DynamicInvoke") != 0)
380 return FALSE;
384 if (m == *dest) {
385 *dest = NULL;
386 return FALSE;
389 *dest = m;
390 return TRUE;
394 * get_reflection_caller:
396 * Walk to the first managed method outside:
397 * - System.Reflection* namespaces
398 * - System.[Multicast]Delegate or Activator type
399 * - platform code
400 * and return a pointer to its MonoMethod.
402 * This is required since CoreCLR checks needs to be done on this "real" caller.
404 static MonoMethod*
405 get_reflection_caller (void)
407 MonoMethod *m = NULL;
408 mono_stack_walk_no_il (get_caller_no_reflection_related, &m);
409 if (G_UNLIKELY (!m)) {
410 mono_trace (G_LOG_LEVEL_WARNING, MONO_TRACE_SECURITY, "No caller outside reflection was found");
412 return m;
415 typedef struct {
416 int depth;
417 MonoMethod *caller;
418 } ElevatedTrustCookie;
421 * get_caller_of_elevated_trust_code
423 * Stack walk to find who is calling code requiring Elevated Trust.
424 * If a critical method is found then the caller is platform code
425 * and has elevated trust, otherwise (transparent) a check needs to
426 * be done (on the managed side) to determine if the application is
427 * running with elevated permissions.
429 static gboolean
430 get_caller_of_elevated_trust_code (MonoMethod *m, gint32 no, gint32 ilo, gboolean managed, gpointer data)
432 ElevatedTrustCookie *cookie = (ElevatedTrustCookie *)data;
434 /* skip unmanaged frames and wrappers */
435 if (!managed || (m->wrapper_type != MONO_WRAPPER_NONE))
436 return FALSE;
438 /* end stack walk if we find ourselves outside platform code (we won't find critical code anymore) */
439 if (!mono_security_core_clr_is_platform_image (m->klass->image)) {
440 cookie->caller = m;
441 return TRUE;
444 switch (cookie->depth) {
445 /* while depth == 0 look for SecurityManager::[Check|Ensure]ElevatedPermissions */
446 case 0:
447 if (strcmp (m->klass->name_space, "System.Security"))
448 return FALSE;
449 if (strcmp (m->klass->name, "SecurityManager"))
450 return FALSE;
451 if ((strcmp (m->name, "EnsureElevatedPermissions")) && strcmp (m->name, "CheckElevatedPermissions"))
452 return FALSE;
453 cookie->depth = 1;
454 break;
455 /* while depth == 1 look for the caller to SecurityManager::[Check|Ensure]ElevatedPermissions */
456 case 1:
457 /* this frame is [SecuritySafeCritical] because it calls [SecurityCritical] [Check|Ensure]ElevatedPermissions */
458 /* the next frame will contain the caller(s) we want to check */
459 cookie->depth = 2;
460 break;
461 /* while depth >= 2 look for [safe]critical caller, end stack walk if we find it */
462 default:
463 cookie->depth++;
464 /* if the caller is transparent then we continue the stack walk */
465 if (mono_security_core_clr_method_level (m, TRUE) == MONO_SECURITY_CORE_CLR_TRANSPARENT)
466 break;
468 /* Security[Safe]Critical code is always allowed to call elevated-trust code */
469 cookie->caller = m;
470 return TRUE;
473 return FALSE;
477 * mono_security_core_clr_require_elevated_permissions:
479 * Return TRUE if the caller of the current method (the code who
480 * called SecurityManager.get_RequiresElevatedPermissions) needs
481 * elevated trust to perform an action.
483 * A stack walk is done to find the callers. If one of the callers
484 * is either [SecurityCritical] or [SecuritySafeCritical] then the
485 * action is needed for platform code (i.e. no restriction).
486 * Otherwise (transparent) the requested action needs elevated trust
488 gboolean
489 mono_security_core_clr_require_elevated_permissions (void)
491 ElevatedTrustCookie cookie;
492 cookie.depth = 0;
493 cookie.caller = NULL;
494 mono_stack_walk_no_il (get_caller_of_elevated_trust_code, &cookie);
496 /* return TRUE if the stack walk did not reach far enough or did not find callers */
497 if (!cookie.caller || cookie.depth < 3)
498 return TRUE;
500 /* return TRUE if the caller is transparent, i.e. if elevated trust is required to continue executing the method */
501 return (mono_security_core_clr_method_level (cookie.caller, TRUE) == MONO_SECURITY_CORE_CLR_TRANSPARENT);
506 * check_field_access:
508 * Return TRUE if the caller method can access the specified field, FALSE otherwise.
510 static gboolean
511 check_field_access (MonoMethod *caller, MonoClassField *field)
513 /* if get_reflection_caller returns NULL then we assume the caller has NO privilege */
514 if (caller) {
515 MonoError error;
516 MonoClass *klass;
518 /* this check can occur before the field's type is resolved (and that can fail) */
519 mono_field_get_type_checked (field, &error);
520 if (!mono_error_ok (&error)) {
521 mono_error_cleanup (&error);
522 return FALSE;
525 klass = (mono_field_get_flags (field) & FIELD_ATTRIBUTE_STATIC) ? NULL : mono_field_get_parent (field);
526 return mono_method_can_access_field_full (caller, field, klass);
528 return FALSE;
532 * check_method_access:
534 * Return TRUE if the caller method can access the specified callee method, FALSE otherwise.
536 static gboolean
537 check_method_access (MonoMethod *caller, MonoMethod *callee)
539 /* if get_reflection_caller returns NULL then we assume the caller has NO privilege */
540 if (caller) {
541 MonoClass *klass = (callee->flags & METHOD_ATTRIBUTE_STATIC) ? NULL : callee->klass;
542 return mono_method_can_access_method_full (caller, callee, klass);
544 return FALSE;
548 * get_argument_exception
550 * Helper function to create an MonoException (ArgumentException in
551 * managed-land) and provide a descriptive message for it. This
552 * message is also, optionally, being logged (export
553 * MONO_LOG_MASK="security") for debugging purposes.
555 static MonoException*
556 get_argument_exception (const char *format, MonoMethod *caller, MonoMethod *callee)
558 MonoException *ex;
559 char *caller_name = get_method_full_name (caller);
560 char *callee_name = get_method_full_name (callee);
561 char *message = g_strdup_printf (format, caller_name, callee_name);
562 g_free (callee_name);
563 g_free (caller_name);
565 mono_trace (G_LOG_LEVEL_WARNING, MONO_TRACE_SECURITY, "%s", message);
566 ex = mono_get_exception_argument ("method", message);
567 g_free (message);
569 return ex;
573 * get_field_access_exception
575 * Helper function to create an MonoException (FieldAccessException
576 * in managed-land) and provide a descriptive message for it. This
577 * message is also, optionally, being logged (export
578 * MONO_LOG_MASK="security") for debugging purposes.
580 static MonoException*
581 get_field_access_exception (const char *format, MonoMethod *caller, MonoClassField *field)
583 MonoException *ex;
584 char *caller_name = get_method_full_name (caller);
585 char *field_name = mono_field_full_name (field);
586 char *message = g_strdup_printf (format, caller_name, field_name);
587 g_free (field_name);
588 g_free (caller_name);
590 mono_trace (G_LOG_LEVEL_WARNING, MONO_TRACE_SECURITY, "%s", message);
591 ex = mono_get_exception_field_access_msg (message);
592 g_free (message);
594 return ex;
598 * get_method_access_exception
600 * Helper function to create an MonoException (MethodAccessException
601 * in managed-land) and provide a descriptive message for it. This
602 * message is also, optionally, being logged (export
603 * MONO_LOG_MASK="security") for debugging purposes.
605 static MonoException*
606 get_method_access_exception (const char *format, MonoMethod *caller, MonoMethod *callee)
608 MonoException *ex;
609 char *caller_name = get_method_full_name (caller);
610 char *callee_name = get_method_full_name (callee);
611 char *message = g_strdup_printf (format, caller_name, callee_name);
612 g_free (callee_name);
613 g_free (caller_name);
615 mono_trace (G_LOG_LEVEL_WARNING, MONO_TRACE_SECURITY, "%s", message);
616 ex = mono_get_exception_method_access_msg (message);
617 g_free (message);
619 return ex;
623 * mono_security_core_clr_ensure_reflection_access_field:
625 * Ensure that the specified field can be used with reflection since
626 * Transparent code cannot access to Critical fields and can only use
627 * them if they are visible from it's point of view.
629 * Returns TRUE if acess is allowed. Otherwise returns FALSE and sets @error to a FieldAccessException if the field is cannot be accessed.
631 gboolean
632 mono_security_core_clr_ensure_reflection_access_field (MonoClassField *field, MonoError *error)
634 mono_error_init (error);
635 MonoMethod *caller = get_reflection_caller ();
636 /* CoreCLR restrictions applies to Transparent code/caller */
637 if (mono_security_core_clr_method_level (caller, TRUE) != MONO_SECURITY_CORE_CLR_TRANSPARENT)
638 return TRUE;
640 if (mono_security_core_clr_get_options () & MONO_SECURITY_CORE_CLR_OPTIONS_RELAX_REFLECTION) {
641 if (!mono_security_core_clr_is_platform_image (mono_field_get_parent(field)->image))
642 return TRUE;
645 /* Transparent code cannot [get|set]value on Critical fields */
646 if (mono_security_core_clr_class_level (mono_field_get_parent (field)) == MONO_SECURITY_CORE_CLR_CRITICAL) {
647 mono_error_set_exception_instance (error, get_field_access_exception (
648 "Transparent method %s cannot get or set Critical field %s.",
649 caller, field));
650 return FALSE;
653 /* also it cannot access a fields that is not visible from it's (caller) point of view */
654 if (!check_field_access (caller, field)) {
655 mono_error_set_exception_instance (error, get_field_access_exception (
656 "Transparent method %s cannot get or set private/internal field %s.",
657 caller, field));
658 return FALSE;
660 return TRUE;
664 * mono_security_core_clr_ensure_reflection_access_method:
666 * Ensure that the specified method can be used with reflection since
667 * Transparent code cannot call Critical methods and can only call them
668 * if they are visible from it's point of view.
670 * If access is allowed returns TRUE. Returns FALSE and sets @error to a MethodAccessException if the field is cannot be accessed.
672 gboolean
673 mono_security_core_clr_ensure_reflection_access_method (MonoMethod *method, MonoError *error)
675 mono_error_init (error);
676 MonoMethod *caller = get_reflection_caller ();
677 /* CoreCLR restrictions applies to Transparent code/caller */
678 if (mono_security_core_clr_method_level (caller, TRUE) != MONO_SECURITY_CORE_CLR_TRANSPARENT)
679 return TRUE;
681 if (mono_security_core_clr_get_options () & MONO_SECURITY_CORE_CLR_OPTIONS_RELAX_REFLECTION) {
682 if (!mono_security_core_clr_is_platform_image (method->klass->image))
683 return TRUE;
686 /* Transparent code cannot invoke, even using reflection, Critical code */
687 if (mono_security_core_clr_method_level (method, TRUE) == MONO_SECURITY_CORE_CLR_CRITICAL) {
688 mono_error_set_exception_instance (error, get_method_access_exception (
689 "Transparent method %s cannot invoke Critical method %s.",
690 caller, method));
691 return FALSE;
694 /* also it cannot invoke a method that is not visible from it's (caller) point of view */
695 if (!check_method_access (caller, method)) {
696 mono_error_set_exception_instance (error, get_method_access_exception (
697 "Transparent method %s cannot invoke private/internal method %s.",
698 caller, method));
699 return FALSE;
701 return TRUE;
705 * can_avoid_corlib_reflection_delegate_optimization:
707 * Mono's mscorlib use delegates to optimize PropertyInfo and EventInfo
708 * reflection calls. This requires either a bunch of additional, and not
709 * really required, [SecuritySafeCritical] in the class libraries or
710 * (like this) a way to skip them. As a bonus we also avoid the stack
711 * walk to find the caller.
713 * Return TRUE if we can skip this "internal" delegate creation, FALSE
714 * otherwise.
716 static gboolean
717 can_avoid_corlib_reflection_delegate_optimization (MonoMethod *method)
719 if (!mono_security_core_clr_is_platform_image (method->klass->image))
720 return FALSE;
722 if (strcmp (method->klass->name_space, "System.Reflection") != 0)
723 return FALSE;
725 if (strcmp (method->klass->name, "MonoProperty") == 0) {
726 if ((strcmp (method->name, "GetterAdapterFrame") == 0) || strcmp (method->name, "StaticGetterAdapterFrame") == 0)
727 return TRUE;
728 } else if (strcmp (method->klass->name, "EventInfo") == 0) {
729 if ((strcmp (method->name, "AddEventFrame") == 0) || strcmp (method->name, "StaticAddEventAdapterFrame") == 0)
730 return TRUE;
733 return FALSE;
737 * mono_security_core_clr_ensure_delegate_creation:
739 * Return TRUE if a delegate can be created on the specified
740 * method. CoreCLR can also affect the binding, this function may
741 * return (FALSE) and set @error to an ArgumentException.
743 * @error is set to a MethodAccessException if the specified method is not
744 * visible from the caller point of view.
746 gboolean
747 mono_security_core_clr_ensure_delegate_creation (MonoMethod *method, MonoError *error)
749 MonoMethod *caller;
751 mono_error_init (error);
753 /* note: mscorlib creates delegates to avoid reflection (optimization), we ignore those cases */
754 if (can_avoid_corlib_reflection_delegate_optimization (method))
755 return TRUE;
757 caller = get_reflection_caller ();
758 /* if the "real" caller is not Transparent then it do can anything */
759 if (mono_security_core_clr_method_level (caller, TRUE) != MONO_SECURITY_CORE_CLR_TRANSPARENT)
760 return TRUE;
762 /* otherwise it (as a Transparent caller) cannot create a delegate on a Critical method... */
763 if (mono_security_core_clr_method_level (method, TRUE) == MONO_SECURITY_CORE_CLR_CRITICAL) {
764 mono_error_set_exception_instance (error, get_argument_exception (
765 "Transparent method %s cannot create a delegate on Critical method %s.",
766 caller, method));
767 return FALSE;
770 if (mono_security_core_clr_get_options () & MONO_SECURITY_CORE_CLR_OPTIONS_RELAX_DELEGATE) {
771 if (!mono_security_core_clr_is_platform_image (method->klass->image))
772 return TRUE;
775 /* also it cannot create the delegate on a method that is not visible from it's (caller) point of view */
776 if (!check_method_access (caller, method)) {
777 mono_error_set_exception_instance (error, get_method_access_exception (
778 "Transparent method %s cannot create a delegate on private/internal method %s.",
779 caller, method));
780 return FALSE;
783 return TRUE;
787 * mono_security_core_clr_ensure_dynamic_method_resolved_object:
789 * Called from mono_reflection_create_dynamic_method (reflection.c) to add some extra checks required for CoreCLR.
790 * Dynamic methods needs to check to see if the objects being used (e.g. methods, fields) comes from platform code
791 * and do an accessibility check in this case. Otherwise (i.e. user/application code) can be used without this extra
792 * accessbility check.
794 MonoException*
795 mono_security_core_clr_ensure_dynamic_method_resolved_object (gpointer ref, MonoClass *handle_class)
797 /* XXX find/create test cases for other handle_class XXX */
798 if (handle_class == mono_defaults.fieldhandle_class) {
799 MonoClassField *field = (MonoClassField*) ref;
800 MonoClass *klass = mono_field_get_parent (field);
801 /* fields coming from platform code have extra protection (accessibility check) */
802 if (mono_security_core_clr_is_platform_image (klass->image)) {
803 MonoMethod *caller = get_reflection_caller ();
804 /* XXX Critical code probably can do this / need some test cases (safer off otherwise) XXX */
805 if (!check_field_access (caller, field)) {
806 return get_field_access_exception (
807 "Dynamic method %s cannot create access private/internal field %s.",
808 caller, field);
811 } else if (handle_class == mono_defaults.methodhandle_class) {
812 MonoMethod *method = (MonoMethod*) ref;
813 /* methods coming from platform code have extra protection (accessibility check) */
814 if (mono_security_core_clr_is_platform_image (method->klass->image)) {
815 MonoMethod *caller = get_reflection_caller ();
816 /* XXX Critical code probably can do this / need some test cases (safer off otherwise) XXX */
817 if (!check_method_access (caller, method)) {
818 return get_method_access_exception (
819 "Dynamic method %s cannot create access private/internal method %s.",
820 caller, method);
824 return NULL;
828 * mono_security_core_clr_can_access_internals
830 * Check if we allow [InternalsVisibleTo] to work between two images.
832 gboolean
833 mono_security_core_clr_can_access_internals (MonoImage *accessing, MonoImage* accessed)
835 /* are we trying to access internals of a platform assembly ? if not this is acceptable */
836 if (!mono_security_core_clr_is_platform_image (accessed))
837 return TRUE;
839 /* we can't let everyone with the right name and public key token access the internals of platform code.
840 * (Silverlight can rely on the strongname signature of the assemblies, but Mono does not verify them)
841 * However platform code is fully trusted so it can access the internals of other platform code assemblies */
842 if (mono_security_core_clr_is_platform_image (accessing))
843 return TRUE;
845 /* catch-22: System.Xml needs access to mscorlib's internals (e.g. ArrayList) but is not considered platform code.
846 * Promoting it to platform code would create another issue since (both Mono/Moonlight or MS version of)
847 * System.Xml.Linq.dll (an SDK, not platform, assembly) needs access to System.Xml.dll internals (either ).
848 * The solution is to trust, even transparent code, in the plugin directory to access platform code internals */
849 if (!accessed->assembly->basedir || !accessing->assembly->basedir)
850 return FALSE;
851 return (strcmp (accessed->assembly->basedir, accessing->assembly->basedir) == 0);
855 * mono_security_core_clr_is_field_access_allowed
857 * Return a MonoException (FieldccessException in managed-land) if
858 * the access from "caller" to "field" is not valid under CoreCLR -
859 * i.e. a [SecurityTransparent] method calling a [SecurityCritical]
860 * field.
862 MonoException*
863 mono_security_core_clr_is_field_access_allowed (MonoMethod *caller, MonoClassField *field)
865 /* there's no restriction to access Transparent or SafeCritical fields, so we only check calls to Critical methods */
866 if (mono_security_core_clr_class_level (mono_field_get_parent (field)) != MONO_SECURITY_CORE_CLR_CRITICAL)
867 return NULL;
869 /* caller is Critical! only SafeCritical and Critical callers can access the field, so we throw if caller is Transparent */
870 if (!caller || (mono_security_core_clr_method_level (caller, TRUE) != MONO_SECURITY_CORE_CLR_TRANSPARENT))
871 return NULL;
873 return get_field_access_exception (
874 "Transparent method %s cannot call use Critical field %s.",
875 caller, field);
879 * mono_security_core_clr_is_call_allowed
881 * Return a MonoException (MethodAccessException in managed-land) if
882 * the call from "caller" to "callee" is not valid under CoreCLR -
883 * i.e. a [SecurityTransparent] method calling a [SecurityCritical]
884 * method.
886 MonoException*
887 mono_security_core_clr_is_call_allowed (MonoMethod *caller, MonoMethod *callee)
889 /* there's no restriction to call Transparent or SafeCritical code, so we only check calls to Critical methods */
890 if (mono_security_core_clr_method_level (callee, TRUE) != MONO_SECURITY_CORE_CLR_CRITICAL)
891 return NULL;
893 /* callee is Critical! only SafeCritical and Critical callers can call it, so we throw if the caller is Transparent */
894 if (!caller || (mono_security_core_clr_method_level (caller, TRUE) != MONO_SECURITY_CORE_CLR_TRANSPARENT))
895 return NULL;
897 return get_method_access_exception (
898 "Transparent method %s cannot call Critical method %s.",
899 caller, callee);
903 * mono_security_core_clr_level_from_cinfo:
905 * Return the MonoSecurityCoreCLRLevel that match the attribute located
906 * in the specified custom attributes. If no attribute is present it
907 * defaults to MONO_SECURITY_CORE_CLR_TRANSPARENT, which is the default
908 * level for all code under the CoreCLR.
910 static MonoSecurityCoreCLRLevel
911 mono_security_core_clr_level_from_cinfo (MonoCustomAttrInfo *cinfo, MonoImage *image)
913 int level = MONO_SECURITY_CORE_CLR_TRANSPARENT;
915 if (cinfo && mono_custom_attrs_has_attr (cinfo, security_safe_critical_attribute ()))
916 level = MONO_SECURITY_CORE_CLR_SAFE_CRITICAL;
917 if (cinfo && mono_custom_attrs_has_attr (cinfo, security_critical_attribute ()))
918 level = MONO_SECURITY_CORE_CLR_CRITICAL;
920 return (MonoSecurityCoreCLRLevel)level;
924 * mono_security_core_clr_class_level_no_platform_check:
926 * Return the MonoSecurityCoreCLRLevel for the specified class, without
927 * checking for platform code. This help us avoid multiple redundant
928 * checks, e.g.
929 * - a check for the method and one for the class;
930 * - a check for the class and outer class(es) ...
932 static MonoSecurityCoreCLRLevel
933 mono_security_core_clr_class_level_no_platform_check (MonoClass *klass)
935 MonoSecurityCoreCLRLevel level = MONO_SECURITY_CORE_CLR_TRANSPARENT;
936 MonoCustomAttrInfo *cinfo = mono_custom_attrs_from_class (klass);
937 if (cinfo) {
938 level = mono_security_core_clr_level_from_cinfo (cinfo, klass->image);
939 mono_custom_attrs_free (cinfo);
942 if (level == MONO_SECURITY_CORE_CLR_TRANSPARENT && klass->nested_in)
943 level = mono_security_core_clr_class_level_no_platform_check (klass->nested_in);
945 return level;
949 * mono_security_core_clr_class_level:
951 * Return the MonoSecurityCoreCLRLevel for the specified class.
953 MonoSecurityCoreCLRLevel
954 mono_security_core_clr_class_level (MonoClass *klass)
956 /* non-platform code is always Transparent - whatever the attributes says */
957 if (!mono_security_core_clr_test && !mono_security_core_clr_is_platform_image (klass->image))
958 return MONO_SECURITY_CORE_CLR_TRANSPARENT;
960 return mono_security_core_clr_class_level_no_platform_check (klass);
964 * mono_security_core_clr_field_level:
966 * Return the MonoSecurityCoreCLRLevel for the specified field.
967 * If with_class_level is TRUE then the type (class) will also be
968 * checked, otherwise this will only report the information about
969 * the field itself.
971 MonoSecurityCoreCLRLevel
972 mono_security_core_clr_field_level (MonoClassField *field, gboolean with_class_level)
974 MonoCustomAttrInfo *cinfo;
975 MonoSecurityCoreCLRLevel level = MONO_SECURITY_CORE_CLR_TRANSPARENT;
977 /* if get_reflection_caller returns NULL then we assume the caller has NO privilege */
978 if (!field)
979 return level;
981 /* non-platform code is always Transparent - whatever the attributes says */
982 if (!mono_security_core_clr_test && !mono_security_core_clr_is_platform_image (field->parent->image))
983 return level;
985 cinfo = mono_custom_attrs_from_field (field->parent, field);
986 if (cinfo) {
987 level = mono_security_core_clr_level_from_cinfo (cinfo, field->parent->image);
988 mono_custom_attrs_free (cinfo);
991 if (with_class_level && level == MONO_SECURITY_CORE_CLR_TRANSPARENT)
992 level = mono_security_core_clr_class_level (field->parent);
994 return level;
998 * mono_security_core_clr_method_level:
1000 * Return the MonoSecurityCoreCLRLevel for the specified method.
1001 * If with_class_level is TRUE then the type (class) will also be
1002 * checked, otherwise this will only report the information about
1003 * the method itself.
1005 MonoSecurityCoreCLRLevel
1006 mono_security_core_clr_method_level (MonoMethod *method, gboolean with_class_level)
1008 MonoCustomAttrInfo *cinfo;
1009 MonoSecurityCoreCLRLevel level = MONO_SECURITY_CORE_CLR_TRANSPARENT;
1011 /* if get_reflection_caller returns NULL then we assume the caller has NO privilege */
1012 if (!method)
1013 return level;
1015 /* non-platform code is always Transparent - whatever the attributes says */
1016 if (!mono_security_core_clr_test && !mono_security_core_clr_is_platform_image (method->klass->image))
1017 return level;
1019 cinfo = mono_custom_attrs_from_method (method);
1020 if (cinfo) {
1021 level = mono_security_core_clr_level_from_cinfo (cinfo, method->klass->image);
1022 mono_custom_attrs_free (cinfo);
1025 if (with_class_level && level == MONO_SECURITY_CORE_CLR_TRANSPARENT)
1026 level = mono_security_core_clr_class_level (method->klass);
1028 return level;
1032 * mono_security_enable_core_clr:
1034 * Enable the verifier and the CoreCLR security model
1036 void
1037 mono_security_enable_core_clr ()
1039 mono_verifier_set_mode (MONO_VERIFIER_MODE_VERIFIABLE);
1040 mono_security_set_mode (MONO_SECURITY_MODE_CORE_CLR);
1043 #else
1045 void
1046 mono_security_core_clr_check_inheritance (MonoClass *klass)
1050 void
1051 mono_security_core_clr_check_override (MonoClass *klass, MonoMethod *override, MonoMethod *base)
1055 gboolean
1056 mono_security_core_clr_require_elevated_permissions (void)
1058 return FALSE;
1061 gboolean
1062 mono_security_core_clr_ensure_reflection_access_field (MonoClassField *field, MonoError *error)
1064 mono_error_init (error);
1065 return TRUE;
1068 gboolean
1069 mono_security_core_clr_ensure_reflection_access_method (MonoMethod *method, MonoError *error)
1071 mono_error_init (error);
1072 return TRUE;
1075 gboolean
1076 mono_security_core_clr_ensure_delegate_creation (MonoMethod *method, MonoError *error)
1078 mono_error_init (error);
1079 return TRUE;
1082 MonoException*
1083 mono_security_core_clr_ensure_dynamic_method_resolved_object (gpointer ref, MonoClass *handle_class)
1085 return NULL;
1088 gboolean
1089 mono_security_core_clr_can_access_internals (MonoImage *accessing, MonoImage* accessed)
1091 return TRUE;
1094 MonoException*
1095 mono_security_core_clr_is_field_access_allowed (MonoMethod *caller, MonoClassField *field)
1097 return NULL;
1100 MonoException*
1101 mono_security_core_clr_is_call_allowed (MonoMethod *caller, MonoMethod *callee)
1103 return NULL;
1106 MonoSecurityCoreCLRLevel
1107 mono_security_core_clr_class_level (MonoClass *klass)
1109 return MONO_SECURITY_CORE_CLR_TRANSPARENT;
1112 MonoSecurityCoreCLRLevel
1113 mono_security_core_clr_field_level (MonoClassField *field, gboolean with_class_level)
1115 return MONO_SECURITY_CORE_CLR_TRANSPARENT;
1118 MonoSecurityCoreCLRLevel
1119 mono_security_core_clr_method_level (MonoMethod *method, gboolean with_class_level)
1121 return MONO_SECURITY_CORE_CLR_TRANSPARENT;
1124 void
1125 mono_security_enable_core_clr ()
1129 #endif /* DISABLE_SECURITY */