mcs/class/corlib/System.Security.Cryptography.X509Certificates/X509Certificate.cs

   1 //
   2 // X509Certificate.cs: Handles X.509 certificates.
   3 //
   4 // Author:
   5 //      Sebastien Pouliot  <sebastien@ximian.com>
   6 //
   7 // (C) 2002, 2003 Motus Technologies Inc. (http://www.motus.com)
   8 // Copyright (C) 2004-2006 Novell, Inc (http://www.novell.com)
   9 //
  10 // Permission is hereby granted, free of charge, to any person obtaining
  11 // a copy of this software and associated documentation files (the
  12 // "Software"), to deal in the Software without restriction, including
  13 // without limitation the rights to use, copy, modify, merge, publish,
  14 // distribute, sublicense, and/or sell copies of the Software, and to
  15 // permit persons to whom the Software is furnished to do so, subject to
  16 // the following conditions:
  17 //
  18 // The above copyright notice and this permission notice shall be
  19 // included in all copies or substantial portions of the Software.
  20 //
  21 // THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
  22 // EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
  23 // MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
  24 // NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
  25 // LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
  26 // OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
  27 // WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
  28 //
  29
  30 using System.IO;
  31 using System.Runtime.InteropServices;
  32 using System.Security.Permissions;
  33 using System.Text;
  34
  35 using Mono.Security;
  36 using Mono.Security.X509;
  37
  38 using System.Runtime.Serialization;
  39 using Mono.Security.Authenticode;
  40
  41 namespace System.Security.Cryptography.X509Certificates {
  42
  43         // References:
  44         // a.   Internet X.509 Public Key Infrastructure Certificate and CRL Profile
  45         //      http://www.ietf.org/rfc/rfc3280.txt
  46
  47         // LAMESPEC: the MSDN docs always talks about X509v3 certificates
  48         // and/or Authenticode certs. However this class works with older
  49         // X509v1 certificates and non-authenticode (code signing) certs.
  50         [Serializable]
  51 #if NET_2_1
  52         public partial class X509Certificate {
  53 #else
  54         public partial class X509Certificate : IDeserializationCallback, ISerializable {
  55 #endif
  56                 X509CertificateImpl impl;
  57
  58                 private bool hideDates;
  59
  60                 // static methods
  61
  62                 public static X509Certificate CreateFromCertFile (string filename)
  63                 {
  64                         byte[] data = File.ReadAllBytes (filename);
  65                         return new X509Certificate (data);
  66                 }
  67
  68                 [MonoTODO ("Incomplete - minimal validation in this version")]
  69                 public static X509Certificate CreateFromSignedFile (string filename)
  70                 {
  71                         try {
  72                                 AuthenticodeDeformatter a = new AuthenticodeDeformatter (filename);
  73                                 if (a.SigningCertificate != null) {
  74                                         return new X509Certificate (a.SigningCertificate.RawData);
  75                                 }
  76                         }
  77                         catch (SecurityException) {
  78                                 // don't wrap SecurityException into a COMException
  79                                 throw;
  80                         }
  81                         catch (Exception e) {
  82                                 string msg = Locale.GetText ("Couldn't extract digital signature from {0}.", filename);
  83                                 throw new COMException (msg, e);
  84                         }
  85                         throw new CryptographicException (Locale.GetText ("{0} isn't signed.", filename));
  86                 }
  87
  88                 // constructors
  89
  90                 // special constructor for Publisher (and related classes).
  91                 // Dates strings are null
  92                 internal X509Certificate (byte[] data, bool dates)
  93                 {
  94                         if (data != null) {
  95                                 Import (data, (string)null, X509KeyStorageFlags.DefaultKeySet);
  96                                 hideDates = !dates;
  97                         }
  98                 }
  99
 100                 public X509Certificate (byte[] data) : this (data, true)
 101                 {
 102                 }
 103
 104                 public X509Certificate (IntPtr handle)
 105                 {
 106                         if (handle == IntPtr.Zero)
 107                                 throw new ArgumentException ("Invalid handle.");
 108
 109                         impl = X509Helper.InitFromHandle (handle);
 110                 }
 111
 112                 internal X509Certificate (X509CertificateImpl impl)
 113                 {
 114                         if (impl == null)
 115                                 throw new ArgumentNullException ("impl");
 116
 117                         this.impl = X509Helper.InitFromCertificate (impl);
 118                 }
 119
 120                 public X509Certificate (System.Security.Cryptography.X509Certificates.X509Certificate cert)
 121                 {
 122                         if (cert == null)
 123                                 throw new ArgumentNullException ("cert");
 124
 125                         impl = X509Helper.InitFromCertificate (cert);
 126                         hideDates = false;
 127                 }
 128
 129                 internal void ImportHandle (X509CertificateImpl impl)
 130                 {
 131                         Reset ();
 132                         this.impl = impl;
 133                 }
 134
 135                 internal X509CertificateImpl Impl {
 136                         get {
 137                                 X509Helper.ThrowIfContextInvalid (impl);
 138                                 return impl;
 139                         }
 140                 }
 141
 142                 internal bool IsValid {
 143                         get { return X509Helper.IsValid (impl); }
 144                 }
 145
 146                 internal void ThrowIfContextInvalid ()
 147                 {
 148                         X509Helper.ThrowIfContextInvalid (impl);
 149                 }
 150
 151                 // public methods
 152
 153                 public virtual bool Equals (System.Security.Cryptography.X509Certificates.X509Certificate other)
 154                 {
 155                         if (other == null) {
 156                                 return false;
 157                         } else {
 158                                 if (!X509Helper.IsValid (other.impl)) {
 159                                         if (!X509Helper.IsValid (impl))
 160                                                 return true;
 161                                         throw new CryptographicException (Locale.GetText ("Certificate instance is empty."));
 162                                 }
 163
 164                                 return X509CertificateImpl.Equals (impl, other.impl);
 165                         }
 166                 }
 167
 168                 // LAMESPEC: This is the equivalent of the "thumbprint" that can be seen
 169                 // in the certificate viewer of Windows. This is ALWAYS the SHA1 hash of
 170                 // the certificate (i.e. it has nothing to do with the actual hash
 171                 // algorithm used to sign the certificate).
 172                 public virtual byte[] GetCertHash ()
 173                 {
 174                         X509Helper.ThrowIfContextInvalid (impl);
 175                         return impl.GetCertHash ();
 176                 }
 177
 178                 public virtual string GetCertHashString ()
 179                 {
 180                         // must call GetCertHash (not variable) or optimization wont work
 181                         return X509Helper.ToHexString (GetCertHash ());
 182                 }
 183
 184                 // strangly there are no DateTime returning function
 185                 public virtual string GetEffectiveDateString ()
 186                 {
 187                         if (hideDates)
 188                                 return null;
 189                         X509Helper.ThrowIfContextInvalid (impl);
 190
 191                         return impl.GetValidFrom ().ToLocalTime ().ToString ();
 192                 }
 193
 194                 // strangly there are no DateTime returning function
 195                 public virtual string GetExpirationDateString ()
 196                 {
 197                         if (hideDates)
 198                                 return null;
 199                         X509Helper.ThrowIfContextInvalid (impl);
 200
 201                         return impl.GetValidUntil ().ToLocalTime ().ToString ();
 202                 }
 203
 204                 // well maybe someday there'll be support for PGP or SPKI ?
 205                 public virtual string GetFormat ()
 206                 {
 207                         return "X509";  // DO NOT TRANSLATE
 208                 }
 209
 210                 public override int GetHashCode ()
 211                 {
 212                         if (!X509Helper.IsValid (impl))
 213                                 return 0;
 214                         return impl.GetHashCode ();
 215                 }
 216
 217                 [Obsolete ("Use the Issuer property.")]
 218                 public virtual string GetIssuerName ()
 219                 {
 220                         X509Helper.ThrowIfContextInvalid (impl);
 221                         return impl.GetIssuerName (true);
 222                 }
 223
 224                 public virtual string GetKeyAlgorithm ()
 225                 {
 226                         X509Helper.ThrowIfContextInvalid (impl);
 227                         return impl.GetKeyAlgorithm ();
 228                 }
 229
 230                 public virtual byte[] GetKeyAlgorithmParameters ()
 231                 {
 232                         X509Helper.ThrowIfContextInvalid (impl);
 233
 234                         byte[] kap = impl.GetKeyAlgorithmParameters ();
 235                         if (kap == null)
 236                                 throw new CryptographicException (Locale.GetText ("Parameters not part of the certificate"));
 237
 238                         return kap;
 239                 }
 240
 241                 public virtual string GetKeyAlgorithmParametersString ()
 242                 {
 243                         return X509Helper.ToHexString (GetKeyAlgorithmParameters ());
 244                 }
 245
 246                 [Obsolete ("Use the Subject property.")]
 247                 public virtual string GetName ()
 248                 {
 249                         X509Helper.ThrowIfContextInvalid (impl);
 250                         return impl.GetSubjectName (true);
 251                 }
 252
 253                 public virtual byte[] GetPublicKey ()
 254                 {
 255                         X509Helper.ThrowIfContextInvalid (impl);
 256                         return impl.GetPublicKey ();
 257                 }
 258
 259                 public virtual string GetPublicKeyString ()
 260                 {
 261                         return X509Helper.ToHexString (GetPublicKey ());
 262                 }
 263
 264                 public virtual byte[] GetRawCertData ()
 265                 {
 266                         X509Helper.ThrowIfContextInvalid (impl);
 267                         return impl.GetRawCertData ();
 268                 }
 269
 270                 public virtual string GetRawCertDataString ()
 271                 {
 272                         X509Helper.ThrowIfContextInvalid (impl);
 273                         return X509Helper.ToHexString (impl.GetRawCertData ());
 274                 }
 275
 276                 public virtual byte[] GetSerialNumber ()
 277                 {
 278                         X509Helper.ThrowIfContextInvalid (impl);
 279                         return impl.GetSerialNumber ();
 280                 }
 281
 282                 public virtual string GetSerialNumberString ()
 283                 {
 284                         byte[] sn = GetSerialNumber ();
 285                         Array.Reverse (sn);
 286                         return X509Helper.ToHexString (sn);
 287                 }
 288
 289                 // to please corcompare ;-)
 290                 public override string ToString ()
 291                 {
 292                         return base.ToString ();
 293                 }
 294
 295                 public virtual string ToString (bool fVerbose)
 296                 {
 297                         if (!fVerbose || !X509Helper.IsValid (impl))
 298                                 return base.ToString ();
 299
 300                         return impl.ToString (true);
 301                 }
 302
 303                 protected static string FormatDate (DateTime date)
 304                 {
 305                         throw new NotImplementedException ();
 306                 }
 307         }
 308 }