X509BasicConstraintsExtension Klas
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee definieert u de beperkingen die voor een certificaat zijn ingesteld. Deze klasse kan niet worden overgenomen.
public ref class X509BasicConstraintsExtension sealed : System::Security::Cryptography::X509Certificates::X509Extension
public sealed class X509BasicConstraintsExtension : System.Security.Cryptography.X509Certificates.X509Extension
type X509BasicConstraintsExtension = class
inherit X509Extension
Public NotInheritable Class X509BasicConstraintsExtension
Inherits X509Extension
- Overname
Voorbeelden
In het volgende codevoorbeeld ziet u hoe u het persoonlijke certificaatarchief van een gebruiker opent en informatie weergeeft over elk certificaat in het archief. In dit voorbeeld wordt de X509BasicConstraintsExtension klasse gebruikt om de informatie weer te geven.
using System;
using System.Security.Cryptography;
using System.Security.Cryptography.X509Certificates;
public class CertSelect
{
public static void Main()
{
try
{
X509Store store = new X509Store("MY", StoreLocation.CurrentUser);
store.Open(OpenFlags.ReadOnly | OpenFlags.OpenExistingOnly);
X509Certificate2Collection collection = (X509Certificate2Collection)store.Certificates;
for (int i = 0; i < collection.Count; i++)
{
foreach (X509Extension extension in collection[i].Extensions)
{
Console.WriteLine(extension.Oid.FriendlyName + "(" + extension.Oid.Value + ")");
if (extension.Oid.FriendlyName == "Key Usage")
{
X509KeyUsageExtension ext = (X509KeyUsageExtension)extension;
Console.WriteLine(ext.KeyUsages);
}
if (extension.Oid.FriendlyName == "Basic Constraints")
{
X509BasicConstraintsExtension ext = (X509BasicConstraintsExtension)extension;
Console.WriteLine(ext.CertificateAuthority);
Console.WriteLine(ext.HasPathLengthConstraint);
Console.WriteLine(ext.PathLengthConstraint);
}
if (extension.Oid.FriendlyName == "Subject Key Identifier")
{
X509SubjectKeyIdentifierExtension ext = (X509SubjectKeyIdentifierExtension)extension;
Console.WriteLine(ext.SubjectKeyIdentifier);
}
if (extension.Oid.FriendlyName == "Enhanced Key Usage")
{
X509EnhancedKeyUsageExtension ext = (X509EnhancedKeyUsageExtension)extension;
OidCollection oids = ext.EnhancedKeyUsages;
foreach (Oid oid in oids)
{
Console.WriteLine(oid.FriendlyName + "(" + oid.Value + ")");
}
}
}
}
store.Close();
}
catch (CryptographicException)
{
Console.WriteLine("Information could not be written out for this certificate.");
}
}
}
Imports System.Security.Cryptography
Imports System.Security.Cryptography.X509Certificates
Module CertSelect
Sub Main()
Try
Dim store As New X509Store("MY", StoreLocation.CurrentUser)
store.Open(OpenFlags.ReadOnly Or OpenFlags.OpenExistingOnly)
Dim collection As X509Certificate2Collection = CType(store.Certificates, X509Certificate2Collection)
For i As Integer = 0 To collection.Count - 1
Dim extension As X509Extension
For Each extension In collection(i).Extensions
Console.WriteLine(extension.Oid.FriendlyName + "(" + extension.Oid.Value + ")")
If extension.Oid.FriendlyName = "Key Usage" Then
Dim ext As X509KeyUsageExtension = CType(extension, X509KeyUsageExtension)
Console.WriteLine(ext.KeyUsages)
End If
If extension.Oid.FriendlyName = "Basic Constraints" Then
Dim ext As X509BasicConstraintsExtension = CType(extension, X509BasicConstraintsExtension)
Console.WriteLine(ext.CertificateAuthority)
Console.WriteLine(ext.HasPathLengthConstraint)
Console.WriteLine(ext.PathLengthConstraint)
End If
If extension.Oid.FriendlyName = "Subject Key Identifier" Then
Dim ext As X509SubjectKeyIdentifierExtension = CType(extension, X509SubjectKeyIdentifierExtension)
Console.WriteLine(ext.SubjectKeyIdentifier)
End If
If extension.Oid.FriendlyName = "Enhanced Key Usage" Then
Dim ext As X509EnhancedKeyUsageExtension = CType(extension, X509EnhancedKeyUsageExtension)
Dim oids As OidCollection = ext.EnhancedKeyUsages
Dim oid As Oid
For Each oid In oids
Console.WriteLine(oid.FriendlyName + "(" + oid.Value + ")")
Next oid
End If
Next extension
Next i
store.Close()
Catch
Console.WriteLine("Information could not be written out for this certificate.")
End Try
End Sub
End Module
Opmerkingen
Deze klasse biedt eigenschappen waarmee de basisbeperkingen voor een certificaat worden gedefinieerd.
Constructors
| Name | Description |
|---|---|
| X509BasicConstraintsExtension() |
Initialiseert een nieuw exemplaar van de X509BasicConstraintsExtension klasse. |
| X509BasicConstraintsExtension(AsnEncodedData, Boolean) |
Initialiseert een nieuw exemplaar van de X509BasicConstraintsExtension klasse met behulp van een AsnEncodedData object en een waarde die aangeeft of de extensie kritiek is. |
| X509BasicConstraintsExtension(Boolean, Boolean, Int32, Boolean) |
Initialiseert een nieuw exemplaar van de X509BasicConstraintsExtension klasse. Parameters geven een waarde op die aangeeft of een certificaat een ca-certificaat (certificeringsinstantie) is, een waarde die aangeeft of het certificaat een beperking heeft voor het aantal padniveaus dat is toegestaan, het aantal toegestane niveaus in het pad van een certificaat en een waarde die aangeeft of de extensie kritiek is. |
Eigenschappen
| Name | Description |
|---|---|
| CertificateAuthority |
Hiermee wordt een waarde opgehaald die aangeeft of een certificaat een ca-certificaat (certificeringsinstantie) is. |
| Critical |
Hiermee wordt een Booleaanse waarde opgehaald die aangeeft of de extensie kritiek is. (Overgenomen van X509Extension) |
| HasPathLengthConstraint |
Hiermee wordt een waarde opgehaald die aangeeft of een certificaat een beperking heeft voor het aantal padniveaus dat is toegestaan. |
| Oid |
Hiermee haalt u de waarde voor een AsnEncodedData object op of stelt u deze Oid in. (Overgenomen van AsnEncodedData) |
| PathLengthConstraint |
Hiermee haalt u het aantal niveaus op dat is toegestaan in het pad van een certificaat. |
| RawData |
Hiermee haalt u de abstracte syntaxis notatie één (ASN.1)-gecodeerde gegevens op die worden weergegeven in een bytematrix. (Overgenomen van AsnEncodedData) |
Methoden
| Name | Description |
|---|---|
| CopyFrom(AsnEncodedData) |
Initialiseert een nieuw exemplaar van de X509BasicConstraintsExtension klasse met behulp van een AsnEncodedData object. |
| Equals(Object) |
Bepaalt of het opgegeven object gelijk is aan het huidige object. (Overgenomen van Object) |
| Format(Boolean) |
Retourneert een opgemaakte versie van de abstracte syntaxisnotatie één (ASN.1)-gecodeerde gegevens als een tekenreeks. (Overgenomen van AsnEncodedData) |
| GetHashCode() |
Fungeert als de standaardhashfunctie. (Overgenomen van Object) |
| GetType() |
Hiermee haalt u de Type huidige instantie op. (Overgenomen van Object) |
| MemberwiseClone() |
Hiermee maakt u een ondiepe kopie van de huidige Object. (Overgenomen van Object) |
| ToString() |
Retourneert een tekenreeks die het huidige object vertegenwoordigt. (Overgenomen van Object) |