Objet de certificat
[capicom est un composant uniquement de 32 bits qui peut être utilisé dans les systèmes d’exploitation suivants : Windows Server 2008, Windows Vista et Windows XP. Utilisez plutôt la classe X509Certificate2 dans l’espace de noms System. Security. Cryptography. X509Certificates .]
L’objet Certificate représente un seul certificat numérique.
L’objet certificat expose les interfaces suivantes :
- ICertificate : introduit dans CAPICOM 1,0.
- ICertificate2 : introduit dans CAPICOM 2,0.
Quand l’utiliser
L’objet certificat est utilisé pour effectuer les tâches suivantes :
- Charger les données de certificat, y compris la clé privée, à partir d’un fichier.
- Obtient des informations à partir du certificat.
- Retourne les contraintes de base, l’utilisation améliorée de la clé, les propriétés étendues, les extensions, l’utilisation de la clé, la clé publique et les objets de modèle associés au certificat.
- Déterminez si le certificat est valide et vérifiez la disponibilité d’accès de la clé privée du sujet du certificat.
- Affichez le certificat.
- Importez et exportez le certificat.
- Enregistrez le certificat dans un fichier.
- Récupérez ou définissez les propriétés qui décrivent le certificat.
Membres
L’objet certificat a les types de membres suivants :
Méthodes
L’objet certificat a ces méthodes.
| Méthode | Description |
|---|---|
| BasicConstraints | Retourne un objet basicConstraints qui représente l’extension de contraintes de base du certificat. (Héritée de CertificateICertificate2ICertificate) |
| Affichage | Affiche un certificat. (Héritée de CertificateICertificate2ICertificate) |
| Exporter | Copie un certificat dans une chaîne encodée. La chaîne encodée peut être écrite dans un fichier ou importée dans un nouvel objet de certificat . (Héritée de CertificateICertificate2ICertificate) |
| ExtendedKeyUsage | Retourne un objet ExtendedKeyUsage qui indique les utilisations de clés étendues valides du certificat. (Héritée de CertificateICertificate2ICertificate) |
| ExtendedProperties | Retourne une collection des propriétés étendues du certificat. (Héritée de CertificateICertificate2) |
| Extensions | Retourne une collection des extensions associées au certificat. (Héritée de CertificateICertificate2) |
| GetInfo | Récupère les informations du certificat. (Héritée de CertificateICertificate2ICertificate) |
| HasPrivateKey | Détermine si le certificat a une clé privée qui lui est associée. (Héritée de CertificateICertificate2ICertificate) |
| Port | Importe un certificat précédemment encodé à partir d’une chaîne dans l’objet certificat . (Héritée de CertificateICertificate2ICertificate) |
| IsValid | Crée une chaîne de vérification de certificat pour un certificat et retourne un objet CertificateStatus qui contient l’état de validité du certificat. (Héritée de CertificateICertificate2ICertificate) |
| Utilisation | Retourne un objet KeyUsage qui indique l’utilisation valide de la clé du certificat. (Héritée de CertificateICertificate2ICertificate) |
| Load | Importe un certificat à partir d’un fichier. (Héritée de CertificateICertificate2) |
| PublicKey | Retourne un objet PublicKey . (Héritée de CertificateICertificate2) |
| Enregistrer | Enregistre le certificat dans un fichier. (Héritée de CertificateICertificate2) |
| Modèle | Retourne le modèle associé au certificat. (Héritée de CertificateICertificate2) |
Propriétés
L’objet certificat a ces propriétés.
| Propriété | Type d’accès | Description |
|---|---|---|
| Archivé |
Lecture/écriture |
Définit ou récupère une valeur booléenne qui indique si le certificat est archivé. (Héritée de CertificateICertificate2) |
| IssuerName |
Lecture seule |
Récupère une chaîne qui contient le nom de l’émetteur du certificat. (Héritée de CertificateICertificate2ICertificate) |
| PrivateKey |
Lecture/écriture |
Définit ou récupère la clé privée associée au certificat. (Héritée de CertificateICertificate2) |
| SerialNumber |
Lecture seule |
Récupère une chaîne qui contient le numéro de série du certificat. (Héritée de CertificateICertificate2ICertificate) |
| SubjectName |
Lecture seule |
Récupère une chaîne qui contient le nom de l’objet du certificat. (Héritée de CertificateICertificate2ICertificate) |
| D |
Lecture seule |
Récupère une chaîne hexadécimale qui contient le hachage SHA-1 du certificat. (Héritée de CertificateICertificate2ICertificate) |
| ValidFromDate |
Lecture seule |
Récupère la date de début de validité du certificat. (Héritée de CertificateICertificate2ICertificate) |
| ValidToDate |
Lecture seule |
Récupère la date de fin de validité du certificat. (Héritée de CertificateICertificate2ICertificate) |
| Version |
Lecture seule |
Récupère le numéro de version du certificat. (Héritée de CertificateICertificate2ICertificate) |
Remarques
L’objet de certificat peut être créé et il est sécurisé pour l’écriture de scripts. Le ProgID de l’objet certificat est «CAPICOM. Certificate. 2».
CAPICOM 1. x: le ProgID de l’objet certificat est «CAPICOM. Certificate. 1».
Configuration requise
| Condition requise | Valeur |
|---|---|
| Fin de la prise en charge des clients |
Windows Vista |
| Fin de la prise en charge des serveurs |
Windows Server 2008 |
| Composant redistribuable |
capicom 2,0 ou version ultérieure sur Windows Server 2003 et Windows XP |
| DLL |
|