{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-products/pki-on-prem/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["img"]},"type":"markdown"},"seo":{"title":"SSL Certificates Generation and Management","description":"Integration and usage documentation."},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"ssl-certificates-generation-and-management","__idx":0},"children":["SSL Certificates Generation and Management"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["SSL certificates are required to provide encrypted HTTPS communication and to ensure trusted access for clients and administrators."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"1-overview","__idx":1},"children":["1. Overview"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["SmartTSA allows administrators to:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Generate SSL Certificate Signing Requests (CSR)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Create self-enrolled (self-signed) certificates"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Import certificates issued by a trusted Certification Authority (CA)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Assign and activate SSL certificates for the TSA service endpoint"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Import certificates in PKCS#12 format"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Correct SSL configuration is mandatory for production environments."]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/sslcertifiedmanagement.1c45ec71460ab6c6941afa07304efd4815d286ce87730cbebc4f196df81ecedc.761d52a0.png","alt":"SSL Certificate management page","framed":false,"withLightbox":false,"width":"700","align":"center"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"2-purpose-of-ssl-certificates-in-smarttsa","__idx":2},"children":["2. Purpose of SSL Certificates in SmartTSA"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["SSL certificates are used to:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Secure web-based administrative access"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Protect client connections to TSA services"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Enable HTTPS encryption"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Ensure authenticity of the TSA endpoint"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Prevent man-in-the-middle attacks"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Without SSL, browsers and clients may display security warnings or reject connections."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"3-generating-an-ssl-certificate-request-csr","__idx":3},"children":["3. Generating an SSL Certificate Request (CSR)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Once selected, it will be shown a page with a form to fill with the wished values for the attribute certificate.",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"In the field description you have to fill in with the mnemonic name you want to assign to the service (e.g., “Test_TSA”)."," ","The Hash Algorithm combo-box let you select among MD5, SHA-1 or SHA-256."," ","Key Length can be set to 1024 or 2048; it specifies the length of the keys that will be generated on the HSM inside the smartTSA appliance that will be bound to the TSA-certificate."," ","The others field represent specific field of the certificate to be created. After filling all the mandatory fields, select the button “Generate Request”."," ","Once created the request, it has to be sent to a third-party trusted CA or to be self-signed (point 2)."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"4-validation-of-a-request","__idx":4},"children":["4. Validation of a request"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For both procedures, you have to select in the left menu “Manage Pending Certificate Requests”.",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"In this page are showed, in a table, the requests that need to be validate in order to become usable to enable a timestamping service."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["On the third column of the table there are all the operations that could be done on that:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["details"]},": it shows a brief summary of certificate request’s data;"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["download"]},": it allows the download of the request (in .pem format). The administrative user can select the destination folder where the request will be saved. This feature allows the forward of the request to a third-party trusted CA in order to let it generate a linked certificate;"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["assign certificate"]},": after sending the request to a CA, the CA reply with a certificate associated to that specific request. Selecting this feature, it is possible to bind a trusted certificate (that can be selected on the user’s file system) to the request previously generated."," ","After this operation, the request is associated to a new “offline” service."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["self-enroll"]},": this feature allows to self-sign a certificate request previously generated."," ","After this operation, the request is associated to a new “offline” service."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["delete"]},": for deleting a request."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Once is finalized a “assign certificate” or a “self enroll” operation, the smartTSA create a Timestamping service. Its status is set to “Offline”."," ","To change the service status to “Online”, select “modify” in the fourth column."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In the field Url, it is possible to specify the suffix that will be added to the Url of the SmartTSS."," ","For example, assuming that the Url of the smartTSA is http://XXX.XXX.XXX.XXX, if the field Url relative to the Service “Test cert” is filed with “/TSAtest”, the corresponding service will be available at http://XXX.XXX.XXX.XXX/TSAtest"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The option “download” in the fourth column allows the downloading of the certificate connected to that Timestamping service."]}]},"headings":[{"value":"SSL Certificates Generation and Management","id":"ssl-certificates-generation-and-management","depth":1},{"value":"1. Overview","id":"1-overview","depth":1},{"value":"2. Purpose of SSL Certificates in SmartTSA","id":"2-purpose-of-ssl-certificates-in-smarttsa","depth":1},{"value":"3. Generating an SSL Certificate Request (CSR)","id":"3-generating-an-ssl-certificate-request-csr","depth":1},{"value":"4. Validation of a request","id":"4-validation-of-a-request","depth":1}],"frontmatter":{"seo":{"title":"SSL Certificates Generation and Management"}},"lastModified":"2026-03-23T10:44:53.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/products/pki-on-prem/tsa/customer_documentation/ssl","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}