Constantes para extensões Netscape

As seguintes extensões Netscape são usadas com operações de codificação e decodificação. As constantes predefinidas do Netscape e as cadeias de caracteres de identificador de objeto não são usadas diretamente com as funções de codificação ou decodificação, CryptEncodeObject, CryptEncodeObjectEx, CryptSignAndEncodeCertificate, CryptDecodeObjectou CryptDecodeObjectEx. Em vez disso, essas extensões exigem o uso do lpszStructType mostrado.

Para obter detalhes adicionais que se aplicam a algumas extensões do Netscape, consulte os comentários a seguir à tabela.

Para todas as funções de codificação que usam o X509_ANY_STRING ou o X5O9_UNICODE_ANY_STRING lpszStructType, X509_ANY_STRING é usado se o formato de cadeia de caracteres no Value membro membro pbData for ASCIIe X509_UNICODE_ANY_STRING for usado se o formato de cadeia de caracteres for UNICODE. No caso Unicode, a cadeia de caracteres deve ser convertida em um IA5_STRING antes da codificação, definindo o dwValueType membro da estrutura CERT_NAME_VALUE como CERT_RDN_IA5_STRING.

Para funções de decodificação, o usuário seleciona o formato da cadeia de caracteres de saída. Use X509_ANY_STRING se o formato de cadeia de caracteres desejado for ASCII e X509_UNICODE_ANY_STRING se o formato de cadeia de caracteres desejado for Unicode.

Para a extensão szOID_NETSCAPE_CERT_RENEWAL_URL, a estrutura de dados contém uma URL relativa ou absoluta que aponta para um formulário de renovação de certificado. O formulário de renovação será acessado com um método HTTP GET usando uma URL que é a concatenação da URL de renovação e do número de série do certificado. O número de série do certificado é codificado como uma cadeia de caracteres de dígitos hexadecimais ASCII. Por exemplo, se o netscape-base-url for https://URL da autoridade de certificação/, o netscape-cert-renewal-url for cgi-bin/check-renew.cgi?, e o número de série do certificado for 173420, o URL resultante será: URL da autoridade de certificação https:///cgi-bin/check-renew.cgi?02a56c. O documento devolvido deve ser um formulário HTML que permitirá ao utilizador solicitar uma renovação do seu certificado.

Para a extensão szOID_NETSCAPE_CERT_SEQUENCE usando X509_ASN_ENCODING, o certificado é codificado como uma estrutura PKCS_CONTENT_INFO que envolve uma sequência de ANY. O valor do membro contentType é pszObjId, enquanto o campo de conteúdo é a seguinte estrutura:

SequenceOfAny ::= SEQUÊNCIA DE QUALQUER

Os CRYPT_DER_BLOBs no rgValue do CRYPT_CONTENT_INFO_SEQUENCE_OF_ANYponto de membro para certificados X509 codificados.

Para szOID_NETSCAPE_CERT_TYPE extensões, os seguintes bits são definidos.

Para as extensões szOID_NETSCAPE_REVOCATION_URL, uma URL relativa ou absoluta pode ser usada para verificar o status de revogação de um certificado. A verificação de revogação será executada como um método HTTP GET usando uma URL que é a concatenação de revocation-URL e certificate-serial-number. O número de série do certificado é codificado como uma cadeia de caracteres de dígitos hexadecimais ASCII. Por exemplo, se o netscape-base-url for https://www.certs-r-us.com/, o netscape-revocation-url for cgi-bin/check-rev.cgi?, e o número de série do certificado for 173420, o URL resultante será: https://www.certs-r-us.com/cgi-bin/check-rev.cgi?02a56c.

O servidor deve retornar um documento com um Content-Type of application/x-netscape-revocation. O documento deve conter um único dígito ASCII, "1" se o certificado não for válido no momento, e "0" se estiver válido no momento.

Observe que, para todas as URLs que incluem o número de série do certificado, o número de série será codificado como uma cadeia de caracteres que consiste em um número par de dígitos hexadecimais. Se o número de dígitos significativos for ímpar, a cadeia de caracteres terá um único zero à esquerda para garantir que um número par de dígitos seja gerado.