1 /*
2 * Copyright (c) 1997, 2015, Oracle and/or its affiliates. All rights reserved.
3 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
4 *
5 * This code is free software; you can redistribute it and/or modify it
6 * under the terms of the GNU General Public License version 2 only, as
7 * published by the Free Software Foundation. Oracle designates this
8 * particular file as subject to the "Classpath" exception as provided
9 * by Oracle in the LICENSE file that accompanied this code.
10 *
11 * This code is distributed in the hope that it will be useful, but WITHOUT
12 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
13 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
14 * version 2 for more details (a copy is included in the LICENSE file that
15 * accompanied this code).
16 *
17 * You should have received a copy of the GNU General Public License version
18 * 2 along with this work; if not, write to the Free Software Foundation,
19 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
20 *
21 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
22 * or visit www.oracle.com if you need additional information or have any
23 * questions.
24 */
25
26 package java.security;
27
28 import java.util.ArrayList;
29 import java.util.List;
30
31 import sun.security.util.Debug;
32 import sun.security.util.FilePermCompat;
33 import sun.security.util.SecurityConstants;
34
35
36 /**
37 * An AccessControlContext is used to make system resource access decisions
38 * based on the context it encapsulates.
39 *
40 * <p>More specifically, it encapsulates a context and
41 * has a single method, {@code checkPermission},
42 * that is equivalent to the {@code checkPermission} method
43 * in the AccessController class, with one difference: The AccessControlContext
44 * {@code checkPermission} method makes access decisions based on the
45 * context it encapsulates,
46 * rather than that of the current execution thread.
47 *
48 * <p>Thus, the purpose of AccessControlContext is for those situations where
49 * a security check that should be made within a given context
50 * actually needs to be done from within a
51 * <i>different</i> context (for example, from within a worker thread).
52 *
53 * <p> An AccessControlContext is created by calling the
54 * {@code AccessController.getContext} method.
55 * The {@code getContext} method takes a "snapshot"
56 * of the current calling context, and places
57 * it in an AccessControlContext object, which it returns. A sample call is
58 * the following:
59 *
60 * <pre>
61 * AccessControlContext acc = AccessController.getContext()
62 * </pre>
63 *
64 * <p>
65 * Code within a different context can subsequently call the
66 * {@code checkPermission} method on the
67 * previously-saved AccessControlContext object. A sample call is the
68 * following:
69 *
70 * <pre>
71 * acc.checkPermission(permission)
72 * </pre>
73 *
74 * @see AccessController
75 *
76 * @author Roland Schemers
77 * @since 1.2
78 */
79
80 public final class AccessControlContext {
81
82 private ProtectionDomain[] context;
83 // isPrivileged and isAuthorized are referenced by the VM - do not remove
84 // or change their names
85 private boolean isPrivileged;
86 private boolean isAuthorized = false;
87
88 // Note: This field is directly used by the virtual machine
89 // native codes. Don't touch it.
90 private AccessControlContext privilegedContext;
91
92 private DomainCombiner combiner = null;
93
94 // limited privilege scope
95 private Permission[] permissions;
96 private AccessControlContext parent;
97 private boolean isWrapped;
98
99 // is constrained by limited privilege scope?
100 private boolean isLimited;
101 private ProtectionDomain[] limitedContext;
102
103 private static boolean debugInit = false;
104 private static Debug debug = null;
105
106 static Debug getDebug()
107 {
108 if (debugInit)
109 return debug;
110 else {
111 if (Policy.isSet()) {
112 debug = Debug.getInstance("access");
113 debugInit = true;
114 }
115 return debug;
116 }
117 }
118
119 /**
120 * Create an AccessControlContext with the given array of ProtectionDomains.
121 * Context must not be null. Duplicate domains will be removed from the
122 * context.
123 *
124 * @param context the ProtectionDomains associated with this context.
125 * The non-duplicate domains are copied from the array. Subsequent
126 * changes to the array will not affect this AccessControlContext.
127 * @throws NullPointerException if {@code context} is {@code null}
128 */
129 public AccessControlContext(ProtectionDomain[] context)
130 {
131 if (context.length == 0) {
132 this.context = null;
133 } else if (context.length == 1) {
134 if (context[0] != null) {
135 this.context = context.clone();
136 } else {
137 this.context = null;
138 }
139 } else {
140 List<ProtectionDomain> v = new ArrayList<>(context.length);
141 for (int i =0; i< context.length; i++) {
142 if ((context[i] != null) && (!v.contains(context[i])))
143 v.add(context[i]);
144 }
145 if (!v.isEmpty()) {
146 this.context = new ProtectionDomain[v.size()];
147 this.context = v.toArray(this.context);
148 }
149 }
150 }
151
152 /**
153 * Create a new {@code AccessControlContext} with the given
154 * {@code AccessControlContext} and {@code DomainCombiner}.
155 * This constructor associates the provided
156 * {@code DomainCombiner} with the provided
157 * {@code AccessControlContext}.
158 *
159 * @param acc the {@code AccessControlContext} associated
160 * with the provided {@code DomainCombiner}.
161 *
162 * @param combiner the {@code DomainCombiner} to be associated
163 * with the provided {@code AccessControlContext}.
164 *
165 * @exception NullPointerException if the provided
166 * {@code context} is {@code null}.
167 *
168 * @exception SecurityException if a security manager is installed and the
169 * caller does not have the "createAccessControlContext"
170 * {@link SecurityPermission}
171 * @since 1.3
172 */
173 public AccessControlContext(AccessControlContext acc,
174 DomainCombiner combiner) {
175
176 this(acc, combiner, false);
177 }
178
179 /**
180 * package private to allow calls from ProtectionDomain without performing
181 * the security check for {@linkplain SecurityConstants#CREATE_ACC_PERMISSION}
182 * permission
183 */
184 AccessControlContext(AccessControlContext acc,
185 DomainCombiner combiner,
186 boolean preauthorized) {
187 if (!preauthorized) {
188 SecurityManager sm = System.getSecurityManager();
189 if (sm != null) {
190 sm.checkPermission(SecurityConstants.CREATE_ACC_PERMISSION);
191 this.isAuthorized = true;
192 }
193 } else {
194 this.isAuthorized = true;
195 }
196
197 this.context = acc.context;
198
199 // we do not need to run the combine method on the
200 // provided ACC. it was already "combined" when the
201 // context was originally retrieved.
202 //
203 // at this point in time, we simply throw away the old
204 // combiner and use the newly provided one.
205 this.combiner = combiner;
206 }
207
208 /**
209 * package private for AccessController
210 *
211 * This "argument wrapper" context will be passed as the actual context
212 * parameter on an internal doPrivileged() call used in the implementation.
213 */
214 AccessControlContext(ProtectionDomain caller, DomainCombiner combiner,
215 AccessControlContext parent, AccessControlContext context,
216 Permission[] perms)
217 {
218 /*
219 * Combine the domains from the doPrivileged() context into our
220 * wrapper context, if necessary.
221 */
222 ProtectionDomain[] callerPDs = null;
223 if (caller != null) {
224 callerPDs = new ProtectionDomain[] { caller };
225 }
226 if (context != null) {
227 if (combiner != null) {
228 this.context = combiner.combine(callerPDs, context.context);
229 } else {
230 this.context = combine(callerPDs, context.context);
231 }
232 } else {
233 /*
234 * Call combiner even if there is seemingly nothing to combine.
235 */
236 if (combiner != null) {
237 this.context = combiner.combine(callerPDs, null);
238 } else {
239 this.context = combine(callerPDs, null);
240 }
241 }
242 this.combiner = combiner;
243
244 Permission[] tmp = null;
245 if (perms != null) {
246 tmp = new Permission[perms.length];
247 for (int i=0; i < perms.length; i++) {
248 if (perms[i] == null) {
249 throw new NullPointerException("permission can't be null");
250 }
251
252 /*
253 * An AllPermission argument is equivalent to calling
254 * doPrivileged() without any limit permissions.
255 */
256 if (perms[i].getClass() == AllPermission.class) {
257 parent = null;
258 }
259 // Add altPath into permission for compatibility.
260 tmp[i] = FilePermCompat.newPermPlusAltPath(perms[i]);
261 }
262 }
263
264 /*
265 * For a doPrivileged() with limited privilege scope, initialize
266 * the relevant fields.
267 *
268 * The limitedContext field contains the union of all domains which
269 * are enclosed by this limited privilege scope. In other words,
270 * it contains all of the domains which could potentially be checked
271 * if none of the limiting permissions implied a requested permission.
272 */
273 if (parent != null) {
274 this.limitedContext = combine(parent.context, parent.limitedContext);
275 this.isLimited = true;
276 this.isWrapped = true;
277 this.permissions = tmp;
278 this.parent = parent;
279 this.privilegedContext = context; // used in checkPermission2()
280 }
281 this.isAuthorized = true;
282 }
283
284
285 /**
286 * package private constructor for AccessController.getContext()
287 */
288
289 AccessControlContext(ProtectionDomain[] context,
290 boolean isPrivileged)
291 {
292 this.context = context;
293 this.isPrivileged = isPrivileged;
294 this.isAuthorized = true;
295 }
296
297 /**
298 * Constructor for JavaSecurityAccess.doIntersectionPrivilege()
299 */
300 AccessControlContext(ProtectionDomain[] context,
301 AccessControlContext privilegedContext)
302 {
303 this.context = context;
304 this.privilegedContext = privilegedContext;
305 this.isPrivileged = true;
306 }
307
308 /**
309 * Returns this context's context.
310 */
311 ProtectionDomain[] getContext() {
312 return context;
313 }
314
315 /**
316 * Returns true if this context is privileged.
317 */
318 boolean isPrivileged()
319 {
320 return isPrivileged;
321 }
322
323 /**
324 * get the assigned combiner from the privileged or inherited context
325 */
326 DomainCombiner getAssignedCombiner() {
327 AccessControlContext acc;
328 if (isPrivileged) {
329 acc = privilegedContext;
330 } else {
331 acc = AccessController.getInheritedAccessControlContext();
332 }
333 if (acc != null) {
334 return acc.combiner;
335 }
336 return null;
337 }
338
339 /**
340 * Get the {@code DomainCombiner} associated with this
341 * {@code AccessControlContext}.
342 *
343 * @return the {@code DomainCombiner} associated with this
344 * {@code AccessControlContext}, or {@code null}
345 * if there is none.
346 *
347 * @exception SecurityException if a security manager is installed and
348 * the caller does not have the "getDomainCombiner"
349 * {@link SecurityPermission}
350 * @since 1.3
351 */
352 public DomainCombiner getDomainCombiner() {
353
354 SecurityManager sm = System.getSecurityManager();
355 if (sm != null) {
356 sm.checkPermission(SecurityConstants.GET_COMBINER_PERMISSION);
357 }
358 return getCombiner();
359 }
360
361 /**
362 * package private for AccessController
363 */
364 DomainCombiner getCombiner() {
365 return combiner;
366 }
367
368 boolean isAuthorized() {
369 return isAuthorized;
370 }
371
372 /**
373 * Determines whether the access request indicated by the
374 * specified permission should be allowed or denied, based on
375 * the security policy currently in effect, and the context in
376 * this object. The request is allowed only if every ProtectionDomain
377 * in the context implies the permission. Otherwise the request is
378 * denied.
379 *
380 * <p>
381 * This method quietly returns if the access request
382 * is permitted, or throws a suitable AccessControlException otherwise.
383 *
384 * @param perm the requested permission.
385 *
386 * @exception AccessControlException if the specified permission
387 * is not permitted, based on the current security policy and the
388 * context encapsulated by this object.
389 * @exception NullPointerException if the permission to check for is null.
390 */
391 public void checkPermission(Permission perm)
392 throws AccessControlException
393 {
394 boolean dumpDebug = false;
395
396 if (perm == null) {
397 throw new NullPointerException("permission can't be null");
398 }
399 if (getDebug() != null) {
400 // If "codebase" is not specified, we dump the info by default.
401 dumpDebug = !Debug.isOn("codebase=");
402 if (!dumpDebug) {
403 // If "codebase" is specified, only dump if the specified code
404 // value is in the stack.
405 for (int i = 0; context != null && i < context.length; i++) {
406 if (context[i].getCodeSource() != null &&
407 context[i].getCodeSource().getLocation() != null &&
408 Debug.isOn("codebase=" + context[i].getCodeSource().getLocation().toString())) {
409 dumpDebug = true;
410 break;
411 }
412 }
413 }
414
415 dumpDebug &= !Debug.isOn("permission=") ||
416 Debug.isOn("permission=" + perm.getClass().getCanonicalName());
417
418 if (dumpDebug && Debug.isOn("stack")) {
419 Thread.dumpStack();
420 }
421
422 if (dumpDebug && Debug.isOn("domain")) {
423 if (context == null) {
424 debug.println("domain (context is null)");
425 } else {
426 for (int i=0; i< context.length; i++) {
427 debug.println("domain "+i+" "+context[i]);
428 }
429 }
430 }
431 }
432
433 /*
434 * iterate through the ProtectionDomains in the context.
435 * Stop at the first one that doesn't allow the
436 * requested permission (throwing an exception).
437 *
438 */
439
440 /* if ctxt is null, all we had on the stack were system domains,
441 or the first domain was a Privileged system domain. This
442 is to make the common case for system code very fast */
443
444 if (context == null) {
445 checkPermission2(perm);
446 return;
447 }
448
449 for (int i=0; i< context.length; i++) {
450 if (context[i] != null && !context[i].impliesWithAltFilePerm(perm)) {
451 if (dumpDebug) {
452 debug.println("access denied " + perm);
453 }
454
455 if (Debug.isOn("failure") && debug != null) {
456 // Want to make sure this is always displayed for failure,
457 // but do not want to display again if already displayed
458 // above.
459 if (!dumpDebug) {
460 debug.println("access denied " + perm);
461 }
462 Thread.dumpStack();
463 final ProtectionDomain pd = context[i];
464 final Debug db = debug;
465 AccessController.doPrivileged (new PrivilegedAction<>() {
466 public Void run() {
467 db.println("domain that failed "+pd);
468 return null;
469 }
470 });
471 }
472 throw new AccessControlException("access denied "+perm, perm);
473 }
474 }
475
476 // allow if all of them allowed access
477 if (dumpDebug) {
478 debug.println("access allowed "+perm);
479 }
480
481 checkPermission2(perm);
482 }
483
484 /*
485 * Check the domains associated with the limited privilege scope.
486 */
487 private void checkPermission2(Permission perm) {
488 if (!isLimited) {
489 return;
490 }
491
492 /*
493 * Check the doPrivileged() context parameter, if present.
494 */
495 if (privilegedContext != null) {
496 privilegedContext.checkPermission2(perm);
497 }
498
499 /*
500 * Ignore the limited permissions and parent fields of a wrapper
501 * context since they were already carried down into the unwrapped
502 * context.
503 */
504 if (isWrapped) {
505 return;
506 }
507
508 /*
509 * Try to match any limited privilege scope.
510 */
511 if (permissions != null) {
512 Class<?> permClass = perm.getClass();
513 for (int i=0; i < permissions.length; i++) {
514 Permission limit = permissions[i];
515 if (limit.getClass().equals(permClass) && limit.implies(perm)) {
516 return;
517 }
518 }
519 }
520
521 /*
522 * Check the limited privilege scope up the call stack or the inherited
523 * parent thread call stack of this ACC.
524 */
525 if (parent != null) {
526 /*
527 * As an optimization, if the parent context is the inherited call
528 * stack context from a parent thread then checking the protection
529 * domains of the parent context is redundant since they have
530 * already been merged into the child thread's context by
531 * optimize(). When parent is set to an inherited context this
532 * context was not directly created by a limited scope
533 * doPrivileged() and it does not have its own limited permissions.
534 */
535 if (permissions == null) {
536 parent.checkPermission2(perm);
537 } else {
538 parent.checkPermission(perm);
539 }
540 }
541 }
542
543 /**
544 * Take the stack-based context (this) and combine it with the
545 * privileged or inherited context, if need be. Any limited
546 * privilege scope is flagged regardless of whether the assigned
547 * context comes from an immediately enclosing limited doPrivileged().
548 * The limited privilege scope can indirectly flow from the inherited
549 * parent thread or an assigned context previously captured by getContext().
550 */
551 AccessControlContext optimize() {
552 // the assigned (privileged or inherited) context
553 AccessControlContext acc;
554 DomainCombiner combiner = null;
555 AccessControlContext parent = null;
556 Permission[] permissions = null;
557
558 if (isPrivileged) {
559 acc = privilegedContext;
560 if (acc != null) {
561 /*
562 * If the context is from a limited scope doPrivileged() then
563 * copy the permissions and parent fields out of the wrapper
564 * context that was created to hold them.
565 */
566 if (acc.isWrapped) {
567 permissions = acc.permissions;
568 parent = acc.parent;
569 }
570 }
571 } else {
572 acc = AccessController.getInheritedAccessControlContext();
573 if (acc != null) {
574 /*
575 * If the inherited context is constrained by a limited scope
576 * doPrivileged() then set it as our parent so we will process
577 * the non-domain-related state.
578 */
579 if (acc.isLimited) {
580 parent = acc;
581 }
582 }
583 }
584
585 // this.context could be null if only system code is on the stack;
586 // in that case, ignore the stack context
587 boolean skipStack = (context == null);
588
589 // acc.context could be null if only system code was involved;
590 // in that case, ignore the assigned context
591 boolean skipAssigned = (acc == null || acc.context == null);
592 ProtectionDomain[] assigned = (skipAssigned) ? null : acc.context;
593 ProtectionDomain[] pd;
594
595 // if there is no enclosing limited privilege scope on the stack or
596 // inherited from a parent thread
597 boolean skipLimited = ((acc == null || !acc.isWrapped) && parent == null);
598
599 if (acc != null && acc.combiner != null) {
600 // let the assigned acc's combiner do its thing
601 if (getDebug() != null) {
602 debug.println("AccessControlContext invoking the Combiner");
603 }
604
605 // No need to clone current and assigned.context
606 // combine() will not update them
607 combiner = acc.combiner;
608 pd = combiner.combine(context, assigned);
609 } else {
610 if (skipStack) {
611 if (skipAssigned) {
612 calculateFields(acc, parent, permissions);
613 return this;
614 } else if (skipLimited) {
615 return acc;
616 }
617 } else if (assigned != null) {
618 if (skipLimited) {
619 // optimization: if there is a single stack domain and
620 // that domain is already in the assigned context; no
621 // need to combine
622 if (context.length == 1 && context[0] == assigned[0]) {
623 return acc;
624 }
625 }
626 }
627
628 pd = combine(context, assigned);
629 if (skipLimited && !skipAssigned && pd == assigned) {
630 return acc;
631 } else if (skipAssigned && pd == context) {
632 calculateFields(acc, parent, permissions);
633 return this;
634 }
635 }
636
637 // Reuse existing ACC
638 this.context = pd;
639 this.combiner = combiner;
640 this.isPrivileged = false;
641
642 calculateFields(acc, parent, permissions);
643 return this;
644 }
645
646
647 /*
648 * Combine the current (stack) and assigned domains.
649 */
650 private static ProtectionDomain[] combine(ProtectionDomain[] current,
651 ProtectionDomain[] assigned) {
652
653 // current could be null if only system code is on the stack;
654 // in that case, ignore the stack context
655 boolean skipStack = (current == null);
656
657 // assigned could be null if only system code was involved;
658 // in that case, ignore the assigned context
659 boolean skipAssigned = (assigned == null);
660
661 int slen = (skipStack) ? 0 : current.length;
662
663 // optimization: if there is no assigned context and the stack length
664 // is less then or equal to two; there is no reason to compress the
665 // stack context, it already is
666 if (skipAssigned && slen <= 2) {
667 return current;
668 }
669
670 int n = (skipAssigned) ? 0 : assigned.length;
671
672 // now we combine both of them, and create a new context
673 ProtectionDomain[] pd = new ProtectionDomain[slen + n];
674
675 // first copy in the assigned context domains, no need to compress
676 if (!skipAssigned) {
677 System.arraycopy(assigned, 0, pd, 0, n);
678 }
679
680 // now add the stack context domains, discarding nulls and duplicates
681 outer:
682 for (int i = 0; i < slen; i++) {
683 ProtectionDomain sd = current[i];
684 if (sd != null) {
685 for (int j = 0; j < n; j++) {
686 if (sd == pd[j]) {
687 continue outer;
688 }
689 }
690 pd[n++] = sd;
691 }
692 }
693
694 // if length isn't equal, we need to shorten the array
695 if (n != pd.length) {
696 // optimization: if we didn't really combine anything
697 if (!skipAssigned && n == assigned.length) {
698 return assigned;
699 } else if (skipAssigned && n == slen) {
700 return current;
701 }
702 ProtectionDomain[] tmp = new ProtectionDomain[n];
703 System.arraycopy(pd, 0, tmp, 0, n);
704 pd = tmp;
705 }
706
707 return pd;
708 }
709
710
711 /*
712 * Calculate the additional domains that could potentially be reached via
713 * limited privilege scope. Mark the context as being subject to limited
714 * privilege scope unless the reachable domains (if any) are already
715 * contained in this domain context (in which case any limited
716 * privilege scope checking would be redundant).
717 */
718 private void calculateFields(AccessControlContext assigned,
719 AccessControlContext parent, Permission[] permissions)
720 {
721 ProtectionDomain[] parentLimit = null;
722 ProtectionDomain[] assignedLimit = null;
723 ProtectionDomain[] newLimit;
724
725 parentLimit = (parent != null)? parent.limitedContext: null;
726 assignedLimit = (assigned != null)? assigned.limitedContext: null;
727 newLimit = combine(parentLimit, assignedLimit);
728 if (newLimit != null) {
729 if (context == null || !containsAllPDs(newLimit, context)) {
730 this.limitedContext = newLimit;
731 this.permissions = permissions;
732 this.parent = parent;
733 this.isLimited = true;
734 }
735 }
736 }
737
738
739 /**
740 * Checks two AccessControlContext objects for equality.
741 * Checks that {@code obj} is
742 * an AccessControlContext and has the same set of ProtectionDomains
743 * as this context.
744 *
745 * @param obj the object we are testing for equality with this object.
746 * @return true if {@code obj} is an AccessControlContext, and has the
747 * same set of ProtectionDomains as this context, false otherwise.
748 */
749 public boolean equals(Object obj) {
750 if (obj == this)
751 return true;
752
753 if (! (obj instanceof AccessControlContext))
754 return false;
755
756 AccessControlContext that = (AccessControlContext) obj;
757
758 if (!equalContext(that))
759 return false;
760
761 if (!equalLimitedContext(that))
762 return false;
763
764 return true;
765 }
766
767 /*
768 * Compare for equality based on state that is free of limited
769 * privilege complications.
770 */
771 private boolean equalContext(AccessControlContext that) {
772 if (!equalPDs(this.context, that.context))
773 return false;
774
775 if (this.combiner == null && that.combiner != null)
776 return false;
777
778 if (this.combiner != null && !this.combiner.equals(that.combiner))
779 return false;
780
781 return true;
782 }
783
784 private boolean equalPDs(ProtectionDomain[] a, ProtectionDomain[] b) {
785 if (a == null) {
786 return (b == null);
787 }
788
789 if (b == null)
790 return false;
791
792 if (!(containsAllPDs(a, b) && containsAllPDs(b, a)))
793 return false;
794
795 return true;
796 }
797
798 /*
799 * Compare for equality based on state that is captured during a
800 * call to AccessController.getContext() when a limited privilege
801 * scope is in effect.
802 */
803 private boolean equalLimitedContext(AccessControlContext that) {
804 if (that == null)
805 return false;
806
807 /*
808 * If neither instance has limited privilege scope then we're done.
809 */
810 if (!this.isLimited && !that.isLimited)
811 return true;
812
813 /*
814 * If only one instance has limited privilege scope then we're done.
815 */
816 if (!(this.isLimited && that.isLimited))
817 return false;
818
819 /*
820 * Wrapped instances should never escape outside the implementation
821 * this class and AccessController so this will probably never happen
822 * but it only makes any sense to compare if they both have the same
823 * isWrapped state.
824 */
825 if ((this.isWrapped && !that.isWrapped) ||
826 (!this.isWrapped && that.isWrapped)) {
827 return false;
828 }
829
830 if (this.permissions == null && that.permissions != null)
831 return false;
832
833 if (this.permissions != null && that.permissions == null)
834 return false;
835
836 if (!(this.containsAllLimits(that) && that.containsAllLimits(this)))
837 return false;
838
839 /*
840 * Skip through any wrapped contexts.
841 */
842 AccessControlContext thisNextPC = getNextPC(this);
843 AccessControlContext thatNextPC = getNextPC(that);
844
845 /*
846 * The protection domains and combiner of a privilegedContext are
847 * not relevant because they have already been included in the context
848 * of this instance by optimize() so we only care about any limited
849 * privilege state they may have.
850 */
851 if (thisNextPC == null && thatNextPC != null && thatNextPC.isLimited)
852 return false;
853
854 if (thisNextPC != null && !thisNextPC.equalLimitedContext(thatNextPC))
855 return false;
856
857 if (this.parent == null && that.parent != null)
858 return false;
859
860 if (this.parent != null && !this.parent.equals(that.parent))
861 return false;
862
863 return true;
864 }
865
866 /*
867 * Follow the privilegedContext link making our best effort to skip
868 * through any wrapper contexts.
869 */
870 private static AccessControlContext getNextPC(AccessControlContext acc) {
871 while (acc != null && acc.privilegedContext != null) {
872 acc = acc.privilegedContext;
873 if (!acc.isWrapped)
874 return acc;
875 }
876 return null;
877 }
878
879 private static boolean containsAllPDs(ProtectionDomain[] thisContext,
880 ProtectionDomain[] thatContext) {
881 boolean match = false;
882
883 //
884 // ProtectionDomains within an ACC currently cannot be null
885 // and this is enforced by the constructor and the various
886 // optimize methods. However, historically this logic made attempts
887 // to support the notion of a null PD and therefore this logic continues
888 // to support that notion.
889 ProtectionDomain thisPd;
890 for (int i = 0; i < thisContext.length; i++) {
891 match = false;
892 if ((thisPd = thisContext[i]) == null) {
893 for (int j = 0; (j < thatContext.length) && !match; j++) {
894 match = (thatContext[j] == null);
895 }
896 } else {
897 Class<?> thisPdClass = thisPd.getClass();
898 ProtectionDomain thatPd;
899 for (int j = 0; (j < thatContext.length) && !match; j++) {
900 thatPd = thatContext[j];
901
902 // Class check required to avoid PD exposure (4285406)
903 match = (thatPd != null &&
904 thisPdClass == thatPd.getClass() && thisPd.equals(thatPd));
905 }
906 }
907 if (!match) return false;
908 }
909 return match;
910 }
911
912 private boolean containsAllLimits(AccessControlContext that) {
913 boolean match = false;
914 Permission thisPerm;
915
916 if (this.permissions == null && that.permissions == null)
917 return true;
918
919 for (int i = 0; i < this.permissions.length; i++) {
920 Permission limit = this.permissions[i];
921 Class <?> limitClass = limit.getClass();
922 match = false;
923 for (int j = 0; (j < that.permissions.length) && !match; j++) {
924 Permission perm = that.permissions[j];
925 match = (limitClass.equals(perm.getClass()) &&
926 limit.equals(perm));
927 }
928 if (!match) return false;
929 }
930 return match;
931 }
932
933
934 /**
935 * Returns the hash code value for this context. The hash code
936 * is computed by exclusive or-ing the hash code of all the protection
937 * domains in the context together.
938 *
939 * @return a hash code value for this context.
940 */
941
942 public int hashCode() {
943 int hashCode = 0;
944
945 if (context == null)
946 return hashCode;
947
948 for (int i =0; i < context.length; i++) {
949 if (context[i] != null)
950 hashCode ^= context[i].hashCode();
951 }
952
953 return hashCode;
954 }
955 }
956