Infoblox::Grid::Admin::RadiusAuthServer - RADIUS Authentication Server object


NAME

Infoblox::Grid::Admin::RadiusAuthServer - RADIUS Authentication Server object


DESCRIPTION

Represents a RADIUS server that is used to authenticate administrators and DHCP clients.


CONSTRUCTOR

 my $radius_auth_server = Infoblox::Grid::Admin::RadiusAuthServer->new(
     acct_enabled     => "true" | "false"      #Optional / Default is false
     acct_port        => $num,                 #Optional / Default is 1813
     auth_port        => $num,                 #Optional / Default is 1812
     auth_type        => "PAP" | "CHAP",       #Optional / Default is "PAP"
     comment          => $string,              #Optional / Default is empty
     disabled         => "true" | "false"      #Optional / Default is false
     fqdn_or_ip       => $fqdn | $ipv4addr     #Required
     shared_secret    => $string,              #Required
     use_mgmt_port    => "true" | "false"      #Optional / Default is false
 );


SESSION METHODS

This section describes all the methods in an Infoblox::Session module that you can apply to an object.

Infoblox::Grid::Admin::RadiusAuthService->radius_servers()

Use this method to add a list of RADIUS Server objects to the RADIUS Service object on an Infoblox appliance. See Infoblox::Grid::Admin::RadiusAuthService for parameters and return values.

Example
 # Construct an object
 my $radius_auth_server1 = Infoblox::Grid::Admin::RadiusAuthServer->new(
                                                            fqdn_or_ip    => '10.0.1.1',
                                                            shared_secret => 'secret',
 );
 # Construct another object
 my $radius_auth_server2 = Infoblox::Grid::Admin::RadiusAuthServer->new(
                                                            fqdn_or_ip    => '10.0.2.1',
                                                            shared_secret => 'secret',
 );
 # Configure RadiusAuthServer
 my $response = $radius_auth_service->radius_servers([$radius_auth_server1, $radius_auth_server2]);


METHODS

Use the following methods to access the attributes of an Infoblox::Grid::Admin::RadiusAuthServer object. Specify a parameter to set the attribute's value, or omit the parameter to get the attribute's value.

acct_enabled( )

Use this method to set or retrieve the flag that indicates if the RADIUS server is enabled for accounting packets.

Include the specified parameter to set the attribute value. Omit the parameter to retrieve the attribute value.

Parameter

Specify "true" to set the disable flag or "false" to deactivate/unset it. The default value is "false".

Returns

If you specified a parameter, the method returns true when the modification succeeds, and returns false when the operation fails.

If you did not specify a parameter, the method returns the attribute value.

Example
   #Get acct_enabled
   my $acct_enabled = $radius_server->acct_enabled();
   #Modify acct_enabled
   $radius_server->acct_enabled("true");

acct_port( )

Use this method to set or retrieve the port number used by RADIUS server for accounting packets.

Include the specified parameter to set the attribute value. Omit the parameter to retrieve the attribute value.

Parameter

An unsigned integer between 1 and 65535, inclusive.

Returns

If you specified a parameter, the method returns true when the modification succeeds, and returns false when the operation fails.

If you did not specify a parameter, the method returns the attribute value.

Example
   #Getting acct_port
   my $acct_port = $radius_server->acct_port( );
   #Modifying acct_port
   $radius_server->acct_port("1813");

auth_port( )

Use this method to set or retrieve the port number used by the RADIUS server for accounting packets.

Include the specified parameter to set the attribute value. Omit the parameter to retrieve the attribute value.

Parameter

An unsigned integer between 1 and 65535, inclusive.

Returns

If you specified a parameter, the method returns true when the modification succeeds, and returns false when the operation fails.

If you did not specify a parameter, the method returns the attribute value.

Example
   #Getting auth_port
   my $auth_port = $radius_server->auth_port( );
   #Modifying auth_port
   $radius_server->auth_port("1812");

auth_type( )

Use this method to set or retrieve the authentication type used by the RADIUS client and server.

Include the specified parameter to set the attribute value. Omit the parameter to retrieve the attribute value.

Parameter

The valid value is either "PAP" or "CHAP", the default is "PAP".

Returns

If you specified a parameter, the method returns true when the modification succeeds, and returns false when the operation fails.

If you did not specify a parameter, the method returns the attribute value.

Example
   #Getting auth_type
   my $auth_type = $radius_server->auth_type( );
   #Modifying auth_type
   $radius_server->auth_type("PAP");

comment( )

Use this method to set or retrieve a descriptive comment about the RADIUS server.

Include the specified parameter to set the attribute value. Omit the parameter to retrieve the attribute value.

Parameter

The comment in string format, with a maximum of 256 characters.

Returns

If you specified a parameter, the method returns true when the modification succeeds, and returns false when the operation fails.

If you did not specify a parameter, the method returns the attribute value.

Example
   #Get comment
   my $comment = $radius_server->comment();
   #Modify comment
   $radius_server->comment("NAC Authentication RADIUS server");

disabled( )

Use this method to set or retrieve the disable flag of the RADIUS server.

Include the specified parameter to set the attribute value. Omit the parameter to retrieve the attribute value.

Parameter

Specify "true" to set the disable flag or "false" to deactivate/unset it. The default value is "false".

Returns

If you specified a parameter, the method returns true when the modification succeeds, and returns false when the operation fails.

If you did not specify a parameter, the method returns the attribute value.

Example
   #Get disabled
   my $disable = $radius_server->disabled();
   #Modify disabled
   $radius_server->disabled("true");

fqdn_or_ip( )

Use this method to set or retrieve the FQDN or IP address of the RADIUS server.

Include the specified parameter to set the attribute value. Omit the parameter to retrieve the attribute value.

Parameter

A string in FQDN (Fully Qualified Domain Name) format, or an IP address.

Returns

If you specified a parameter, the method returns true when the modification succeeds, and returns false when the operation fails.

If you did not specify a parameter, the method returns the attribute value.

Example
   #Get fqdn_or_ip
   my $fqdn_or_ip = $radius_server->fqdn_or_ip();
   #Modify fqdn_or_ip
   $radius_server->fqdn_or_ip("10.0.0.1");

shared_secret( )

Use this method to set the shared secret used by the RADIUS client and RADIUS server. This is a write-only attribute.

Include the specified parameter to set the attribute value.

Parameter

The shared secret in string format, with a maximum of 128 characters.

Returns

If you specified a parameter, the method returns true when the modification succeeds, and returns false when the operation fails.

Example
   #Modify shared_secret
   $radius_server->shared_secret("secret");

use_mgmt_port( )

Use this method to set or retrieve the flag that indicates if the appliance connects to the RADIUS server through the MGMT network interface.

Include the specified parameter to set the attribute value. Omit the parameter to retrieve the attribute value.

Parameter

Specify "true" to set the flag or "false" to deactivate/unset it. The default value is "false".

Returns

If you specified a parameter, the method returns true when the modification succeeds, and returns false when the operation fails.

If you did not specify a parameter, the method returns the attribute value.

Example
   #Get use_mgmt_port
   my $use_mgmt_port = $radius_server->use_mgmt_port();
   #Modify use_mgmt_port
   $radius_server->use_mgmt_port("true");


AUTHOR

Infoblox Inc. http://www.infoblox.com


SEE ALSO

Infoblox::Grid::Admin::RadiusAuthService, Infoblox::Session, Infoblox::Session->add(), Infoblox::Session->get(), Infoblox::Session->modify(), Infoblox::Session->remove()


COPYRIGHT

Copyright (c) 2017 Infoblox Inc.