Skip to content
ATTENTION
You are viewing the documentation of the current development state (git-main / nightly).
The current latest stable documentation can be found here.

SshKeys

SshKeys.add

add a new ssh-key

Permission

admin customer

Parameter

FieldTypeDescription
idintoptional id of ftp-user to add the ssh-key for, required if ftpuser is empty
ftpuserstringoptional loginname of ftp-user to add the ssh-key for, required if id is empty
customeridintoptional, required when called as admin (if $loginname is not specified)
loginnamestringoptional, required when called as admin (if $customerid is not specified)
ssh_pubkeystringssh public key to add for the given user
descriptionstringoptional, description for ssh-key

Response

string as json-encoded array

SshKeys.get

return a ssh-key entry by id

Permission

admin customer

Parameter

FieldTypeDescription
idintthe ssh-key id

Response

string as json-encoded array

SshKeys.update

update a given ftp-user by id or username

Permission

admin customer

Parameter

FieldTypeDescription
idintthe ssh-key id
descriptionstringoptional, description for ssh-key
customeridintoptional, required when called as admin (if $loginname is not specified)
loginnamestringoptional, required when called as admin (if $customerid is not specified)

Response

string as json-encoded array

SshKeys.listing

list all ssh-keys, if called from an admin, list all ssh-keys of all customers you are allowed to view, or specify id or loginname for one specific customer

Permission

admin customer

Parameter

FieldTypeDescription
customeridintoptional, admin-only, select ftp-users of a specific customer by id
loginnamestringoptional, admin-only, select ftp-users of a specific customer by loginname
sql_searcharrayoptional array with index = fieldname, and value = array with 'op' => operator (one of <, > or =),LIKE is used if left empty and 'value' => searchvalue
sql_limitintoptional specify number of results to be returned
sql_offsetintoptional specify offset for resultset
sql_orderbyarrayoptional array with index = fieldname and value = ASC|DESC to order the resultset by one or morefields

Response

string as json-encoded array count|list

SshKeys.listingCount

returns the total number of accessible ssh keys

Permission

admin customer

Parameter

FieldTypeDescription
customeridintoptional, admin-only, select ftp-users of a specific customer by id
loginnamestringoptional, admin-only, select ftp-users of a specific customer by loginname

Response

string as json-encoded response message

SshKeys.delete

delete a ftp-user by either id or username

Permission

admin customer

Parameter

FieldTypeDescription
idintthe ssh-key id
customeridintoptional, required when called as admin (if $loginname is not specified)
loginnamestringoptional, required when called as admin (if $customerid is not specified)

Response

string as json-encoded array