Cisco Unified Communications Operating System Administration Guide for Cisco Unified CCX and Cisco Unified IP IVR, Release 9.0(2)
Security
Download this chapter
SecuritySecurity
Download the complete book
Cisco Unified Communications Operating System Administration Guide for Cisco Unified CCX and Cisco Unified IP IVR, Release 9.0(2)Cisco Unified Communications Operating System Administration Guide for Cisco Unified CCX and Cisco Unified IP IVR, Release 9.0(2) (PDF - 1 MB)
 Feedback

Security

This chapter describes Certificate Management and IPSec Management and provides procedures for managing system security.

Set Internet Explorer security settings

To download certificates from the server, ensure your Internet Explorer security settings are configured as follows:

Procedure
    Step 1   Start Internet Explorer.
    Step 2   Navigate to Tools > Internet Option.
    Step 3   Click the Advanced tab.
    Step 4   Scroll down to the Security section on the Advanced tab.
    Step 5   If necessary, clear the Do not save encrypted pages to disk check box.
    Step 6   Click OK.

    Certificate Management menu


    Note

    To access the Security menu items, you must log in to Cisco Unified Communications Operating System Administration using your administrator password.

    Display certificates

    To display existing certificates, follow this procedure:

    Procedure
      Step 1   Navigate to Security > Certificate Management.

      The Certificate List window appears.

      Step 2   You can use the Find controls to filter the certificate list.
      Step 3   To view details of a certificate or trust store, click its file name.

      The Certificate Configuration window shows information about the certificate.

      Step 4   To return to the Certificate List window, select Back To Find/List in the Related Links list; then, click Go.

      Download certificate

      To download a certificate from the Cisco Unified Communications Operating System to your PC, follow this procedure:

      Procedure
        Step 1   Navigate to Security > Certificate Management. The Certificate List window appears.
        Step 2   You can use the Find controls to filter the certificate list.
        Step 3   Click the file name of the certificate. The Certificate Configuration window appears.
        Step 4   Click Download.
        Step 5   In the File Download dialog box, click Save.

        Delete certificate

        To delete a trusted certificate, follow this procedure:


        Caution

        Deleting a certificate can affect your system operations. Any existing CSR for the certificate that you choose from the Certificate list is deleted from the system. You must generate a new CSR.

        Procedure
          Step 1   Navigate to Security > Certificate Management.

          The Certificate List window appears.

          Step 2   You can use the Find controls to filter the certificate list.
          Step 3   Click the file name of the certificate. The Certificate Configuration window appears.
          Step 4   Click Delete.
          Related topics

          Regenerate certificate

          To regenerate a certificate, follow this procedure:


          Caution

          Regenerating a certificate can affect your system operations.

          Procedure
            Step 1   Navigate to Security > Certificate Management. The Certificate List window appears.
            Step 2   Click Generate New. The Generate Certificate dialog box opens.
            Step 3   Choose a certificate name from the Certificate Name list. The following table contains descriptions of the certificate names that appear:
            Name Description
            tomcat This self-signed root certificate is generated during installation for the HTTPS server.
            ipsec This self-signed root certificate is generated during installation for IPSec connections with MGCP and H.323 gateways.
            Step 4   Click Generate New.
            What to Do Next

            After you regenerate certificates in Cisco Unified Communications Operating System, you must perform a backup so that the latest backup contains the regenerated certificates. For information on performing a backup, see the Disaster Recovery System Administration Guide.

            Upload certificate to server


            Caution

            Uploading a new certificate can affect your system operations. After you upload a new certificate, you must restart the Unified CCX server (in the case of high availability deployments, restart both nodes).


            Note

            The system does not distribute trust certificates to other cluster node automatically. If you must have the same certificate on more than one node, you must upload the certificate to each node individually.

            Upload certificate or certificate chain

            Procedure
              Step 1   Navigate to Security > Certificate Management. The Certificate List window appears.
              Step 2   Click Upload Certificate/Certificate Chain. The Upload Certificate/Certificate Chain dialog box opens.
              Step 3   Select the certificate name from the Certificate Name list.
              Step 4   Select the file to upload by performing one of the following steps:
              • In the Upload File text box, enter the path to the file, or
              • Click the Browse button and navigate to the file; then, click Open.

                Cisco Unified CCX supports Privacy Enhanced Mail (PEM) Base64 encoded format of X.509 certificate (only one PEM certificate in a file), Distinguished Encoding Rules (DER) format of X509 Certificate and DER format of PKCS#7 (Public-Key Cryptography Standards) Certificate Chain. The system does not support PEM format of PKCS#7 Certificate Chain.

              Step 5   Click the Upload File button to upload the file to the server.

              Directory Trust Certificate


              Note

              Uploading a Directory Trust Certificate is not applicable for Unified CCX 9.0(1).

              Obtain third-party CA certificates

              Cisco Unified Communications Operating System supports certificates that a third-party Certificate Authority (CA) issues with PKCS # 10 Certificate Signing Request (CSR). The following table provides an overview of this process, with references to additional documentation:

              Procedure
                Step 1   Generate a CSR on the server.

                See Generate Certificate Signing Request.

                Step 2   Download the CSR to your PC.

                See Download Certificate Signing Request.

                Step 3   Use the CSR to obtain an application certificate from a CA.

                Get information about obtaining application certificates from your CA. See Application certificates for additional notes.

                Step 4   Obtain the CA root certificate.

                Get information about obtaining a root certificate from your CA. See Application certificates for additional notes.

                Step 5   Upload the CA root certificate to the server.

                See Upload certificate or certificate chain.

                Step 6   Upload the application certificate to the server.

                See Upload certificate or certificate chain.

                Step 7   Restart the services that are affected by the new certificate.

                For all certificate types, restart the corresponding service (for example, restart the Tomcat service if you updated the Tomcat certificate). See the Cisco Unified CCX Serviceability Administration Guide for information about restarting services.

                Generate Certificate Signing Request

                To generate a Certificate Signing Request (CSR), follow these steps:

                Procedure
                  Step 1   Navigate to Security > Certificate Management. The Certificate List window appears.
                  Step 2   Click Generate CSR. The Generate Certificate Signing Request dialog box opens.
                  Step 3   Select the certificate name from the Certificate Name list.
                  Note   

                  For the current release of the Cisco Unified Operating System, the Directory option no longer appears in the list of Certificate Names.

                  Step 4   Click Generate CSR.

                  Download Certificate Signing Request

                  To download a Certificate Signing Request, follow this procedure:

                  Procedure
                    Step 1   Navigate to Security > Certificate Management. The Certificate List window appears.
                    Step 2   Click Download CSR. The Download Certificate Signing Request dialog box opens.
                    Step 3   Select the certificate name from the Certificate Name list.
                    Step 4   Click Download CSR.
                    Step 5   In the File Download dialog box, click Save.

                    Application certificates

                    To use an application certificate that a third-party CA issues, you must obtain both the signed application certificate and the CA root certificate from the CA. Collect information about obtaining these certificates from your CA. The process varies among CAs.

                    Cisco Unified Communications Operating System generates certificates in DER and PEM encoding formats and generates CSRs in PEM encoding format. It accepts certificates in DER and PEM encoding formats.

                    For all certificate types, obtain and upload a CA root certificate and an application certificate on each node.

                    The CSRs for Tomcat and IPSec use the following extensions: 

                    X509v3 Key Usage: 
Digital Signature, Key Encipherment, Data Encipherment, Key Agreement
X509v3 Extended Key Usage:
TLS Web Server Authentication, TLS Web Client Authentication, IPSec End System
                    1. Upload the CA root certificate of the CA that signed an application certificate. If a subordinate CA signs an application certificate, you must upload the CA root certificate of the subordinate CA, not the root CA.
                    2. You upload CA root certificates and application certificates by using the same Upload Certificate dialog box. When you upload a CA root certificate, choose the certificate name with the format certificate type-trust.
                    3. When you upload an application certificate, choose the certificate name that only includes the certificate type. For example, choose tomcat-trust when you upload a Tomcat CA root certificate; choose tomcat when you upload a Tomcat application certificate.

                    Monitor certificate expiration dates

                    The system can automatically send you an e-mail when a certificate is close to its expiration date. To view and configure the Certificate Expiration Monitor, follow this procedure:

                    Procedure
                      Step 1   Navigate to Security > Certificate Monitor.

                      The Certificate Monitor window appears.

                      Step 2   Enter the required configuration information.

                      See the table below for a description of the Certificate Monitor Expiration fields.

                      Step 3   To save your changes, click Save.
                      Table 1 Certificate monitor field descriptions
                      Field Description

                      Notification Start Time

                      Enter the number of days before the certificate expires that you want to be notified.

                      Notification Frequency

                      Enter the frequency for notification, either in hours or days.

                      Enable Email Notification

                      Select the check box to enable e-mail notification.

                      Email IDs

                      Enter the e-mail address to which you want notifications sent.

                      Note   

                      For the system to send notifications, you must configure an SMTP host.

                      IPSec Management

                      The following topics describe the functions that you can perform with the IPSec menu:


                      Note

                      IPSec does not automatically get set up between nodes in the cluster during installation.

                      Set up new IPSec policy

                      Any changes that you make to an IPSec policy during a system upgrade are lost, so do not modify or create IPSec policies during an upgrade.


                      Caution

                      IPSec, especially with encryption, affects the performance of your system.

                      Procedure
                        Step 1   Navigate to Security > IPSEC Configuration. The IPSEC Policy List window appears.
                        Step 2   Click Add New. The IPSEC Policy Configuration window appears.
                        Step 3   Enter the appropriate information on the IPSEC Policy Configuration window. See the table below for descriptions of the fields on this window.
                        Step 4   Click Save to set up the new IPSec policy.
                        Table 2 IPSec policy and association field descriptions
                        Field Description
                        Policy Group Name

                        Specifies the name of the IPSec policy group. The name can contain only letters, digits, and hyphens.

                        Policy Name

                        Specifies the name of the IPSec policy. The name can contain only letters, digits, and hyphens.

                        Authentication Method

                        Specifies the authentication method.

                        Preshared Key

                        Specifies the preshared key if you selected Pre-shared Key in the Authentication Name field.

                        Note   

                        Pre-shared IPSec keys can contain alphanumeric characters and hyphens only, not white spaces or any other characters. If you are migrating from a Windows-based version of Unified CCX, you may need to change the name of your pre-shared IPSec keys, so they are compatible with current versions of Unified CCX.

                        Peer Type

                        Specifies whether the peer is the same type or different.

                        Certificate Name

                        If you choose Different for the Peer Type, enter the new certificate name.

                        Destination Address

                        Specifies the IP address or FQDN of the destination.

                        Destination Port

                        Specifies the port number at the destination.

                        Source Address

                        Specifies the IP address or FQDN of the source.

                        Source Port

                        Specifies the port number at the source.

                        Mode

                        Specifies Transport mode.

                        Remote Port

                        Specifies the port number to use at the destination.

                        Protocol
                        Specifies the protocol:
                        • TCP
                        • UDP
                        • Any
                        Encryption Algorithm
                        From the drop-down list, choose the encryption algorithm. Choices include
                        • DES
                        • 3DES
                        Hash Algorithm
                        Specifies the hash algorithm:
                        • SHA1—Hash algorithm that is used in phase 1 IKE negotiation
                        • MD5—Hash algorithm that is used in phase 1 IKE negotiation
                        ESP Algorithm
                        From the drop-down list, choose the ESP algorithm. Choices include
                        • NULL_ENC
                        • DES
                        • 3DES
                        • BLOWFISH
                        • RIJNDAEL
                        Phase One Life Time

                        Specifies the lifetime for phase One, IKE negotiation, in seconds.

                        Phase One DH

                        From the drop-down list, choose the phase One DH value. Choices include: 2, 1, and 5.

                        Phase Two Life Time

                        Specifies the lifetime for phase Two, IKE negotiation, in seconds.

                        Phase Two DH

                        From the drop-down list, choose the phase Two DH value. Choices include: 2, 1, and 5.

                        Enable Policy

                        Check the check box to enable the policy.

                        Manage IPSec policies

                        To display, enable or disable, or delete an existing IPSec policy, follow this procedure:


                        Note

                        Because any changes that you make to an IPSec policy during a system upgrade are lost, do not modify or create IPSec policies during an upgrade.


                        Caution

                        IPSec, especially with encryption, will affect the performance of your system.


                        Caution

                        Any changes that you make to the existing IPSec policies can impact your normal system operations.

                        Procedure
                          Step 1   Navigate to Security > IPSEC Configuration.
                          Note   

                          To access the Security menu items, you must log in to Cisco Unified Communications Operating System Administration again by using your Administrator password.

                          The IPSEC Policy List window appears.
                          Step 2   To display, enable, or disable a policy, follow these steps:
                          1. Click the policy name. The IPSEC Policy Configuration window appears.
                          2. To enable or disable the policy, click the Enable Policy check box.
                          3. Click Save.
                          Step 3   To delete one or more policies, follow these steps:
                          1. Check the check box next to the policies that you want to delete.

                            You can click Select All to select all policies or Clear All to clear all the check boxes.

                          2. Click Delete Selected.

                          Bulk Certificate Management


                          Note

                          The Security > Bulk Certificate Management menu option is not applicable for Unified CCX 9.0(1).

                          Single sign on


                          Note

                          The Security > Single Sign On menu option is not applicable for Unified CCX 9.0(1).