Difference between revisions of "API: User Certificates"
(Новая страница: « Администраторские функции требуют root-права API, чтобы использовать любой логин, размещен…») |
|||
(7 intermediate revisions by 3 users not shown) | |||
Line 1: | Line 1: | ||
− | + | <div data-placeholder="Перевод" dir="ltr">Administrative functions require API root rights in order to use any login hosted on the server. If you do not have root rights, you can only use your login.</div> <div data-placeholder="Перевод" dir="ltr">Incoming data marked with an asterisk are required.</div> | |
− | |||
− | |||
− | |||
− | |||
{| border="1" cellpadding="5" | {| border="1" cellpadding="5" | ||
|- | |- | ||
− | | <p dir="ltr" style="text-align: center;">''' | + | | <p dir="ltr" style="text-align: center;">'''Module'''</p> |
− | | <p dir="ltr" style="text-align: center;">''' | + | | <p dir="ltr" style="text-align: center;">'''Function'''</p> |
− | | <p dir="ltr" style="text-align: center;">''' | + | | <p dir="ltr" style="text-align: center;">'''Incoming data'''</p> |
− | | <p dir="ltr" style="text-align: center;">''' | + | | <p dir="ltr" style="text-align: center;">'''Error variants'''</p> |
|- | |- | ||
| style="vertical-align: top;" | | | style="vertical-align: top;" | | ||
Line 15: | Line 11: | ||
| style="vertical-align: top;" | | | style="vertical-align: top;" | | ||
− | + | Show user certificates. | |
listcerts | listcerts | ||
+ | | style="vertical-align: top;" | <div data-placeholder="Перевод" dir="ltr">username (post) * - username;</div> <div data-placeholder="Перевод" dir="ltr">password (post) * - user password;</div> <div data-placeholder="Перевод" dir="ltr">certs_control (post) * - constant, module name;</div> <div data-placeholder="Перевод" dir="ltr">listcerts (post) * - constant, operation type;</div> <div data-placeholder="Перевод" dir="ltr">language (post) - can take the value: en / ru (ru by default);</div> <div data-placeholder="Перевод" dir="ltr">panel_user (post) - ISP username to which the operation is applied.</div> | ||
| style="vertical-align: top;" | | | style="vertical-align: top;" | | ||
− | + | error: 0, mess: 'The list of certificates was successfully received for the user: <name>', data: contains the list of certificates; | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | error:0, mess:' | ||
− | error:1, mess:' | + | error: 1, mess: 'There was an error getting the list of certificates for the user: <name>'; |
− | error:5, mess:' | + | error: 5, mess: 'Error in the parameter block'; |
− | error:1000, mess:' | + | error: 1000, mess: 'You do not have administrator rights'; |
− | error:1001, mess:' | + | error: 1001, mess: 'There is no such user in the ISP-panel: <user>'. |
|- | |- | ||
Line 48: | Line 32: | ||
| style="vertical-align: top;" | | | style="vertical-align: top;" | | ||
− | + | Delete certificate and key. | |
delcerts | delcerts | ||
+ | | style="vertical-align: top;" | <div data-placeholder="Перевод" dir="ltr">username (post) * - username;</div> <div data-placeholder="Перевод" dir="ltr">password (post) * - user password;</div> <div data-placeholder="Перевод" dir="ltr">certs_control (post) * - constant, module name;</div> <div data-placeholder="Перевод" dir="ltr">delcerts (post) * - constant, type of operation;</div> <div data-placeholder="Перевод" dir="ltr">key_name (post) * - name to delete;</div> <div data-placeholder="Перевод" dir="ltr">language (post) - can take the value: en / ru (ru by default);</div> <div data-placeholder="Перевод" dir="ltr">panel_user (post) - ISP username to which the operation is applied.</div> | ||
+ | | style="vertical-align: top;" | <div data-placeholder="Перевод" dir="ltr">error: 0, mess: 'Key and certificate have been successfully deleted for user: <name>';</div> <div data-placeholder="Перевод" dir="ltr">error: 1, mess: 'The required certificate cannot be removed because it is in use';</div> <div data-placeholder="Перевод" dir="ltr">error: 2, mess: 'No such key and certificate. There is nothing to delete ';</div> <div data-placeholder="Перевод" dir="ltr">error: 5, mess: 'Error in the parameter block';</div> <div data-placeholder="Перевод" dir="ltr">error: 1000, mess: 'You do not have administrator rights';</div> <div data-placeholder="Перевод" dir="ltr">error: 1001, mess: 'There is no such user in the ISP-panel: <user>'.</div> | ||
+ | |- | ||
| style="vertical-align: top;" | | | style="vertical-align: top;" | | ||
− | + | certs_control | |
− | |||
− | |||
− | |||
− | certs_control | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
| style="vertical-align: top;" | | | style="vertical-align: top;" | | ||
− | + | Create key and certificate. | |
− | + | addcerts | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
+ | | style="vertical-align: top;" | <div data-placeholder="Перевод" dir="ltr">username (post) * - username;</div> <div data-placeholder="Перевод" dir="ltr">password (post) * - user password;</div> <div data-placeholder="Перевод" dir="ltr">certs_control (post) * - constant, module name;</div> <div data-placeholder="Перевод" dir="ltr">addcerts (post) * - constant, type of operation;</div> <div data-placeholder="Перевод" dir="ltr">key_size (post) - key size (by default 2048; can be 4096);</div> <div data-placeholder="Перевод" dir="ltr">domain (post) * - domain for which the certificate is applied;</div> <div data-placeholder="Перевод" dir="ltr">country (post) * - country (defined by two characters; default 'ru');</div> <div data-placeholder="Перевод" dir="ltr">state (post) * - state (string variable);</div> <div data-placeholder="Перевод" dir="ltr">city (post) * - city (string variable);</div> <div data-placeholder="Перевод" dir="ltr">company (post) * - company (string variable);</div> <div data-placeholder="Перевод" dir="ltr">division (post) * - department (string variable);</div> <div data-placeholder="Перевод" dir="ltr">language (post) - can take the value: en / ru (by default ru);</div> <div data-placeholder="Перевод" dir="ltr">panel_user (post) - ISP username to which the operation is applied.</div> | ||
+ | | style="vertical-align: top;" | <div data-placeholder="Перевод" dir="ltr">error: 0, mess: 'New certificate has been successfully added for user: <name>', data: contains the name of the new key and certificate;</div> <div data-placeholder="Перевод" dir="ltr">error: 1, mess: 'An error occurred while adding a new certificate for the user: <name>';</div> <div data-placeholder="Перевод" dir="ltr">error: 5, mess: 'Error in the parameter block';</div> <div data-placeholder="Перевод" dir="ltr">error: 1000, mess: 'You do not have administrator rights';</div> <div data-placeholder="Перевод" dir="ltr">error: 1001, mess: 'There is no such user in the ISP-panel: <user>'.</div> | ||
|- | |- | ||
| style="vertical-align: top;" | | | style="vertical-align: top;" | | ||
Line 85: | Line 54: | ||
| style="vertical-align: top;" | | | style="vertical-align: top;" | | ||
− | + | Add key and certificate for domain. | |
− | + | savedomaincerts | |
+ | | style="vertical-align: top;" | <div data-placeholder="Перевод" dir="ltr">username (post) * - username;</div> <div data-placeholder="Перевод" dir="ltr">password (post) * - user password;</div> <div data-placeholder="Перевод" dir="ltr">certs_control (post) * - constant, module name;</div> <div data-placeholder="Перевод" dir="ltr">savedomaincerts (post) * - constant, type of operation;</div> <div data-placeholder="Перевод" dir="ltr">domain (post) * - domain for which the certificate is applied;</div> <div data-placeholder="Перевод" dir="ltr">key (post) * - the key that applies to the domain. Or specify the 'letencrypt' option to generate a key of this type;</div> <div data-placeholder="Перевод" dir="ltr">key_mail (post) - apply the key for mail: yes / no (by default - no).</div> | ||
+ | | style="vertical-align: top;" | <div data-placeholder="Перевод" dir="ltr">error: 0, mess: 'The certificate was installed for the domain: <domain>';</div> <div data-placeholder="Перевод" dir="ltr">error: 5, mess: 'Error in the parameter block';</div> <div data-placeholder="Перевод" dir="ltr">error: 1000, mess: 'You do not have administrator rights';</div> <div data-placeholder="Перевод" dir="ltr">error: 1001, mess: 'There is no such user in the ISP-panel: <user>'.</div> | ||
+ | |- | ||
| style="vertical-align: top;" | | | style="vertical-align: top;" | | ||
− | + | certs_control | |
− | |||
− | |||
− | |||
− | certs_control | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
| style="vertical-align: top;" | | | style="vertical-align: top;" | | ||
− | + | Get list of domains with certificates. | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
+ | | style="vertical-align: top;" | <div data-placeholder="Перевод" dir="ltr">username (post) * - username;</div> <div data-placeholder="Перевод" dir="ltr">password (post) * - user password;</div> <div data-placeholder="Перевод" dir="ltr">certs_control (post) * - constant, module name;</div> <div data-placeholder="Перевод" dir="ltr">listdomaincerts (post) * - constant, type of operation;</div> <div data-placeholder="Перевод" dir="ltr">language (post) - can take the value: en / ru (ru by default);</div> <div data-placeholder="Перевод" dir="ltr">panel_user (post) - ISP username to which the operation is applied.</div> | ||
+ | | style="vertical-align: top;" | <div data-placeholder="Перевод" dir="ltr">error: 0, mess: 'A list of domains using certificates was received for the user: <name>', data: contains a list of domains;</div> <div data-placeholder="Перевод" dir="ltr">error: 5, mess: 'Error in the parameter block';</div> <div data-placeholder="Перевод" dir="ltr">error: 1000, mess: 'You do not have administrator rights';</div> <div data-placeholder="Перевод" dir="ltr">error: 1001, mess: 'There is no such user in the ISP-panel: <user>'.</div> | ||
|- | |- | ||
| style="vertical-align: top;" | | | style="vertical-align: top;" | | ||
Line 132: | Line 74: | ||
| style="vertical-align: top;" | | | style="vertical-align: top;" | | ||
− | + | delete certificate from domain. | |
− | + | deldomaincerts | |
− | | style="vertical-align: top;" | | + | | style="vertical-align: top;" | <div data-placeholder="Перевод" dir="ltr">username (post) * - username;</div> <div data-placeholder="Перевод" dir="ltr">password (post) * - user password;</div> <div data-placeholder="Перевод" dir="ltr">certs_control (post) * - constant, module name;</div> <div data-placeholder="Перевод" dir="ltr">deldomaincerts (post) * - constant, type of operation;</div> <div data-placeholder="Перевод" dir="ltr">domain (post) * - domain for which the certificate is being deleted;</div> <div data-placeholder="Перевод" dir="ltr">language (post) - can take the value: en / ru (ru by default);</div> <div data-placeholder="Перевод" dir="ltr">panel_user (post) - ISP username to which the operation is applied.</div> |
− | username (post)* | + | | style="vertical-align: top;" | <div data-placeholder="Перевод" dir="ltr">error: 0, mess: 'The certificate was removed from the domain';</div> <div data-placeholder="Перевод" dir="ltr">error: 1, mess: 'Error, such domain was not found or does not contain any certificate';</div> <div data-placeholder="Перевод" dir="ltr">error: 5, mess: 'Error in the parameter block';</div> <div data-placeholder="Перевод" dir="ltr">error: 1000, mess: 'You do not have administrator rights';</div> <div data-placeholder="Перевод" dir="ltr">error: 1001, mess: 'There is no such user in the ISP-panel: <user>'.</div> |
+ | |} | ||
− | + | Other useful articles: | |
− | + | {| style="width: 1021px;" | |
+ | |- | ||
+ | | style="width: 287px;" | | ||
+ | '''[https://docs.brainycp.io/index.php/API:_connection <font><font>API: connection</font></font>]''' | ||
− | + | | style="width: 350px;" | | |
+ | '''[https://docs.brainycp.io/index.php/API:_Monitoring <font><font>API: monitoring</font></font>]''' | ||
− | + | | style="width: 362px;" | | |
+ | '''[https://docs.brainycp.io/index.php/API:_Webserver_status <font><font>API: web server status</font></font>]''' | ||
− | + | |- | |
+ | | style="width: 287px;" | | ||
+ | '''[https://docs.brainycp.io/index.php/API:_CMS_Autoinstaller <font><font>API: auto installer CMS</font></font>]''' | ||
− | + | | style="width: 350px;" | | |
+ | '''[https://docs.brainycp.io/index.php/API:_Configuring_backups <font><font>API: configuring backups</font></font>]''' | ||
− | | style=" | + | | style="width: 362px;" | |
− | + | '''[https://docs.brainycp.io/index.php/API:_Transfer_between_servers <font><font>API: transfer between servers</font></font>]''' | |
− | + | |- | |
+ | | style="width: 287px;" | | ||
+ | '''[https://docs.brainycp.io/index.php/API:_Antivirus <font><font>API: antivirus</font></font>]''' | ||
− | + | | style="width: 350px;" | | |
+ | '''[https://docs.brainycp.io/index.php/API:_Server_configuration <font><font>API: server settings</font></font>]''' | ||
− | + | | style="width: 362px;" | | |
+ | '''[https://docs.brainycp.io/index.php/API:_Manage_webserver <font><font>API: web server management</font></font>]''' | ||
|- | |- | ||
− | | style=" | + | | style="width: 287px;" | |
− | + | '''[https://docs.brainycp.io/index.php/API:_Databases <font><font>API: database</font></font>]''' | |
− | | style=" | + | | style="width: 350px;" | |
− | + | '''[https://docs.brainycp.io/index.php/API:_User_Certificates <font><font>API: custom certificates</font></font>]''' | |
− | | style=" | + | | style="width: 362px;" | |
− | + | '''[https://docs.brainycp.io/index.php/API:_Managing_mailboxes <font><font>API: mailbox management</font></font>]''' | |
− | + | |- | |
+ | | style="width: 287px;" | | ||
+ | '''[https://docs.brainycp.io/index.php/API:_Server_info <font><font>API: server information</font></font>]''' | ||
− | + | | style="width: 350px;" | | |
+ | '''[https://docs.brainycp.io/index.php/API:_Mail <font><font>API: mail</font></font>]''' | ||
− | + | | style="width: 362px;" | | |
+ | '''[https://docs.brainycp.io/index.php/API:_Manage_DNS-zones <font><font>API: DNS zone management</font></font>]''' | ||
− | + | |- | |
+ | | style="width: 287px;" | | ||
+ | '''[https://docs.brainycp.io/index.php/API:_Traffic_usage <font><font>API: traffic usage</font></font>]''' | ||
− | + | | style="width: 350px;" | | |
+ | '''[https://docs.brainycp.io/index.php/API:_Client_mail <font><font>API: client mailboxes</font></font>]''' | ||
− | | style=" | + | | style="width: 362px;" | |
− | + | '''[https://docs.brainycp.io/index.php/API:_Webserver_Installation <font><font>API: web server installation</font></font>]''' | |
− | + | |- | |
+ | | style="width: 287px;" | | ||
+ | '''[https://docs.brainycp.io/index.php/API:_Logging <font><font>API: logging</font></font>]''' | ||
− | + | | style="width: 350px;" | | |
+ | '''[https://docs.brainycp.io/index.php/API:_Nameserver <font><font>API: name server</font></font>]''' | ||
− | + | | style="width: 362px;" | | |
+ | '''[https://docs.brainycp.io/index.php/API:_host-accounts <font><font>API: host accounts</font></font>]''' | ||
|- | |- | ||
− | | style=" | + | | style="width: 287px;" | |
− | + | '''[https://docs.brainycp.io/index.php/API:_App_manager <font><font>API: application manager</font></font>]''' | |
− | | style=" | + | | style="width: 350px;" | |
− | + | '''[https://docs.brainycp.io/index.php/API:_Certificates_of_services <font><font>API: service certificates</font></font>]''' | |
− | + | | style="width: 362px;" | | |
+ | '''[https://docs.brainycp.io/index.php/API:_CRON <font><font>API: CRON</font></font>]''' | ||
− | | style=" | + | |- |
− | + | | style="width: 287px;" | | |
+ | '''[https://docs.brainycp.io/index.php/API:_Process_manager <font><font>API: process manager</font></font>]''' | ||
− | + | | style="width: 350px;" | | |
+ | '''[https://docs.brainycp.io/index.php/API:_Network_tools <font><font>API: network tools</font></font>]''' | ||
− | + | | style="width: 362px;" | | |
+ | '''[https://docs.brainycp.io/index.php/API:_FTP-server <font><font>API: FTP server</font></font>]''' | ||
− | + | |- | |
+ | | style="width: 287px;" | | ||
+ | '''[https://docs.brainycp.io/index.php/API:_IP-address_manager <font><font>API: IP address manager</font></font>]''' | ||
− | + | | style="width: 350px;" | | |
+ | '''[https://docs.brainycp.io/index.php/API:_Load_average <font><font>API: average load</font></font>]''' | ||
− | + | | style="width: 362px;" | | |
− | + | '''[https://docs.brainycp.io/index.php/API:_MySQL_processlist <font><font>API: MySQL processlist</font></font>]''' | |
− | |||
− | |||
− | | style=" | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
|} | |} | ||
− | |||
− |
Latest revision as of 14:25, 17 November 2021
Module |
Function |
Incoming data |
Error variants |
certs_control |
Show user certificates. listcerts |
username (post) * - username; password (post) * - user password; certs_control (post) * - constant, module name; listcerts (post) * - constant, operation type; language (post) - can take the value: en / ru (ru by default); panel_user (post) - ISP username to which the operation is applied.
|
error: 0, mess: 'The list of certificates was successfully received for the user: <name>', data: contains the list of certificates; error: 1, mess: 'There was an error getting the list of certificates for the user: <name>'; error: 5, mess: 'Error in the parameter block'; error: 1000, mess: 'You do not have administrator rights'; error: 1001, mess: 'There is no such user in the ISP-panel: <user>'. |
certs_control |
Delete certificate and key. delcerts |
username (post) * - username; password (post) * - user password; certs_control (post) * - constant, module name; delcerts (post) * - constant, type of operation; key_name (post) * - name to delete; language (post) - can take the value: en / ru (ru by default); panel_user (post) - ISP username to which the operation is applied.
|
error: 0, mess: 'Key and certificate have been successfully deleted for user: <name>'; error: 1, mess: 'The required certificate cannot be removed because it is in use'; error: 2, mess: 'No such key and certificate. There is nothing to delete '; error: 5, mess: 'Error in the parameter block'; error: 1000, mess: 'You do not have administrator rights'; error: 1001, mess: 'There is no such user in the ISP-panel: <user>'.
|
certs_control |
Create key and certificate. addcerts |
username (post) * - username; password (post) * - user password; certs_control (post) * - constant, module name; addcerts (post) * - constant, type of operation; key_size (post) - key size (by default 2048; can be 4096); domain (post) * - domain for which the certificate is applied; country (post) * - country (defined by two characters; default 'ru'); state (post) * - state (string variable); city (post) * - city (string variable); company (post) * - company (string variable); division (post) * - department (string variable); language (post) - can take the value: en / ru (by default ru); panel_user (post) - ISP username to which the operation is applied.
|
error: 0, mess: 'New certificate has been successfully added for user: <name>', data: contains the name of the new key and certificate; error: 1, mess: 'An error occurred while adding a new certificate for the user: <name>'; error: 5, mess: 'Error in the parameter block'; error: 1000, mess: 'You do not have administrator rights'; error: 1001, mess: 'There is no such user in the ISP-panel: <user>'.
|
certs_control |
Add key and certificate for domain. savedomaincerts |
username (post) * - username; password (post) * - user password; certs_control (post) * - constant, module name; savedomaincerts (post) * - constant, type of operation; domain (post) * - domain for which the certificate is applied; key (post) * - the key that applies to the domain. Or specify the 'letencrypt' option to generate a key of this type; key_mail (post) - apply the key for mail: yes / no (by default - no).
|
error: 0, mess: 'The certificate was installed for the domain: <domain>'; error: 5, mess: 'Error in the parameter block'; error: 1000, mess: 'You do not have administrator rights'; error: 1001, mess: 'There is no such user in the ISP-panel: <user>'.
|
certs_control |
Get list of domains with certificates. |
username (post) * - username; password (post) * - user password; certs_control (post) * - constant, module name; listdomaincerts (post) * - constant, type of operation; language (post) - can take the value: en / ru (ru by default); panel_user (post) - ISP username to which the operation is applied.
|
error: 0, mess: 'A list of domains using certificates was received for the user: <name>', data: contains a list of domains; error: 5, mess: 'Error in the parameter block'; error: 1000, mess: 'You do not have administrator rights'; error: 1001, mess: 'There is no such user in the ISP-panel: <user>'.
|
certs_control |
delete certificate from domain. deldomaincerts |
username (post) * - username; password (post) * - user password; certs_control (post) * - constant, module name; deldomaincerts (post) * - constant, type of operation; domain (post) * - domain for which the certificate is being deleted; language (post) - can take the value: en / ru (ru by default); panel_user (post) - ISP username to which the operation is applied.
|
error: 0, mess: 'The certificate was removed from the domain'; error: 1, mess: 'Error, such domain was not found or does not contain any certificate'; error: 5, mess: 'Error in the parameter block'; error: 1000, mess: 'You do not have administrator rights'; error: 1001, mess: 'There is no such user in the ISP-panel: <user>'.
|
Other useful articles: