User Guide: AMF Security version 2.5.0 for VST-APL

# AMF

AMF Application Proxy Settings
AMF Masters
Edit AMF Master
White-List Settings
SSL Certificate
Upload SSL Certificate
TQ Settings
Common Settings
VistaManagerEX
Edit VistaManagerEX
TQ List
Edit TQ

## AMF Application Proxy Settings

### AMF Masters

Register the AMF Master in AMF Security. It also shows a list of registered AMF Masters.

> Note

> > With the following settings, the connection with connected OpenFlow Switch or AMF Master is temporarily disconnected.
> > ・AMF Master
> > ・White-List Settings
> > ・Uploading or deleting the SSL Certificate of the Web server

Table 1: Displayed columns
Item Name | Description
--- | ---
IPv4 Address | IPv4 Address of AMF Master using AMF Application Proxy.
Username | Username of a level 15 (privileged) account on the AMF Master.
Connected | Displays the connection status with the AMF Master, Good, Error, Checking, or Disconnected. Disconnected is displayed when the base license is not registered.

Table 2: Buttons
Item Name | Description
--- | ---
Add | Open Edit AMF Master dialog to register a new AMF Master.
Edit | Open the Edit AMF Master dialog to update AMF Master information.
Delete | Delete information of the selected AMF Master.

#### Edit AMF Master

This dialog lets you add or edit information of AMF Master.

Table 3: Sample Configuration Data
Item Name | Description
--- | ---
IPv4 Address | Enter an IPv4 Address of AMF Master using AMF Application Proxy. Then enter the username and password below.
Username | Enter a username of a level 15 (privileged) account on the AMF Master.
Password | Enter a password for the above username.
Pre-Shared Key | Enter a pre-shared key used between the AMF Master and the Whitelist Server (AMF Security).

> Note

> > The same privilege level 15 (privilege level) account must be set up for all AMF Members.
> > Note that if you specify an account with privilege levels 1 to 14 (including those set with the "http webapi read-only-privilege" command), it is not work properly.

Table 4: Buttons
Item Name | Description
--- | ---
Bottom of the dialog
Submit | Register a new AMF Master or update information of an existing AMF Master.
Cancel | Cancel the operation for registering or updating AMF Master information.

> Note

> > When you finish this configuration, the AMF Master (proxy node) is contacted periodically (every 30 seconds) in order to acquire edge node information.
> > It is recommended that the AMF Master account (Username and Password) set for AMF Security be different from the user account used for AMF Member console connection. Create a user account with authority level 15 in advance by AMF Master and AMF Member.
> > When sharing the user account used for the console connection of AMF Master and AMF Member with the account set in AMF Security, set the lockout time for login failure of AMF Master and AMF Member to less than 5 minutes (use the "aaa local authentication attempts lockout-time" command). Note that the user is not able to log in under the following conditions and operations. - Lockout time for AMF Master and AMF Members when login fails is set to 5 minutes or more - Share the AMF Master and AMF Member CLI connection account with the account set in AMF Security. If the above two conditions are met and the account is locked out due to consecutive failures to log in to the AMF Master and AMF Members, or if the AMF Master account setting is incorrect in AMF Security, The node information of the AMF network cannot be obtained from AMF Security, and the lockout timer is continuously updated by polling from AMF Security, so that the user cannot log in.

### White-List Settings

Table 5: Sample Configuration Data
Item Name | Description
--- | ---
session-timeout | Specify a timer value (in seconds) to be configured on the switch when a device is successfully authenticated. When the timer expires, the device is reset to unauthenticated state. Valid range is 0 to 65535. Default is 65535. When set to zero, nodes are always in authenticated state because no timer is configured on switches. This value is used when a security policy for a device does not have Schedule. This value may be preceded by a Schedule's End Date / Time. This value is used as it is when the interval between the successful authentication and a scheduled End Date / Time is less than 65535 seconds. If the interval between the successful authentication and a scheduled End Date / Time is larger than or equals to 65535 seconds, actual timeout is set to 65535 seconds.
Reload authorized device list when AMF Member connects to network. | The node information authenticated by the AMF Application Proxy displayed on the Device > Active Device List page is reloaded when AMF Security is restarted. To use this feature, your Proxy Node and Edge Nodes must have AlliedWare Plus firmware version 5.5.0-0.x or later installed.

> Note

> > The "session-timeout" setting is the same as the "Flow Lifetime" on the System Settings > OpenFlow Settings page.

Table 6: Buttons
Item Name | Description
--- | ---
Submit | Save the settings.

### SSL Certificate

Register the SSL server certificate of the Web server (AMF Security) and the SSL server certificate of the whitelist authentication server installed in AMF Security.
If you want external applications to interact with AMF Security via HTTPS, you may have to install an SSL server certificate issued by a trusted certificate authority (CA).
If you want to encrypt control session between AMF Master and Whitelist Server (AMF Security), upload an SSL server certificate issued by a trusted certificate authority (CA).
"SSL Certificate" section shows a summary of the installed SSL server certificate.

Use the method best suited for your needs to get the certificate.

- If your CA provides you with intermediate CA certificates or cross root CA certificates in addition to your server certificate, concatenate those certificates into a single file then upload the file to AMF Security. Contact the CA for detailed information on how to concatenate certificate files.
- To install a certificate file, it must meet the following requirements.

  Table 7: SSL Certificate Requirements
  Type | X.509, RFC6818
  Encryption | PEM (Privacy Enhanced Mail)
  Extension | .crt

Table 8: Displayed columns
Item Name | Description
--- | ---
Role | Displays Web (Web server) or WhiteList (Authentication server).
Common Name(CN) | Displays the common name of the web server (AMF Security) or authentication server (AMF Security).
Organization(O) | Displays the name of the organization to which the Web server (AMF Security) or authentication server (AMF Security) belongs.
Expiration Date [UTC] | Expiration date of the certificate.

Table 9: Buttons
Item Name | Description
--- | ---
Detail | The detailed information of the registered SSL server certificate is displayed.
Upload | Open the Upload SSL Certificate dialog to register the SSL Certificate with AMF Security.
Delete | Delete the installed SSL server certificate and restore the default certificate which is self-signed by AMF Security.

> Note

> > After setting the AMF Master, AMF Security accepts both unencrypted and encrypted sessions. You cannot disable one of them.

#### Upload SSL Certificate

This dialog lets you upload your own SSL certificate for the Whitelist Authentication Server.

Table 10: Configurable fields
Item Name | Description
--- | ---
Certificate | Click the "Choose File" button and select the SSL Certificate to upload.
Private Key | Click the "Choose File" button and select the SSL private key to upload.

Table 11: Buttons
Item Name | Description
--- | ---
Submit | Import the specified private key and certificate.
Cancel | Cancel the operation for importing SSL certificate.

## TQ Settings

> Note

> > With this setting, the connection with connected OpenFlow Switch or AMF Master is temporarily disconnected.
> > At that time, if the device already managed by TQ's AMF Application Proxy (devices displayed on the Device > Active Device List page) exists, the device's authentication and actions remain applied. However, it is deleted from the Devices > Active Device List page.
> > Also, even if the connection between the connected OpenFlow Switch and the AMF Master is temporarily disconnected due to other settings or operations (such as restarting the service), it is deleted from the Device > Active Device List page.

### Common Settings

Specifies the VLAN ID of the quarantine network.

Table 12: Configurable fields
Item Name | Description
--- | ---
Quarantine VLAN ID | VLAN ID of the quarantine network where quarantined devices are placed. Valid range is 0 to 4094. Default is 4089.

> Note

> > This setting is the same as the "Quarantine VLAN ID" on the System Settings > OpenFlow Settings page.

Table 13: Buttons
Item Name | Description
--- | ---
Submit | Register the Quarantine VLAN ID.

### VistaManagerEX

This page shows a list of AT-Vista Manager EX.

Table 14: Displayed columns
Item Name | Description
--- | ---
IPv4 Address | The IP Address of the AT-Vista Manager EX server. When using the Windows version of AT-Vista Manager EX, specify the IP Address of the AT-Vista Manager EX server. When using the AT-VST-APL version of AT-Vista Manager EX, specify the IP Address of the AWC Plug-in.
Username | The Username of the AT-Vista Manager EX Admin account.

Table 15: Buttons
Item Name | Description
--- | ---
Add | Open the Edit VistaManagerEX dialog and register a new AT-Vista Manager EX.
Edit | Open the Edit VistaManagerEX dialog and updates the AT-Vista Manager EX information.
Delete | Delete AT-Vista Manager EX.

#### Edit VistaManagerEX

Register or update AT-Vista Manager EX.

Table 16: Configurable fields
Item Name | Description
--- | ---
IPv4 Address | Enter the IP Address of the AT-Vista Manager EX server.
Port number | Set the port number for using AT-Vista Manager EX. This setting specifies the port number of the AWC Plug-in. The default port number for the AWC Plug-in is 5443, but if you have changed the port number, specify that port number. Valid range is 1 to 65535. The default setting is 5443.
Username | Enter the Username of the AT-Vista Manager EX Admin account.
Password | Enter the password for the AT-Vista Manager EX Admin account.

Table 17: Buttons
Item Name | Description
--- | ---
Submit | Register the entered AT-Vista Manager EX information.
Cancel | Cancel AT-Vista Manager EX registration or information update.

### TQ List

Lists the wireless access points managed by AT-Vista Manager EX.

> Note

> > Register the wireless access point with an IP Address. Duplicate IP Addresses cannot be registered.

Table 18: Displayed columns
Item Name | Description
--- | ---
IPv4 Address | The IP Address of the wireless access point.

Table 19: Buttons
Item Name | Description
--- | ---
Import | Use the CSV file to register a new wireless access point or update the information.
Reset | Delete all registered wireless access points.
Add | Opne the Edit TQ dialog and register a new wireless access point.
Edit | Open the Edit TQ dialog and updates the information of the wireless access point.
Delete | Delete the wireless access point.

◼ About CSV file format
When registering a new wireless access point or updating information using a CSV file, create a CSV file with the character code "UTF-8" in the format shown below.

- Can be added ("+" at the beginning of the line) or deleted ("-" at the beginning of the line)
- The second field is "IPv4 Address" and the third field is "Pre-Shared Key (PSK)"

"+","192.168.1.98","xxxxxxxxx" ↓
"+","192.168.1.99","xxxxxxxxx" ↓
"-","192.168.1.100" ↓

> Note

> > It is not necessary to specify the "Pre-Shared key (PSK)" when deleting.

#### Edit TQ

Register or renew your wireless access point.

Table 20: Configurable fields
Item Name | Description
--- | ---
IPv4 Address | Enter the IP Address of the wireless access point. If you add with an IP Address that has already been registered, the existing settings is overwritten.
Pre-Shared Key | Enter the security key (AMF Application Proxy server secret) configured on the wireless access point.

Table 21: Buttons
Item Name | Description
--- | ---
Submit | Register the entered wireless access point information.
Cancel | Cancel the registration of the wireless access point or the update of information.

19 Apr 2023 14:11