2 // CertificateValidationHelper.cs
5 // Martin Baulig <martin.baulig@xamarin.com>
7 // Copyright (c) 2015 Xamarin, Inc.
9 // Permission is hereby granted, free of charge, to any person obtaining a copy
10 // of this software and associated documentation files (the "Software"), to deal
11 // in the Software without restriction, including without limitation the rights
12 // to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
13 // copies of the Software, and to permit persons to whom the Software is
14 // furnished to do so, subject to the following conditions:
16 // The above copyright notice and this permission notice shall be included in
17 // all copies or substantial portions of the Software.
19 // THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
20 // IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
21 // FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
22 // AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
23 // LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
24 // OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
30 using System.Net.Security;
31 using System.Threading;
32 using System.Security.Cryptography.X509Certificates;
33 using Mono.Security.Protocol.Tls;
34 using MX = Mono.Security.X509;
35 using Mono.Net.Security;
37 namespace Mono.Security.Interface
39 public class ValidationResult
44 MonoSslPolicyErrors? policy_errors;
46 public ValidationResult (bool trusted, bool user_denied, int error_code, MonoSslPolicyErrors? policy_errors)
48 this.trusted = trusted;
49 this.user_denied = user_denied;
50 this.error_code = error_code;
51 this.policy_errors = policy_errors;
54 internal ValidationResult (bool trusted, bool user_denied, int error_code)
56 this.trusted = trusted;
57 this.user_denied = user_denied;
58 this.error_code = error_code;
62 get { return trusted; }
65 public bool UserDenied {
66 get { return user_denied; }
69 public int ErrorCode {
70 get { return error_code; }
73 public MonoSslPolicyErrors? PolicyErrors {
74 get { return policy_errors; }
79 * Internal interface - do not implement
81 public interface ICertificateValidator
83 MonoTlsSettings Settings {
88 * Returns `true` if a client certificate has been selected (which could be `null`).
90 bool SelectClientCertificate (
91 string targetHost, X509CertificateCollection localCertificates, X509Certificate remoteCertificate,
92 string[] acceptableIssuers, out X509Certificate clientCertificate);
95 * If @serverMode is true, then we're a server and want to validate a certificate that we received from a client.
97 ValidationResult ValidateCertificate (string targetHost, bool serverMode, X509CertificateCollection certificates);
100 internal interface ICertificateValidator2 : ICertificateValidator
105 ValidationResult ValidateCertificate (string targetHost, bool serverMode, X509Certificate leaf, X509Chain chain);
108 public static class CertificateValidationHelper
110 const string SecurityLibrary = "/System/Library/Frameworks/Security.framework/Security";
111 static readonly bool noX509Chain;
112 static readonly bool supportsTrustAnchors;
114 static CertificateValidationHelper ()
116 #if MONOTOUCH || XAMMAC
118 supportsTrustAnchors = true;
121 supportsTrustAnchors = false;
123 if (File.Exists (SecurityLibrary)) {
125 supportsTrustAnchors = true;
128 supportsTrustAnchors = false;
133 public static bool SupportsX509Chain {
134 get { return !noX509Chain; }
137 public static bool SupportsTrustAnchors {
138 get { return supportsTrustAnchors; }
142 * Internal API, intended to be used by MonoTlsProvider implementations.
144 internal static ICertificateValidator2 GetInternalValidator (MonoTlsSettings settings, MonoTlsProvider provider)
146 return (ICertificateValidator2)NoReflectionHelper.GetInternalValidator (provider, settings);
149 [Obsolete ("Use GetInternalValidator")]
150 internal static ICertificateValidator2 GetDefaultValidator (MonoTlsSettings settings, MonoTlsProvider provider)
152 return GetInternalValidator (settings, provider);
156 * Use this overloaded version in user code.
158 public static ICertificateValidator GetValidator (MonoTlsSettings settings)
160 return (ICertificateValidator)NoReflectionHelper.GetDefaultValidator (settings);