Get a Quote     (408) 943-4100   TrueNAS Discord VendOp_Icon_15x15px Enterprise Support
TrueNAS.com Software Systems Company Community Security iX Portal Download
TrueNAS Enterprise TrueNAS SCALE TrueNAS CORE Compare Editions TrueCommand Software Status FreeNAS
Compare Systems F-Series M-Series H-Series R-Series Mini Series
Contact Us iXsystems Careers Clients Reviews
TrueNAS GitHub Community Forum Discord TrueNAS Merch Store
Use Cases Analytics Backup and Archival Cloud Data Mobility File Sharing iX Storj Media Creation Surveillance Virtualization
Industry Education Government Healthcare Research / AI / ML Media & Entertainment
Enterprise Support Community Support Documentation TrueNAS Security FAQ ZFS Overview
TrueNAS Blog Solution Guides Datasheets Case Studies Videos TrueCommand Cloud
Download TrueNAS SCALE Download TrueNAS CORE Get TrueNAS Enterprise Compare TrueNAS Editions Contact an Enterprise Specialist
  1. TrueNAS CORE
  2. /
  3. UI Reference Guide
  4. /
  5. System
  6. /
  7. Certificates
Edit page
TrueNAS CORETrueNAS CORE Version Documentation
This content follows the TrueNAS CORE 13.0 releases. Use the Product and Version selectors above to view content specific to different TrueNAS software or major version.

Certificates

  5 minute read.

After you create or import a new certificate, bind it to the relevant service. For HTTPS binding, go to System > General and select the certificate you want to bind in the GUI SSL Certificate field.

For other services, such as SMB or FTP, bind the certificate within the Services screen. Click the Configure button next to the service you want to bind to, then select the certificate within the Certificate field.

CAInternalIntermediate

Identifier and Type

NameDescription
NameDescriptive identifier for this certificate.
TypeInternal Certificate is used for internal or local systems. Certificate Signing Request is used to get a CA signature. Import Certificate allows an existing certificate to be imported onto the system. Import Certificate Signing Request allows an existing CSR to be imported onto the system.
ProfilesPredefined certificate extensions. Choose a profile that best matches your certificate usage scenario.

Internal Certificate and Certificate Signing Request

Certificate Options

NameDescription
Signing Certificate Authority (Internal Certificate)Select a previously imported or created CA.
Key TypeSee Why is elliptic curve cryptography not widely used, compared to RSA? for more information about key types.
EC CurveBrainpool curves can be more secure, while secp curves can be faster.
Key LengthThe number of bits in the key used by the cryptographic algorithm. For security reasons, a minimum key length of 2048 is recommended.
Digest AlgorithmThe cryptographic algorithm to use. The default SHA256 only needs to be changed if the organization requires a different algorithm.
LifetimeThe lifetime of the CA specified in days.

Certificate Subject

NameDescription
CountrySelect the country of the organization.
StateEnter the state or province of the organization.
LocalityEnter the location of the organization. For example, the city.
OrganizationEnter the name of the company or organization.
Organizational UnitOrganizational unit of the entity.
EmailEnter the email address of the person responsible for the CA.
Common NameEnter the fully-qualified hostname (FQDN) of the system. This name must be unique within a certificate chain.
Subject Alternate NamesMulti-domain support. Enter additional domains to secure. Separate domains by pressing Enter. For example, if the primary domain is example.com, entering www.example.com secures both addresses.

Basic Constraints

NameDescription
EnabledActivate this certificate extension.
Path LengthHow many non-self-issued intermediate certificates that can follow this certificate in a valid certification path. Entering 0 allows a single additional certificate to follow in the certificate path. Cannot be less than 0.
Basic Constraints ConfigThe basic constraints extension identifies whether the subject of the certificate is a CA and the maximum depth of valid certification paths that include this certificate. See RFC 3280, section 4.2.1.10 for more information.

Authority Key Identifier

NameDescription
EnabledActivate this certificate extension.
Authority Key ConfigThe authority key identifier extension provides a means of identifying the public key corresponding to the private key used to sign a certificate. This extension is used where an issuer has multiple signing keys (either due to multiple concurrent key pairs or due to changeover). The identification MAY be based on either the key identifier (the subject key identifier in the issuer’s certificate) or on the issuer name and serial number. See RFC 3280, section 4.2.1.1 for more information.

Extended Key Usage

NameDescription
EnabledActivate this certificate extension.
UsagesIdentify the purpose for this public key. Typically used for end entity certificates. Multiple usages can be selected. Do not mark this extension critical when the Usage is ANY_EXTENDED_KEY_USAGE. Using both Extended Key Usage and Key Usage extensions requires that the purpose of the certificate is consistent with both extensions. See RFC 3280, section 4.2.1.13 for more details.
Critical ExtensionIdentify this extension as critical for the certificate. Critical extensions must be recognized by the certificate-using system or this certificate will be rejected. Extensions identified as not critical can be ignored by the certificate-using system and the certificate still approved.

Key Usage

NameDescription
EnabledActivate this certificate extension.
Key Usage ConfigThe key usage extension defines the purpose (e.g., encipherment, signature, certificate signing) of the key contained in the certificate. The usage restriction might be employed when a key that could be used for more than one operation is to be restricted. For example, when an RSA key should be used only to verify signatures on objects other than public key certificates and CRLs, the Digital Signature bits would be asserted. Likewise, when an RSA key should be used only for key management, the Key Encipherment bit would be asserted. See RFC 3280, section 4.2.1.3 for more information.

Import Certificate and Import Certificate Signing Request

Certificate Options (Import Certificate)

NameDescription
CSR exists on this systemCheck this box if importing a certificate for which a CSR exists on this system
Signing Certificate AuthoritySelect a previously imported or created CA.

Certificate Subject

NameDescription
Certificate (Import Certificate)Paste the certificate for the CA.
Signing Request (Import CSR)Paste the contents of your Certificate Signing Request here.
Private KeyPaste the private key associated with the Certificate when available. Please provide a key at least 1024 bits long.
PassphraseEnter the passphrase for the Private Key.
Confirm PassphraseConfirm the passphrase for the Private Key.

Related Content

Have more questions or want to discuss your specific configuration? For further discussion or assistance, see these resources:

Found content that needs an update? You can suggest content changes directly! To request changes to this content, click the Feedback button located on the middle-right side of the page (might require disabling ad blocking plugins).