Costanti per le estensioni Netscape

Le estensioni Netscape seguenti vengono usate con operazioni di codifica e decodifica. Le costanti predefinite e le stringhe di identificatore di oggetto Netscape non vengono usate direttamente con le funzioni di codifica o decodifica, CryptEncodeObject, CryptEncodeObjectEx, CryptSignAndEncodeCertificate, CryptDecodeObject o CryptDecodeObjectEx. Queste estensioni richiedono invece l'uso di lpszStructType visualizzato.

Per altri dettagli che si applicano ad alcune estensioni Netscape, vedere le osservazioni che seguono la tabella.

Per tutte le funzioni di codifica che usano il X509_ANY_STRING o il X5O9_UNICODE_ANY_STRING lpszStructType, X509_ANY_STRING viene utilizzato se il formato stringa nel membro pbData del membro Value è ASCII e X509_UNICODE_ANY_STRING viene utilizzato se il formato stringa è UNICODE. Nel caso Unicode, la stringa deve essere convertita in un IA5_STRING prima della codifica impostando il membro dwValueType della struttura CERT_NAME_VALUE su CERT_RDN_IA5_STRING.

Per le funzioni di decodifica, l'utente seleziona il formato della stringa di output. Usare X509_ANY_STRING se il formato di stringa desiderato è ASCII e X509_UNICODE_ANY_STRING se il formato di stringa desiderato è Unicode.

Per l'estensione szOID_NETSCAPE_CERT_RENEWAL_URL, la struttura dei dati contiene un URL relativo o assoluto che punta a un modulo di rinnovo del certificato. Il modulo di rinnovo sarà accessibile con un metodo HTTP GET usando un URL che rappresenta la concatenazione dell'URL di rinnovo e del numero di serie del certificato. Il numero di serie del certificato viene codificato come stringa di cifre esadecimali ASCII. Ad esempio, se netscape-base-url è https:// URL dell'autorità di certificazione/, netscape-cert-renewal-url è cgi-bin/check-renew.cgi?e il numero di serie del certificato è 173420, l'URL risultante sarà: https:// certification authority URL/cgi-bin/check-renew.cgi?02a56c. Il documento restituito deve essere un modulo HTML che consentirà all'utente di richiedere il rinnovo del certificato.

Per l'estensione szOID_NETSCAPE_CERT_SEQUENCE tramite X509_ASN_ENCODING, il certificato viene codificato come struttura PKCS_CONTENT_INFO che esegue il wrapping di una sequenza di ANY. Il valore del membro contentType è pszObjId, mentre il campo contenuto è la struttura seguente:

SequenceOfAny ::= SEQUENZA DI ANY

Il CRYPT_DER_BLOBnel punto membro rgValue del CRYPT_CONTENT_INFO_SEQUENCE_OF_ANY ai certificati X509 codificati.

Per le estensioni szOID_NETSCAPE_CERT_TYPE, vengono definiti i bit seguenti.

Per le estensioni szOID_NETSCAPE_REVOCATION_URL, è possibile usare un URL relativo o assoluto per controllare lo stato di revoca di un certificato. Il controllo di revoca verrà eseguito come metodo HTTP GET usando un URL che rappresenta la concatenazione di url di revoca e numero di serie del certificato. Il numero di serie del certificato viene codificato come stringa di cifre esadecimali ASCII. Ad esempio, se netscape-base-url è https://www.certs-r-us.com/, netscape-rev-url è cgi-bin/check-rev.cgi?e il numero di serie del certificato è 173420, l'URL risultante sarà: https://www.certs-r-us.com/cgi-bin/check-rev.cgi?02a56c.

Il server deve restituire un documento con un tipo di contenuto di application/x-netscape-revocation. Il documento deve contenere una singola cifra ASCII, "1" se il certificato non è attualmente valido e "0" se è attualmente valido.

Si noti che per tutti gli URL che includono il numero di serie del certificato, il numero di serie verrà codificato come stringa costituita da un numero pari di cifre esadecimali. Se il numero di cifre significative è dispari, la stringa avrà uno zero iniziale singolo per garantire la generazione di un numero pari di cifre.