Interface MasterProxy
public interface MasterProxy
The Interface MasterProxy.
-
Method Summary
Modifier and TypeMethodDescriptionlongfindSubscriberIdByPassword(String inuId, String password) Find the PSB_ID of the active subscriber matching the given password for the given IncomingUser.Gets the data file access interface.getDestination(String name) Gets the destination.getECauthToken(String user) Gets the ecauth token.getIncomingProfile(String incomingUser, String incomingPassword, String from) Gets the incoming profile.getIncomingProfileNoAuth(String incomingUser) Returns a freshIncomingProfilefor an already-authenticated user, without re-running credential validation, TOTP, connection-count checks, or last-login updates.getPortalSubscriberEmail(long psbId) Get the email address of the portal subscriber with the given PSB_ID.voidinvalidatePortalSessionAcrossMovers(String token, String excludeMoverName) Broadcast a portal session token invalidation to all connected data movers except the calling one.booleanisSubscriberActive(long psbId) Check whether a specific portal subscriber is still active.booleanisValidDataFile(long dataFileId) Checks if is valid data file.longproxyHostIsAlive(String name) Proxy host is alive.voidreleaseConnectionSlot(String incomingUser) Releases a pending connection slot for the given user.resolvePortalSessionAcrossMovers(String token, String excludeMoverName) Ask the Master to locate a portal session token on any currently connected data mover other than the requesting one.voidsendMessage(String name, String service, int status, String message) Sends the message.voidshutdown()Shutdown.voidupdateData(Host host) Update data.voidupdateData(String hostId, String data) Update data.voidupdateDataTransfers(DataTransfer[] transfers) Update data transfers.updateDownloadProgress(DownloadProgress[] progress) Update download progress.voidupdateLocation(Host host) Update location.
-
Method Details
-
shutdown
void shutdown()Shutdown. -
updateDataTransfers
Update data transfers.- Parameters:
transfers- the transfers- Throws:
Exception- the exception
-
updateDownloadProgress
Update download progress.- Parameters:
progress- the progress- Returns:
- the list of DownloadProgress to interrupt (not found on the MasterServer)
- Throws:
Exception- the exception
-
proxyHostIsAlive
-
updateData
-
updateData
-
updateLocation
-
sendMessage
-
getDataFileAccessInterface
Gets the data file access interface.- Returns:
- the data file access interface
- Throws:
Exception- the exception
-
getDestination
Gets the destination.- Parameters:
name- the name- Returns:
- the destination
- Throws:
Exception- the exception
-
isValidDataFile
-
getIncomingProfile
IncomingProfile getIncomingProfile(String incomingUser, String incomingPassword, String from) throws Exception Gets the incoming profile.- Parameters:
incomingUser- the incoming userincomingPassword- the incoming passwordfrom- the from- Returns:
- the incoming profile
- Throws:
Exception- the exception
-
getIncomingProfileNoAuth
Returns a freshIncomingProfilefor an already-authenticated user, without re-running credential validation, TOTP, connection-count checks, or last-login updates. Used to refresh user settings (e.g. portal.color, portal.maxConnections) from INU_DATA for an existing portal session.- Parameters:
incomingUser- the incoming user id- Returns:
- the incoming profile
- Throws:
Exception- the exception
-
isSubscriberActive
Check whether a specific portal subscriber is still active. Lightweight single-row lookup by primary key — used on cookie re-auth to detect deactivated subscribers without a full password re-validation round-trip.- Parameters:
psbId- the PortalSubscriber primary key- Returns:
trueif the subscriber exists and is active- Throws:
Exception- the exception
-
findSubscriberIdByPassword
Find the PSB_ID of the active subscriber matching the given password for the given IncomingUser. Returns -1 if not found.- Parameters:
inuId- the IncomingUser loginpassword- the subscriber password- Returns:
- the subscriber's PSB_ID, or
-1if not found - Throws:
Exception- the exception
-
getPortalSubscriberEmail
Get the email address of the portal subscriber with the given PSB_ID. Returns an empty string if the subscriber does not exist or has no email recorded.- Parameters:
psbId- the portal subscriber PSB_ID- Returns:
- the subscriber email, or an empty string if not found
- Throws:
Exception- the exception
-
releaseConnectionSlot
-
resolvePortalSessionAcrossMovers
Ask the Master to locate a portal session token on any currently connected data mover other than the requesting one. Used after a load-balancer failover to migrate a session from one mover to another without forcing the user to re-authenticate.- Parameters:
token- the portal session token to search forexcludeMoverName- the name of the calling mover (excluded from the search to avoid a self-lookup round-trip)- Returns:
- the serialised session entry (tab-separated
user\tsubscriberId\tsubscriberEmail\texpiryEpochMs), ornullif the token is not found on any other mover - Throws:
Exception- the exception
-
invalidatePortalSessionAcrossMovers
Broadcast a portal session token invalidation to all connected data movers except the calling one. Used after user-initiated logout to evict imported tokens from any mover that received the token via cross-mover migration.- Parameters:
token- the portal session token to invalidateexcludeMoverName- the name of the calling mover (already invalidated locally)- Throws:
Exception- the exception
-
getECauthToken
Gets the ecauth token.- Parameters:
user- the user- Returns:
- the ecauth token
- Throws:
Exception- the exception
-