Skip to main content

security login publickey create

Contributors
Suggest changes

Add a new public key

Availability: This command is available to cluster and Vserver administrators at the admin privilege level.

Description

The security login publickey create associates an existing public key with a user account. This command requires that you enter a valid OpenSSH-formatted public key, a user name, index number, and optionally, a comment and a certificate.

Parameters

-vserver <vserver name> - Vserver

This parameter optionally specifies the Vserver of the user for whom you are adding the public key.

-username <text> - Username

This parameter specifies the name of the user for whom you are adding the public key. If you do not specify a user, the user named admin is specified by default.

[-application <text>] - Application

This parameter optionally specifies the application for which you are adding the public key. Presently, the only supported value is ssh . The default value for this parameter is ssh .

[-index <integer>] - Index

This parameter specifies an index number for the public key. The default value is the next available index value, starting with zero if it is the first public key created for the user.

-publickey <certificate> - Public Key

This specifies the OpenSSH public key, which must be enclosed in double quotation marks.

[-comment <text>] - Comment

This optionally specifies comment text for the public key. Note that comment text should be enclosed in quotation marks.

[-x509-certificate <text>] - Install/Modify/Delete X509 Certificate

If this parameter is used, the specified certificate will be installed. The default when the public key is created is no certificate.

Examples

The following command associates a public key with a user named tsmith for Vserver vs1. The public key is assigned index number 5 and the comment text is “This is a new key”. Optionally, we can also specify the certificate.

cluster1::> security login publickey create -vserver vs1 -username tsmith -index 5 -publickey
"ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAIEAspH64CYbUsDQCdW22JnK6J
/vU9upnKzd2zAk9C1f7YaWRUAFNs2Qe5lUmQ3ldi8AD0Vfbr5T6HZPCixNAIza
FciDy7hgnmdj9eNGedGr/JNrftQbLD1hZybX+72DpQB0tYWBhe6eDJ1oPLob
ZBGfMlPXh8VjeU44i7W4+s0hG0E=tsmith@publickey.example.com"
-comment "This is a new key"
-x509-certificate install
Please enter Certificate: Press <Enter> when done
-----BEGIN CERTIFICATE-----
MIIBYTCB56ADAgECAhQybXS4lSL99APGRPqaGTy7CGUICzAKBggqhkjOPQQDAjAS
MRAwDgYDVQQDDAdTU0ggS2V5MB4XDTIyMDkyNjA1MDcwMVoXDTIzMDkyNjAwMDAw
MFowEjEQMA4GA1UEAwwHU1NIIEtleTB2MBAGByqGSM49AgEGBSuBBAAiA2IABEL4
UEJYUBfTO8gGSdRQleLQNvxVFjTiCN9V+8/6qsSTshb+K2zGT7qoF2RNPRMtHvtH
r/EC7Wo+9yP/ovtjFsshC+boJpfe8NN4xpqDzeC0nn1kw1GIavOCGyhGUNauITAK
BggqhkjOPQQDAgNpADBmAjEA4ClCSp3Nb7DlX6Bxvi7utQobj2qQETgNxHpiYzlD
Zr920lNPHDRxJTQ04vIdNeoZAjEAwTfv5jpuowaYxXxPJND2ytpyFcjyl/BUrFpQ
7XyjxyVFzKP3Rfj+uBvhIb8sLbl8
-----END CERTIFICATE-----