Package org.forgerock.opendj.server.config.client

Interface SNMPConnectionHandlerCfgClient

  • All Superinterfaces:
    ConfigurationClient, ConnectionHandlerCfgClient
    public interface SNMPConnectionHandlerCfgClient
extends ConnectionHandlerCfgClient
    A client-side interface for reading and modifying SNMP Connection Handler settings.

    The SNMP Connection Handler can be used to process SNMP requests to retrieve monitoring information described by the MIB 2605. Supported protocol are SNMP V1, V2c and V3.

    • Method Detail

      • getAllowedManager

        SortedSet<String> getAllowedManager()
        Gets the "allowed-manager" property.

        Specifies the hosts of the managers to be granted the access rights. This property is required for SNMP v1 and v2 security configuration. An asterisk (*) opens access to all managers.

        Returns:
        Returns the values of the "allowed-manager" property.

      • setAllowedManager

        void setAllowedManager​(Collection<String> values)
                throws PropertyException
        Sets the "allowed-manager" property.

        Specifies the hosts of the managers to be granted the access rights. This property is required for SNMP v1 and v2 security configuration. An asterisk (*) opens access to all managers.

        Parameters:
        values - The values of the "allowed-manager" property.
        Throws:
        PropertyException - If one or more of the new values are invalid.

      • getAllowedUser

        SortedSet<String> getAllowedUser()
        Gets the "allowed-user" property.

        Specifies the users to be granted the access rights. This property is required for SNMP v3 security configuration. An asterisk (*) opens access to all users.

        Returns:
        Returns the values of the "allowed-user" property.

      • setAllowedUser

        void setAllowedUser​(Collection<String> values)
             throws PropertyException
        Sets the "allowed-user" property.

        Specifies the users to be granted the access rights. This property is required for SNMP v3 security configuration. An asterisk (*) opens access to all users.

        Parameters:
        values - The values of the "allowed-user" property.
        Throws:
        PropertyException - If one or more of the new values are invalid.

      • getCommunity

        String getCommunity()
        Gets the "community" property.

        Specifies the v1,v2 community or the v3 context name allowed to access the MIB 2605 monitoring information or the USM MIB. The mapping between "community" and "context name" is set.

        Returns:
        Returns the value of the "community" property.

      • setCommunity

        void setCommunity​(String value)
           throws PropertyException
        Sets the "community" property.

        Specifies the v1,v2 community or the v3 context name allowed to access the MIB 2605 monitoring information or the USM MIB. The mapping between "community" and "context name" is set.

        Parameters:
        value - The value of the "community" property.
        Throws:
        PropertyException - If the new value is invalid.

      • getJavaClass

        String getJavaClass()
        Gets the "java-class" property.

        Specifies the fully-qualified name of the Java class that provides the SNMP Connection Handler implementation.

        Specified by:
        getJavaClass in interface ConnectionHandlerCfgClient
        Returns:
        Returns the value of the "java-class" property.

      • setJavaClass

        void setJavaClass​(String value)
           throws PropertyException
        Sets the "java-class" property.

        Specifies the fully-qualified name of the Java class that provides the SNMP Connection Handler implementation.

        Specified by:
        setJavaClass in interface ConnectionHandlerCfgClient
        Parameters:
        value - The value of the "java-class" property.
        Throws:
        PropertyException - If the new value is invalid.

      • getListenAddress

        SortedSet<InetAddress> getListenAddress()
        Gets the "listen-address" property.

        Specifies the address or set of addresses on which this SNMP Connection Handler should listen for connections from SNMP clients.

        Multiple addresses may be provided as separate values for this attribute. If no values are provided, then the SNMP Connection Handler listens on all interfaces.

        Returns:
        Returns the values of the "listen-address" property.

      • setListenAddress

        void setListenAddress​(Collection<InetAddress> values)
               throws PropertyException,
                      PropertyException
        Sets the "listen-address" property.

        Specifies the address or set of addresses on which this SNMP Connection Handler should listen for connections from SNMP clients.

        Multiple addresses may be provided as separate values for this attribute. If no values are provided, then the SNMP Connection Handler listens on all interfaces.

        This property is read-only and can only be modified during creation of a SNMP Connection Handler.

        Parameters:
        values - The values of the "listen-address" property.
        Throws:
        PropertyException - If one or more of the new values are invalid.
        PropertyException - If this SNMP Connection Handler is not being initialized.

      • getListenPort

        Integer getListenPort()
        Gets the "listen-port" property.

        Specifies the port number on which the SNMP Connection Handler will listen for connections from clients.

        Only a single port number may be provided.

        Returns:
        Returns the value of the "listen-port" property.

      • setListenPort

        void setListenPort​(int value)
            throws PropertyException
        Sets the "listen-port" property.

        Specifies the port number on which the SNMP Connection Handler will listen for connections from clients.

        Only a single port number may be provided.

        Parameters:
        value - The value of the "listen-port" property.
        Throws:
        PropertyException - If the new value is invalid.

      • getOpendmkJarfile

        String getOpendmkJarfile()
        Gets the "opendmk-jarfile" property.

        Indicates the OpenDMK runtime jar file location

        Returns:
        Returns the value of the "opendmk-jarfile" property.

      • setOpendmkJarfile

        void setOpendmkJarfile​(String value)
                throws PropertyException
        Sets the "opendmk-jarfile" property.

        Indicates the OpenDMK runtime jar file location

        Parameters:
        value - The value of the "opendmk-jarfile" property.
        Throws:
        PropertyException - If the new value is invalid.

      • isRegisteredMbean

        boolean isRegisteredMbean()
        Gets the "registered-mbean" property.

        Indicates whether the SNMP objects have to be registered in the directory server MBeanServer or not allowing to access SNMP Objects with RMI connector if enabled.

        Returns:
        Returns the value of the "registered-mbean" property.

      • setRegisteredMbean

        void setRegisteredMbean​(Boolean value)
                 throws PropertyException
        Sets the "registered-mbean" property.

        Indicates whether the SNMP objects have to be registered in the directory server MBeanServer or not allowing to access SNMP Objects with RMI connector if enabled.

        Parameters:
        value - The value of the "registered-mbean" property.
        Throws:
        PropertyException - If the new value is invalid.

      • getSecurityAgentFile

        String getSecurityAgentFile()
        Gets the "security-agent-file" property.

        Specifies the USM security configuration to receive authenticated only SNMP requests.

        Returns:
        Returns the value of the "security-agent-file" property.

      • setSecurityAgentFile

        void setSecurityAgentFile​(String value)
                   throws PropertyException
        Sets the "security-agent-file" property.

        Specifies the USM security configuration to receive authenticated only SNMP requests.

        Parameters:
        value - The value of the "security-agent-file" property.
        Throws:
        PropertyException - If the new value is invalid.

      • getSecurityLevel

        SNMPConnectionHandlerCfgDefn.SecurityLevel getSecurityLevel()
        Gets the "security-level" property.

        Specifies the type of security level : NoAuthNoPriv : No security mechanisms activated, AuthNoPriv : Authentication activated with no privacy, AuthPriv : Authentication with privacy activated. This property is required for SNMP V3 security configuration.

        Returns:
        Returns the value of the "security-level" property.

      • setSecurityLevel

        void setSecurityLevel​(SNMPConnectionHandlerCfgDefn.SecurityLevel value)
               throws PropertyException
        Sets the "security-level" property.

        Specifies the type of security level : NoAuthNoPriv : No security mechanisms activated, AuthNoPriv : Authentication activated with no privacy, AuthPriv : Authentication with privacy activated. This property is required for SNMP V3 security configuration.

        Parameters:
        value - The value of the "security-level" property.
        Throws:
        PropertyException - If the new value is invalid.

      • getTrapPort

        Integer getTrapPort()
        Gets the "trap-port" property.

        Specifies the port to use to send SNMP Traps.

        Returns:
        Returns the value of the "trap-port" property.

      • setTrapPort

        void setTrapPort​(int value)
          throws PropertyException
        Sets the "trap-port" property.

        Specifies the port to use to send SNMP Traps.

        Parameters:
        value - The value of the "trap-port" property.
        Throws:
        PropertyException - If the new value is invalid.

      • getTrapsCommunity

        String getTrapsCommunity()
        Gets the "traps-community" property.

        Specifies the community string that must be included in the traps sent to define managers (trap-destinations). This property is used in the context of SNMP v1, v2 and v3.

        Returns:
        Returns the value of the "traps-community" property.

      • setTrapsCommunity

        void setTrapsCommunity​(String value)
                throws PropertyException
        Sets the "traps-community" property.

        Specifies the community string that must be included in the traps sent to define managers (trap-destinations). This property is used in the context of SNMP v1, v2 and v3.

        Parameters:
        value - The value of the "traps-community" property.
        Throws:
        PropertyException - If the new value is invalid.

      • getTrapsDestination

        SortedSet<String> getTrapsDestination()
        Gets the "traps-destination" property.

        Specifies the hosts to which V1 traps will be sent. V1 Traps are sent to every host listed.

        If this list is empty, V1 traps are sent to "localhost". Each host in the list must be identifed by its name or complete IP Addess.

        Returns:
        Returns the values of the "traps-destination" property.

      • setTrapsDestination

        void setTrapsDestination​(Collection<String> values)
                  throws PropertyException
        Sets the "traps-destination" property.

        Specifies the hosts to which V1 traps will be sent. V1 Traps are sent to every host listed.

        If this list is empty, V1 traps are sent to "localhost". Each host in the list must be identifed by its name or complete IP Addess.

        Parameters:
        values - The values of the "traps-destination" property.
        Throws:
        PropertyException - If one or more of the new values are invalid.