RUGGEDCOM ROS
User Guide
Chapter 1
Introduction
Certificate and Key Requirements
23
Section 1.8
Certificate and Key Requirements
Users are able to load custom and unique SSL certificates and SSL/SSH keys in ROS or use the certificates and
keys provided by ROS.
There are three types of certificates and keys:
NOTE
Default and auto-generated SSH keys are not available for Non-Controlled (NC) versions of ROS.
•
Default
Each ROS device is shipped with an SSL certificate and RSA key pair, and a DSA key pair for SSH that are
unique to software version. If a valid SSL certificate or SSL/SSH keys are not available on the device, the
default certificate and keys are used immediately so that SSH and SSL (https) sessions can be served.
•
Auto-Generated
If a default SSL certificate and SSL/SSH keys are in use, ROS immediately begins to generate a unique
certificate and SSL/SSH keys for the device in the background. This process takes approximately 5 minutes
to complete (depending on how busy the device is at the time) following the startup of the device. If a custom
certificate and keys are loaded while auto-generated certificates and keys are being generated, the generator
will abort and the custom certificate and keys and will be used.
•
User-Generated (Recommended)
Custom certificates and keys are the most secure option. They give the user complete control over certificate
and key management, allow for certificates signed by a public or local certificate authority, controlled
distribution of public SSH keys to network hosts that need them, and more.
NOTE
The RSA key pair must be added to the
ssl.crt
file after the SSL certificate.
For SSL, ROS requires an X.509 certificate in standard PEM format and an RSA key pair. The certificate may
be self-signed or signed by a separate authoriy. The RSA key must be between 512 and 2048 bits in length. The
certificate and keys must be combined in a single
ssl.crt
file and uploaded to the device.
The following is an example of a combined SSL certificate and key:
-----BEGIN CERTIFICATE-----
MIIgAwIBAgIJAJh6rrehMt3iMA0GCSqGSIb3DQEBBQUAMIGuMQswCQYD
VQQGEwJDQTEQMA4GA1UECBMHT250YXJpbzEQMA4GA1UEBxMHQ29uY29yZDESMBAG
A1UEChMJUnVnZ2VkY29tMRkwFwYDVQQLExBDdXN0b21lciBTdXBwb3J0MSYwJAYD
VQQDEx1XUy1NSUxBTkdPVkFOLlJVR0dFRENPTS5MT0NBTDEkMCIGCSqGSIb3DQEJ
ARYVc3VwcG9ydEBydWdnZWRjb20uY29tMB4XDTEyMTAyMzIxMTA1M1oXDTE3MTAy
MjIxMTA1M1owgZwxCzAJBgNVBAYTAlVTMRAwDgYDVQQIEwdPbnRhcmlvMRAwDgYD
VQQHEwdDb25jb3JkMRIwEAYDVQQKEwlSdWdnZWRDb20xGTAXBgNVBAsTEEN1c3Rv
bWVyIFN1cHBvcnQxFDASBgNVBAMTCzE5Mi4xNjguMS4yMSQwIgYJKoZIhvcNAQkB
FhVTdXBwb3J0QHJ1Z2dlZGNvbS5jb20wgZ8wDQYJKoZIhvcNAQEBBQADgY0AMIGJ
AoGBALfCE3W5a4Wz1Z1RGRP02COHt153wFFrU8/fFQXNhKlQirlAHbNT
RSwcTR8ZFapivwYDivn0ogOGFXknYP90gv2oIaSVY08FqZkJW77g3kzkv/8Zrw3m
W/cBsZJ8SyKLIDfy401HkHpDOle5NsQFSrziGUPjAOIvvx4rAgMBAAGjLDAqMAkG
A1UdEwQCMAAwHQYDVR0OBBYEFER0utgQOifnrflnDtsqNcnvRB0XMA0GCSqGSIb3
DQEBBQUAA4GBAHtBsNZuh8tB3XidCsD70YnI7w0tiy9yiRRhARmVXH8h
5Q1rOeHceri3JFFIOxIxQt4Kc9Esk/nXQQar3zR7IQCt0qOABPkviiY8
c3ibVbhJjLpR2vHkNNtBOg1xUlp4vOm7XAy/OP/S
-----END CERTIFICATE-----
-----BEGIN RSA PRIVATE KEY-----
MIICXAIBAAKBgQC3xOHodmmPghN1uWuFs9WdURkT9Ngjh7ded8BRa1PP3xUFzYSp