45
edits
Changes
Template:Networking rutos manual administration (view source)
Revision as of 12:34, 13 May 2024
, 13 Mayno edit summary
| TCR1=[[File:Networking_rutos_manual_administration_general_tcr_v2.png|border|class=tlt-border]]
| TCR1=[[File:Networking_rutos_manual_administration_general_tcr_v2.png|border|class=tlt-border]]
| TRB1|TRB2|TRB5=[[File:Networking_rutos_manual_administration_general_trb_v2.png|border|class=tlt-border]]
| TRB1|TRB2|TRB5=[[File:Networking_rutos_manual_administration_general_trb_v2.png|border|class=tlt-border]]
| #default=[[File:Networking_rutos_manual_administration_general_rut_v2.png|border|class=tlt-border]]
| #default=[[File:Networking_rutos_manual_administration_general_rut_V3.png|border|class=tlt-border]]
}}
}}
<table class="nd-mantable">
<table class="nd-mantable">
<td>Basic {{!}} Advanced; default: <b>Basic</b></td>
<td>Basic {{!}} Advanced; default: <b>Basic</b></td>
<td>Mode determines what options and configurations are shown. In Basic mode only the essential configurations are shown. In Advanced mode there is greater freedom to configure and access more options.</td>
<td>Mode determines what options and configurations are shown. In Basic mode only the essential configurations are shown. In Advanced mode there is greater freedom to configure and access more options.</td>
</tr>}}
</tr>
<tr>
<td>Data Analytics</td>
<td>Off {{!}} On; default: <b>Off</b></td>
<td>Enables collecting usage data</td>
</tr>
}}
<tr>
<tr>
<th>Device name and hostname</th>
<th>Device name and hostname</th>
This section is used to specify which time servers the device will use for time synchronization. To add more time servers to the list, click the 'Add' button.
This section is used to specify which time servers the device will use for time synchronization. To add more time servers to the list, click the 'Add' button.
{{#switch:{{{series}}}|TAP100|TAP200=[[File:Networking_rutos_ntp_ntp_time_servers_tap100.png|border|class=tlt-border]]|#default=[[File:Networking_rutos_ntp_ntp_time_servers.png|border|class=tlt-border]]}}
{{#switch:{{{series}}}|TAP100|TAP200=[[File:Networking_rutos_ntp_ntp_time_servers_tap100_v2.png|border|class=tlt-border]]|#default=[[File:Networking_rutos_ntp_ntp_time_servers_v2.png|border|class=tlt-border]]}}
<table class="nd-mantable">
<table class="nd-mantable">
<tr>
<tr>
<b>Note:</b> NTPD is additional software that can be installed from the <b>System → [[{{{name}}} Package Manager|Package Manager]]</b> page.
<b>Note:</b> NTPD is additional software that can be installed from the <b>System → [[{{{name}}} Package Manager|Package Manager]]</b> page.
[[File:Networking_rutos_ntp_ntpd.png|border|class=tlt-border]]
[[File:Networking_rutos_ntp_ntpd_v2.png|border|class=tlt-border]]
<table class="nd-mantable">
<table class="nd-mantable">
<td>off {{!}} on; default: <b>on</b></td>
<td>off {{!}} on; default: <b>on</b></td>
<td>Turns SSH access from the local network (LAN) on or off.</td>
<td>Turns SSH access from the local network (LAN) on or off.</td>
</tr>{{#switch:{{{series}}}|TAP100|TAP200=|#default
</tr>{{#switch:{{{series}}}|TAP100|TAP200=|#default=
<tr>
<tr>
<td>Remote SSH access</td>
<td>Remote SSH access</td>
----{{#switch:{{{series}}}
----{{#switch:{{{series}}}
|TAP100|TAP200 = [[File:Networking_rutos_manual_administration_access_control_general_webui_tap100_v1.png|border|class=tlt-border]]
|TAP100|TAP200 = [[File:Networking_rutos_manual_administration_access_control_general_webui_tap100_v1.png|border|class=tlt-border]]
|#default = [[File:Networking_rutos_manual_administration_access_control_general_webui_v1.png|border|class=tlt-border]]}}
|#default = [[File:Networking_rutos_manual_administration_access_control_general_webui_v2.png|border|class=tlt-border]]}}
<table class="nd-mantable">
<table class="nd-mantable">
<td>.key; default: <b>uhttpd.key</b></td>
<td>.key; default: <b>uhttpd.key</b></td>
<td>Server key file.</td>
<td>Server key file.</td>
</tr>
<tr>
<td>Certificate file</td>
<td><b>Download</b></td>
<td>Certificate file.</td>
</tr>}}
</tr>}}
</table>
</table>
<b>Note:</b> PAM is additional software that can be installed from the <b>System → [[{{{name}}} Package Manager|Package Manager]]</b> page.
<b>Note:</b> PAM is additional software that can be installed from the <b>System → [[{{{name}}} Package Manager|Package Manager]]</b> page.
[[File:Networking_rutos_manual_administration_access_control_pam_v1.png|border|class=tlt-border]]
[[File:Networking_rutos_manual_administration_access_control_pam_v2.png|border|class=tlt-border]]
====Modify PAM Auth====
====Modify PAM Auth====
<tr>
<tr>
<td>Type</td>
<td>Type</td>
<td>Required {{!}} Requisite {{!}} Sufficient {{!}} Optional; default: <b>Required </b></td>
<td>Required {{!}} Requisite {{!}} Sufficient {{!}} Optional; default: <b>Optional </b></td>
<td>Determines the continuation or failure behavior for the module</td>
<td>Determines the continuation or failure behavior for the module</td>
</tr>
<tr>
<td><span style="color:red">Radius</span>: Enable for all users</td>
<td>off {{!}} on; default: <b>off</b></td>
<td>Turn on PAM authentication for all users. It will allow login with users that are not created on the device.</td>
</tr>
</tr>
<tr>
<tr>
<tr>
<tr>
<td><span style="color:blue">TACACS+</span>/<span style="color:red">Radius</span>: Port</td>
<td><span style="color:blue">TACACS+</span>/<span style="color:red">Radius</span>: Port</td>
<td>integer [0..65535]; default: <b>1812</b></td>
<td>integer [0..65535]; default: <b><span style="color:blue">49</span>/<span style="color:red">1812</span></b></td>
<td>RADIUS server authentication port</td>
<td>RADIUS server authentication port</td>
</tr>
</tr>
<b>IP Block Settings</b>
<b>IP Block Settings</b>
----
----
[[File:Networking_rutos_manual_administration_access_control_security_v3.png|border|class=tlt-border]]
[[File:Networking_rutos_manual_administration_access_control_security_v4.png|border|class=tlt-border]]
<table class="nd-mantable">
<table class="nd-mantable">
<tr>
<tr>
<td>off {{!}} on; default: <b>on</b></td>
<td>off {{!}} on; default: <b>on</b></td>
<td>Enable or disable blocking IP's if they have reached the set amount of failed times.</td>
<td>Enable or disable blocking IP's if they have reached the set amount of failed times.</td>
</tr>
<tr>
<td>Type</td>
<td>Timed blocking {{!}} Permanent blocking; default: <b>Timed blocking</b></td>
<td>You can choose an option of a blocking type.</td>
</tr>
</tr>
<tr>
<tr>
<td>off {{!}} on; default: <b>off</b></td>
<td>off {{!}} on; default: <b>off</b></td>
<td>If enabled, blocked loging attempts list will be cleared on device reboot.</td>
<td>If enabled, blocked loging attempts list will be cleared on device reboot.</td>
</tr>
</tr>
</table>
</table>
<b>Login Attempts</b>
<b>Login Attempts</b>
----
----
[[File:Networking_rutos_manual_administration_access_control_security_login.png|border|class=tlt-border]]
[[File:Networking_rutos_manual_administration_access_control_security_login_v2.png|border|class=tlt-border]]
<table class="nd-mantable">
<table class="nd-mantable">
<tr>
<tr>
</tr>
</tr>
<tr>
<tr>
<td>Source address</td>
<td>Source</td>
<td>IP address</td>
<td>IP address</td>
<td>Shows the IP address from which the connection failed.</td>
<td>Shows the IP address from which the connection failed.</td>
</tr>
</tr>
<tr>
<tr>
<td>Destination</td>
<td>Destination address</td>
<td>IP address</td>
<td>IP address</td>
<td>Shows yours device IP adress</td>
<td>Shows yours device IP adress</td>
</tr>
</tr>
<tr>
<tr>
<td>Protocol</td>
<td>Port (protocol)</td>
<td>Connection protocol</td>
<td>Port number</td>
<td>Displays the connection protocol used for connection.</td>
<td>Shows the port number from which the connection failed.</td>
</tr>
</tr>
<tr>
<tr>
<td>Failed atempts</td>
<td>Status</td>
<td>Number</td>
<td>Attempt count {{!}} Blocked</td>
<td>Shows the number of failed attempts to connect to device.</td>
<td>Shows the number of failed attempts to connect to device. Indicates whether the source address is blocked or not.</td>
</tr>
</tr>
<tr>
<tr>
<td>Reset</td>
<td>Reset</td>
<td>Check box</td>
<td>Check box</td>
<td>Allows you to select multiple IP addresses.</td>
<td>Allows you to select multiple IP addresses.</td>
</tr>
</tr>
<tr>
<tr>
<td>Actions</td>
<td>-(interactive button)</td>
<td>Allows you to select multiple IP addresses.</td>
</tr>
<tr>
<td>Unblock all</td>
<td>Unblock all</td>
<td>-(interactive button)</td>
<td>-(interactive button)</td>
<td>Unblocks all source adresses from the list.</td>
<td>Deletes instance.</td>
</tr>
</tr>
<tr>
<td>Unblock selected</td>
<td>Unblock selected</td>
<td>-(interactive button)</td>
<td>-(interactive button)</td>
<li>Enter a custom name for the phone group into the 'Name' field.</li>
<li>Enter a custom name for the phone group into the 'Name' field.</li>
<li>Click the 'Add' button.</li>
<li>Click the 'Add' button.</li>
</ol>
</ol>
[[File:Networking_rutos_manual_administration_recipients_phone_groups_add_button_edit_button.png|border|class=tlt-border]]
[[File:Networking_rutos_manual_administration_recipients_phone_groups_add_button.png|border|class=tlt-border]]
After clicking 'Edit' you should be redirected to that phone group's configuration page where you can start adding phone numbers to it.
After clicking 'Edit' you should be redirected to that phone group's configuration page where you can start adding phone numbers to it.
[[File:Networking_rutos_manual_administration_recipients_phone_groups_modify_phone_group.png|border|class=tlt-border]]
[[File:Networking_rutos_manual_administration_recipients_phone_groups_modify_phone_group_v2.png|border|class=tlt-border]]
<table class="nd-mantable">
<table class="nd-mantable">
</table>
</table>
===Email Accounts===
===Email Users===
----
----
When email related services{{#ifeq:{{{events_reporting}}}|0| | (such as [[{{{name}}} Events Reporting|Events Reporting]]) }}are used, the device logs in to the specified email account and reads the inbox (e.g., Email to SMS) or sends out a message (e.g., SMS to Email) depending on the configured service. In this context, an <b>Email Account</b> is an configuration instance that contains the necessary data required in order to log into an email account.
When email related services{{#ifeq:{{{events_reporting}}}|0| | (such as [[{{{name}}} Events Reporting|Events Reporting]]) }}are used, the device logs in to the specified email account and reads the inbox (e.g., Email to SMS) or sends out a message (e.g., SMS to Email) depending on the configured service. In this context, an <b>Email Account</b> is an configuration instance that contains the necessary data required in order to log into an email account.
<li>Enter a custom name for the email account into the 'Name' field.</li>
<li>Enter a custom name for the email account into the 'Name' field.</li>
<li>Click the 'Add' button.</li>
<li>Click the 'Add' button.</li>
</ol>
</ol>
[[File:Networking_rutos_manual_administration_recipients_email_accounts_groups_add_button_edit_button.png|border|class=tlt-border]]
[[File:Networking_rutos_manual_administration_recipients_email_accounts_groups_add_button_v1.png|border|class=tlt-border]]
After clicking 'Edit' you should be redirected to that email account's settings page where you can start configuring the account.
After clicking 'Add' you should be redirected to that email account's settings page where you can start configuring the account.
[[File:Networking_rutos_manual_administration_recipients_email_accounts_modify_email_account_v2.png|border|class=tlt-border]]
[[File:Networking_rutos_manual_administration_recipients_email_accounts_modify_email_account_v3.png|border|class=tlt-border]]
<table class="nd-mantable">
<table class="nd-mantable">
<tr>
<tr>
<td>Secure connection</td>
<td>Secure connection</td>
<td>off <nowiki>|</nowiki> on; default: <b>off</b></td>
<td>off {{!}} on; default: <b>off</b></td>
<td>Use if your SMTP server supports TLS or SSL encryption.</td>
<td>Use if your SMTP server supports TLS or SSL encryption.</td>
</tr>
</tr>
<tr>
<tr>
<td>Credentials</td>
<td>Credentials</td>
<td>off {{!}} on; default: <b>off</b></td>
<td>off {{!}} <span style="color: blue;">on</span>; default: <b>off</b></td>
<td>This options allows you to set username and password of email account.</td>
<td>This options allows you to set username and password of email account.</td>
</tr>
</tr>
<tr>
<tr>
<td>Username</td>
<td><span style="color: blue;">Username</span></td>
<td>string; default: <b>none</b></td>
<td>string; default: <b>none</b></td>
<td>Username used to authenticate to the email service.</td>
<td>Username for authentication on SMTP (Simple Mail Transfer Protocol) server. All characters are allowed except `' and space.</td>
</tr>
</tr>
<tr>
<tr>
<td>Password</td>
<td><span style="color: blue;">Password</span></td>
<td>string; default: <b>none</b></td>
<td>string; default: <b>none</b></td>
<td>Password used to authenticate to the email service..</td>
<td>Password for authentication on SMTP (Simple Mail Transfer Protocol) server. All characters are allowed except `' and space.</td>
</tr>
</tr>
<tr>
<tr>
<td>Sender's email address</td>
<td>Sender's email address</td>
<td>string; default: <b>none</b></td>
<td>string; default: <b>none</b></td>
<td>Configured SMTP server user's email address.</td>
<td>An address that will be used to send your email from. Allowed characters (a-zA-Z0-9._%+-@).</td>
</tr>
<tr>
<td>Do not verify authenticity</td>
<td><span style="color: red;">off</span> {{!}} on; default: <b>off</b></td>
<td>When enabled peer's certificate authenticity will not be verified.</td>
</tr>
<tr>
<td><span style="color: red;">Server's CA file</span></td>
<td> - (interactive button)</td>
<td>Upload server's CA file.</td>
</tr>
</tr>
<tr>
<tr>
The <b>Certificate Generation</b> tab provides the possibility to generate TLS certificates required for secure authentication and communication encryption used by some of the devices services.
The <b>Certificate Generation</b> tab provides the possibility to generate TLS certificates required for secure authentication and communication encryption used by some of the devices services.
There are five distinct generation methods (denoted by the selected 'File Type').
There are six distinct generation methods (denoted by the selected 'File Type').
<ol>
<ol>
<li><b>Client</b> - generates a client certificate and key. A client certificate validates a client's identity to the server that it's connecting to, while a key is responsible for encryption.</li>
<li><b>Client</b> - generates a client certificate and key. A client certificate validates a client's identity to the server that it's connecting to, while a key is responsible for encryption.</li>
<li><b>DH Parameters</b> - generates a Diffie-Hellman (DH) parameters file. DH parameters are used in symmetric encryption to protect and define how OpenSSL key exchange is performed.</li>
<li><b>DH Parameters</b> - generates a Diffie-Hellman (DH) parameters file. DH parameters are used in symmetric encryption to protect and define how OpenSSL key exchange is performed.</li>
<li><b>Let's encrypt</b> - generates SSL certificate.</li>
</ol>
</ol>
====Generation Parameters====
====Generation Parameters====
----
----
Generating each type of file (excluding 'Simple') requires setting some parameters. This section provides an overview for parameters used in TLS certificate generation.
Generating each type of file requires setting some parameters. This section provides an overview for parameters used in Simple and TLS certificate generation.
----
----
<b>Core parameters</b> or simply parameters that apply to each file type are the size and common name of the generated file(s).
<b>Simple file parameters</b>
[[File:Networking_rutos_manual_administartion_certificates_certificates_generation_simple_parameters.png|border|class=tlt-border]]
<table class="nd-mantable">
<tr>
<th>Field</th>
<th>Value</th>
<th>Description</th>
</tr>
<tr>
<td>Hosts</td>
<td>string; default: <b>none</b></td>
<td>Appends hostnames to certificates.</td>
</tr>
<tr>
<td>IP addresses</td>
<td>IPv4 address; default: <b>none</b></td>
<td>Appends IPv4 addresses to certificates.</td>
</tr>
</table>
----
<b>TLS parameters</b> or simply parameters that apply to each (CA, Server, Client, DH) file type are the size and common name of the generated file(s).
[[File:Networking_rutos_manual_administartion_certificates_certificates_generation_core_parameters_v1.png|border|class=tlt-border]]
[[File:Networking_rutos_manual_administartion_certificates_certificates_generation_core_parameters_v1.png|border|class=tlt-border]]
The <b>Certificate Signing</b> section is used to validate (sign) unsigned certificates.
The <b>Certificate Signing</b> section is used to validate (sign) unsigned certificates.
[[File:Networking_rutos_manual_administartion_certificates_certificates_generation_certificate_signing_v2.png|border|class=tlt-border]]
[[File:Networking_rutos_manual_administartion_certificates_certificates_generation_certificate_signing_v3.png|border|class=tlt-border]]
<table class="nd-mantable">
<table class="nd-mantable">
<td>off {{!}} on; default: <b>off</b></td>
<td>off {{!}} on; default: <b>off</b></td>
<td>Generation creates additional 'signing request' files (which appear under the [[#Certificate_Manager|Certificate Manager]] tab) that are later used to sign the generated certificates. When this option is set to 'on', the device deletes the signing request files after the signing process is complete.</td>
<td>Generation creates additional 'signing request' files (which appear under the [[#Certificate_Manager|Certificate Manager]] tab) that are later used to sign the generated certificates. When this option is set to 'on', the device deletes the signing request files after the signing process is complete.</td>
</tr>
<tr>
<td>Hosts</td>
<td>string; default: <b>none</b></td>
<td>Appends hostnames to certificates.</td>
</tr>
<tr>
<td>IP addresses</td>
<td>IPv4 address; default: <b>none</b></td>
<td>Appends IPv4 addresses to certificates.</td>
</tr>
</tr>
<tr>
<tr>
The <b>Certificate Import</b> section provides the possibility to import certificates and files generated on another machine. To upload such a file simply click 'Browse' and locate the file on your computer, it should then start uploading automatically.
The <b>Certificate Import</b> section provides the possibility to import certificates and files generated on another machine. To upload such a file simply click 'Browse' and locate the file on your computer, it should then start uploading automatically.
[[File:Networking_rutos_manual_administartion_certificates_certificates_manager_certificate_import_v2.png|border|class=tlt-border]]
[[File:Networking_rutos_manual_administartion_certificates_certificates_manager_certificate_import_v3.png|border|class=tlt-border]]
====Certificates, Keys & Requests====
====Certificates, Keys & Requests====
By default, the lists are empty. A set certificates generated using 'Simple' file type would look something like this:
By default, the lists are empty. A set certificates generated using 'Simple' file type would look something like this:
[[File:Networking_rutos_manual_administartion_certificates_certificates_manager_certificate_list_v1.png|border|class=tlt-border]]
[[File:Networking_rutos_manual_administartion_certificates_certificates_manager_certificate_list_v2.png|border|class=tlt-border]]
The 'Export' buttons are used to download the files from the device onto your local machine. The 'X' buttons located to the right of each entry are used to delete related files.
The 'Export' buttons are used to download the files from the device onto your local machine. The 'X' buttons located to the right of each entry are used to delete related files.
