Configuring 802.1x Network Device Authentication

This section describes the components you need to configure 802.1x authentication, and the detailed steps you need to follow to configure the authentication. The 802.1x configurable options are listed in table form and show the default settings and where the options can be managed from.

Preparing for 802.1x Configuration

Before you begin the configuration process, make sure you have these components:

  • PCoIP Management Console 3.1 or later

  • Windows Server 2008 R2 with AD DS (Active Directory Domain Services)

  • Windows Server 2008 R2 with AD CS (Active Directory Certificate Services)

  • Windows Server 2008 R2 with NPS (Network Policy and Access Services)

  • A switch with 802.1x support configured

Configuring Devices for 802.1x Authentication

To configure 802.1x device authentication, complete the following steps:

  1. Create a Client User.

  2. Export the Root CA Certificate.

  3. Create a Certificate Template for Client Authentication.

  4. Issue the Client Certificate.

  5. Export the Client Certificate.

  6. Convert the Certificate Format from .pfx to .pem.

  7. Import the Client Certificate into the Client User Account.

  8. Import the Certificates to the Client Device.

The following sections assume you are using Windows Server 2008 R2

The instructions in the following sections are based on Windows Server 2008 R2. If you are using a newer version of Windows Server, the steps may vary slightly.

Create a Client User

In the Windows 2008 server, create a client user.

To create a client user:

  1. Log in to the Windows 2008 server.

  2. Click Start > Administrative Tools > Server Manager.

  3. Navigate to Roles > Active Directory Domain Services > Active Directory Users and Computers > <domain.local> > Users.

  4. Right-click Users, select New > User, and follow the wizard.

Export the Root CA Certificate

In the Certificate Authority (CA) server, export the root CA certificate.

To export the root CA certificate:

  1. Log in to the Certificate Authority (CA) server.

  2. Open a Microsoft Management Console window (for example, enter mmc.exe in the Start menu search field).

  3. From the console window, select File > Add/Remove Snap-in.

  4. Add the Certificates snap-in, selecting Computer account and then Local computer.

  5. Click Finish, and OK to close the Add or Remove Snap-ins dialog.

  6. From the console, select Certificates (Local Computer) > Trusted Root Certification Authorities > Certificates.

  7. In the right panel, right-click the certificate, and select All Tasks > Export.

  8. Follow the wizard to export the certificate:

    1. Select Base-64 encoded X.509 (.CER).

    2. Click Browse, specify a name and location for the certificate, and then click Save.

    3. Click Finish, and then click OK.

Create a Certificate Template for Client Authentication

In the CA server, create a certificate template for client authentication.

To create a certificate template for client authentication:

  1. From the CA server, click Start > Administrative Tools > Certification Authority.

  2. Expand the tree for your CA.

  3. Right-click Certificate Templates, and then click Manage.

  4. Right-click the Computer template, and then click Duplicate Template.

  5. Configure the template as follows:

    1. From the Compatibility tab, select Windows Server 2003.

    2. From the General tab, enter a name for the template (for example, PCoIP Remote Workstation Card 802.1x) and change the validity period to match the organization’s security policy.

    3. From the Request Handling tab, select Allow private key to be exported.

    4. From the Subject Name tab, select Supply in the request.

    5. From the Security tab, select the user who will be requesting the certificate, and give Enroll permission to this user.

    6. Click OK and close the Certificate Templates Console window.

  6. From the Certification Authority window, right-click Certificate Templates, select New, and then click Certificate Template to Issue.

  7. Select the certificate you just created (that is, PCoIP Remote Workstation Card 802.1x), and then click OK. The template will now appear in the Certificate Templates list.

  8. Close the window.

Issue the Client Certificate

From the CA Web Enrollment interface for the certificate server, issue the client certificate.

To issue the client certificate:

Use Internet Explorer to log in to certificate server

Do not use any other browser except Internet Explorer to log into the certificate server.

  1. Using Internet Explorer on your local machine, go to your Certificate Authority URL using the format https://<server>/certsrv/ (for example, https://ca.domain.local/certsrv/).

  2. Click Request a certificate and then click advanced certificate request.

  3. Click Create and submit a request to this CA.

  4. From the pop-up window, click Yes.

  5. Fill out the Advanced Certificate Request form as follows:

    1. In the Certificate Template section, select the certificate for clients (for example, Remote Workstation Card 802.1x).

    2. In the Identifying Information for Offline Template section, enter the account name in the Name field. The other fields are not required.

      Enter the same name as the universal principal name of the client user

      The name you enter in the Name field must be the universal principal name (UPN) of the client user you created in Create a Client User (for example, remoteworkstationcard@mydomain.local).

    3. In the Additional Options section, set the Request Format to PKCS10.

    4. If desired, enter a name in the Friendly Name field.

    5. Click Submit, and then click Yes at the pop-up window.

    6. From the Certificate Issued window, click Install this certificate.

Export the Client Certificate

From the machine on which you issued the certificate, export the client certificate.

To export the client certificate:

  1. From the machine on which you issued the certificate, open a Microsoft Management Console window (for example, enter mmc.exe in the Start menu search field).

  2. From the console window, select File > Add/Remove Snap-in.

  3. Add the Certificates snap-in, selecting My user account.

  4. Click Finish, and then click OK to close the Add or Remove Snap-ins dialog.

  5. Select Certificates - Current User > Personal > Certificates.

  6. In the right panel, right-click the certificate, and select All Tasks > Export.

  7. Follow the wizard to export the certificate:

    1. Click Yes, export the private key.

    2. Select Personal Information Exchange - PKCS #12 (.PFX).

    3. Enter a password for the certificate.

    4. Click Browse, specify a name and location for the certificate, and then click Save.

    5. Click Finish, and then click OK.

  8. Repeat Steps 5 to 7 again to export the PCoIP Remote Workstation Card certificate, but this time without the private key (No, do not export the private key), selecting the DER encoded binary X.509 (.CER) format instead of the PKCS format.

  9. Save this .cer file to a location where it can be accessed by the Windows 2008 server and imported into Active Directory.

Convert the Certificate Format from .pfx to .pem

Using OpenSSL, convert the certificate format from .pfx to .pem.

To convert the certificate format from .pfx to .pem:

  1. Download and install Windows OpenSSL from https://www.slproweb.com/products/Win32OpenSSL.html. (The light version is sufficient.)

  2. Copy the .pfx client certificate file you saved above to the C:\OpenSSL-Win32\bin directory.

  3. Open a command prompt window, and enter the following command to convert the certificate format from .pfx to .pem:

    C:\OpenSSL-Win32\bin\openssl.exe pkcs12 ‑in <client_cert>.pfx ‑out <client_cert>.pem ‑nodes

    where is the name of the .pfx certificate file you saved to your local machine.

  4. When prompted, enter the password for the certificate file.

  5. At the command prompt, enter the following command to create an RSA private key file:

    C:\OpenSSL-Win32\bin\openssl.exe rsa –in <client_cert>.pem –out <client_cert>_rsa.pem

    where is the name of the .pem certificate file you created in the previous step.

  6. In Notepad or any text editor:

    1. Open both the original .pem file and the RSA .pem file you just created. The RSA .pem file contains only an RSA private key. Because the PCoIP Remote Workstation Card certificate requires its private key in RSA format, you need to replace its private key with this RSA private key.

    2. Copy the entire contents of the RSA .pem file (everything from -----BEGIN RSA PRIVATE KEY ----- to -----END RSA PRIVATE KEY-----), and paste it into the original .pem file, replacing its private key with this RSA private key.

      In other words, make sure that all the text from -----BEGIN PRIVATE KEY----- to -----END PRIVATE KEY (including the dashes) in the original .pem file is replaced with the contents of -----BEGIN RSA PRIVATE KEY ----- to -----END RSA PRIVATE KEY----- (including the dashes) from the RSA .pem file.

    3. Save the original .pem file and close it. The certificate is now ready to be uploaded to the PCoIP Remote Workstation Card.

Import the Client Certificate into the Client User Account

In the Windows 2008 server, import the client certificate into the client user account.

To import the client certificate into the client user account:

  1. Log in to the Windows 2008 server.

  2. Click Start > Administrative Tools > Active Directory Users and Computers.

  3. From the View menu, select Advanced Features.

  4. Navigate to the user you created for the PCoIP Remote Workstation Card.

  5. Right-click the user, and select Name Mappings.

  6. In the X.509 Certificates section, click Add.

  7. Locate and select the PCoIP Remote Workstation Card certificate you exported that does not contain the private key (This file was saved to a network location in step 9 of Export the Client Certificate.)

  8. Make sure both identity boxes are selected. Click OK, and then click OK again.

Import the Certificates to the Client Device

From the device’s AWI, import the certificates.

To import the certificates into a profile using the PCoIP Management Console, see the PCoIP® Management Console Administrators’ Guide.

To import the certificates to a device using the AWI:

  1. From a browser, log into the AWI for the PCoIP Remote Workstation Card.

  2. From the AWI, select Upload > Certificate.

  3. Upload both the Root CA certificate and the certificate with the private key, using the Browse button to locate each certificate and the Upload button to upload them.

  4. From the OSD or AWI, select Configuration > Network.

  5. Select Enable 802.1x Security.

  6. Click Choose beside the Client Certificate field.

  7. Select the certificate with the private key, and then click Select.

  8. Enter the identity name of the certificate. Typically, this is the universal principal name (UPN) that appears after Subject: (for example, remoteworkstationcard@mydomain.local).

    Windows server may be configured to use the certificate’s Subject, the Subject Alternative Name, or another field

    For the identity name, your Windows server may be configured to use the certificate’s Subject, the Subject Alternative Name, or another field. Check with your administrator.

  9. To enable greater 802.1x compatability for older switches on the network, select Enable 802.1X Support for Legacy Switches. This setting is only available from the AWI Network page.

  10. Click Apply, and then click Reset.