libmongocrypt-helper 1.6.1.0.1001 → 1.7.4.0.1000

data/ext/libmongocrypt/libmongocrypt/bindings/cs/MongoDB.Libmongocrypt/LibraryLoader.cs

@@ -0,0 +1,252 @@
+/*
+ * Copyright 2019–present MongoDB, Inc.
+ *
+ * Licensed 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.
+ */
+
+using System;
+using System.Collections.Generic;
+using System.IO;
+using System.Reflection;
+using System.Runtime.InteropServices;
+
+namespace MongoDB.Libmongocrypt
+{
+    /// <summary>
+    /// LibraryLoader abstracts loading C functions from a shared library across OS
+    /// </summary>
+    internal class LibraryLoader
+    {
+        private ISharedLibraryLoader _loader;
+
+        public LibraryLoader()
+        {
+            if (!Environment.Is64BitProcess)
+            {
+                throw new PlatformNotSupportedException($"{this.GetType().Namespace} needs to be run in a 64-bit process.");
+            }
+
+            // Windows:
+            // https://stackoverflow.com/questions/2864673/specify-the-search-path-for-dllimport-in-net
+            //
+            // See for better ways
+            // https://github.com/dotnet/coreclr/issues/930
+            // https://github.com/dotnet/corefx/issues/32015
+            List<string> candidatePaths = new List<string>();
+
+            // In the nuget package, get the shared library from a relative path of this assembly
+            // Also, when running locally, get the shared library from a relative path of this assembly
+            var assembly = typeof(LibraryLoader).GetTypeInfo().Assembly;
+            var location = assembly.Location;
+            string basepath = Path.GetDirectoryName(location);
+            candidatePaths.Add(basepath);
+
+            switch (OperatingSystemHelper.CurrentOperatingSystem)
+            {
+                case OperatingSystemPlatform.MacOS:
+                    {
+                        string[] suffixPaths = new[]
+                        {
+                            "../../runtimes/osx/native/",
+                            "runtimes/osx/native/",
+                            string.Empty
+                        };
+                        string path = FindLibrary(candidatePaths, suffixPaths, "libmongocrypt.dylib");
+                        _loader = new DarwinLibraryLoader(path);
+                    }
+                    break;
+                case OperatingSystemPlatform.Linux:
+                    {
+                        string[] suffixPaths = new[]
+                        {
+                            "../../runtimes/linux/native/",
+                            "runtimes/linux/native/",
+                            string.Empty
+                        };
+                        string path = FindLibrary(candidatePaths, suffixPaths, "libmongocrypt.so");
+                        _loader = new LinuxLibrary(path);
+                    }
+                    break;
+                case OperatingSystemPlatform.Windows:
+                    {
+                        string[] suffixPaths = new[]
+                        {
+                            @"..\..\runtimes\win\native\",
+                            @".\runtimes\win\native\",
+                            string.Empty
+                        };
+                        string path = FindLibrary(candidatePaths, suffixPaths, "mongocrypt.dll");
+                        _loader = new WindowsLibrary(path);
+                    }
+                    break;
+                default:
+                    // should not be reached. If we're here, then there is a bug in OperatingSystemHelper
+                    throw new PlatformNotSupportedException("Unsupported operating system.");
+            }
+        }
+
+        private string FindLibrary(IList<string> basePaths, string[] suffixPaths, string library)
+        {
+            var candidates = new List<string>();
+            foreach (var basePath in basePaths)
+            {
+                foreach (var suffix in suffixPaths)
+                {
+                    string path = Path.Combine(basePath, suffix, library);
+                    if (File.Exists(path))
+                    {
+                        return path;
+                    }
+                    candidates.Add(path);
+                }
+            }
+
+            throw new FileNotFoundException("Could not find: " + library + " --\n Tried: " + string.Join(",", candidates));
+        }
+
+        public T GetFunction<T>(string name)
+        {
+            IntPtr ptr = _loader.GetFunction(name);
+            if (ptr == IntPtr.Zero)
+            {
+                throw new FunctionNotFoundException(name);
+            }
+
+            return Marshal.GetDelegateForFunctionPointer<T>(ptr);
+
+        }
+
+        public class FunctionNotFoundException : Exception
+        {
+            public FunctionNotFoundException(string message) : base(message) { }
+        }
+
+        private interface ISharedLibraryLoader
+        {
+            IntPtr GetFunction(string name);
+        }
+
+        /// <summary>
+        /// macOS Dynamic Library loader using dlsym
+        /// </summary>
+        private class DarwinLibraryLoader : ISharedLibraryLoader
+        {
+
+            // See dlfcn.h
+            // #define RTLD_LAZY       0x1
+            // #define RTLD_NOW        0x2
+            // #define RTLD_LOCAL      0x4
+            // #define RTLD_GLOBAL     0x8
+            public const int RTLD_GLOBAL = 0x8;
+            public const int RTLD_NOW = 0x2;
+
+            private readonly IntPtr _handle;
+            public DarwinLibraryLoader(string path)
+            {
+                _handle = dlopen(path, RTLD_GLOBAL | RTLD_NOW);
+                if (_handle == IntPtr.Zero)
+                {
+                    throw new FileNotFoundException(path);
+                }
+            }
+
+            public IntPtr GetFunction(string name)
+            {
+                return dlsym(_handle, name);
+            }
+
+#pragma warning disable IDE1006 // Naming Styles
+            [DllImport("libdl")]
+            public static extern IntPtr dlopen(string filename, int flags);
+
+            [DllImport("libdl", CallingConvention = CallingConvention.Cdecl, CharSet = CharSet.Ansi)]
+            public static extern IntPtr dlsym(IntPtr handle, string symbol);
+#pragma warning restore IDE1006 // Naming Styles
+        }
+
+        /// <summary>
+        /// Linux Shared Object loader using dlsym
+        /// </summary>
+        private class LinuxLibrary : ISharedLibraryLoader
+        {
+            // See dlfcn.h
+            // #define RTLD_LAZY       0x1
+            // #define RTLD_NOW        0x2
+            // #define RTLD_LOCAL      0x4
+            // #define RTLD_GLOBAL     0x100
+            public const int RTLD_GLOBAL = 0x100;
+            public const int RTLD_NOW = 0x2;
+
+            private readonly IntPtr _handle;
+            public LinuxLibrary(string path)
+            {
+                _handle = dlopen(path, RTLD_GLOBAL | RTLD_NOW);
+                if (_handle == IntPtr.Zero)
+                {
+                    throw new FileNotFoundException(path);
+                }
+            }
+
+            public IntPtr GetFunction(string name)
+            {
+                return dlsym(_handle, name);
+            }
+
+#pragma warning disable IDE1006 // Naming Styles
+            [DllImport("libdl")]
+            public static extern IntPtr dlopen(string filename, int flags);
+
+            [DllImport("libdl", CallingConvention = CallingConvention.Cdecl, CharSet = CharSet.Ansi)]
+            public static extern IntPtr dlsym(IntPtr handle, string symbol);
+#pragma warning restore IDE1006 // Naming Styles
+        }
+
+        /// <summary>
+        /// Windows DLL loader using GetProcAddress
+        /// </summary>
+        private class WindowsLibrary : ISharedLibraryLoader
+        {
+            private readonly IntPtr _handle;
+            public WindowsLibrary(string path)
+            {
+                _handle = LoadLibrary(path);
+                if (_handle == IntPtr.Zero)
+                {
+                    var gle = Marshal.GetLastWin32Error();
+
+                    // error code 193 indicates that a 64-bit OS has tried to load a 32-bit dll
+                    // https://docs.microsoft.com/en-us/windows/win32/debug/system-error-codes--0-499-
+                    throw new LibraryLoadingException(path + ", Windows Error: " + gle);
+                }
+            }
+
+            public IntPtr GetFunction(string name)
+            {
+                var ptr = GetProcAddress(_handle, name);
+                if (ptr == null)
+                {
+                    var gle = Marshal.GetLastWin32Error();
+                    throw new FunctionNotFoundException(name + ", Windows Error: " + gle);
+                }
+
+                return ptr;
+            }
+
+            [DllImport("kernel32", SetLastError = true, CharSet = CharSet.Ansi)]
+            public static extern IntPtr LoadLibrary([MarshalAs(UnmanagedType.LPStr)] string lpFileName);
+
+            [DllImport("kernel32", CharSet = CharSet.Ansi, ExactSpelling = true, SetLastError = true)]
+            public static extern IntPtr GetProcAddress(IntPtr hModule, string procName);
+        }
+    }
+}

data/ext/libmongocrypt/libmongocrypt/bindings/cs/MongoDB.Libmongocrypt/LibraryLoadingException.cs

@@ -0,0 +1,34 @@
+/*
+ * Copyright 2019–present MongoDB, Inc.
+ *
+ * Licensed 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.
+ */
+using System;
+
+namespace MongoDB.Libmongocrypt
+{
+    /// <summary>
+    /// An exception that indicates that an error occured while loading a library.
+    /// </summary>
+    public class LibraryLoadingException : Exception
+    {
+        /// <summary>
+        /// Initializes an instance of a <see cref="LibraryLoadingException"/>
+        /// </summary>
+        /// <param name="message">The message.</param>
+        public LibraryLoadingException(string message) : base(message)
+        {
+        }
+
+    }
+}

data/ext/libmongocrypt/libmongocrypt/bindings/cs/MongoDB.Libmongocrypt/License.txt

@@ -0,0 +1,14 @@
+/* Copyright 2010–present MongoDB Inc.
+*
+* Licensed 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.
+*/

data/ext/libmongocrypt/libmongocrypt/bindings/cs/MongoDB.Libmongocrypt/LogLevel.cs

@@ -0,0 +1,26 @@
+/*
+ * Copyright 2019–present MongoDB, Inc.
+ *
+ * Licensed 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.
+ */
+
+namespace MongoDB.Libmongocrypt
+{
+    public enum LogLevel {
+        MONGOCRYPT_LOG_LEVEL_FATAL = 0,
+        MONGOCRYPT_LOG_LEVEL_ERROR = 1,
+        MONGOCRYPT_LOG_LEVEL_WARNING = 2,
+        MONGOCRYPT_LOG_LEVEL_INFO = 3,
+        MONGOCRYPT_LOG_LEVEL_TRACE = 4
+    };
+}

data/ext/libmongocrypt/libmongocrypt/bindings/cs/MongoDB.Libmongocrypt/MongoCryptSafeHandle.cs

@@ -0,0 +1,48 @@
+/*
+ * Copyright 2019–present MongoDB, Inc.
+ *
+ * Licensed 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.
+ */
+
+using System.Runtime.ConstrainedExecution;
+
+namespace MongoDB.Libmongocrypt
+{
+    /// <summary>
+    /// SafeHandle to manage the lifetime of a mongocrypt_t.
+    /// </summary>
+    /// <seealso cref="System.Runtime.InteropServices.SafeHandle" />
+    internal class MongoCryptSafeHandle : CheckableSafeHandle
+    {
+        private MongoCryptSafeHandle() : base()
+        {
+        }
+
+        public override void Check(Status status, bool success)
+        {
+            if (!success)
+            {
+                Library.mongocrypt_status(this, status.Handle);
+                status.ThrowExceptionIfNeeded();
+            }
+        }
+
+        [ReliabilityContract(Consistency.WillNotCorruptState, Cer.MayFail)]
+        protected override bool ReleaseHandle()
+        {
+            // Here, we must obey all rules for constrained execution regions.
+            Library.mongocrypt_destroy(handle);
+            return true;
+        }
+    }
+}

data/ext/libmongocrypt/libmongocrypt/bindings/cs/MongoDB.Libmongocrypt/MongoDB.Libmongocrypt.csproj

@@ -0,0 +1,106 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <PropertyGroup>
+    <TargetFrameworks>net472;netstandard2.0;netstandard2.1</TargetFrameworks>
+    <TargetFrameworks Condition="'$(OS)' != 'Windows_NT'">netstandard2.0;netstandard2.1</TargetFrameworks>
+    <PlatformTarget>AnyCPU</PlatformTarget>
+    <LangVersion>7.3</LangVersion>
+    <AllowUnsafeBlocks>true</AllowUnsafeBlocks>
+    <CodeAnalysisRuleSet>MongoDB.Libmongocrypt.ruleset</CodeAnalysisRuleSet>
+  </PropertyGroup>
+
+  <PropertyGroup>
+    <AssemblyTitle>MongoDB.Libmongocrypt</AssemblyTitle>
+    <Product>MongoDB.Libmongocrypt</Product>
+    <Company>MongoDB Inc.</Company>
+    <Copyright>Copyright © 2019–present MongoDB Inc.</Copyright>
+    <Description>Libmongocrypt wrapper for the .NET driver.</Description>
+    <Authors>MongoDB Inc.</Authors>
+    <PackageIconUrl>http://jobs.mongodb.org/files/logos/889002/889002.png</PackageIconUrl>
+    <PackageRequireLicenseAcceptance>true</PackageRequireLicenseAcceptance>
+    <PackageDescription>Libmongocrypt wrapper for the .NET driver.</PackageDescription>
+    <PackageProjectUrl>http://www.mongodb.org/display/DOCS/CSharp+Language+Center</PackageProjectUrl>
+    <PackageLicenseFile>License.txt</PackageLicenseFile>
+    <PackageTags>mongodb;mongo;nosql</PackageTags>
+    <PackageLanguage>en-US</PackageLanguage>
+    <IncludeSymbols>true</IncludeSymbols>
+  </PropertyGroup>
+
+  <PropertyGroup>
+    <LibMongoCryptBinaries>../../../cmake-build/$(Configuration)</LibMongoCryptBinaries>
+    <LibMongoCryptBinaries Condition="'$(Configuration)'=='Release' And '$(OS)' == 'Windows_NT'">../../../cmake-build/RelWithDebInfo/</LibMongoCryptBinaries>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <Content Include="$(LibMongoCryptBinaries)/libmongocrypt.so" Condition="Exists('$(LibMongoCryptBinaries)/libmongocrypt.so')">
+      <Link>libmongocrypt.so</Link>
+      <CopyToOutputDirectory>Always</CopyToOutputDirectory>
+    </Content>
+
+    <Content Include="$(LibMongoCryptBinaries)/libmongocrypt.dylib" Condition="Exists('$(LibMongoCryptBinaries)/libmongocrypt.dylib')">
+      <Link>libmongocrypt.dylib</Link>
+      <CopyToOutputDirectory>Always</CopyToOutputDirectory>
+    </Content>
+
+    <Content Include="$(LibMongoCryptBinaries)/mongocrypt.dll" Condition="Exists('$(LibMongoCryptBinaries)/mongocrypt.dll')">
+      <Link>mongocrypt.dll</Link>
+      <CopyToOutputDirectory>Always</CopyToOutputDirectory>
+    </Content>
+
+    <Content Include="$(LibMongoCryptBinaries)/mongocrypt.pdb" Condition="Exists('$(LibMongoCryptBinaries)/mongocrypt.pdb')">
+      <Link>mongocrypt.pdb</Link>
+      <CopyToOutputDirectory>Always</CopyToOutputDirectory>
+    </Content>
+  </ItemGroup>
+
+  <!-- <ItemGroup>
+    <PackageReference Include="StyleCop.Analyzers" Version="1.0.2">
+      <PrivateAssets>all</PrivateAssets>
+      <IncludeAssets>runtime; build; native; contentfiles; analyzers</IncludeAssets>
+    </PackageReference>
+  </ItemGroup> -->
+  <ItemGroup>
+    <Content Include="$(LibMongoCryptBinaries)/mongocrypt.dll">
+      <Pack>true</Pack>
+      <PackagePath>runtimes/win/native</PackagePath>
+    </Content>
+    <Content Include="$(LibMongoCryptBinaries)/libmongocrypt.so">
+      <Pack>true</Pack>
+      <PackagePath>runtimes/linux/native</PackagePath>
+    </Content>
+    <Content Include="$(LibMongoCryptBinaries)/libmongocrypt.dylib">
+      <Pack>true</Pack>
+      <PackagePath>runtimes/osx/native</PackagePath>
+    </Content>
+  </ItemGroup>
+
+  <ItemGroup>
+    <Content Include="License.txt">
+      <Pack>true</Pack>
+      <PackagePath>$(PackageLicenseFile)</PackagePath>
+    </Content>
+  </ItemGroup>
+
+  <ItemGroup>
+    <Content Include="MongoDB.Libmongocrypt.targets">
+      <Pack>true</Pack>
+      <PackagePath>build</PackagePath>
+    </Content>
+  </ItemGroup>
+
+  <PropertyGroup Condition="'$(Version)'==''">
+    <Version>1.1.0</Version>
+  </PropertyGroup>
+
+  <PropertyGroup Condition=" '$(Configuration)|$(Platform)' == 'Debug|x64' ">
+    <DocumentationFile>bin\x64\Debug\MongoDB.Libmongocrypt.xml</DocumentationFile>
+  </PropertyGroup>
+
+  <PropertyGroup Condition=" '$(Configuration)|$(Platform)' == 'Release|x64' ">
+    <DebugSymbols>true</DebugSymbols>
+    <DocumentationFile>bin\x64\Release\MongoDB.Libmongocrypt.xml</DocumentationFile>
+  </PropertyGroup>
+
+  <Import Project="Package.csproj.include" Condition="Exists('Package.csproj.include')" />
+
+</Project>

data/ext/libmongocrypt/libmongocrypt/bindings/cs/MongoDB.Libmongocrypt/MongoDB.Libmongocrypt.ruleset

@@ -0,0 +1,85 @@
+<?xml version="1.0" encoding="utf-8"?>
+<RuleSet Name="Microsoft Managed Recommended Rules" Description="These rules focus on the most critical problems in your code, including potential security holes, application crashes, and other important logic and design errors. It is recommended to include this rule set in any custom rule set you create for your projects." ToolsVersion="10.0">
+  <Localization ResourceAssembly="Microsoft.VisualStudio.CodeAnalysis.RuleSets.Strings.dll" ResourceBaseName="Microsoft.VisualStudio.CodeAnalysis.RuleSets.Strings.Localized">
+    <Name Resource="MinimumRecommendedRules_Name" />
+    <Description Resource="MinimumRecommendedRules_Description" />
+  </Localization>
+  <Rules AnalyzerId="Microsoft.Analyzers.ManagedCodeAnalysis" RuleNamespace="Microsoft.Rules.Managed">
+    <Rule Id="CA1001" Action="Warning" />
+    <Rule Id="CA1009" Action="Warning" />
+    <Rule Id="CA1016" Action="Warning" />
+    <Rule Id="CA1033" Action="Warning" />
+    <Rule Id="CA1049" Action="Warning" />
+    <Rule Id="CA1060" Action="Warning" />
+    <Rule Id="CA1061" Action="Warning" />
+    <Rule Id="CA1063" Action="Warning" />
+    <Rule Id="CA1065" Action="Warning" />
+    <Rule Id="CA1301" Action="Warning" />
+    <Rule Id="CA1400" Action="Warning" />
+    <Rule Id="CA1401" Action="Warning" />
+    <Rule Id="CA1403" Action="Warning" />
+    <Rule Id="CA1404" Action="Warning" />
+    <Rule Id="CA1405" Action="Warning" />
+    <Rule Id="CA1410" Action="Warning" />
+    <Rule Id="CA1415" Action="Warning" />
+    <Rule Id="CA1821" Action="Warning" />
+    <Rule Id="CA1900" Action="Warning" />
+    <Rule Id="CA1901" Action="Warning" />
+    <Rule Id="CA2002" Action="Warning" />
+    <Rule Id="CA2100" Action="Warning" />
+    <Rule Id="CA2101" Action="Warning" />
+    <Rule Id="CA2108" Action="Warning" />
+    <Rule Id="CA2111" Action="Warning" />
+    <Rule Id="CA2112" Action="Warning" />
+    <Rule Id="CA2114" Action="Warning" />
+    <Rule Id="CA2116" Action="Warning" />
+    <Rule Id="CA2117" Action="Warning" />
+    <Rule Id="CA2122" Action="Warning" />
+    <Rule Id="CA2123" Action="Warning" />
+    <Rule Id="CA2124" Action="Warning" />
+    <Rule Id="CA2126" Action="Warning" />
+    <Rule Id="CA2131" Action="Warning" />
+    <Rule Id="CA2132" Action="Warning" />
+    <Rule Id="CA2133" Action="Warning" />
+    <Rule Id="CA2134" Action="Warning" />
+    <Rule Id="CA2137" Action="Warning" />
+    <Rule Id="CA2138" Action="Warning" />
+    <Rule Id="CA2140" Action="Warning" />
+    <Rule Id="CA2141" Action="Warning" />
+    <Rule Id="CA2146" Action="Warning" />
+    <Rule Id="CA2147" Action="Warning" />
+    <Rule Id="CA2149" Action="Warning" />
+    <Rule Id="CA2200" Action="Warning" />
+    <Rule Id="CA2202" Action="Warning" />
+    <Rule Id="CA2207" Action="Warning" />
+    <Rule Id="CA2212" Action="Warning" />
+    <Rule Id="CA2213" Action="Warning" />
+    <Rule Id="CA2214" Action="Warning" />
+    <Rule Id="CA2216" Action="Warning" />
+    <Rule Id="CA2220" Action="Warning" />
+    <Rule Id="CA2229" Action="Warning" />
+    <Rule Id="CA2231" Action="Warning" />
+    <Rule Id="CA2232" Action="Warning" />
+    <Rule Id="CA2235" Action="Warning" />
+    <Rule Id="CA2236" Action="Warning" />
+    <Rule Id="CA2237" Action="Warning" />
+    <Rule Id="CA2238" Action="Warning" />
+    <Rule Id="CA2240" Action="Warning" />
+    <Rule Id="CA2241" Action="Warning" />
+    <Rule Id="CA2242" Action="Warning" />
+  </Rules>
+  <Rules AnalyzerId="StyleCop.Analyzers" RuleNamespace="StyleCop.Analyzers">
+    <Rule Id="SA1101" Action="None" />
+    <Rule Id="SX1101" Action="Warning" />
+    <Rule Id="SA1309" Action="None" />
+    <Rule Id="SA1200" Action="None" />
+    <Rule Id="SA1124" Action="None" />
+    <Rule Id="SA1633" Action="None" />
+    <Rule Id="SA1652" Action="None" />
+    <Rule Id="SA1300" Action="None" />
+    <Rule Id="SA1307" Action="None" />
+    <Rule Id="SA1310" Action="None" />
+    <Rule Id="SA1304" Action="None" />
+    <Rule Id="SA1311" Action="None" />
+  </Rules>
+</RuleSet>

data/ext/libmongocrypt/libmongocrypt/bindings/cs/MongoDB.Libmongocrypt/MongoDB.Libmongocrypt.targets

@@ -0,0 +1,21 @@
+<?xml version="1.0" encoding="utf-8"?>
+<Project ToolsVersion="4.0" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
+  <ItemGroup Condition="$([MSBuild]::IsOsPlatform('Windows'))">
+    <Content Include="$(MSBuildThisFileDirectory)../runtimes/win/native/mongocrypt.dll">
+      <CopyToOutputDirectory>Always</CopyToOutputDirectory>
+      <Link>mongocrypt.dll</Link>
+    </Content>
+  </ItemGroup>
+  <ItemGroup Condition="$([MSBuild]::IsOsPlatform('Linux'))">
+    <Content Include="$(MSBuildThisFileDirectory)../runtimes/linux/native/libmongocrypt.so">
+      <CopyToOutputDirectory>Always</CopyToOutputDirectory>
+      <Link>libmongocrypt.so</Link>
+    </Content>
+  </ItemGroup>
+  <ItemGroup Condition="$([MSBuild]::IsOsPlatform('OSX'))">
+    <Content Include="$(MSBuildThisFileDirectory)../runtimes/osx/native/libmongocrypt.dylib">
+      <CopyToOutputDirectory>Always</CopyToOutputDirectory>
+      <Link>libmongocrypt.dylib</Link>
+    </Content>
+  </ItemGroup>
+</Project>

data/ext/libmongocrypt/libmongocrypt/bindings/cs/MongoDB.Libmongocrypt/OperatingSystemHelper.cs

@@ -0,0 +1,59 @@
+/*
+ * Copyright 2020–present MongoDB, Inc.
+ *
+ * Licensed 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.
+ */
+
+#if !NET472
+using System;
+using System.Runtime.InteropServices;
+#endif
+
+namespace MongoDB.Libmongocrypt
+{
+    internal enum OperatingSystemPlatform
+    {
+        Windows,
+        Linux,
+        MacOS
+    }
+
+    internal static class OperatingSystemHelper
+    {
+        public static OperatingSystemPlatform CurrentOperatingSystem
+        {
+            get
+            {
+#if NET472
+                return OperatingSystemPlatform.Windows;
+#else
+                if (RuntimeInformation.IsOSPlatform(OSPlatform.OSX))
+                {
+                    return OperatingSystemPlatform.MacOS;
+                }
+                else if (RuntimeInformation.IsOSPlatform(OSPlatform.Linux))
+                {
+                    return OperatingSystemPlatform.Linux;
+                }
+                else if (RuntimeInformation.IsOSPlatform(OSPlatform.Windows))
+                {
+                    return OperatingSystemPlatform.Windows;
+                }
+
+                // should not be reached. If we're here, then there is a bug in the library
+                throw new PlatformNotSupportedException($"Unsupported platform '{RuntimeInformation.OSDescription}'.");
+#endif
+            }
+        }
+    }
+}