Microsoft KB Archive/931351

= How to add a Subject Alternative Name to a secure LDAP certificate =

Article ID: 931351

Article Last Modified on 5/3/2007

-

APPLIES TO


 * Microsoft Windows Server 2003, Enterprise Edition (32-bit x86)
 * Microsoft Windows Server 2003, Standard Edition (32-bit x86)

-



SUMMARY
This article describes how to add a Subject Alternative Name (SAN) to a secure Lightweight Directory Access Protocol (LDAP) certificate. The LDAP certificate is submitted to a certification authority (CA) that is configured on a Microsoft Windows Server 2003-based computer. The SAN lets you connect to a domain controller by using a Domain Name System (DNS) name other than the computer name. This article includes information about how to add SAN attributes to a certification request that is submitted to an enterprise CA, a stand-alone CA, or a third-party CA.



INTRODUCTION
This article describes how to add a SAN attribute to a secure LDAP certificate. This article also discusses how to do the following:
 * Configure a CA to accept a SAN attribute from a certificate request.
 * Create and submit a certificate request to an enterprise CA.
 * Create and submit a certificate request to a stand-alone CA.
 * Create a certificate request by using the Certreq.exe tool.
 * Create and submit a certificate request to a third-party CA.



How to configure a CA to accept a SAN attribute from a certificate request
By default, a CA that is configured on a Windows Server 2003-based computer does not issue certificates that contain the SAN extension. If SAN entries are included in the certificate request, these entries are omitted from the issued certificate. To change this behavior, run the following commands at a command prompt on the server that runs the Certification Authority service. Press ENTER after each command.

certutil -setreg policy\EditFlags +EDITF_ATTRIBUTESUBJECTALTNAME2

net stop certsvc

net start certsvc

How to create and submit a certificate request
When you submit a certificate request to an enterprise CA, the certificate template must be configured to use the SAN in the request instead of using information from the Active Directory directory service. The Version 1 Web Server template can be used to request a certificate that will support LDAP over the Secure Sockets Layer (SSL). Version 2 templates can be configured to retrieve the SAN either from the certificate request or from Active Directory. To issue certificates that are based on Version 2 templates, the enterprise CA must be running on a Windows Server 2003, Enterprise Edition-based computer.

When you submit a request to a stand-alone CA, certificate templates are not used. Therefore, the SAN must always be included in the certificate request. SAN attributes can be added to a request that is created by using the Certreq.exe program. Or, SAN attributes can be included in requests that are submitted by using the Web enrollment pages.

How to use Web enrollment pages to submit a certificate request to an enterprise CA
To submit a certificate request that contains a SAN to an enterprise CA, follow these steps:  Open Internet Explorer. In Internet Explorer, connect to http:// /certsrv.

Note  is the name of the Web server that is running Windows Server 2003 and that has the CA that you want to access. Click Request a Certificate. Click Advanced certificate request. Click Create and submit a request to this CA. In the Certificate Template list, click Web Server.

Note The CA must be configured to issue Web Server certificates. You may have to add the Web Server template to the Certificate Templates folder in the Certification Authority snap-in if the CA is not already configured to issue Web Server certificates. Provide identifying information as required.</li> In the Name box, type the fully qualified domain name of the domain controller.</li> Under Key Options, set the following options: <ul> Create a new key set</li> CSP: Microsoft RSA SChannel Cryptographic Provider</li> Key Usage: Exchange</li> Key Size: 1024 - 16384</li> Automatic key container name</li> Store certificate in the local computer certificate store</li></ul> </li> Under Advanced Options, set the request format to CMC.</li> In the Attributes box, type the desired SAN attributes. SAN attributes take the following form:

san:dns= [&dns= ]

Multiple DNS names are separated by an ampersand (&). For example, if the name of the domain controller is corpdc1.fabrikam.com and the alias is ldap.fabrikam.com, both of these names must be included in the SAN attributes. The resulting attribute string appears as follows:

san:dns=corpdc1.fabrikam.com&dns=ldap.fabrikam.com

</li> Click Submit.</li> If you see the Certificate Issued Web page, click Install this Certificate.</li></ol>

How to use Web enrollment pages to submit a certificate request to a stand-alone CA
To submit a certificate request that includes a SAN to a stand-alone CA, follow these steps: <ol> Open Internet Explorer.</li> In Internet Explorer, connect to http:// /certsrv.

Note  is the name of the Web server that is running Windows Server 2003 and that has the CA that you want to access.</li> Click Request a Certificate.</li> <li>Click Advanced certificate request.</li> <li>Click Create and submit a request to this CA.</li> <li>Provide identifying information as required.</li> <li>In the Name box, type the fully qualified domain name of the domain controller.</li> <li>In the Type of Certificate Needed Server list, click Server Authentication Certificate.</li> <li>Under Key Options, set the following options: <ul> <li>Create a new key set</li> <li>CSP: Microsoft RSA SChannel Cryptographic Provider</li> <li>Key Usage: Exchange</li> <li>Key Size: 1024 - 16384</li> <li>Automatic key container name</li> <li>Store certificate in the local computer certificate store</li></ul> </li> <li>Under Advanced Options, set the request format as CMC.</li> <li>In the Attributes box, type the desired SAN attributes. SAN attributes take the following form:

san:dns= [&dns= ]

Multiple DNS names are separated by an ampersand (&). For example, if the name of the domain controller is corpdc1.fabrikam.com and the alias is ldap.fabrikam.com, both of these names must be included in the SAN attributes. The resulting attribute string appears as follows:

san:dns=corpdc1.fabrikam.com&dns=ldap.fabrikam.com

</li> <li>Click Submit.</li> <li>If the CA is not configured to issue certificates automatically, a Certificate Pending Web page appears and requests that you wait for an administrator to issue the certificate that was requested.

To retrieve a certificate that an administrator has issued, connect to http:// /certsrv, and then click Check on a Pending Certificate. Click the requested certificate, and then click Next.

If the certificate has been issued, the Certificate Issued Web page appears. Click Install this Certificate to install the certificate.</li></ol>

How to use the Certreq.exe utility to create and submit a certificate request that includes a SAN
To use the Certreq.exe utility to create and submit a certificate request, follow these steps: <ol> <li> Create an .inf file that specifies the settings for the certificate request. You can use the following sample code to create an .inf file. [Version]

Signature=&quot;$Windows NT$

[NewRequest] Subject = &quot;CN=corpdc1.fabrikam.com&quot; ; must be the FQDN of domain controller EncipherOnly = FALSE Exportable = FALSE ; TRUE = Private key is exportable KeyLength = 1024   ; Common key sizes: 512, 1024, 2048, ;   4096, 8192, 16384 KeySpec = 1             ; Key Exchange KeyUsage = 0xA0    ; Digital Signature, Key Encipherment MachineKeySet = True ProviderName = &quot;Microsoft RSA SChannel Cryptographic Provider&quot; ProviderType = 12 RequestType = CMC [EnhancedKeyUsageExtension] OID=1.3.6.1.5.5.7.3.1 ; Server Authentication [RequestAttributes] CertificateTemplate = WebServer ;Omit line if CA is a stand-alone CA SAN=&quot;dns=.fabrikam.com&dns=ldap.fabrikam.com&quot; </li> <li>Save the file as Request.inf.</li> <li>Open a command prompt.</li> <li>At the command prompt, type the following command, and then press ENTER:
 * Omit entire section if CA is an enterprise CA

certreq -new request.inf certnew.req

This command uses the information in the Request.inf file to create a request in the format that is specified by the RequestType value in the .inf file. When the request is created, the public and private key pair is automatically generated and then put in a request object in the enrollment requests store on the local computer.</li> <li>At the command prompt, type the following command, and then press ENTER:

certreq -submit certnew.req certnew.cer

This command submits the certificate request to the CA. If there is more than one CA in the environment, the -config switch can be used in the command line to direct the request to a specific CA. If you do not use the -config switch, you will be prompted to select the CA to which the request should be submitted.

The -config switch uses the following format to refer to a specific CA:

\

For example, assume that the CA name is Corporate Policy CA1 and that the domain name is corpca1.fabrikam.com. To use the certreq command together with the –config switch to specify this CA, type the following command:

certreq -submit -config &quot;corpca1.fabrikam.com\Corporate Policy CA1&quot; certnew.req certnew.cer

If this CA is an enterprise CA and if the user who submits the certificate request has Read and Enroll permissions for the template, the request is submitted. The issued certificate is saved in the Certnew.cer file. If the CA is a stand-alone CA, the certificate request will be in a pending state until it is approved by the CA administrator. The output from the certreq -submit command contains the Request ID number of the submitted request. As soon as the certificate has been approved, it can be retrieved by using the Request ID number.</li> <li>Use the Request ID number to retrieve the certificate. To do this, type the following command, and then press ENTER:

certreq -retrieve  certnew.cer

You can also use the -config switch here to retrieve the certificate request from a specific CA. If the -config switch is not used, you are prompted to select the CA from which to retrieve the certificate.</li> <li>At the command prompt, type the following command, and then press ENTER:

certreq -accept certnew.cer

After you retrieve the certificate, you must install it. This command imports the certificate into the appropriate store and then links the certificate to the private key that is created in step 4.</li></ol>

How to submit a certificate request to a third-party CA
If you want to submit a certificate request to a third-party CA, first use the Certreq.exe tool to create the certificate request file. You can then submit the request to the third-party CA by using whatever method is appropriate for that vendor. The third-party must be able to process certificate requests in the CMC format.

Note Most vendors refer to the certificate request as a Certificate Signing Request (CSR).

<div class="references_section">