X509ChainPolicy Klasa

Definicja

Przestrzeń nazw:

System.Security.Cryptography.X509Certificates

Zestawy:

netstandard.dll, System.Security.Cryptography.dll

Źródło:

X509ChainPolicy.cs

Reprezentuje zasady łańcucha, które mają być stosowane podczas tworzenia łańcucha certyfikatów X509. Klasa ta nie może być dziedziczona.

C#

public sealed class X509ChainPolicy

Dziedziczenie

Object

X509ChainPolicy

Przykłady

Poniższy przykład otwiera osobisty magazyn certyfikatów bieżącego użytkownika, umożliwia użytkownikowi wybranie certyfikatu, a następnie zapisanie informacji o certyfikacie i łańcuchu certyfikatów w konsoli programu . Dane wyjściowe zależą od wybranego certyfikatu.

C#

using System;
using System.Security.Cryptography;
using System.Security.Cryptography.X509Certificates;
using System.IO;

class TestX509Chain
{
    static void Main(string[] args)
    {
        //Create new X509 store from local certificate store.
        X509Store store = new X509Store("MY", StoreLocation.CurrentUser);
        store.Open(OpenFlags.OpenExistingOnly | OpenFlags.ReadWrite);

        //Output store information.
        Console.WriteLine ("Store Information");
        Console.WriteLine ("Number of certificates in the store: {0}", store.Certificates.Count);
        Console.WriteLine ("Store location: {0}", store.Location);
        Console.WriteLine ("Store name: {0} {1}", store.Name, Environment.NewLine);
    
        //Put certificates from the store into a collection so user can select one.
        X509Certificate2Collection fcollection = (X509Certificate2Collection)store.Certificates;
        X509Certificate2Collection collection = X509Certificate2UI.SelectFromCollection(fcollection, "Select an X509 Certificate", "Choose a certificate to examine.", X509SelectionFlag.SingleSelection);
        X509Certificate2 certificate = collection[0];
        X509Certificate2UI.DisplayCertificate(certificate);

        //Output chain information of the selected certificate.
        X509Chain ch = new X509Chain();
        ch.ChainPolicy.RevocationMode = X509RevocationMode.Online;
        ch.Build (certificate);
        Console.WriteLine ("Chain Information");
        Console.WriteLine ("Chain revocation flag: {0}", ch.ChainPolicy.RevocationFlag);
        Console.WriteLine ("Chain revocation mode: {0}", ch.ChainPolicy.RevocationMode);
        Console.WriteLine ("Chain verification flag: {0}", ch.ChainPolicy.VerificationFlags);
        Console.WriteLine ("Chain verification time: {0}", ch.ChainPolicy.VerificationTime);
        Console.WriteLine ("Chain status length: {0}", ch.ChainStatus.Length);
        Console.WriteLine ("Chain application policy count: {0}", ch.ChainPolicy.ApplicationPolicy.Count);
        Console.WriteLine ("Chain certificate policy count: {0} {1}", ch.ChainPolicy.CertificatePolicy.Count, Environment.NewLine);

        //Output chain element information.
        Console.WriteLine ("Chain Element Information");
        Console.WriteLine ("Number of chain elements: {0}", ch.ChainElements.Count);
        Console.WriteLine ("Chain elements synchronized? {0} {1}", ch.ChainElements.IsSynchronized, Environment.NewLine);
    
        foreach (X509ChainElement element in ch.ChainElements)
        {
            Console.WriteLine ("Element issuer name: {0}", element.Certificate.Issuer);
            Console.WriteLine ("Element certificate valid until: {0}", element.Certificate.NotAfter);
            Console.WriteLine ("Element certificate is valid: {0}", element.Certificate.Verify ());
            Console.WriteLine ("Element error status length: {0}", element.ChainElementStatus.Length);
            Console.WriteLine ("Element information: {0}", element.Information);
            Console.WriteLine ("Number of element extensions: {0}{1}", element.Certificate.Extensions.Count, Environment.NewLine);

            if (ch.ChainStatus.Length > 1)
            {
                for (int index = 0; index < element.ChainElementStatus.Length; index++)
                {
                    Console.WriteLine (element.ChainElementStatus[index].Status);
                    Console.WriteLine (element.ChainElementStatus[index].StatusInformation);
                }
            }
        }
        store.Close();
    }
}

Uwagi

Każdy X509Certificate2 obiekt może mieć właściwość określającą X509ChainPolicy zasady do użycia w procesie weryfikacji. Należy pamiętać, że tylko X509Certificate2 obiekty mogą konstruować X509ChainPolicy obiekt.

Konstruktory

X509ChainPolicy()

Inicjuje nowe wystąpienie klasy X509ChainPolicy.

Właściwości

ApplicationPolicy	Pobiera kolekcję identyfikatorów obiektów (OID) określającą, które zasady aplikacji lub rozszerzone użycie kluczy (EKU) certyfikat musi obsługiwać.
CertificatePolicy	Pobiera kolekcję identyfikatorów obiektów (OID) określającą zasady certyfikatów, które certyfikat musi obsługiwać.
CustomTrustStore	Reprezentuje kolekcję certyfikatów zastępującą domyślną relację zaufania certyfikatów.
DisableCertificateDownloads	Pobiera lub ustawia wartość wskazującą, czy aparat łańcucha może używać rozszerzenia Dostępu do informacji o urzędach (AIA) w celu zlokalizowania nieznanych certyfikatów wystawców.
ExtraStore	Pobiera obiekt reprezentujący dodatkową kolekcję certyfikatów, które mogą być przeszukiwane przez aparat łańcucha podczas weryfikowania łańcucha certyfikatów.
RevocationFlag	Pobiera lub ustawia wartości flag odwołania X509.
RevocationMode	Pobiera lub ustawia wartości trybu odwołania certyfikatów X509.
TrustMode	Tryb określania zaufania głównego do tworzenia łańcucha certyfikatów.
UrlRetrievalTimeout	Pobiera lub ustawia maksymalny czas spędzony podczas weryfikacji odwołania online lub pobierania listy odwołania certyfikatów (CRL). Wartość Zero oznacza, że nie ma żadnych ograniczeń.
VerificationFlags	Pobiera flagi weryfikacji certyfikatu.
VerificationTime	Pobiera lub ustawia czas weryfikacji łańcucha.
VerificationTimeIgnored	Pobiera lub ustawia wartość wskazującą, czy walidacja łańcucha powinna być używana VerificationTime , czy bieżący czas systemowy podczas tworzenia łańcucha certyfikatów X.509.

Metody

Clone()	Tworzy nowe wystąpienie zasad łańcucha, które ma te same ustawienia co to wystąpienie.
Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetType()	Type Pobiera bieżące wystąpienie. (Odziedziczone po Object)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
Reset()	Resetuje X509ChainPolicy członków do ich wartości domyślnych.
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)

Dotyczy