Open Ethernet Networking (OpEN) API Guide and Reference Manual  3.11.1.2
openapi_authmgr.h
Go to the documentation of this file.
1 
9 /*********************************************************************
10 *
11 * Copyright 2023 Broadcom.
12 *
13 * Licensed under the Apache License, Version 2.0 (the "License");
14 * you may not use this file except in compliance with the License.
15 * You may obtain a copy of the License at
16 *
17 * http://www.apache.org/licenses/LICENSE-2.0
18 *
19 * Unless required by applicable law or agreed to in writing, software
20 * distributed under the License is distributed on an "AS IS" BASIS,
21 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
22 * See the License for the specific language governing permissions and
23 * limitations under the License.
24 *
25 **********************************************************************
26 *
27 * @filename openapi_authmgr.h
28 *
29 * @purpose Authentication manager Configuration and Status
30 *
31 * @component OPEN
32 *
33 * @create 02/23/2023
34 *
35 * @end
36 *
37 **********************************************************************/
38 #ifndef OPENAPI_AUTHMGR_H_INCLUDED
39 #define OPENAPI_AUTHMGR_H_INCLUDED
40 
41 #include "openapi_common.h"
42 
43 #define OPEN_AUTHMGR_USER_NAME_LEN 65
44 
46 typedef enum
47 {
48  OPEN_AUTHMGR_INITIALIZE = 0,
57 typedef enum
58 {
62 
64 typedef enum
65 {
71 
73 typedef enum
74 {
79 
81 typedef enum
82 {
92 
94 typedef enum
95 {
99 
101 typedef enum
102 {
108 
110 typedef enum
111 {
119 
120 
121 /*************************************************************************/
137 
138 /*************************************************************************/
154 
155 /*************************************************************************/
171 
172 /*************************************************************************/
188 
189 /*************************************************************************/
206 open_error_t openapiAuthMgrPortAuthMethodOrderSet(openapiClientHandle_t *client_handle, uint32_t intIfNum, uint32_t index, OPEN_AUTHMGR_METHOD_t method);
207 
208 /*************************************************************************/
225 open_error_t openapiAuthMgrPortAuthMethodOrderGet(openapiClientHandle_t *client_handle, uint32_t intIfNum, uint32_t index, OPEN_AUTHMGR_METHOD_t *method);
226 
227 /*************************************************************************/
244 open_error_t openapiAuthMgrPortAuthMethodPrioritySet(openapiClientHandle_t *client_handle, uint32_t intIfNum, uint32_t index, OPEN_AUTHMGR_METHOD_t method);
245 
246 /*************************************************************************/
263 open_error_t openapiAuthMgrPortAuthMethodPriorityGet(openapiClientHandle_t *client_handle, uint32_t intIfNum, uint32_t index, OPEN_AUTHMGR_METHOD_t *method);
264 
265 /*************************************************************************/
282 open_error_t openapiAuthMgrPortMaxUsersSet(openapiClientHandle_t *client_handle, uint32_t intIfNum, uint32_t maxUsers);
283 
284 /*************************************************************************/
301 open_error_t openapiAuthMgrPortMaxUsersGet(openapiClientHandle_t *client_handle, uint32_t intIfNum, uint32_t *maxUsers);
302 
303 /*************************************************************************/
319 open_error_t openapiAuthMgrPortUnauthenticatedVlanSet(openapiClientHandle_t *client_handle, uint32_t intIfNum, uint32_t vlanId);
320 
321 /*************************************************************************/
337 open_error_t openapiAuthMgrPortUnauthenticatedVlanGet(openapiClientHandle_t *client_handle, uint32_t intIfNum, uint32_t *vlanId);
338 
339 /*************************************************************************/
355 open_error_t openapiAuthMgrPortMaxAuthAttemptsSet(openapiClientHandle_t *client_handle, uint32_t intIfNum, uint32_t maxAuthAttempts);
356 
357 /*************************************************************************/
373 open_error_t openapiAuthMgrPortMaxAuthAttemptsGet(openapiClientHandle_t *client_handle, uint32_t intIfNum, uint32_t *maxAuthAttempts);
374 
375 /*************************************************************************/
392 open_error_t openapiAuthMgrEnabledMethodGet(openapiClientHandle_t *client_handle, uint32_t intIfNum, uint32_t index, OPEN_AUTHMGR_METHOD_t *method);
393 
394 /*************************************************************************/
411 open_error_t openapiAuthMgrEnabledPriorityGet(openapiClientHandle_t *client_handle, uint32_t intIfNum, uint32_t index, OPEN_AUTHMGR_METHOD_t *method);
412 
413 /*************************************************************************/
429 open_error_t openapiAuthMgrNumClientsGet(openapiClientHandle_t *client_handle, uint32_t intIfNum, uint32_t *clientsCount);
430 
431 /*************************************************************************/
447 open_error_t openapiAuthMgrLogicalPortClientMacAddrGet(openapiClientHandle_t *client_handle, uint32_t lIntIfNum, open_buffdesc *macAddrBuffDesc);
448 
449 /*************************************************************************/
466 
467 /*************************************************************************/
484 
485 /*************************************************************************/
502 
503 /*************************************************************************/
519 open_error_t openapiAuthMgrLogicalPortUserNameGet(openapiClientHandle_t *client_handle, uint32_t lIntIfNum, open_buffdesc *userName);
520 
521 /*************************************************************************/
538 
539 /*************************************************************************/
555 open_error_t openapiAuthMgrLogicalPortClientVlanTypeGet(openapiClientHandle_t *client_handle, uint32_t lIntIfNum, uint32_t *vlanType);
556 
557 /*************************************************************************/
573 open_error_t openapiAuthMgrLogicalPortSessionTimeGet(openapiClientHandle_t *client_handle, uint32_t lIntIfNum, uint32_t *sessionTime);
574 
575 /*************************************************************************/
591 open_error_t openapiAuthMgrLogicalPortSessionTimeoutGet(openapiClientHandle_t *client_handle, uint32_t lIntIfNum, uint32_t *sessionTimeout);
592 
593 /*************************************************************************/
609 open_error_t openapiAuthmgrLogicalPortTimeLeftForTerminateActionGet(openapiClientHandle_t *client_handle, uint32_t lIntIfNum, uint32_t *timeLeft);
610 
611 /*************************************************************************/
627 open_error_t openapiAuthMgrLogicalPortTerminationActionGet(openapiClientHandle_t *client_handle, uint32_t lIntIfNum, uint32_t *terminationAction);
628 
629 /*************************************************************************/
645 open_error_t openapiAuthMgrLogicalPortFilterIdGet(openapiClientHandle_t *client_handle, uint32_t lIntIfNum, open_buffdesc *filterId);
646 
647 /*************************************************************************/
665 open_error_t openapiAuthMgrAuthenticationReAuthPeriodFromSeverGet(openapiClientHandle_t *client_handle, uint32_t intIfNum, uint32_t *reAuthPeriod);
666 
667 /*************************************************************************/
685 open_error_t openapiDbAuthMgrAuthenticationReAuthPeriodGet(openapiClientHandle_t *client_handle, uint32_t intIfNum, uint32_t *reAuthPeriod);
686 
687 /*************************************************************************/
703 open_error_t openapiAuthMgrLogicalPortFirstGet(openapiClientHandle_t *client_handle, uint32_t intIfNum, uint32_t *firstlIntIfNum);
704 
705 /*************************************************************************/
721 open_error_t openapiAuthMgrLogicalPortNextGet(openapiClientHandle_t *client_handle, uint32_t lIntIfNum, uint32_t *nextlIntIfNum);
722 
723 /*****************************************************************/
738 
739 /*****************************************************************/
754 
755 /*****************************************************************/
770  uint32_t ifNum, OPEN_AUTHMGR_PORT_STATUS_t *status);
771 
772 /*****************************************************************/
787  uint32_t ifNum, OPEN_AUTHMGR_PORT_CONTROL_t *mode);
788 /*****************************************************************/
803  OPEN_CONTROL_t mode);
804 
805 /*****************************************************************/
820  OPEN_CONTROL_t *mode);
821 
822 /*****************************************************************/
838  uint32_t ifNum,
840 
841 /*****************************************************************/
857  uint32_t ifNum,
859 
860 /*****************************************************************/
874 open_error_t openapiAuthMgrPortGuestVlanGet(openapiClientHandle_t *client_handle, uint32_t ifNum, uint32_t *vlanId);
875 
876 /*****************************************************************/
890 open_error_t openapiAuthMgrPortGuestVlanSet(openapiClientHandle_t *client_handle, uint32_t ifNum, uint32_t vlanId);
891 
892 
893 /*****************************************************************/
910  uint32_t ifNum,
911  OPEN_BOOL_t val);
912 
913 /*****************************************************************/
930  uint32_t ifNum,
931  OPEN_BOOL_t *val);
932 /*****************************************************************/
950  uint32_t ifNum,
951  OPEN_BOOL_t val);
952 
953 /*****************************************************************/
971  uint32_t ifNum,
972  OPEN_BOOL_t *val);
973 /*****************************************************************/
989 open_error_t openapiAuthMgrLogicalPortVlanAssignmentGet(openapiClientHandle_t *client_handle, uint32_t logicalIfNum, uint32_t *vlan, OPEN_AUTHMGR_VLAN_ASSIGNED_MODE_t *reason);
990 
991 /*****************************************************************/
1007  uint32_t ifNum,
1008  uint32_t val);
1009 
1010 /*****************************************************************/
1026  uint32_t ifNum,
1027  uint32_t *val);
1028 
1029 /*****************************************************************/
1044  uint32_t ifNum, uint32_t *vlan);
1045 
1046 /*****************************************************************/
1061  uint32_t ifNum, OPEN_AUTHMGR_VLAN_ASSIGNED_MODE_t *reason);
1062 
1063 #endif /* OPENAPI_AUTHMGR_H_INCLUDED */
1064 
open_error_t openapiAuthMgrPortStatusGet(openapiClientHandle_t *client_handle, uint32_t ifNum, OPEN_AUTHMGR_PORT_STATUS_t *status)
Gets the authentication manager port status.
open_error_t openapiAuthMgrLogicalPortClientReauthStateGet(openapiClientHandle_t *client_handle, uint32_t lIntIfNum, OPEN_CONTROL_t *reauthState)
Get the client reauthenticating state for the logical interface.
open_error_t openapiAuthMgrLogicalPortFirstGet(openapiClientHandle_t *client_handle, uint32_t intIfNum, uint32_t *firstlIntIfNum)
Gets the first logical port in use for the physcial interface.
open_error_t openapiAuthMgrAuthenticationPeriodicGet(openapiClientHandle_t *client_handle, uint32_t ifNum, OPEN_BOOL_t *val)
Gets the authentication periodic (reauth) enabled status for the specified interface.
open_error_t openapiAuthMgrEnabledPriorityGet(openapiClientHandle_t *client_handle, uint32_t intIfNum, uint32_t index, OPEN_AUTHMGR_METHOD_t *method)
Get the Enabled method priority.
OPEN_AUTHMGR_PORT_CONTROL_t
OpEN uses this enumeration to define port authorization mode.
open_error_t openapiAuthMgrPortControlModeGet(openapiClientHandle_t *client_handle, uint32_t ifNum, OPEN_AUTHMGR_PORT_CONTROL_t *mode)
Gets the authentication manager port configured control mode.
open_error_t openapiAuthMgrAuthenticationPeriodicSet(openapiClientHandle_t *client_handle, uint32_t ifNum, OPEN_BOOL_t val)
Sets the authentication periodic (reauth) enabled status for the specified interface.
open_error_t openapiAuthMgrAuthenticationHostModeGet(openapiClientHandle_t *client_handle, uint32_t ifNum, OPEN_AUTHMGR_HOST_CONTROL_t *mode)
Gets the authentication host mode for the specified interface.
open_error_t openapiAuthMgrLogicalPortClientVlanTypeGet(openapiClientHandle_t *client_handle, uint32_t lIntIfNum, uint32_t *vlanType)
Get the authenticated client vlan type (data/voice) for the logical interface.
open_error_t openapiAuthMgrPortMaxAuthAttemptsSet(openapiClientHandle_t *client_handle, uint32_t intIfNum, uint32_t maxAuthAttempts)
Set the max number of failed authentication attempts value on the specified port. ...
OPEN_AUTHMGR_PORT_STATUS_t
OpEN uses this enumeration to define port authorization status.
open_error_t openapiAuthMgrPortVlanAssignedReasonGet(openapiClientHandle_t *client_handle, uint32_t ifNum, OPEN_AUTHMGR_VLAN_ASSIGNED_MODE_t *reason)
Gets the authentication manager port assigned VLAN reason.
open_error_t openapiAuthMgrAuthenticationHostModeSet(openapiClientHandle_t *client_handle, uint32_t ifNum, OPEN_AUTHMGR_HOST_CONTROL_t mode)
Sets the authentication host mode for the specified interface.
OPEN_AUTHMGR_METHOD_TYPE_t
OpEN uses this enumeration to define authentication manager method mode.
open_error_t
OPEN uses these enumerators to indicate the error codes.
open_error_t openapiAuthMgrLogicalPortClientAuthStatusGet(openapiClientHandle_t *client_handle, uint32_t lIntIfNum, OPEN_AUTHMGR_PORT_STATUS_t *authStatus)
Get the client authenticated Status for the logical interface.
open_error_t openapiAuthMgrLogicalPortClientAuthStateGet(openapiClientHandle_t *client_handle, uint32_t lIntIfNum, OPEN_AUTHMGR_STATES_t *authState)
Get the client reauth state for the logical interface.
open_error_t openapiAuthMgrPortMaxUsersGet(openapiClientHandle_t *client_handle, uint32_t intIfNum, uint32_t *maxUsers)
Get the max users of the port.
open_error_t openapiAuthMgrLogicalPortTerminationActionGet(openapiClientHandle_t *client_handle, uint32_t lIntIfNum, uint32_t *terminationAction)
Get the logical port termination action value.
open_error_t openapiAuthMgrDynamicVlanCreationModeGet(openapiClientHandle_t *client_handle, OPEN_CONTROL_t *dynamicVlanMode)
Get the authentication manager Dynamic Vlan Creation Mode.
OPEN_AUTHMGR_TERMINATION_ACTION_t
OpEN uses this enumeration to define radius termination action (needed by UI)
open_error_t openapiAuthMgrLogicalPortFilterIdGet(openapiClientHandle_t *client_handle, uint32_t lIntIfNum, open_buffdesc *filterId)
Get the filter id for the logical interface.
open_error_t openapiAuthMgrAuthenticationReAuthPeriodServerGet(openapiClientHandle_t *client_handle, uint32_t ifNum, OPEN_BOOL_t *val)
Gets the flag to get reauthentication period from server/user for the specified interface.
open_error_t openapiAuthMgrNumClientsGet(openapiClientHandle_t *client_handle, uint32_t intIfNum, uint32_t *clientsCount)
Get the number of clients authenticated.
OPEN_AUTHMGR_VLAN_ASSIGNED_MODE_t
OpEN uses this enumeration to define vlan assignment mode.
open_error_t openapiAuthMgrPortAuthMethodOrderGet(openapiClientHandle_t *client_handle, uint32_t intIfNum, uint32_t index, OPEN_AUTHMGR_METHOD_t *method)
Get authentication manager method order.
open_error_t openapiAuthMgrAuthenticationReAuthPeriodGet(openapiClientHandle_t *client_handle, uint32_t ifNum, uint32_t *val)
Gets the reauthentication period for the specified interface.
Captive-Portal.
open_error_t openapiAuthMgrPortUnauthenticatedVlanSet(openapiClientHandle_t *client_handle, uint32_t intIfNum, uint32_t vlanId)
Set the Authentication fail action (Unauthenticated vlan) value.
open_error_t openapiAuthMgrEnabledMethodGet(openapiClientHandle_t *client_handle, uint32_t intIfNum, uint32_t index, OPEN_AUTHMGR_METHOD_t *method)
Get the Enabled method order.
open_error_t openapiAuthMgrAuthenticationReAuthPeriodSet(openapiClientHandle_t *client_handle, uint32_t ifNum, uint32_t val)
Sets the reauthentication period for the specified interface.
open_error_t openapiAuthMgrAdminModeGet(openapiClientHandle_t *client_handle, OPEN_CONTROL_t *mode)
Gets the authentication manager global administrative mode.
open_error_t openapiAuthMgrLogicalPortVlanAssignmentGet(openapiClientHandle_t *client_handle, uint32_t logicalIfNum, uint32_t *vlan, OPEN_AUTHMGR_VLAN_ASSIGNED_MODE_t *reason)
Gets the authentication manager assigned VLAN ID and reason for the specified logical interface...
open_error_t openapiAuthMgrPortMaxAuthAttemptsGet(openapiClientHandle_t *client_handle, uint32_t intIfNum, uint32_t *maxAuthAttempts)
Get the max number of failed authentication attempts value on the specified port. ...
OPEN_CONTROL_t
OPEN uses these enumerators to indicate enable or disable for a given config or status parameter...
OPEN_BOOL_t
OPEN uses these enumerators to indicate true or false for a given config or status parameter...
open_error_t openapiAuthMgrLogicalPortClientAuthenticatedMethodGet(openapiClientHandle_t *client_handle, uint32_t lIntIfNum, OPEN_AUTHMGR_METHOD_t *method)
Get the client authenticated Method for the logical interface.
open_error_t openapiAuthMgrPortAuthMethodPrioritySet(openapiClientHandle_t *client_handle, uint32_t intIfNum, uint32_t index, OPEN_AUTHMGR_METHOD_t method)
Set authentication manager method priority.
open_error_t openapiAuthMgrPortOperatingControlModeGet(openapiClientHandle_t *client_handle, uint32_t ifNum, OPEN_AUTHMGR_PORT_CONTROL_t *mode)
Gets the authentication manager port operating control mode.
open_error_t openapiAuthMgrAuthenticationReAuthPeriodFromSeverGet(openapiClientHandle_t *client_handle, uint32_t intIfNum, uint32_t *reAuthPeriod)
Get the reauthentication status which is coonfigured on the radius server.
open_error_t openapiAuthMgrPortControlModeSet(openapiClientHandle_t *client_handle, uint32_t ifNum, OPEN_AUTHMGR_PORT_CONTROL_t mode)
Sets the authentication manager port configured control mode.
open_error_t openapiAuthMgrPortAuthMethodOrderSet(openapiClientHandle_t *client_handle, uint32_t intIfNum, uint32_t index, OPEN_AUTHMGR_METHOD_t method)
Set authentication manager method order.
open_error_t openapiAuthMgrAuthenticationReAuthPeriodFromServerSet(openapiClientHandle_t *client_handle, uint32_t ifNum, OPEN_BOOL_t val)
Sets the flag to get reauthentication period from server/user for the specified interface.
open_error_t openapiAuthMgrPortUnauthenticatedVlanGet(openapiClientHandle_t *client_handle, uint32_t intIfNum, uint32_t *vlanId)
Get the Authentication fail action (Unauthenticated vlan) value.
open_error_t openapiAuthMgrAdminModeSet(openapiClientHandle_t *client_handle, OPEN_CONTROL_t mode)
Sets the authentication manager global administrative mode.
open_error_t openapiAuthMgrPortMaxUsersSet(openapiClientHandle_t *client_handle, uint32_t intIfNum, uint32_t maxUsers)
Set the max users for the port.
open_error_t openapiAuthMgrLogicalPortUserNameGet(openapiClientHandle_t *client_handle, uint32_t lIntIfNum, open_buffdesc *userName)
Get the client username for the logical interface.
open_error_t openapiAuthMgrPortGuestVlanSet(openapiClientHandle_t *client_handle, uint32_t ifNum, uint32_t vlanId)
Set the Authentication Server Alive action.
open_error_t openapiAuthMgrLogicalPortSessionTimeGet(openapiClientHandle_t *client_handle, uint32_t lIntIfNum, uint32_t *sessionTime)
Get Logical port Session time.
OPEN_AUTHMGR_METHOD_t
OpEN uses this enumeration to define authentication manager method.
open_error_t openapiDbAuthMgrAuthenticationReAuthPeriodGet(openapiClientHandle_t *client_handle, uint32_t intIfNum, uint32_t *reAuthPeriod)
Get the reauthentication period on the specified port.
open_error_t openapiAuthMgrPortGuestVlanGet(openapiClientHandle_t *client_handle, uint32_t ifNum, uint32_t *vlanId)
Get the Authentication guest vlan Id.
open_error_t openapiAuthMgrLogicalPortNextGet(openapiClientHandle_t *client_handle, uint32_t lIntIfNum, uint32_t *nextlIntIfNum)
Gets the next logical port for the physcial interface.
open_error_t openapiAuthMgrLogicalPortSessionTimeoutGet(openapiClientHandle_t *client_handle, uint32_t lIntIfNum, uint32_t *sessionTimeout)
Get the session timeout value for the logical interface.
open_error_t openapiAuthmgrLogicalPortTimeLeftForTerminateActionGet(openapiClientHandle_t *client_handle, uint32_t lIntIfNum, uint32_t *timeLeft)
Get the time left for the session termination action to occur for the logical interface.
open_error_t openapiAuthMgrPortAuthMethodPriorityGet(openapiClientHandle_t *client_handle, uint32_t intIfNum, uint32_t index, OPEN_AUTHMGR_METHOD_t *method)
Get authentication manager method priority.
open_error_t openapiAuthMgrLogicalPortClientMacAddrGet(openapiClientHandle_t *client_handle, uint32_t lIntIfNum, open_buffdesc *macAddrBuffDesc)
Get the client/supplicant Mac address for the logical interface.
open_error_t openapiAuthMgrVlanAssignmentModeSet(openapiClientHandle_t *client_handle, OPEN_CONTROL_t vlanAssignmentMode)
Set the authentication manager Vlan Assignment Mode.
OPEN_AUTHMGR_STATES_t
OpEN uses this enumeration to define authentication manager states.
open_error_t openapiAuthMgrPortVlanAssignedGet(openapiClientHandle_t *client_handle, uint32_t ifNum, uint32_t *vlan)
Gets the authentication manager port assigned VLAN.
open_error_t openapiAuthMgrVlanAssignmentModeGet(openapiClientHandle_t *client_handle, OPEN_CONTROL_t *vlanAssignmentMode)
Get the authentication manager Vlan Assignment Mode.
OPEN_AUTHMGR_HOST_CONTROL_t
OpEN uses this enumeration to define port host mode.
open_error_t openapiAuthMgrDynamicVlanCreationModeSet(openapiClientHandle_t *client_handle, OPEN_CONTROL_t dynamicVlanMode)
Set the authentication manager Dynamic Vlan Creation Mode.