X509Chain.Build(X509Certificate2) 메서드

정의

네임스페이스:

System.Security.Cryptography.X509Certificates

어셈블리:

System.Security.Cryptography.X509Certificates.dll

어셈블리:

System.Security.Cryptography.dll

어셈블리:

System.dll

어셈블리:

netstandard.dll

X509ChainPolicy에 지정된 정책을 사용하여 X.509 체인을 빌드합니다.

public:
 bool Build(System::Security::Cryptography::X509Certificates::X509Certificate2 ^ certificate);

public bool Build (System.Security.Cryptography.X509Certificates.X509Certificate2 certificate);

[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public bool Build (System.Security.Cryptography.X509Certificates.X509Certificate2 certificate);

member this.Build : System.Security.Cryptography.X509Certificates.X509Certificate2 -> bool

[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
member this.Build : System.Security.Cryptography.X509Certificates.X509Certificate2 -> bool

Public Function Build (certificate As X509Certificate2) As Boolean

매개 변수

certificate

X509Certificate2

X509Certificate2 개체입니다.

반환

Boolean

X.509 인증서가 유효하면 true이고, 그렇지 않으면 false입니다.

특성

UnsupportedOSPlatformAttribute

예외

ArgumentException

certificate가 유효한 인증서가 아니거나 null인 경우

CryptographicException

certificate를 읽을 수 없는 경우

예제

다음 코드 예제에서는 현재 사용자의 개인 인증서 저장소를 열고, 인증서를 선택한 다음, 인증서 및 인증서 체인 정보를 콘솔에 씁니다. 출력은 선택한 인증서에 따라 달라집니다.

//Output chain information of the selected certificate.
X509Chain ^ ch = gcnew 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 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 information of the selected certificate.
Dim ch As 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)

설명

신뢰할 수 있는 발급자의 유효한 X.509 인증서는 개체에 X509ChainPolicy 지정된 용도로만 유효합니다. 이러한 체인 정책 규칙을 충족하는 인증서는 SMIME(Security/MIME), Authenticode 또는 SSL(Secure Sockets Layer)과 같은 기능을 사용하는 특정 용도에 여전히 유효하지 않을 수 있습니다. 인증서가 특정 정책에 대해 유효한지 여부를 확인하기 위해 추가 처리가 필요한 경우 클래스를 파생시키고 기본 클래스 X509Chain Build 메서드를 먼저 호출하도록 메서드를 재정 Build 의한 다음 추가 처리를 수행합니다.