TLS Command Reference

Command Hierarchies

Security TLS Commands

config
— system
— security
tls
client-cipher-list name [create]
— no client-cipher-list name
cipher index name cipher-suite-code
— no cipher index
client-tls-profile name [create]
— no client-tls-profile name
cipher-list name
[no] shutdown
trust-anchor-profile name [create]
[no] trust-anchor ca-profile-name

LDAP TLS Profile Commands

config
— system
— security
— ldap
server server-index [create]
— no server server-index
tls-profile tls-profile-name

Admin Commands

admin
— certificate
reload type {cert | key | cert-key-pair} filename protocol protocol [key-file filename]

Command Descriptions

This section provides the CLI command descriptions. Topics include:

Security TLS Commands

tls

Syntax 
tls
Context 
config>system>security
Description 

This command configures TLS parameters.

client-cipher-list

Syntax 
client-cipher-list name [create]
no client-cipher-list name
Context 
config>system>security>tls
Description 

This command creates a cipher list that the client sends to the server in the client Hello message. It is a list of ciphers that are supported and preferred by the SR OS to be used in the TLS session. The server matches this list against the server cipher list. The top cipher between both lists is chosen.

Parameters 
name—
Specifies the name of the client cipher list, up to 32 characters.
create—
Keyword used to create the client cipher list.

cipher

Syntax 
cipher index name cipher-suite-code
no cipher index
Context 
config>system>security>tls>client-cipher-list
Description 

This command configures the cipher suite to be negotiated by the client with the server. The index provides the location of the cipher in the negotiation list, with the lower index number being on top of the negotiation list and the higher index number being at the bottom of the list.

Parameters 
index—
Specifies the index.
Values—
1 to 255
name cipher-suite-code
Specifies the cipher suite code.
Values—
tls-rsa-with-null-md5
tls-rsa-with-null-sha
tls-rsa-with-null-sha256
tls-rsa-with-3des-ede-cbc-sha
tls-rsa-with-aes128-cbc-sha
tls-rsa-with-aes256-cbc-sha
tls-rsa-with-aes128-cbc-sha256
tls-rsa-with-aes256-cbc-sha256

client-tls-profile

Syntax 
client-tls-profile name [create]
no client-tls-profile name
Context 
config>system>security>tls
Description 

This command configures the TLS client profile to be assigned to applications for encryption.

Parameters 
name—
Specifies the name of the client TLS profile, up to 32 characters.
create—
Keyword used to create the client TLS profile.

cipher-list

Syntax 
cipher-list name
no cipher-list
Context 
config>system>security>tls>client-tls-profile
Description 

This command assigns the cipher list to be used by the TLS profile for negotiation in the client Hello message.

Parameters 
name—
Specifies the name of the cipher list.

shutdown

Syntax 
[no] shutdown
Context 
config>system>security>tls>client-tls-profile
Description 

This command administratively enables or disables the TLS profile. If the TLS profile is shut down, the TLS operational status will be down. Therefore, if the TLS profile is shut down, any application using TLS should not attempt to send any PDUs.

trust-anchor-profile

Syntax 
trust-anchor-profile name
no trust-anchor-profile
Context 
config>system>security>tls>client-tls-profile
Description 

This command assigns the trust anchor used by this TLS profile to authenticate the server.

Parameters 
name—
Specifies the name of the trust anchor profile.

trust-anchor-profile

Syntax 
trust-anchor-profile name [create]
no trust-anchor-profile name
Context 
config>system>security>tls
Description 

This command configures a trust anchor profile to be used in the TLS profile. The trust anchor is used for authentication of the server certificate.

Parameters 
name—
Specifies the name of the trust anchor profile, up to 32 characters.
create—
Keyword used to create the trust anchor profile.

trust-anchor

Syntax 
[no] trust-anchor ca-profile-name
Context 
config>system>security>tls>client-tls-profile
Description 

This command configures a trust anchor with a CA profile used by the TLS profile. Up to eight CA profiles can be configured under the trust anchor. TLS will read the CA profiles one by one to try to authenticate the server certificate.

Parameters 
ca-profile-name—
Specifies the name of the TLS trust anchor, up to 32 characters.

LDAP TLS Profile Commands

server

Syntax 
server server-index [create]
no server server-index
Context 
config>system>security>ldap
Description 

This command adds or removes an LDAP server.

Parameters 
server-index—
Specifies the server index.
Values—
1 to 5
create—
Keyword used to create the server index.

tls-profile

Syntax 
tls-profile tls-profile-name
no tls-profile
Context 
config>system>security>ldap>server
Description 

This command assigns a TLS profile to the LDAP application. When a TLS profile is assigned, the LDAP application will send encrypted PDUs from the client to the LDAP server. If TLS is operationally down, the LDAP application should not send any PDUs.

Parameters 
tls-profile-name—
Specifies the name of the TLS client transport profile.

Admin Commands

reload

Syntax 
reload type {cert | key | cert-key-pair} filename protocol protocol [key-file filename]
Context 
admin>certificate
Description 

This command manually reloads the certificate or key cache.

Parameters 
type—
Specifies what item will be reloaded.
cert—
Specifies that a certificate cache will be reloaded.
key—
Specifies that a key cache will be reloaded.
cert-key-pair—
Specifies that a paired certificate and key cache will be reloaded.
filename—
Up to 95 characters.
protocol protocol
Specifies which protocol the certificate will be reloaded for (IPSec or TLS).
Values—
ipsec | tls