POST /user-management/local
This controller can be used as a RADIUS server by other controllers on the network. In this scenario, the other controllers must be configured to use the Remote RADIUS server mode with this controller’s IP address. This centralizes access management on this controller thereby saving time by eliminating the need to add users to each controller individually. Set the port numbers and shared key that other controllers will use to connect to this controller.
The port values of 1812 for authentication and 1813 for accounting are RADIUS standard port numbers. However, other port numbers may be used. No matter which port numbers are used, make sure that the port numbers are unused by other services on this controller and that both the RADIUS server and the RADIUS clients use the same port number values.
The shared key is sent in Base64.
Use a POST on this resource will only change the values, but the mode won't be applied. If you want to apply the mode you need to do a POST on "/api/rest/v1/user-management".
If this parameter is not in the request, the Application/Json will be chosen by default.
There are multiple possible values (according the resource):
The first two are the most often used.
There are multiple possible values according the resource:
If this parameter is not present during the request, and error 415 Unsupported Media Type will be thrown.
The Content-Length entity-header field indicates the size of the entity-body.
Object Name: Local
| Property Name | Type | Description | Method |
|---|---|---|---|
| AuthenticationPort | Integer | The RADIUS server authentication port number. | GET POST |
| AccountingPort | Integer | The RADIUS server accounting port number. | GET POST |
| SharedKey | String | This is an encryption key that devices use to encrypt and decrypt user authentication credentials that are sent between devices. The shared key should be a long string of up 32 alphanumeric characters and symbols that would be difficult to guess. For example, he^sg3iq6pg2+gqw@89hsm,wz[ This same key must be copied to the remote RADIUS client. The shared key, can't be less than 16 characters. Dunring a POST the shared key must be encoded in Base64. |
GET POST |
| Users | Array |
User access to this controller and to other controllers that are using this controller as their RADIUS server are managed by adding them to this array. | GET |
| PasswordPolicy | Object | This object is used to configure how secure the users password will be. | GET |
URL Example: https://0.0.0.0/api/rest/v1/user-management/local
{
"authenticationPort": 1812,
"accountingPort": 1813,
"sharedKey": "NV5AIXNLPEFoNEhvJTdfPTxBZEAzXUJRQiZMKkNnO1c="
}
URL Example: https://0.0.0.0/api/rest/v1/user-management/local
<?xml version="1.0" encoding="utf-8"?>
<Local>
<AuthenticationPort>1812</AuthenticationPort>
<AccountingPort>1813</AccountingPort>
<SharedKey>NV5AIXNLPEFoNEhvJTdfPTxBZEAzXUJRQiZMKkNnO1c=</SharedKey>
</Local>