Copyright © TIBCO Software Inc. All Rights Reserved
Copyright © TIBCO Software Inc. All Rights Reserved


Chapter 1 Using the TIBCO Runtime Agent Authentication API : Common Aspects of the API

Common Aspects of the API
For more details on the objects and classes referenced in the section ahead, refer to the Javadocs as described in the section API Overview.
Objects and Factory
Two main objects are User and Role. The factory classes UserFactory and RoleFactory provide methods to retrieve the User and Role objects respectively.
AuthenticationSubject
An object of the AuthenticationSubject class represents an authenticated user, and contains such information as the user name, password, and whether or not the user is authenticated.
This is not used for validating the authentication for the username and password specified here. This is only used for such purposes as identifying the user or checking role memberships for a user. For information on checking authorization, refer to AuthUtils.
RoleMembershipConfig and RoleMembership
There are two major portions of the API: model and runtime. The model portion of the API deals with managing the configuration of the Object. The runtime portion of the API contains utilities you can use to compute something or take some action.
RoleMembershipConfig is the model component that provides details necessary for computing the membership of the role. RoleMembership is the runtime component that provides logic for computing the membership of a Role. The runtime portion of the API is generally useful only in the context of custom Role Membership Plug ins. You will not have the necessary context to run this runtime API in a command-line context.
AuthUtils
The model objects such as User and Role are purely data objects with no behavior exposed. This utility class exposes the behavior for these objects. For example, it provides role membership, taking into account the membership inherited from child roles.
The single instance of this utility class is obtained by calling instance().

Copyright © TIBCO Software Inc. All Rights Reserved
Copyright © TIBCO Software Inc. All Rights Reserved