Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Migrated to Confluence 5.3

2.3.1 Introduction

The certificates management is related to the server name and the services provided (please refer to PSAM 2.2 Network Segregation for details about the certificate assignation to a specific NIC/IP/name). In order to provide to the client a sure match of your identity you need to load and configure a secure certificate bonded to your server name (ie: name.server.tld).

Subtitle
Prefixfigure
SubtitleTextCertificate configuration, default certificate installed
AnchorNamedefault_certificate

You can get the certificates configuration page using the Certificate Management link in the main menu. As shown above the default page is listing the installed TLS Keypair. 

Info

By default, on PrivateServer it's installed one "*.madama.at" wildcard certificate as shown in

Xref
AnchorNamedefault_certificate

Subtitle
Prefixfig.
SubtitleTextThe tabs to access the two section related with the certificate management
AnchorNametls tabs

From this page you can decide to view and delete your keypairs or the Certification Authority entries, using the tabs shown in the above 

Xref
AnchorNametls tabs
.

Subtitle
Prefixfig
SubtitleTextlink for adding new tis keypairs or new CAs
AnchorNamenew_tls_new_ca

Instead if you need to create a new TLS key pair or add a new CA, then you have to use the buttons above the "TLS Keypair" list (the ones shown in 

Xref
AnchorNamenew_tls_new_ca
).

2.3.2 New TLS Key pair

If you need to upload a new certificate, click on the New TlsKeyPair link above the certificate table.

Subtitle
Prefixfigure
SubtitleTextNew certificate form
AnchorNamenew_certificate

 

You are redirected on the Create TlsKeyPair page (it's shown in 

Xref
AnchorNamenew_certificate
) where an upload form needs to be filled. Its fields are:

  • Description: a generic name you choose to identify this certificate
  • Private Key: your private key, provided by the signature authority
  • Certificate: the certificate itself
  • Cert Chain: a possible intermediate certificate used to link the certification authority to your certificate.

All the fields must be in PEM (Privacy Enhanced Mail) format and you just copy and paste each of them in the proper field. When your' done you just press the Create button on the bottom line and the certificates are ready to be assigned to an interface/IP.

Anchor
2.3.3_add_certification_authority
2.3.3_add_certification_authority
2.3.3 Add Certification Authority

You might need to upload a new CA (Certification Authority) if you tried to install a tis key pair not signed by an installed CA. 

Info

By default PrivateServer contains a default list of pre-loaded Certification Authorities.

Subtitle
Prefixfig
SubtitleTextthe default CA list
AnchorNameclean_CA_list

The new CA installation becomes mandatory because without a complete certificate chain the new TLS key pair would not be accepted by PrivateServer. If you need to upload a new certificate, click on the Add certification authority button above the certificate list table.

Subtitle
Prefixfig
SubtitleTextNew Certification Authority
AnchorNamenew_CA

You get the form shown in 

Xref
AnchorNamenew_CA
 which is pretty straightforward. You just have to cut 'n' paste the CA's content in the Certificate box and click on the Create button at the bottom. 

Subtitle
Prefixfig
SubtitleTextCA list updated
AnchorNameCA_list_updated

As shown in 

Xref
AnchorNameCA_list_updated
 the Certification Authority list shows a new entry. You can check the entry by subject (which is the entity that release the certificate) and the expiry Date (that shows how long the certificate is considered valid). 

2.3.4 Delete TLS key pair

In a day-by-day secure VoIP service administration it's not unusual to delete a TLS key pair. The procedure starts right at the Certificate Management page (the one shown in 

Xref
AnchorNamedefault_certificate
.

Subtitle
Prefixfig
SubtitleTextthe TLS key pair list with a testing entry to be deleted
AnchorNametls_key_pair_to_delete

In 

Xref
AnchorNametls_key_pair_to_delete
 you can see we added an entry conveniently named testing entry to be deleted and that's what we're going to do.

Warning

Please make sure no services got association with the TLS entry you're going to remove, or else the deletion would fail.

Subtitle
Prefixfig
SubtitleTextTLS key pair details
AnchorNametls_details

First you click on the chosen entry and get a detail of the TLS key pair (as in 

Xref
AnchorNametls_details
). At the page's bottom there's a Delete button. Just press it.

Subtitle
Prefixfig
SubtitleTextthe deletion is confirmed
AnchorNametls_key_pair_deleted

Confirm the deletion in the following pop-up windows. After that you get the new TLS key pair list without the deleted entry and with a warning which explains the entry has been deleted (as in 

Xref
AnchorNametls_key_pair_deleted
).

2.3.5 Delete Certification Authority

You cannot edit an entry in the CA list, but you still can delete a CA and create a new one for replacement. That said, the way for deleting a CA entry is quite simple. From the CA list shown in 

Xref
AnchorNameCA_list_updated
 choose the CA you want to expunge and press the Delete link in the last right column. 

Subtitle
Prefixfig
SubtitleTextCA's details
AnchorNamedelete_CA_1

First you get a detail of the certificate you're going to delete. Just press the Delete button at the bottom and confirm your choice in the next pop up window.

Subtitle
Prefixfig
SubtitleTextThe CA list updated and the warning
AnchorNamedelete_CA_2

You receive a confirmation about the deletion in the new CA list page (shown above in 

Xref
AnchorNamedelete_CA_2
). Plus the list no more shows the deleted CA entry.

 

 

Navbar