Interface IRemoteSessionControl

  • public interface IRemoteSessionControl
    Interface that the framework session uses to perform functions on the client side.

    This interface is only intended to be used by the framework.

    Christopher Mindus
    • Method Detail

      • triggerUnlockCheck

        void triggerUnlockCheck​(int serial)
        Triggers a check for unlock event to the client side. Do not call this method, it is intended for the communications framework.
        serial - The serial.
      • triggerRemoteOpenWindow

        boolean triggerRemoteOpenWindow​(java.lang.String url,
                                        java.lang.String target,
                                        WindowOptions options,
                                        IWindowCloseListener windowListener)
        Triggers opening of a browser window on the client.
        url - The URL to open.
        target - The target, null for _blank.
        options - Options to use, null for "new tab" for a browser client.
        windowListener - Callback to listen to blocked or user close window, null for none.
        true for success, false if the window cannot be opened because another window already is open or that the session is disposed of. In case of failure, any callback close listener will not be invoked.
      • triggerRemoteCloseWindow

        boolean triggerRemoteCloseWindow​(boolean ignoreCallbackListener)
        Triggers closing of the window on the client that was opened with triggerRemoteOpenWindow.
        ignoreCallbackListener - Flag to ignore calling a potential callback listener.
        true for success, false if no open window is present.
      • assignAuthenticatedUser

        void assignAuthenticatedUser​(java.lang.String userName,
                                     java.lang.String hashPW)
        Changes the authenticated user to be used the next time the client is started.
        userName - The user name.
        hashPW - The hashed password. It is based on PBKDF2 with Keyed-Hash Message Authentication Code (HMAC) with a SHA-256 hash. It can start with "EXTERNAL:" if the user has signed in using an external Sign In Provider, e.g. LinkedIn or Facebook, the remaining part of the string identifies the provider and the users identifier for that provider.
      • sendStat

        void sendStat​(java.lang.String event,
                      DeviceParameter... params)
        Sends statistics event to the analytics engine on the client to log the event.
        event - The event name.
        params - Parameters to send, null values and sensitive parameters are ignored.
      • saveDeviceParameters

        boolean saveDeviceParameters​(ISensitiveParameterHandler sensitive,
                                     DeviceParameter... params)

        This method is only supported on devices running iiziRun and will always fail for other devices.

        Sensitive parameters are encrypted with a key kept on the server side. The encrypted data is padded and sent to the client and no key is used on the client side. Only the fingerprint of the server key used is included in the encrypted data. This means that the sensitive parameter is virtually undecipherable on the client side.

        sensitive - Processor for sensitive information.
        params - Parameters to save. A value of null means that the value is removed from storage.
        true for success, false for failure (or no parameters to save). In case of failure, an error is logged in the server.
      • getDeviceParameters

        boolean getDeviceParameters​(ISensitiveParameterHandler sensitive,
                                    DeviceParameter... params)
        Retrieves parameters from the device. The variables values and state are filled in before the return of this method call. The state indicates success, some error or if the parameter is not found.

        This method will always fail if the device is not running with iiziRun.

        sensitive - Processor for sensitive information.
        params - The parameter to retrieve.
        true for success, false if iiziRun is not present and device parameters are not present.