jt
2021-06-10 5d0d028456874576560552f5a5c4e8b801786f11
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
#region Apache License
//
// Licensed to the Apache Software Foundation (ASF) under one or more 
// contributor license agreements. See the NOTICE file distributed with
// this work for additional information regarding copyright ownership. 
// The ASF licenses this file to you under the Apache License, Version 2.0
// (the "License"); you may not use this file except in compliance with 
// the License. You may obtain a copy of the License at
//
// http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.
//
#endregion
 
using System;
 
using log4net.Util;
 
namespace log4net.Core
{
    /// <summary>
    /// The <see cref="SecurityContextProvider"/> providers default <see cref="SecurityContext"/> instances.
    /// </summary>
    /// <remarks>
    /// <para>
    /// A configured component that interacts with potentially protected system
    /// resources uses a <see cref="SecurityContext"/> to provide the elevated
    /// privileges required. If the <see cref="SecurityContext"/> object has
    /// been not been explicitly provided to the component then the component
    /// will request one from this <see cref="SecurityContextProvider"/>.
    /// </para>
    /// <para>
    /// By default the <see cref="SecurityContextProvider.DefaultProvider"/> is
    /// an instance of <see cref="SecurityContextProvider"/> which returns only
    /// <see cref="NullSecurityContext"/> objects. This is a reasonable default
    /// where the privileges required are not know by the system.
    /// </para>
    /// <para>
    /// This default behavior can be overridden by subclassing the <see cref="SecurityContextProvider"/>
    /// and overriding the <see cref="CreateSecurityContext"/> method to return
    /// the desired <see cref="SecurityContext"/> objects. The default provider
    /// can be replaced by programmatically setting the value of the 
    /// <see cref="SecurityContextProvider.DefaultProvider"/> property.
    /// </para>
    /// <para>
    /// An alternative is to use the <c>log4net.Config.SecurityContextProviderAttribute</c>
    /// This attribute can be applied to an assembly in the same way as the
    /// <c>log4net.Config.XmlConfiguratorAttribute"</c>. The attribute takes
    /// the type to use as the <see cref="SecurityContextProvider"/> as an argument.
    /// </para>
    /// </remarks>
    /// <author>Nicko Cadell</author>
    public class SecurityContextProvider
    {
        /// <summary>
        /// The default provider
        /// </summary>
        private static SecurityContextProvider s_defaultProvider = new SecurityContextProvider();
 
        /// <summary>
        /// Gets or sets the default SecurityContextProvider
        /// </summary>
        /// <value>
        /// The default SecurityContextProvider
        /// </value>
        /// <remarks>
        /// <para>
        /// The default provider is used by configured components that
        /// require a <see cref="SecurityContext"/> and have not had one
        /// given to them.
        /// </para>
        /// <para>
        /// By default this is an instance of <see cref="SecurityContextProvider"/>
        /// that returns <see cref="NullSecurityContext"/> objects.
        /// </para>
        /// <para>
        /// The default provider can be set programmatically by setting
        /// the value of this property to a sub class of <see cref="SecurityContextProvider"/>
        /// that has the desired behavior.
        /// </para>
        /// </remarks>
        public static SecurityContextProvider DefaultProvider
        {
            get { return s_defaultProvider; }
            set { s_defaultProvider = value; }
        }
 
        /// <summary>
        /// Protected default constructor to allow subclassing
        /// </summary>
        /// <remarks>
        /// <para>
        /// Protected default constructor to allow subclassing
        /// </para>
        /// </remarks>
        protected SecurityContextProvider()
        {
        }
 
        /// <summary>
        /// Create a SecurityContext for a consumer
        /// </summary>
        /// <param name="consumer">The consumer requesting the SecurityContext</param>
        /// <returns>An impersonation context</returns>
        /// <remarks>
        /// <para>
        /// The default implementation is to return a <see cref="NullSecurityContext"/>.
        /// </para>
        /// <para>
        /// Subclasses should override this method to provide their own
        /// behavior.
        /// </para>
        /// </remarks>
        public virtual SecurityContext CreateSecurityContext(object consumer)
        {
            return NullSecurityContext.Instance;
        }
    }
}