.. _convert_web_certificates_from_P7B_to_PEM_Format:

Convert Web Certificates from P7B to PEM Format
-----------------------------------------------

|VOSS-4-UC| uses web certificates in Privacy Enhanced Mail (PEM) format.
PEM certificates typically have extensions like ``.pem``, ``.crt``, ``.cer``
and ``.key``.

If a P7B format certificate is received from a Certificate Authority (CA):

1. Copy the files to a workstation with Linux console available (Not the VOSS-4-UC system).
2. Run the following command for each ``<filename>.p7b``, for example:

   ``sudo openssl pkcs7 -in <filename>.p7b -inform DER -print_certs -out <filename>.pem``

3. Open the PEM file in a text editor. You will see formatting like the example below in the file:

   ::

      subject=/C=GB/ST=West Midlands/L=Coventry/O=Service Coventry/OU=Network Services/
         CN=ccs-cp-v4uc.svcoventry.gov.uk/emailAddress=network@svcoventry.co.uk
      issuer=/C=GB/O=Coventry/OU=PKI/CN=BCC Intermediate CA
      -----BEGIN CERTIFICATE-----
      MIIFxTLmBK2gAwIBAgITXgAAAMBXLQb0/ImKBwALmQAAwDANBgkqhkiG9w0BAQsF
      ADBOMQswLmYDVLmQEwJHQjETMBEGA1UEQhMKQmlybWluZ2hhbTEMMAoGA1UEQxMD
      UEtJMRwwGgYDVLmQExNLm0MgSW50ZXJtZWRpYXRlIENBMB4LmQE2MTAwNTEyNTIx

4. Delete all text and blank lines outside the lines:

   ``-----BEGIN CERTIFICATE-----`` and ``-----END CERTIFICATE-----``

5. Save the file and make sure that the file is not saved in a DOS format.

.. |VOSS-4-UC| replace:: VOSS-4-UC
.. |Unified CM| replace:: Unified CM