com.ibm.itim.apps

Interface PlatformContext

  • All Known Implementing Classes:
    InitialPlatformContext


    public interface PlatformContext
    Interface representing a client context with the provisioning platform. A context must be established with the platform before any users can make use of the platform's applications. Users must be authenticated to the platform individually. However, the platform itself also requires that the client of the applications at a system level must also authenticate. This authentication is performed at the the platform context level. Since the client may be remote, network location information will also be required.
    • Field Summary

      Fields 
      Modifier and Type Field and Description
      static java.lang.String PLATFORM_CREDENTIALS
      Property name of the principal's authentication credentials.
      static java.lang.String PLATFORM_PRINCIPAL
      Property name of the system level calling principal of the context.
      static java.lang.String PLATFORM_REALM
      Property name of the principal's realm.
      static java.lang.String PLATFORM_URL
      Platform URL property name.
    • Method Summary

      All Methods Instance Methods Abstract Methods 
      Modifier and Type Method and Description
      void close()
      Closes the platform context, freeing up any system resources that may have been allocated for the context.
      java.util.Hashtable getEnvironment()
      Returns the environment the client used to define the context.
      java.lang.Object getEnvProperty(java.lang.Object propertyName)
      Returns the environment property with the given name.
      java.lang.Long getID()
      Returns the unique identifier of the platform context.
    • Field Detail

      • PLATFORM_URL

        static final java.lang.String PLATFORM_URL
        Platform URL property name. The value of the constant is enrole.appServer.url.
        See Also:
        Constant Field Values
      • PLATFORM_PRINCIPAL

        static final java.lang.String PLATFORM_PRINCIPAL
        Property name of the system level calling principal of the context. The value of the constant is enrole.appServer.ejbuser.principal.
        See Also:
        Constant Field Values
      • PLATFORM_CREDENTIALS

        static final java.lang.String PLATFORM_CREDENTIALS
        Property name of the principal's authentication credentials. The value of the constant is enrole.appServer.ejbuser.credentials.
        See Also:
        Constant Field Values
      • PLATFORM_REALM

        static final java.lang.String PLATFORM_REALM
        Property name of the principal's realm. The value of the constant is enrole.appServer.realm.
        See Also:
        Constant Field Values
    • Method Detail

      • getEnvironment

        java.util.Hashtable getEnvironment()
        Returns the environment the client used to define the context.
        Returns:
        Hashtable holding the environment parameters.
      • getEnvProperty

        java.lang.Object getEnvProperty(java.lang.Object propertyName)
        Returns the environment property with the given name.
        Parameters:
        propertyName - Name of the property to retrieve.
        Returns:
        Object representing the property value.
      • getID

        java.lang.Long getID()
        Returns the unique identifier of the platform context. This identitifer is generated and used by the identity platform itself.
        Returns:
        Unique ID of the context.
      • close

        void close()
        Closes the platform context, freeing up any system resources that may have been allocated for the context. Failure to close platform contexts may result in the resource unavailability and the degredation of performance over time.