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                 public X509Certificate (System.Security.Cryptography.X509Certificates.X509Certificate cert)
 113                 {
 114                         if (cert == null)
 115                                 throw new ArgumentNullException ("cert");
 116
 117                         X509Helper.ThrowIfContextInvalid (cert.impl);
 118
 119                         impl = X509Helper.InitFromCertificate (cert.impl);
 120                         hideDates = false;
 121                 }
 122
 123
 124                 // public methods
 125
 126                 public virtual bool Equals (System.Security.Cryptography.X509Certificates.X509Certificate other)
 127                 {
 128                         if (other == null) {
 129                                 return false;
 130                         } else {
 131                                 if (!X509Helper.IsValid (other.impl)) {
 132                                         if (!X509Helper.IsValid (impl))
 133                                                 return true;
 134                                         throw new CryptographicException (Locale.GetText ("Certificate instance is empty."));
 135                                 }
 136
 137                                 return X509CertificateImpl.Equals (impl, other.impl);
 138                         }
 139                 }
 140
 141                 // LAMESPEC: This is the equivalent of the "thumbprint" that can be seen
 142                 // in the certificate viewer of Windows. This is ALWAYS the SHA1 hash of
 143                 // the certificate (i.e. it has nothing to do with the actual hash
 144                 // algorithm used to sign the certificate).
 145                 public virtual byte[] GetCertHash ()
 146                 {
 147                         X509Helper.ThrowIfContextInvalid (impl);
 148                         return impl.GetCertHash ();
 149                 }
 150
 151                 public virtual string GetCertHashString ()
 152                 {
 153                         // must call GetCertHash (not variable) or optimization wont work
 154                         return X509Helper.ToHexString (GetCertHash ());
 155                 }
 156
 157                 // strangly there are no DateTime returning function
 158                 public virtual string GetEffectiveDateString ()
 159                 {
 160                         if (hideDates)
 161                                 return null;
 162                         X509Helper.ThrowIfContextInvalid (impl);
 163
 164                         return impl.GetEffectiveDateString ().ToString ();
 165                 }
 166
 167                 // strangly there are no DateTime returning function
 168                 public virtual string GetExpirationDateString ()
 169                 {
 170                         if (hideDates)
 171                                 return null;
 172                         X509Helper.ThrowIfContextInvalid (impl);
 173
 174                         return impl.GetExpirationDateString ().ToString ();
 175                 }
 176
 177                 // well maybe someday there'll be support for PGP or SPKI ?
 178                 public virtual string GetFormat ()
 179                 {
 180                         return "X509";  // DO NOT TRANSLATE
 181                 }
 182
 183                 public override int GetHashCode ()
 184                 {
 185                         if (!X509Helper.IsValid (impl))
 186                                 return 0;
 187                         return impl.GetHashCode ();
 188                 }
 189
 190                 [Obsolete ("Use the Issuer property.")]
 191                 public virtual string GetIssuerName ()
 192                 {
 193                         X509Helper.ThrowIfContextInvalid (impl);
 194                         return impl.GetIssuerName (true);
 195                 }
 196
 197                 public virtual string GetKeyAlgorithm ()
 198                 {
 199                         X509Helper.ThrowIfContextInvalid (impl);
 200                         return impl.GetKeyAlgorithm ();
 201                 }
 202
 203                 public virtual byte[] GetKeyAlgorithmParameters ()
 204                 {
 205                         X509Helper.ThrowIfContextInvalid (impl);
 206
 207                         byte[] kap = impl.GetKeyAlgorithmParameters ();
 208                         if (kap == null)
 209                                 throw new CryptographicException (Locale.GetText ("Parameters not part of the certificate"));
 210
 211                         return kap;
 212                 }
 213
 214                 public virtual string GetKeyAlgorithmParametersString ()
 215                 {
 216                         return X509Helper.ToHexString (GetKeyAlgorithmParameters ());
 217                 }
 218
 219                 [Obsolete ("Use the Subject property.")]
 220                 public virtual string GetName ()
 221                 {
 222                         X509Helper.ThrowIfContextInvalid (impl);
 223                         return impl.GetSubjectName (true);
 224                 }
 225
 226                 public virtual byte[] GetPublicKey ()
 227                 {
 228                         X509Helper.ThrowIfContextInvalid (impl);
 229                         return impl.GetPublicKey ();
 230                 }
 231
 232                 public virtual string GetPublicKeyString ()
 233                 {
 234                         return X509Helper.ToHexString (GetPublicKey ());
 235                 }
 236
 237                 public virtual byte[] GetRawCertData ()
 238                 {
 239                         X509Helper.ThrowIfContextInvalid (impl);
 240                         return impl.GetRawCertData ();
 241                 }
 242
 243                 public virtual string GetRawCertDataString ()
 244                 {
 245                         X509Helper.ThrowIfContextInvalid (impl);
 246                         return X509Helper.ToHexString (impl.GetRawCertData ());
 247                 }
 248
 249                 public virtual byte[] GetSerialNumber ()
 250                 {
 251                         X509Helper.ThrowIfContextInvalid (impl);
 252                         return impl.GetSerialNumber ();
 253                 }
 254
 255                 public virtual string GetSerialNumberString ()
 256                 {
 257                         byte[] sn = GetSerialNumber ();
 258                         Array.Reverse (sn);
 259                         return X509Helper.ToHexString (sn);
 260                 }
 261
 262                 // to please corcompare ;-)
 263                 public override string ToString ()
 264                 {
 265                         return base.ToString ();
 266                 }
 267
 268                 public virtual string ToString (bool fVerbose)
 269                 {
 270                         if (!fVerbose || !X509Helper.IsValid (impl))
 271                                 return base.ToString ();
 272
 273                         return impl.ToString (true);
 274                 }
 275
 276                 protected static string FormatDate (DateTime date)
 277                 {
 278                         throw new NotImplementedException ();
 279                 }
 280         }
 281 }