Certificate Security Administration

understanding digital certificate security ivanti connect secure uses public key infrastructure (pki) to secure the data sent to clients over the internet pki is a security method that uses public and private keys to encrypt and decrypt information these keys are enabled and stored through digital certificates a digital certificate is an encrypted electronic file issued by a certificate authority (ca) that establishes credentials for client/server transactions in public key cryptography, a public/private key pair is used to encrypt and decrypt data data encrypted with a public key, which the owner makes available to the public, can be decrypted with the corresponding private key only, which the owner keeps secret and protected for example, if user1 wants to send user2 an encrypted message, user1 can encrypt it with user2's public key and send it user2 then decrypts the message with the private key the reverse process is also useful encrypting data with a private key and decrypting it with the corresponding public key this process is known as creating a digital signature for example, if user1 wants to present user1's own identity as the sender of a message, user1 can encrypt the message with user1's private key and send the message to user2 user2 then decrypts the message with user1's public key, thus verifying that user1 is indeed the sender ivanti connect secure systems use the following types of digital certificates to establish credentials and secure session transactions device certificates a device certificate helps to secure network traffic to and from the ivanti secure access client service using elements such as company name, a copy of your company's public key, the digital signature of the ca that issued the certificate, a serial number, and expiration date trusted client cas a trusted client ca is a ca that issues client side certificates you can use trusted client cas in the access management framework realm and role configurations to require certificates or certificates with specific attributes for example, you may specify that users must present a valid client side certificate with the ou attribute set to "yourcompany com" to sign into the users authentication realm trusted server cas a trusted server ca is a ca which issues certificates for web server you can install a trusted server ca to validate the credentials of the web sites that users access through the ivanti secure access client service code signing certificates a code signing certificate (also called an applet certificate) is a certificate that re signs java applets that are intermediated by ivanti connect secure you can use the self signed code signing certificate that comes pre loaded, or you can install your own code signing certificate client auth certificates in this context, the client auth certificate is used when backend ssl servers require ivanti connect secure to present a client certificate for authentication the system can verify certificates that use sha2 as the message digest dsa certificates are not supported using device certificates this topic describes how to use device certificates understanding device certificates a device certificate helps to secure network traffic to and from the ivanti secure access client service using elements such as your company name, a copy of your company's public key, the digital signature of the certificate authority (ca) that issued the certificate, a serial number, and an expiration date when receiving the device certificate from the system, the client's browser first verifies whether the device certificate is valid and whether the user trusts the ca that issued the certificate if the user has not already indicated that they trust the certificate issuer, the web browser prompts the user with a warning saying connection is untrusted or there is a problem with the websites security certificate the system supports x 509 device certificates in der and pem encode formats (file extensions include cer, crt, der, and pem) as well as pkcs #12 (file extensions include pfx and p12) the system also supports the following features intermediate device ca certificates within a certificate hierarchy, one or more intermediate certificates are branched off a single root certificate multiple device certificates when using multiple device certificates, each certificate handles validation for a separate hostname or fully qualified domain name (fqdn) and can be issued by a different ca understanding self signed certificates when you initialize the system with the serial console, the system creates a self signed certificate that enables you to immediately begin setting up the system users are prompted with a security alert each time they sign in because the certificate is not issued by a trusted ca figure 193 shows the security alert the following figure depicts the security alert when the device certificate is not issued by a trusted ca before promoting the system to production use, we recommend you replace the self signed certificate with a certificate issued by a trusted ca importing a device certificate and private key the system uses certificates to verify itself to other network devices a digital certificate is an electronic means of verifying your identity through a trusted third party, known as a certificate authority (ca) your company might use its own enterprise ca server, or it might use a reputable third party ca to import an enterprise root server certificate and private key select system > configuration > certificates > device certificates click import certificate & key to display the configuration page one of the following options to complete the import procedure if certificate file includes private key when the certificate and key are contained in one file if certificate and private key are separate files when the certificate and key are in separate files import via system configuration file when the certificate and key are contained in a system configuration file with this option, the system imports all of the certificates specified (including private keys and pending csrs, but not the corresponding port mappings) in the appropriate form, browse to the certificate and key files if the file is password protected, enter the password key click import creating a certificate signing request if your company does not own a digital certificate for its web servers, you can create a certificate signing request (csr) and then send the request to a ca for processing when you create a csr, a private key is created locally that corresponds to the csr if you delete the csr at any point, this file is also deleted, prohibiting you from installing a signed certificate generated from the csr to create a certificate signing request select system > configuration > certificates > device certificates click new csr to display the configuration page complete the required information and click create csr follow the onscreen instructions, which explain what information to send to the ca and how to send it when you submit a csr to a ca authority, you might be asked to specify either the type of web server on which the certificate was created or the type of web server the certificate is for select apache (if more than one option with apache is available, select any) if you are prompted for the certificate format to download, select the standard format do not send more than one csr to a ca at one time doing so can result in duplicate charges to view details of any pending requests that you previously submitted, click the certificate signing request details link while generating a csr, an apostrophe string is required, prefix it by an escape character for example, "children's" should be "children\\'s" importing a signed certificate created from a csr when you receive the signed certificate from the ca, import it to import a signed device certificate created from a csr select system > configuration > certificates > device certificates under certificate signing requests, click the pending csr link that corresponds to the signed certificate under import signed certificate, browse and select the certificate file you received from the ca, and then click import understanding intermediate certificates within a certificate hierarchy, one or more intermediate certificates are branched off a single root certificate the root certificate is issued by a root ca and is self signed each intermediate certificate is issued by the certificate preceding it in the chain to use chained certificates in your deployment, you must ensure that the server (ivanti connect secure) and client (web browser) together contain the entire certificate chain for example, you can secure traffic using a chain that stems from a verisign root certificate if your users' browsers come preloaded with verisign root certificates, you need to install only the lower level certificates in the chain when your users sign in, the system presents any required certificates within the chain to the browser to secure the transaction the system creates the proper links in the chain using the root certificate's issuerdn if the system and browser together do not contain the entire chain, the user's browser does not recognize or trust the device certificate because it is issued by another certificate instead of by a trusted ca you can upload one or more intermediate cas in a pem file the entire chain must be sent to the client in descending order, starting with the root certificate within a certificate hierarchy, one or more intermediate certificates are branched off a single root certificate the root certificate is issued by a root ca and is self signed each intermediate certificate is issued by the certificate preceding it in the chain to use chained certificates in your deployment, you must install the appropriate client side certificates in each user's web browser and then upload the corresponding ca certificates to ivanti connect secure gateway's intermediate ca store use one of the following methods to upload the certificate chain import the entire certificate chain in one file the file must contain the root certificate and any subcertificates whose parents are in the file or already imported you can include certificates in any order in the import file import the certificates one at a time in descending order you must install the root certificate first, and then install the remaining chained certificates in descending order if you follow one of these methods, the system automatically chains the certificates together in the correct order and displays them hierarchically in the admin console if you install multiple certificates in a user's web browser, the browser prompts the user to choose which certificate to use when signing in importing intermediate ca certificates to import an intermediate ca certificate select system > configuration > certificates > device certificates click the intermediate device cas link to display the management page click import ca certificate browse to the certificate file, select it, and click import certificate to complete the import operation importing a renewed certificate that uses the existing private key you can renew a device certificate in two ways submit a new csr to a ca this process is more secure because the ca generates a new certificate and private key and retires the older private key to use this renewal method, you must first create a csr through the admin console request renewal based on the csr previously submitted to the ca this process is less secure, because the ca generates a certificate that uses the existing private key when you order a renewed certificate, you must either resubmit your original csr or ensure that the ca has a record of the csr that you submitted for your current certificate to import a renewed device certificate that uses the existing private key follow your ca's instructions for renewing a certificate that you previously purchased through them be sure to specify the same information you used in the original csr your ca uses this information to create a new certificate that corresponds to the existing key even though you specify the same information used in the original csr, your root ca might have different serial numbers and keys from the original you might need to support both new client and old client certificates during the transition period, which also requires that you maintain two root ca certificates (your existing certificate and the renewed certificate), at least temporarily select system > configuration > certificates > device certificates click the link that corresponds to the certificate you want to renew click renew certificate to display the page in the renew the certificate form, browse to the renewed certificate file, enter the password for the certificate key, and click import downloading a device certificate you download the device certificate to your local host so that you can import it into other network devices as needed to download a device certificate select system > configuration > certificates > device certificates click the link of the device certificate you want to download to display the configuration page click the download link save the file to the desired location using device certificates with virtual ports virtual ports can be used to create multiple fully qualified domain names for user sign in when a user tries to sign in using the ip address defined in a virtual port, the system uses the certificate associated with the virtual port to initiate the ssl transaction you can implement digital certificate security with virtual ports in either of the following ways associate all hostnames with a single certificate with this method, you use a single wildcard certificate to validate the identity of all system hostnames, regardless of which hostname is used to sign into a wildcard certificate includes a variable element in the domain name, making it possible for users who sign in from multiple hosts to map to the "same" domain for example, if you create a wildcard certificate for yourcompany com, the system uses the same certificate to validate its identity to users who sign in to employees yourcompany com as it does to users who sign into partners yourcompany com associate each hostname with its own certificate with this method, you associate different hostnames with different certificates create a virtual port for each hostname a virtual port activates an ip alias on a physical port for example, you can create two virtual ports on a single appliance, mapping the first virtual port to the ip address 10 10 10 1 (sales yourcompany com) and the second virtual port to the ip address 10 10 10 2 (partners yourcompany com) then you can associate each of these virtual ports with its own certificate, ensuring that users authenticate through different certificates to associate certificates with virtual ports create the virtual ports import the device certificates associate the device certificates with the virtual ports select system > configuration > certificates > device certificates click the link of the device certificate you want to configure to display the configuration page use the controls in the "present certificate on these ports" section to associate ports with the certificate you can assign only one device certificate to the management port if you assign a certificate other than the default device certificate to the management port, the default device certificate is automatically deselected as the default if you do not select a device certificate for the management port, the system uses the default device certificate that is presented on the internal port you cannot assign certificates to management port vips acme server mapping an acme server can be mapped to only one device certificate acme mapping section appears only if atleast one port is explicitly mapped to the certificate to map an acme server select the acme server and key type based on the selected key type ecdsa select one of the following ecc curves p 256 p 384 p 521 rsa select one of the following key sizes 2048 bits 3072 bits 4096 bits specify the certificate renewal schedule by entering the date and time in the format dd/mm/yyyy hh\ mm\ ss by default, the renewal date is automatically set to 90% of the current certificate's validity period you can reschedule once the certificate's validity is set automatically as shown below date cannot be reschedule beyond the validity date enter one or more subject alternative names (sans) (for example, www example com, 10 1 12 10) and click add at least one san entry is mandatory all fqdn are resolved to hostname a mapped acme server can be associated with only one device certificate at a time if device certificate belongs to chain, then all intermediate certificate will be updated automatically click renew now to renew the certificate manually enabling certificate revocation check for device certificate to enable the crl for device certificates go to system > configuration > certificates > device certificates click on the certificate from the list to go to the certificate details in the certificate details page, go to certificate status checking and enable the use crls (certificate revocation lists) check box the following figure depicts the enabling certificate revocation check for device certificate click on save changes import the ca or ca chain that issued the device certificate to system > configuration > trusted server cas once the crl is successfully downloaded for device certificate, it is listed in the crl distribution points the following figure depicts the successful crl download for device certificate this version of the ics supports upto 8192 bit key length for device certificates the following figure depicts the bit key length for device certificates using trusted client cas this topic describes how to use trusted client certificate authorities (cas) understanding trusted client cas a trusted client ca is a ca that you deem trusted by adding it to the trusted client ca store the system trusts any certificate issued by that ca to use client ca certificates, you must install and enable the proper certificates additionally, you must install the corresponding client side certificates in your users' web browsers, or you must use the mmc snap in in your users' computer accounts (machine certificate) when validating a client side ca certificate, the system verifies that the certificate is not expired or corrupt and that the certificate is signed by a ca that the system has been configured to recognize if the ca certificate is chained, the system also follows the chain of issuers until it reaches the root ca, validating each issuer in turn the system supports x 509 ca certificates in der and pem encode formats when you install a client side certificate, you must determine whether to use the certificate to identify individual users or individual machines to use the certificate to identify individual users, you must install the certificate in each user's individual certificate store then you must enable authentication using a certificate server, or you must enable authorization using realm, role, and/or resource policy settings to use the certificate to identify individual machines, you must install the certificate in each computer's certificate store then you must configure a host checker policy that checks for the machine certificate and authorizes access to realms, roles, or resource policies based on the certificate's validity the system supports using the following additional features with ca certificates certificate servers a certificate server is a type of local authentication server that allows you to authenticate users based solely on their certificate attributes rather than authenticating them against a standard authentication server (such as ldap or radius), and it requires specific certificates or certificate attributes certificate hierarchies within a certificate hierarchy, one or more subordinate certificates (called intermediate certificates) are branched off a root certificate to create a certificate chain each intermediate certificate (also called a chained certificate) handles requests for a part of the root ca domain for example, you can create a root certificate that handles all requests to the yourcompany com domain and then branch off intermediate certificates that handle requests to partners yourcompany com and employees yourcompany com when you install a chained certificate, the system confirms that the chain is valid and allows users to authenticate using the leaf certificate (that is, the lowest certificate in the chain) certificate revocation lists certificate revocation is a mechanism by which a ca invalidates a certificate before its expiration date the ca publishes a certificate revocation list (crl) which is a list of revoked certificates within crls, each entry contains the serial number of the revoked certificate, the date that the certificate was revoked, and the reason the certificate was revoked the ca can invalidate a certificate for various reasons such as when the employee to whom the certificate is issued leaves the company, the certificate's private key is compromised, or the client side certificate is lost or stolen when the ca revokes a certificate, the system can appropriately deny access to users who present a revoked certificate trusted client ca implementation notes uploading a trusted client ca certificate does not enable client side ssl authentication or authorization to do so, you must use a certificate server, or enable certificate restrictions at the realm, role, or resource policy level, or create a host checker policy that verifies a machine certificate with client side certificates, we strongly recommend that you advise users to close their web browsers after signing out if they do not, other users might be able to use their open browser sessions to access certificate protected resources without reauthentication after loading a client side certificate, internet explorer caches the certificate's credentials and private key the browser keeps this information cached until the user closes the browser (or, in some cases, until the user reboots the workstation) for details, see http //support microsoft com/?kbid=290345 https //support microsoft com/en us/help/290345 to remind users to close their browsers, you can modify the sign out message on the sign in pages tab understanding crls a certificate revocation list (crl) is a mechanism for canceling a client side certificate as the name implies, a crl is a list of revoked certificates published by a ca or a delegated crl issuer the system supports base crls, which include all of the company's revoked certificates in a single, unified list the system determines the correct crl to use by checking the client's certificate (when it issues a certificate, the ca includes crl information for the certificate in the certificate itself ) to ensure that it receives the most up to date crl information, the system periodically contacts a crl distribution point to get an updated list of crls a crl distribution point (cdp) is a location on an ldap directory server or web server where a ca publishes crls the system downloads crl information from the cdp at the interval specified in the crl, at the interval that you specify during crl configuration, and when you manually download the crl the system also supports crl partitioning crl partitioning enables you to verify portions of very large crls without spending the time and bandwidth necessary to access and validate a very large crl or collection of large crls crl partitioning is only enabled when you employ the specify the cdp(s) in the client certificates method (described below) in this case, the system validates the user by verifying only the crl specified in the client certificate although cas include crl information in client side certificates, they do not always include cdp information as well a ca can use any of the following methods to notify the system of a certificate's cdp location specify the cdp(s) in the ca certificate when the ca issues a ca certificate, it might include an attribute specifying the location of the cdps that the system should contact if more than one cdp is specified, the system chooses the first one listed in the certificate and then fails over to subsequent cdps, if necessary specify the cdp(s) in the client certificates when the ca issues a client side certificate, it might include an attribute specifying the location of the cdps that the system must contact if more than one cdp is specified, it chooses the first one listed in the certificate and then fails over to subsequent cdps, if necessary when the system employs crl partitioning and the client certificate specifies only one crl, it performs verification using only that crl if you choose this method, the user receives an error on the first sign in attempt because no crl information is available once the system recognizes the client's certificate and extracts the crl location, it can start downloading the crl and subsequently validate the user's certificate in order to successfully sign in, the user must try to reconnect after a few seconds require the administrator to manually enter the cdp location if the ca does not include the cdp location in the client or ca certificates, you must manually specify how to download the entire crl object you can specify a primary and backup cdp (manually entering the cdp location provides the greatest flexibility because you do not need to reissue certificates if you change the cdp location ) the system compares the user's certificate against the appropriate crl during authentication if it determines that the user's certificate is valid, the system caches the certificate attributes and applies them, if necessary, during role and resource policy checks if it determines that the user's certificate is invalid, if it cannot contact the appropriate crl, or if the crl is expired, it denies the user access note the system supports only crls that are in a pem or der format and that are signed by the ca for which the revocations apply the system only saves the first crl in a pem file understanding ocsp the online certification status protocol (ocsp) is a service that enables you to verify client certificates when ocsp is enabled, the system becomes a client of an ocsp responder and forwards validation requests for users based on client certificates the ocsp responder maintains a store of ca published certificate revocation lists (crls) and maintains an up to date list of valid and invalid client certificates after the ocsp responder receives a validation request, it validates the status of the certificate using its own authentication database, or it calls upon the ocsp responder that originally issued the certificate to validate the request after formulating a response, the ocsp responder returns the signed response, and the original certificate is either approved or rejected importing a trusted client ca certificate if you require users to provide a client side certificate to sign in, you must upload the corresponding ca certificate you can upload ca certificates manually, or you can configure the system to upload ca certificates automatically the system uses the uploaded certificate to verify that the browser submitted certificate is valid in addition, you can specify whether or not to automatically import ca certificates for validation, and you can specify a crl or ocsp retrieval method to use to automatically import ca certificates to import a trusted client ca certificate select system > configuration > certificates > trusted client cas to display the configuration page click import ca certificate to display the configuration page browse to the certificate file, select it, and click import certificate to complete the import operation renewing a certificate to renew a certificate select system > configuration > certificates > trusted client cas click the link for the certificate you want to renew click renew certificate to display the import certificate page browse to the certificate file, select it, and click import certificate to complete the import operation configuring auto importing of client certificates to enable auto importing select system > configuration > certificates > trusted client cas click the auto import options button to display the options complete the configuration described in the following table save your changes the following table lists the auto import options settings settings guidelines auto import trusted cas select this option to enable auto import and display its configuration settings client certificate status checking select a method to validate the trusted client certificate none do not validate use ocsp use the ocsp method, validating the client certificate in real time, as needed after you select this option, you can specify options for ocsp use crls use crls to validate the client certificate after you select this option, you can specify options for crl use ocsp with crl fallback use the ocsp validation method when possible, but attempt to validate client certificates using crls if the ocsp method fails (for example, if the link to the ocsp responder fails) after you select this option, you can specify options for ocsp and crl inherit from root ca use the method configured for the device certificate cdp(s)/ocsp responder select the location of the responder value none do not use the responder from client certificate use the responder value configured in the client certificate from trusted ca certificate use the responder value configured in the trusted ca certificate that has been uploaded to the system verify imported ca certificates select this option to verify that this trusted client ca is valid enabling this will check the crl of this certificate's issuer, and repeat up the chain until reaching the root trusted client ca skip revocation check when ocsp/cdp server is not available select this option to instruct ics to skip revocation check and accept end user certificates when either ocsp server or cdp server is not accessible over the network this option is applicable to digital certificates used for end user authentication the ocsp timeout, applicable only for ocsp, is used as the maximum timeout for a network connection or data transfer operation while connecting to an ocsp responder an internal timeout will be used for cdp ics skips the revocation check in the following conditions server ip is not reachable server hostname is either not resolvable or resolving to non ocsp/crl server ip proxy ip is either not reachable or not resolving downloaded crl has expired ocsp/crl service in server is not responding configuring options for trusted client ca certificates to configure options for the trusted client ca certificate select system > configuration > certificates > trusted client cas click the certificate you want to configure complete the configuration described in the following table the following table lists the trusted client ca settings settings guidelines certificate use the expander buttons to display the following details issued to name and attributes of the entity to whom the certificate is issued issued by name and attributes of the entity that issued the certificate note that the value of this field must match either the issued to field (for root certificates) or the issued to field of the next highest certificate in the chain (for intermediate certificates) valid dates time range for which the certificate is valid details various certificate details, including its version, serial number, signature algorithm, crl distribution points, public key algorithm type, and public key client certificate status checking select a method to validate the trusted client certificate none do not validate use ocsp use the ocsp method, validating the client certificate in real time, as needed after you have selected this option and saved the configuration, you can specify options for ocsp use crls use crls to validate the client certificate after you have selected this option and saved the configuration, you can specify options for crl use ocsp with crl fallback use the ocsp validation method when possible, but attempt to validate client certificates using crls if the ocsp method fails (for example, if the link to the ocsp responder fails) after you have selected this option and saved the configuration, can specify options for ocsp and crl inherit from root ca use the method configured in root ca this option is only applicable for intermediate ca verify trusted client ca select this option to verify that this trusted client ca is valid enabling this will check the crl of this certificate's issuer, and repeat up the chain until reaching the root trusted client ca trusted for client authentication clear this check box to exclude the ca from being trusted for client certificate authentication you might want to do this if this ca was added for another trusting purpose, such as saml signature verification or machine certificate validation participate in client certificate negotiation this option is available only on ivanti connect secure select this option to include the ca participation in client certificate selection for authentication in client certificate authentication or restriction, the device sends a list of all trusted client cas configured in the trusted client ca store with this flag enabled to the user's browser for user certificate selection the browser prompts the client certificates whose issuer ca and/or root ca is in that list this option allows you to control which client certificate(s) are prompted for selection clearing this option for all certificates in a ca chain results in those certificates not being prompted skip revocation check when ocsp/cdp server is not available select this option to instruct ics to skip revocation check and accept end user certificates when either ocsp server or cdp server is not accessible over the network this option is applicable to digital certificates used for end user authentication the ocsp timeout, applicable only for ocsp, is used as the maximum timeout for a network connection or data transfer operation while connecting to an ocsp responder an internal timeout will be used for cdp ics skips the revocation check in the following conditions server ip is not reachable server hostname is either not resolvable or resolving to non ocsp/crl server ip proxy ip is either not reachable or not resolving downloaded crl has expired ocsp/crl service in server is not responding save your changes if you have enabled crl checking , click crl checking options if you have enabled ocsp options click ocsp options complete the configuration described in table 126 the following table lists the ocsp options settings settings guidelines use select the type of ocsp responder to validate trusted client cas none the system does not use ocsp to verify the status of certificates issued by this ca responder(s) specified in the ca certificate the system uses ocsp responders specified in the imported client ca to perform verification when you select this option, the system displays a list of ocsp responders specified in the imported ca (if any) and the last time they were used responder(s) specified in the client certificates the system uses responders specified during client authentication to perform verification when you select this option, the system displays a list of known ocsp responders (if any) and the last time they were used manually configured responders the system uses primary and secondary ocsp responders at the addresses you specify device certificate to sign the request select the appropriate device certificate or leave the default (unsigned) signature hash algorithm select sha 2 use nonce a nonce is random data the system includes in an ocsp request and the ocsp responder returns in the ocsp response the system compares the nonce in the request and response to ensure that the response is generated by the ocsp responder if the two do not match, the system disregards the response and sends a new request nonces are a common way of preventing replay attacks save the configuration after you have added an ocsp responder to the list, you can click its link to display the page complete the configuration described in table 127 the following table lists the responder signer certificate settings settings guidelines responder signer certificate browse to the network path or local directory location of a responder signer certificate this is the certificate the ocsp responder uses to sign the response you must specify the responder signer certificate if the signer certificate is not included in the response trust responder certificate select this option to allow an ocsp responder certificate that matches the responder signer certificate revocation checking select this option to ensure that the certificate has not recently been revoked this option has implications only if you specified the use ocsp with crl fallback option allow clock discrepancy use this option to account for possible mismatches in timestamps between the system clock and the ocsp responder clock if the mismatch is significant, the system disregards the response from the ocsp responder as out of date or expired save the configuration configuring a proxy server for crl downloads and ocsp status checks you can configure the system to send crl download requests and ocsp status checks to the proxy server and collect the response you might want to do this if you deploy proxy server to control access to the internet the following types of crl downloads can use the proxy server crl distribution points (cdps) specified in the trusted client cas cdps specified in client certificates manually configured cdps similarly, the system can send ocsp requests to the ocsp responder through the proxy server the ocsp responses are also received through the proxy server this feature is useful when you deploy a large number of ivanti access systems and the ocsp responders are located outside the network to configure a proxy server select system > configuration > certificates > trusted client cas click proxy settings to display the page complete the configuration described in table 128 save the configuration the following table lists the proxy settings settings guidelines use proxy server for http based crl download select to enable the crl operations to use a proxy server you can configure a proxy server for web based urls, not ldap urls use proxy server for http based ocsp status checking select to enable the ocsp operations to use a proxy server host address specify either an ip address or a fully qualified domain name port enter the proxy server port number if it is different from the default value of 80 username/password if your proxy server required authentication, enter a username and password to log in to the proxy server using trusted server cas this topic describes trusted server certificate authorities (cas) understanding trusted server cas all of the trusted root cas for the web certificates installed in internet explorer are preinstalled you might need to install a trusted server ca for additional web servers in the following situations if you are using third party integrity measurement verifiers (imvs) that are installed on a remote server, you must upload the trusted root certificate of the ca that signed the remote server's server certificate if you are using virus signature version monitoring with your own staging site for storing the current virus signatures list, you must upload the trusted root certificate of the ca that signed the staging server certificate you can install the trusted root ca certificate on the endpoint in any of the following ways use a ca certificate that is chained to a root certificate that is already installed on the endpoint, such as verisign upload the ca certificate and any intermediate ca certificates to the ivanti secure access client system during client installation, the system automatically installs the trusted root device ca certificates on the endpoint when prompted during installation, the user must allow the installation of the ca certificate(s) prompt users to import the ca certificates on the endpoint using internet explorer or other microsoft windows tools in other words, you can use common methods organizations use to distribute root certificates you cannot use crl revocation checks for trusted server ca certificates uploading trusted server ca certificates you can use the trusted server cas page to upload the trusted root certificate of the ca that signed the ivanti secure access client service device certificate if you upload a certificate chain, you must install the certificates one at a time in descending order starting with the root certificate (der or pem files), or you must upload a single file that contains the entire certificate chain (pem files only) the system supports x 509 ca certificates in pem (base 64) and der (binary) encode formats to upload ca certificates select system > configuration > certificates > trusted server cas to display the page click import trusted server ca to display the page browse to the certificate file, select it, and click import certificate to complete the import operation restoring the prepopulated group of trusted server ca certificates the system > configuration > certificates > trusted server cas page is prepopulated with some of the trusted root cas for the web certificates installed in internet explorer and windows you can use the delete functionality on this page to delete cas and the reset functionality to restore the list to the set that was installed during the upgrade the reset operation clears all manually imported certificates to restore the prepopulated group of trusted ca certificates select system > configuration > certificates > trusted server cas click reset trusted server cas confirm that you want to restore the set of trusted server cas that was installed when you upgraded ivanti connect secure restores the group of prepopulated trusted server cas that were installed upon upgrade this operation clears all manually imported certificates renewing a trusted server ca certificate if a trusted ca renews its certificate, you must upload the renewed ca certificate to import a renewed ca certificate select system > configuration > certificates > trusted server cas click the link that corresponds to the certificate that you want to renew to display the page click renew certificate browse to the certificate file, select it, and click import certificate to complete the import operation deleting a trusted server ca certificate you can delete any trusted server ca certificate, including preinstalled certificates to delete a trusted server ca certificate select system > configuration > certificates > trusted server cas select the check box for the certificate you want to delete click delete , and then confirm that you want to delete the certificate using code signing cas this topic describes how to use code signing certificate authorities (cas) understanding code signing cas in a basic setup, the only required certificates are a device certificate and a code signing certificate ivanti connect secure can use a single code signing certificate to resign all java applets and a single device certificate to intermediate all other pki based interactions if the basic certificates do not meet your needs, however, you may install multiple device and applet certificates on ivanti connect secure or use trusted ca certificates to validate users when ivanti connect secure intermediates a signed java applet, it re signs the applet with a self signed certificate by default this certificate is issued by a nonstandard trusted root ca as a result, if a user requests a potentially high risk applet (such as an applet that accesses network servers), the user's web browser alerts him that the root is untrusted if you import a code signing certificate, ivanti connect secure uses the imported certificate to re sign applets instead of the default self signed certificate as a result, if a user requests a potentially high risk applet, the user's web browser displays an informational message instead of a warning the message informs the user that the applet is signed by a trusted authority the system supports the following types of code signing certificates microsoft authenticode certificate the system uses this certificate to sign applets that run on either microsoft jvm or oracle jvm note that we only support microsoft authenticode certificates issued by verisign javasoft certificate the system uses this certificate to sign applets that run on oracle jvm note that we only support javasoft certificates issued by verisign and thawte when deciding which code signing certificate to import, consider the following browser dependencies internet explorer internet explorer running on new computers shipped with windows pre installed typically runs the oracle jvm, which means that ivanti connect secure needs to re sign applets using the javasoft certificate internet explorer running on an older version of windows that has been upgraded may run the microsoft jvm, which means that ivanti connect secure needs to re sign applets using the authenticode certificate netscape, firefox, and safari these browsers only support the oracle jvm, which means that ivanti connect secure needs to re sign applets using the javasoft certificate additional considerations for oracle jvm users by default, the java plug in caches an applet along with the code signing certificate presented when a user accesses the applet this behavior means that even after importing a code signing certificate to ivanti connect secure, the browser continues to present applets with the original certificate to ensure that jvm users are not prompted with an untrusted certificate for applets accessed prior to importing a code signing certificate, users need to flush the java plug in cache alternatively, users can disable the cache, but this option may impact performance since the applet needs to be fetched each time the user accesses it the java plug in maintains its own list of trusted web server certificates that is different from the browser's list of trusted certificates when a user accesses an applet, the jvm makes its own connection (in addition to the browser) to the web server on which the applet resides the user is then presented with the option to accept the web server certificate in addition to the code signing certificate in these cases, the user needs to select the always trust button for the web server certificate due to a built in timeout in the java plug in, if the user waits too long to select this button for the web server certificate, the applet does not load importing a code signing ca certificate to import a code signing certificate select system > configuration > certificates > code signing certificates to display the configuration page click import certificates to display the configuration page complete the configuration described in table 129 the following table lists the import certificates configuration guidelines settings guidelines microsoft authenticode or multipurpose certificate for internet explorer (microsoft jvm) certificate file browse to the network path or local directory location of your certificate key file private key file browse to the network path or local directory location of your private key file password key enter the password key javasoft certificate for internet explorer & netscape (sun jvm) keystore file browse to the network path or local directory location of the keystore file password key enter the password key click import to complete the import operation when you have successfully imported a certificate, the system displays the sign ivanti secure web controls with dialog box specify the signing option default ivanti certificate select this option to sign all activex and java applets originating from ivanti connect secure using the default ivanti certificate if you have previously selected an imported code signing certificate and are reverting back to this option, after you click save, a process icon appears indicating that the system is processing the request and re signing all of the relevant code this process can take several minutes to complete authenticode certificate for \<imported certificate name> select this option to sign all activex and java applets using the certificate or certificates imported in the previous step when you click save, a process icon appears indicating that the system is processing the request and signing all of the relevant code this process can take several minutes to complete use settings in the following tabs to specify which resources are signed or re signed by the applet certificate users > resource policies > web > java > code signing using code signing certificates for java applets to use code signing certificates with java applets install the java code signing certificates use the system > configuration > certificates > code signing certificates page use any of the following methods create code signing policies specifying which applets to re sign use the users > resource policies > web > java > code signing page or the users > resource profiles > web application resource profiles > profile page the policies must specify the hostnames from which the applets originate upload your own java applets to ivanti connect secure and configure the system to sign or re sign the applets using client auth certificates this topic describes how to use client auth certificates understanding client auth certificates in certain corporate environments, servers on the lan are protected with two way ssl authentication these servers require the client to authenticate by presenting a valid certificate in the remote access scenario, ivanti connect secure is a client of these servers you can configure ivanti connect secure to present client authentication certificates to servers whenever it communicates over ssl note that ivanti connect secure will present client certificates only when the ssl handshake requires it this feature authenticates ivanti connect secure (as a client) to back end servers it also authenticates end users or end user machines to servers on the corporate lan the ssl protocol provides for mutual authentication of server and client at the time of session initiation the client part of the authentication is optional for enhanced security, some deployments may require that the client also authenticate itself with a certificate normally, when setting up an ssl connection with a server on behalf of the end user, ivanti connect secure does not present any certificate to the server it needs to be explicitly configured to present such certificate this section explains how such configuration may be performed the basic idea is to upload a certificate, private key pair to the access management framework and configure a mapping between this pair and a server resource subsequently, when an end user attempts to establish a connection with that server, ivanti connect secure presents the associated certificate to the server if no certificate is associated with the server in ivanti connect secure's certificate store, then it is assumed that the server does not demand client certificate if, during the ssl handshake, the back end server requests a client certificate but ivanti connect secure doesn't send a certificate, the end user sees an "access denied" error message similarly, if the back end server rejects the ivanti connect secure certificate, the end user sees an "access denied" error message if a certificate is configured, is successfully retrieved and no error is encountered during handshake, the user is granted access to the server the access management framework allows client authentication certificates to be uploaded to the device in two ways generate a csr and upload the signed certificate returned by the ca, or directly import the certificate if one is available importing a client auth certificate the access management framework allows certificates that include the private key and for instances where the private key is in a separate file from the certificate in addition, if your certificates have been exported into a system configuration file, you can import the system configuration file to upload the certificates to import the client auth certificates files select system > configuration > certificates > client auth certificates click import certificate & key to display the configuration page complete the configuration described in table 130 click import the following table lists the import certificate and key settings settings guidelines if certificate file includes private key certificate file browse to the network path or local directory location of your private key file password key enter the password key if certificate and private file are separate keys certificate file browse to the network path or local directory location of your certificate key file private key file browse to the network path or local directory location of your private key file password key enter the password key import via system configuration file system configuration file browse to the network path or local directory location of the system configuration file password enter the password renewing a client auth certificate to renew a certificate select system > configuration > certificates > client auth certificates click the link that corresponds to the certificate you want to renew click renew certificate to display the configuration page in the renew the certificate form, browse to the renewed certificate file, enter the password for the certificate key, and click import configuring two way ssl authentication to configure two way ssl authentication import the certificates used for two way ssl handshake in the system > configuration > certificates > client auth certificates window define the back end resource and assign a certificate to be presented when accessing it using the users > resource policies > web > client authentication window enabling certificate revocation check for client auth certificate client auth certificate revocation check is only applicable for tls syslog backend server it is not applicable for any other backend server configured to ask client certificate to enable the crl for client auth certificate go to system > configuration > certificates > client auth certificates click on the certificate from the list to go to the certificate details in the certificate details page, go to certificate status checking and enable the use crls (certificate revocation lists) check box the following figure depicts enabling certificate revocation check for client auth certificate click on save changes import the ca or ca chain that issued the client auth certificate to system > configuration > trusted client cas once the crl is successfully downloaded for client auth certificate, it is listed in the crl distribution points see figure 198 the following figure depicts successful crl download for client auth certificate this version of the ics supports the 8192 bit key length for client auth certificates see following figure the following figure depicts the 8192 bit key length for client auth certificates crl download for device certificate and client auth certificate using ldap based url won't work due to dependency of ldap username and password in some cases, cdp ldap url hostname field is also required which is also not supported mapping resource policies to the certificate once the certificates have been uploaded, you can map resources to the certificates and the roles to which they apply select users > resource policies > web > client authentication if you do not see the client authentication menu item, select users > resource policies > web click the customize button in the upper right corner of the console in the customize view dialog box, select client authentication click ok click the client authentication tab click new policy on the new policy page enter a name to label this source interface policy enter an optional description in the resources section, specify the back end servers to which this policy applies valid values/formats are hostnames, ip addresses, ip address\ port and hostname\ port if you specify as the resource, one certificate is used for all resources requesting a back end certificate authentication this certificate becomes the default certificate defining a default certificate is not required in the roles section, select one of the following options policy applies to all roles to apply this policy to all users policy applies to selected roles to apply this policy only to users who are mapped to roles in the selected roles list make sure to add roles to this list from the available roles list policy applies to all roles other than those selected below to apply this policy to all users except for those who map to the roles in the selected roles list make sure to add roles to this list from the available roles list in the action section, select one of the following options use the client authentication certificate below select this option to associate this policy with a client authentication certificate select the certificate to use from the certificate menu if the certificates menu is blank, no certificates have been uploaded to the system > configuration > certificates > client auth certificates window do not use client authentication if this option is selected, the system does not perform client authentication for the configured resource use detailed rules select this option to specify one or more detailed rules for this policy click save changes mapping a client authentication auto policy a client authentication auto policy option is available on the users > resource profiles > web page if the back end server requires two way ssl authentication, this auto policy lets you configure a certificate to be presented during the ssl handshake select users > resource profiles > web follow the process as a regular resource profile for defining the name and type select the autopolicy client authentication check box in the resource field, specify the back end server valid formats/values are hostnames, ip addresses, ip address\ port, and hostname port if you specify as the resource, one certificate is used for all resources requesting a back end certificate authentication this certificate becomes the default certificate defining a default certificate is not required click save changes checking certificate expiry every time a certificate is added to ics (through manual import, xml import, or upgrade), its expiration date is stored in the cache a background process checks all certification expiration dates once in every 7 days if any certificate is about to expire soon, the administrator is notified notifications to administrators include a banner message in the adminui upon login, snmp trap, and log messages in the event log the administrator can configure how soon he or she wishes to be notified of the expiration the default is 60 days in advance it can be configured to a value starting from 7 days in advance to 999 days in advance of the expiration of the certificate the expiration warning window is common to all types of certificates however, the administrator can choose to enable or disable this feature for each certificate category in the user interface features of certificate expiry warning an administrator can know about certificates that are going to expire in the near future and avoid any unexpected downtime due to certificate expiry administrators can take corrective actions whenever a certificate is about to expire in order to ensure there is no service disruption an administrator can enable/disable this feature for each category of certificates an administrator can set how many days in advance i should be notified about certificate expiry this is common to all certificate types read only administrators are not allowed to change these values this feature is enabled by default just after upgrade or a binary/xml import when an administrator logs in to a cluster, the certificate expiration warning messages is seen for both nodes to check validity of certificates click on configuration > certificates > certificates validity check the page displays the certificate expiry notification duration and the certificate types enter the number of days before which the warning must be displayed select the type of certificate for which the expiry notification is required by default, all types of certificates will be selected if no selection is made the following figure shows certificates validity check page click on check now the certificate category, dn name and date of expiry are displayed as seen in the following figure the following figure depicts the certificate expiration page when an administrator logs in, a warning sign is displayed, if there are any certificates that expire within the configured number of days the following figure depicts the warning signal displayed to check if the certificate expiry warning is logged, click on log monitoring the certificate expiry warning logs are displayed the following figure depicts the certificate expiry warning logs already expired certificates under the tabs device certificates, trusted client cas, trusted server cas and client auth certificates are displayed in red color for code signing certificates, if it has expired, a string "expired" is displayed in red color the image below displays code signing certificates that have expired automatic certificate management environment (acme) protocol as certificate authorities continue to shorten certificate validity periods, administrators must renew certificates more frequently the acme protocol simplifies certificate lifecycle management by automating certificate issuance and renewal, reducing administrative effort and minimizing the risk of certificate expiration this capability is particularly useful with let's encrypt, which uses the acme protocol to provide free, automated tls certificates ivanti connect secure supports the acme protocol in accordance with rfc 8555, enabling automated certificate management and streamlined tls deployment the automatic certificate management environment (acme) protocol allows clients to automate interactions with certificate authorities (cas) to obtain, renew, and revoke certificates to add new acme server, do the following select system > configuration > certificates > acme enter the name and url are mandatory fields for configuring acme sever all other fields are optional enter preferred chain preferred certificate chain issuer some acme servers (like let's encrypt) may offer multiple certificate chains for example, chains signed by different root cas or intermediate certificates the directive specifies the subject common name of the topmost certificate (root ca) you prefer the module will fetch all available alternate chains via http link headers and choose the one matching your preference if no chain matches the specified name, the default chain provided by the server is used automatically enter acme profile name or identifier certificate profiles some acme servers support specialized certificate profiles that define specific validation requirements, certificate attributes, or policies (e g , different certificate types, validation methods, or compliance requirements) choose the profile mode preferred (default) requests the profile if the server supports it if the server does not support the profile, a warning is logged but the certificate issuance proceeds normally required (require parameter) certificate renewals will fail if the server does not support the specified profile acme server external account credentials enter the key id key identifier for acme server external account enter the key data secret key for acme server external account click save changes see also acme server mapping docid\ q5tn0rv6w3ngbn7wg4tge with device certificate note tls alpn 01 is the only supported challenge type wildcard domains cannot use tls alpn 01; therefore, wildcard certificates are not supported certificates issued using the p 521 ecc curve are not supported by google chrome and microsoft edge deploying such certificates may cause the ivanti connect secure to become inaccessible when accessed from these browsers only device certificates mapped to an interface can be auto renewed via acme proxy support is absent in the nginx acme module; ics must be able to reach the ca's acme server endpoint directly acme only issues domain validated (dv) certificates the cn must be a validated domain name per ca/browser forum baseline requirements custom csr is not supported — only sans and key type/size can be configured