Open topic with navigation

TIBCO® Enterprise Administrator 2.4.2

# Notify Changes Related to LDAP Realm Configurations

To listen to changes made on the LDAP configurations on the TIBCO Enterprise Administrator server, the agent must implement the com.tibco.tea.agent.api.TeaLdapConfigurationListener interface. On implementing the interface, the agent gets a notification when there is an addition, modification, or deletion of an LDAP configuration on the TIBCO Enterprise Administrator server.

The following steps ensure that changes to the LDAP realm configurations on the TIBCO Enterprise Administrator server are notified to the agent:

1. The TIBCO Enterprise Administrator server is running.
2. At least one LDAP realm configuration is created on the TIBCO Enterprise Administrator server.
3. The agent has implemented the com.tibco.tea.agent.api.TeaLdapConfigurationListener interface.
4. The agent is registered with the TIBCO Enterprise Administrator server.

Note: In the steps mentioned earlier, if the TIBCO Enterprise Administrator server is not running, whenever the server starts, every agent in the `Running` mode receives the LDAP realm configurations.

When an agent is reconnected to the server or when the agent is in the Running mode, the agent receives notifications about the updates on the LDAP realm configurations.

## The TeaLdapConfigurationListener Interface

The interface implementation must be registered with com.tibco.tea.agent.server.TeaAgentServer using the addEventListener() method. This is usually included as a part of the agent setup code block. The following is a snippet fromTeaLdapConfigurationListener.java:

    public interface TeaLdapConfigurationListener extends java.util.EventListener {

        public void onRealmAdded(final TeaLdapConfigurationEvent
        ldapConfigurationEvent);

        public void onRealmUpdated(final TeaLdapConfigurationEvent
        ldapConfigurationEvent);

        public void onRealmDeleted(final TeaLdapConfigurationEvent
        ldapConfigurationEvent);

    }

As a consumer of such an event, you can examine the com.tibco.tea.agent.api.TeaLdapConfigurationEvent.TYPE to retrieve the com.tibco.tea.agent.api.LdapRealmConfig instance from the event object.
Note: com.tibco.tea.agent.api.LdapRealmConfig is available only for com.tibco.tea.agent.api.TeaLdapConfigurationEvent.TYPE.ADD and com.tibco.tea.agent.api.TeaLdapConfigurationEvent.TYPE.UPDATE types and not for the com.tibco.tea.agent.api.TeaLdapConfigurationEvent.TYPE.DELETE type of event. Refer to API documents of these classes for additional details.
The sample Tomcat Agent shipped with TIBCO Enterprise Administrator server contains a sample implementation of the interface in TomcatAgentLdapConfigListener and its registration using the addEventListener() method in TomcatAgentLauncher.

Did you find this helpful?

Yes No
Great!
Thanks for taking the time to give us some feedback.
Sorry about that

Why wasn't this helpful? (check all that apply)

Could not find what I was looking for
Instructions confusing or unclear
Instructions did not work

Want to tell us more?

Please select at least one option or provide details about the issue!!

Error occurred while submitting feedback.

Error2 occurred while submitting feedback.

TIBCO® Enterprise Administrator

Copyright © 1996-2025. Cloud Software Group, Inc. All Rights Reserved.