mirror of
https://github.com/BepInEx/mono.git
synced 2026-11-18 17:02:10 -10:00
NativeObjectSecurity is implemented. I've done it in such a way that, for OSes that do not have a unified API for all ACLs, overrides can be done in subclasses such as FileSystemSecurity without trouble. ObjectSecurity, CommonObjectSecurity, and DirectoryObjectSecurity all implemented. MutexSecurity, PipeSecurity, etc. all just add type specialization and nothing else. Implemented all of these as well. Access and Audit rules now correctly use NTAccount in their string overloads (see unit tests). The constructors all provide correct AccessMasks now. In other words, these classes are all now un-broken/no longer stubs. More unit tests for CommonSecurityDescriptor and fixes to pass them. A few had checks that were redundant (implemented by (Authorization|Audit|Access)Rule) as well. These have been removed. The Allow Everyone Full Access default for null DiscretionaryAcls in CommonSecurityDescriptor is, I think, properly implemented. This required some changes to GenericSecurityDescriptor as well, but now Mono matches MS.NET on GetSddl/GetBinaryForm for null DiscretionaryAcl including roundtrip. What's still missing: (1) CommonAcl's RemoveAccess/RemoveAudit. RemoveAll and RemoveSpecific work so it's not a big issue. (2) CommonAcl merging will not yet try to merge a CommonAce together with an ObjectAce. (3) The various *Security constructors. Get/SetAccessControl work on files and directories. However, you still have to create and then set. I am not too familiar with Mono runtime internal calls, but to someone who is: If the SECURITY_ATTRIBUTES parameter to Create*'s lpSecurityDescriptor pointed to the output of GenericSecurityDescriptor's GetBinaryForm, that would be a complete implementation.
416 lines
12 KiB
C#
416 lines
12 KiB
C#
//
|
|
// System.Security.Policy.SecurityIdentifier class
|
|
//
|
|
// Author:
|
|
// Sebastien Pouliot <[email protected]>
|
|
// Kenneth Bell
|
|
// James Bellinger <[email protected]>
|
|
//
|
|
// Copyright (C) 2005, 2006 Novell, Inc (http://www.novell.com)
|
|
// Copyright (C) 2012 James Bellinger
|
|
//
|
|
// Permission is hereby granted, free of charge, to any person obtaining
|
|
// a copy of this software and associated documentation files (the
|
|
// "Software"), to deal in the Software without restriction, including
|
|
// without limitation the rights to use, copy, modify, merge, publish,
|
|
// distribute, sublicense, and/or sell copies of the Software, and to
|
|
// permit persons to whom the Software is furnished to do so, subject to
|
|
// the following conditions:
|
|
//
|
|
// The above copyright notice and this permission notice shall be
|
|
// included in all copies or substantial portions of the Software.
|
|
//
|
|
// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
|
|
// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
|
|
// MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
|
|
// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
|
|
// LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
|
|
// OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
|
|
// WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
|
|
//
|
|
|
|
|
|
using System.Globalization;
|
|
using System.Runtime.InteropServices;
|
|
using System.Text;
|
|
|
|
namespace System.Security.Principal
|
|
{
|
|
[ComVisible (false)]
|
|
public sealed class SecurityIdentifier : IdentityReference, IComparable<SecurityIdentifier>
|
|
{
|
|
private byte[] buffer;
|
|
|
|
public static readonly int MaxBinaryLength = 68;
|
|
public static readonly int MinBinaryLength = 8;
|
|
|
|
public SecurityIdentifier (string sddlForm)
|
|
{
|
|
if (sddlForm == null)
|
|
throw new ArgumentNullException ("sddlForm");
|
|
|
|
buffer = ParseSddlForm (sddlForm);
|
|
}
|
|
|
|
unsafe public SecurityIdentifier (byte[] binaryForm, int offset)
|
|
{
|
|
if (binaryForm == null)
|
|
throw new ArgumentNullException ("binaryForm");
|
|
if ((offset < 0) || (offset > binaryForm.Length - 2))
|
|
throw new ArgumentException ("offset");
|
|
|
|
fixed (byte* binaryFormPtr = binaryForm)
|
|
CreateFromBinaryForm ((IntPtr)(binaryFormPtr + offset), binaryForm.Length - offset);
|
|
}
|
|
|
|
public SecurityIdentifier (IntPtr binaryForm)
|
|
{
|
|
CreateFromBinaryForm (binaryForm, int.MaxValue);
|
|
}
|
|
|
|
void CreateFromBinaryForm (IntPtr binaryForm, int length)
|
|
{
|
|
int revision = Marshal.ReadByte (binaryForm, 0);
|
|
int numSubAuthorities = Marshal.ReadByte (binaryForm, 1);
|
|
if (revision != 1 || numSubAuthorities > 15)
|
|
throw new ArgumentException ("Value was invalid.");
|
|
if (length < (8 + (numSubAuthorities * 4)))
|
|
throw new ArgumentException ("offset");
|
|
|
|
buffer = new byte[8 + (numSubAuthorities * 4)];
|
|
Marshal.Copy (binaryForm, buffer, 0, buffer.Length);
|
|
}
|
|
|
|
public SecurityIdentifier (WellKnownSidType sidType,
|
|
SecurityIdentifier domainSid)
|
|
{
|
|
WellKnownAccount acct = WellKnownAccount.LookupByType (sidType);
|
|
if (acct == null)
|
|
throw new ArgumentException ("Unable to convert SID type: " + sidType);
|
|
|
|
if (acct.IsAbsolute) {
|
|
buffer = ParseSddlForm (acct.Sid);
|
|
} else {
|
|
if (domainSid == null)
|
|
throw new ArgumentNullException ("domainSid");
|
|
|
|
buffer = ParseSddlForm (domainSid.Value + "-" + acct.Rid);
|
|
}
|
|
}
|
|
|
|
public SecurityIdentifier AccountDomainSid {
|
|
get {
|
|
string strForm = this.Value;
|
|
|
|
// Check prefix, and ensure at least 4 sub authorities
|
|
if (!strForm.StartsWith ("S-1-5-21") || buffer[1] < 4)
|
|
return null;
|
|
|
|
// Domain is first four sub-authorities
|
|
byte[] temp = new byte[8 + (4 * 4)];
|
|
Array.Copy (buffer, 0, temp, 0, temp.Length);
|
|
temp[1] = 4;
|
|
return new SecurityIdentifier (temp, 0);
|
|
}
|
|
}
|
|
|
|
public int BinaryLength {
|
|
get { return buffer.Length; }
|
|
}
|
|
|
|
public override string Value {
|
|
get {
|
|
StringBuilder s = new StringBuilder ();
|
|
|
|
ulong authority = GetSidAuthority ();
|
|
s.AppendFormat (CultureInfo.InvariantCulture, "S-1-{0}", authority);
|
|
|
|
for (byte i = 0; i < GetSidSubAuthorityCount (); ++i)
|
|
s.AppendFormat (
|
|
CultureInfo.InvariantCulture,
|
|
"-{0}", GetSidSubAuthority (i));
|
|
|
|
return s.ToString ();
|
|
}
|
|
}
|
|
|
|
ulong GetSidAuthority ()
|
|
{
|
|
return (((ulong)buffer [2]) << 40) | (((ulong)buffer [3]) << 32)
|
|
| (((ulong)buffer [4]) << 24) | (((ulong)buffer [5]) << 16)
|
|
| (((ulong)buffer [6]) << 8) | (((ulong)buffer [7]) << 0);
|
|
}
|
|
|
|
byte GetSidSubAuthorityCount ()
|
|
{
|
|
return buffer [1];
|
|
}
|
|
|
|
uint GetSidSubAuthority (byte index)
|
|
{
|
|
// Note sub authorities little-endian, authority (above) is big-endian!
|
|
int offset = 8 + (index * 4);
|
|
|
|
return (((uint)buffer [offset + 0]) << 0)
|
|
| (((uint)buffer [offset + 1]) << 8)
|
|
| (((uint)buffer [offset + 2]) << 16)
|
|
| (((uint)buffer [offset + 3]) << 24);
|
|
}
|
|
|
|
// The CompareTo ordering was determined by unit test applied to MS.NET implementation,
|
|
// necessary because the CompareTo has no details in its documentation.
|
|
// (See MonoTests.System.Security.AccessControl.DiscretionaryAclTest.)
|
|
// The comparison was determined to be: authority, then subauthority count, then subauthority.
|
|
public int CompareTo (SecurityIdentifier sid)
|
|
{
|
|
if (sid == null)
|
|
throw new ArgumentNullException ("sid");
|
|
|
|
int result;
|
|
if (0 != (result = GetSidAuthority ().CompareTo (sid.GetSidAuthority ()))) return result;
|
|
if (0 != (result = GetSidSubAuthorityCount ().CompareTo (sid.GetSidSubAuthorityCount ()))) return result;
|
|
for (byte i = 0; i < GetSidSubAuthorityCount (); ++i)
|
|
if (0 != (result = GetSidSubAuthority (i).CompareTo (sid.GetSidSubAuthority (i)))) return result;
|
|
return 0;
|
|
}
|
|
|
|
public override bool Equals (object o)
|
|
{
|
|
return Equals (o as SecurityIdentifier);
|
|
}
|
|
|
|
public bool Equals (SecurityIdentifier sid)
|
|
{
|
|
if (sid == null)
|
|
return false;
|
|
return (sid.Value == Value);
|
|
}
|
|
|
|
public void GetBinaryForm (byte[] binaryForm, int offset)
|
|
{
|
|
if (binaryForm == null)
|
|
throw new ArgumentNullException ("binaryForm");
|
|
if ((offset < 0) || (offset > binaryForm.Length - buffer.Length))
|
|
throw new ArgumentException ("offset");
|
|
|
|
Array.Copy (buffer, 0, binaryForm, offset, buffer.Length);
|
|
}
|
|
|
|
public override int GetHashCode ()
|
|
{
|
|
return Value.GetHashCode ();
|
|
}
|
|
|
|
public bool IsAccountSid ()
|
|
{
|
|
return AccountDomainSid != null;
|
|
}
|
|
|
|
public bool IsEqualDomainSid (SecurityIdentifier sid)
|
|
{
|
|
SecurityIdentifier domSid = AccountDomainSid;
|
|
if (domSid == null)
|
|
return false;
|
|
|
|
return domSid.Equals (sid.AccountDomainSid);
|
|
}
|
|
|
|
public override bool IsValidTargetType (Type targetType)
|
|
{
|
|
if (targetType == typeof(SecurityIdentifier))
|
|
return true;
|
|
if (targetType == typeof(NTAccount))
|
|
return true;
|
|
return false;
|
|
}
|
|
|
|
public bool IsWellKnown (WellKnownSidType type)
|
|
{
|
|
WellKnownAccount acct = WellKnownAccount.LookupByType (type);
|
|
if (acct == null)
|
|
return false;
|
|
|
|
string sid = Value;
|
|
|
|
if (acct.IsAbsolute)
|
|
return sid == acct.Sid;
|
|
|
|
return sid.StartsWith ("S-1-5-21", StringComparison.OrdinalIgnoreCase)
|
|
&& sid.EndsWith ("-" + acct.Rid, StringComparison.OrdinalIgnoreCase);
|
|
}
|
|
|
|
public override string ToString ()
|
|
{
|
|
return Value;
|
|
}
|
|
|
|
public override IdentityReference Translate (Type targetType)
|
|
{
|
|
if (targetType == typeof(SecurityIdentifier))
|
|
return this;
|
|
|
|
if (targetType == typeof(NTAccount)) {
|
|
WellKnownAccount acct = WellKnownAccount.LookupBySid (this.Value);
|
|
if (acct == null || acct.Name == null)
|
|
throw new IdentityNotMappedException ("Unable to map SID: " + this.Value);
|
|
|
|
return new NTAccount (acct.Name);
|
|
}
|
|
|
|
throw new ArgumentException ("Unknown type.", "targetType");
|
|
}
|
|
|
|
public static bool operator == (SecurityIdentifier left, SecurityIdentifier right)
|
|
{
|
|
if (((object)left) == null)
|
|
return (((object)right) == null);
|
|
if (((object)right) == null)
|
|
return false;
|
|
return (left.Value == right.Value);
|
|
}
|
|
|
|
public static bool operator != (SecurityIdentifier left, SecurityIdentifier right)
|
|
{
|
|
if (((object)left) == null)
|
|
return (((object)right) != null);
|
|
if (((object)right) == null)
|
|
return true;
|
|
return (left.Value != right.Value);
|
|
}
|
|
|
|
internal string GetSddlForm()
|
|
{
|
|
string sidString = Value;
|
|
|
|
WellKnownAccount acct = WellKnownAccount.LookupBySid(sidString);
|
|
if(acct == null || acct.SddlForm == null)
|
|
return sidString;
|
|
|
|
return acct.SddlForm;
|
|
}
|
|
|
|
internal static SecurityIdentifier ParseSddlForm(string sddlForm, ref int pos)
|
|
{
|
|
if (sddlForm.Length - pos < 2)
|
|
throw new ArgumentException("Invalid SDDL string.", "sddlForm");
|
|
|
|
string sid;
|
|
int len;
|
|
|
|
string prefix = sddlForm.Substring(pos, 2).ToUpperInvariant();
|
|
if (prefix == "S-")
|
|
{
|
|
// Looks like a SID, try to parse it.
|
|
int endPos = pos;
|
|
|
|
char ch = Char.ToUpperInvariant(sddlForm[endPos]);
|
|
while (ch == 'S' || ch == '-' || ch == 'X'
|
|
|| (ch >= '0' && ch <= '9') || (ch >= 'A' && ch <= 'F')) {
|
|
++endPos;
|
|
ch = Char.ToUpperInvariant(sddlForm[endPos]);
|
|
}
|
|
|
|
sid = sddlForm.Substring(pos, endPos - pos);
|
|
len = endPos - pos;
|
|
} else {
|
|
sid = prefix;
|
|
len = 2;
|
|
}
|
|
|
|
SecurityIdentifier ret = new SecurityIdentifier(sid);
|
|
pos += len;
|
|
return ret;
|
|
}
|
|
|
|
private static byte[] ParseSddlForm (string sddlForm)
|
|
{
|
|
string sid = sddlForm;
|
|
|
|
// If only 2 characters long, can't be a full SID string - so assume
|
|
// it's an attempted alias. Do that conversion first.
|
|
if(sddlForm.Length == 2) {
|
|
WellKnownAccount acct = WellKnownAccount.LookupBySddlForm(sddlForm);
|
|
if (acct == null)
|
|
throw new ArgumentException(
|
|
"Invalid SDDL string - unrecognized account: " + sddlForm,
|
|
"sddlForm");
|
|
if (!acct.IsAbsolute)
|
|
throw new NotImplementedException(
|
|
"Mono unable to convert account to SID: "
|
|
+ (acct.Name != null ? acct.Name : sddlForm));
|
|
|
|
sid = acct.Sid;
|
|
}
|
|
|
|
string[] elements = sid.ToUpperInvariant ().Split ('-');
|
|
int numSubAuthorities = elements.Length - 3;
|
|
|
|
if (elements.Length < 3 || elements[0] != "S" || numSubAuthorities > 15)
|
|
throw new ArgumentException ("Value was invalid.");
|
|
|
|
if (elements[1] != "1")
|
|
throw new ArgumentException ("Only SIDs with revision 1 are supported");
|
|
|
|
byte[] buffer = new byte[8 + (numSubAuthorities * 4)];
|
|
buffer[0] = 1;
|
|
buffer[1] = (byte)numSubAuthorities;
|
|
|
|
ulong authority;
|
|
if (!TryParseAuthority (elements[2], out authority))
|
|
throw new ArgumentException ("Value was invalid.");
|
|
buffer[2] = (byte)((authority >> 40) & 0xFF);
|
|
buffer[3] = (byte)((authority >> 32) & 0xFF);
|
|
buffer[4] = (byte)((authority >> 24) & 0xFF);
|
|
buffer[5] = (byte)((authority >> 16) & 0xFF);
|
|
buffer[6] = (byte)((authority >> 8) & 0xFF);
|
|
buffer[7] = (byte)((authority >> 0) & 0xFF);
|
|
|
|
for (int i = 0; i < numSubAuthorities; ++i) {
|
|
uint subAuthority;
|
|
|
|
if (!TryParseSubAuthority (elements[i + 3],
|
|
out subAuthority))
|
|
throw new ArgumentException ("Value was invalid.");
|
|
|
|
// Note sub authorities little-endian!
|
|
int offset = 8 + (i * 4);
|
|
buffer[offset + 0] = (byte)(subAuthority >> 0);
|
|
buffer[offset + 1] = (byte)(subAuthority >> 8);
|
|
buffer[offset + 2] = (byte)(subAuthority >> 16);
|
|
buffer[offset + 3] = (byte)(subAuthority >> 24);
|
|
}
|
|
|
|
return buffer;
|
|
}
|
|
|
|
private static bool TryParseAuthority (string s, out ulong result)
|
|
{
|
|
if (s.StartsWith ("0X")) {
|
|
return ulong.TryParse (s.Substring (2),
|
|
NumberStyles.HexNumber,
|
|
CultureInfo.InvariantCulture,
|
|
out result);
|
|
} else {
|
|
return ulong.TryParse (s, NumberStyles.Integer,
|
|
CultureInfo.InvariantCulture,
|
|
out result);
|
|
}
|
|
}
|
|
|
|
private static bool TryParseSubAuthority (string s, out uint result)
|
|
{
|
|
if (s.StartsWith ("0X")) {
|
|
return uint.TryParse (s.Substring (2),
|
|
NumberStyles.HexNumber,
|
|
CultureInfo.InvariantCulture,
|
|
out result);
|
|
} else {
|
|
return uint.TryParse (s, NumberStyles.Integer,
|
|
CultureInfo.InvariantCulture,
|
|
out result);
|
|
}
|
|
}
|
|
}
|
|
}
|
|
|