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 * On OS X and Mobile, the @chain will be initialized with the @certificates, but not actually built.
102 bool InvokeSystemValidator (
103 string targetHost, bool serverMode, X509CertificateCollection certificates,
104 X509Chain chain, ref MonoSslPolicyErrors errors, ref int status11);
107 public static class CertificateValidationHelper
109 const string SecurityLibrary = "/System/Library/Frameworks/Security.framework/Security";
110 static readonly bool noX509Chain;
111 static readonly bool supportsTrustAnchors;
113 static CertificateValidationHelper ()
115 #if MONOTOUCH || XAMMAC
117 supportsTrustAnchors = true;
120 supportsTrustAnchors = false;
122 if (File.Exists (SecurityLibrary)) {
124 supportsTrustAnchors = true;
127 supportsTrustAnchors = false;
132 public static bool SupportsX509Chain {
133 get { return !noX509Chain; }
136 public static bool SupportsTrustAnchors {
137 get { return supportsTrustAnchors; }
140 static ICertificateValidator GetDefaultValidator (MonoTlsProvider provider, MonoTlsSettings settings)
142 return (ICertificateValidator)NoReflectionHelper.GetDefaultCertificateValidator (provider, settings);
146 * Internal API, intended to be used by MonoTlsProvider implementations.
148 public static ICertificateValidator GetValidator (MonoTlsProvider provider, MonoTlsSettings settings)
150 return GetDefaultValidator (provider, settings);
154 * Use this overloaded version in user code.
156 public static ICertificateValidator GetValidator (MonoTlsSettings settings)
158 return GetDefaultValidator (null, settings);