{"id":22184,"date":"2026-07-28T09:29:15","date_gmt":"2026-07-28T09:29:15","guid":{"rendered":"https:\/\/tenthplanet.in\/idempiere\/?p=22184"},"modified":"2026-08-13T04:51:04","modified_gmt":"2026-08-13T04:51:04","slug":"how-to-use-the-active-session-window-in-idempiere","status":"publish","type":"post","link":"https:\/\/tenthplanet.in\/idempiere\/how-to-use-the-active-session-window-in-idempiere\/","title":{"rendered":"How to Use Active Session in iDempiere"},"content":{"rendered":"\n

Learn how the Active Session window works in iDempiere \u2014 monitor live logins, view user, role and connection details in real time.<\/p>\n\n\n\n

Introduction<\/strong><\/h2>\n\n\n\n

The Active Session window in iDempiere displays all user logins that are currently active on the system. It is a read-only monitoring window used by administrators to verify who is logged in, from which machine, and on which application server.<\/p>\n\n\n\n

By providing real-time visibility into active logins, the window helps administrators confirm system usage, investigate connectivity issues, and decide when to review historical session data.<\/p>\n\n\n\n

Process Flow<\/strong><\/h2>\n\n\n\n
\"\"<\/figure>\n\n\n\n

Business Rules<\/strong><\/h2>\n\n\n\n
    \n
  • A new session record is created automatically for every successful iDempiere login.<\/li>\n\n\n\n
  • Each login generates a unique Session ID, even for the same user logging in twice.<\/li>\n\n\n\n
  • Only unprocessed sessions (Processed = ‘N’) are displayed in this window.<\/li>\n\n\n\n
  • When a user logs out, the session is marked processed and disappears from this window.<\/li>\n\n\n\n
  • All fields in this window are read-only; no data can be entered or edited here.<\/li>\n\n\n\n
  • Session data is retrieved from a database view, not directly from the session table.<\/li>\n\n\n\n
  • Multiple users can appear simultaneously when multiple active sessions exist.<\/li>\n\n\n\n
  • The Login Date reflects the ERP business date, not the exact login time.<\/li>\n\n\n\n
  • Historical or completed sessions are not shown here; they appear in Session Audit.<\/li>\n<\/ul>\n\n\n\n

    Prerequisites<\/strong><\/h2>\n\n\n\n
      \n
    • User must have System Administrator or equivalent role-based access to Security windows.<\/li>\n\n\n\n
    • The Active Session window must be accessible from the System Admin menu tree.<\/li>\n\n\n\n
    • At least one active user login must exist for records to appear in the window.<\/li>\n\n\n\n
    • Standard iDempiere Role and Client\/Organization setup must be completed for accurate display of Tenant, Organization and Role fields.<\/li>\n<\/ul>\n\n\n\n

      Configuration Steps<\/strong><\/h2>\n\n\n\n

      Since the Active Session window is a read-only monitoring window, the following steps describe how to navigate to it and interpret the information it displays.<\/p>\n\n\n\n

      Step 1: Open the Active Session Window<\/strong><\/h3>\n\n\n\n

      This step is required to access real-time session monitoring data.<\/p>\n\n\n\n

      Navigate to System Admin \u2192 General Rules \u2192 Security \u2192 Active Session. The window opens and lists all currently active login sessions retrieved from the system.<\/p>\n\n\n\n

      \"\"<\/figure>\n\n\n\n

      Step 2: Review Session Identification Details<\/strong><\/h3>\n\n\n\n

      This step helps confirm which user, tenant, organisation and role are associated with the session.<\/p>\n\n\n\n

      Check the Tenant Name, Organization Name, User Name, Login Role and Email Address fields to identify the account behind the active session.<\/p>\n\n\n\n

      Field<\/strong><\/td>Sample Value<\/strong><\/td>Description<\/strong><\/td><\/tr><\/thead>
      Tenant Name<\/td>System<\/td>Tenant in which the user is currently logged in.<\/td><\/tr>
      Organization Name<\/td>*<\/td>Organisation selected during login; blank if logged in at System\/all-org level.<\/td><\/tr>
      User Name<\/td>Praveen<\/td>Display name of the logged-in user.<\/td><\/tr>
      Login Role<\/td>System Administrator<\/td>Security role used during login; determines user permissions.<\/td><\/tr>
      Email Address<\/td>superuser@idempiere.com<\/td>Email address of the logged-in user.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

      Step 3: Review Connection and Server Details<\/strong><\/h3>\n\n\n\n

      This step is required to identify the source machine and application server handling the session.<\/p>\n\n\n\n

      Review the Remote Address, Remote Host, Server Name and Web Session fields to determine where the user connected from and which server is servicing the session.<\/p>\n\n\n\n

      Field<\/strong><\/td>Sample Value<\/strong><\/td>Description<\/strong><\/td><\/tr><\/thead>
      Remote Addr<\/td>192.168.0.193<\/td>IP address of the client machine from which the user connected.<\/td><\/tr>
      Remote Host<\/td>192.168.0.193<\/td>Client host name or IP address, used for network identification.<\/td><\/tr>
      Server Name<\/td>tpt034:192.168.0.113<\/td>Application server currently servicing the session.<\/td><\/tr>
      Web Session<\/td>zkwebui<\/td>Identifies the WebUI browser connection context for the session.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

      These values are useful in clustered or multi-server deployments to trace which server handled a login.<\/p>\n\n\n\n

      Step 4: Review Session Timestamps<\/strong><\/h3>\n\n\n\n

      This step confirms when the session was created and last updated.<\/p>\n\n\n\n

      Check the Login Date, Created and Updated fields to understand the session timeline.<\/p>\n\n\n\n

      Field<\/strong><\/td>Sample Value<\/strong><\/td>Description<\/strong><\/td><\/tr><\/thead>
      Login date<\/td>07\/28\/2026 12:00:00 AM<\/td>ERP business date associated with the login.<\/td><\/tr>
      Created<\/td>07\/28\/2026 11:50:09 AM<\/td>Actual date and time the session record was created.<\/td><\/tr>
      Updated<\/td>07\/28\/2026 11:50:09 AM<\/td>Last time the session record was updated.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

      The Login Date always displays 12:00:00 AM as it stores only the business date, while Created records the exact login time.<\/p>\n\n\n\n

      Step 5: Verify Session Status<\/strong><\/h3>\n\n\n\n

      This step confirms whether the session is status and reviews any additional session notes.<\/p>\n\n\n\n

      Field<\/strong><\/td>Sample Value<\/strong><\/td>Description<\/strong><\/td><\/tr><\/thead>
      Session<\/td>Praveen_1002014<\/td>Unique identifier combining user name and session ID.<\/td><\/tr>
      Active<\/td>Checked<\/td>Indicates the session record is currently active.<\/td><\/tr>
      Description<\/td>Release 13_2026-03-09 iDempiere<\/td>Additional information recorded when the session was created.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

      When a user logs out, Processed is updated to ‘Y’ and the record no longer appears in this window.<\/p>\n\n\n\n

      Common Issues and Resolutions<\/strong><\/h2>\n\n\n\n
      Issue<\/strong><\/td>Cause<\/strong><\/td>Resolution<\/strong><\/td><\/tr><\/thead>
      Session not visible in the window<\/td>The session has already been processed (Processed = ‘Y’).<\/td>Check the Session Audit window for historical session records.<\/td><\/tr>
      Login Date differs from Created time<\/td>Login Date stores the ERP business date, not the exact login timestamp.<\/td>Refer to the Created field for the precise login time.<\/td><\/tr>
      Remote Host shows the same value as Remote Address<\/td>DNS host name resolution is unavailable in the network.<\/td>Configure DNS resolution, or treat the IP address as the host identifier.<\/td><\/tr>
      Web Session always shows ‘zkwebui’<\/td>The field stores the WebUI application context, not a unique browser ID.<\/td>Use the Session field to distinguish between individual user sessions.<\/td><\/tr>
      Organization Name appears blank<\/td>The user logged in at the System tenant or an all-organization context.<\/td>This is expected standard behaviour; no action is required.<\/td><\/tr>
      Session still visible after logout<\/td>The logout request has not yet updated the Processed flag.<\/td>Refresh the window; the session should disappear once processing completes.<\/td><\/tr>
      Cannot find the Active Session menu item<\/td>The logged-in user does not have System Administrator access.<\/td>Log in with a role that has access to System Admin \u2192 Security windows.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

      Next Steps<\/strong><\/h2>\n\n\n\n
        \n
      • Review the corresponding Session Audit record after the session ends.<\/li>\n\n\n\n
      • Analyse related Change Audit entries associated with the session.<\/li>\n\n\n\n
      • Investigate user activity using the recorded Session ID.<\/li>\n\n\n\n
      • Use the session information to troubleshoot login or connectivity issues.<\/li>\n<\/ul>\n\n\n\n

        <\/p>\n","protected":false},"excerpt":{"rendered":"

        Learn how the Active Session window works in iDempiere \u2014 monitor live logins, view user, role and connection details in […]<\/p>\n","protected":false},"author":3,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[10,91],"tags":[],"class_list":["post-22184","post","type-post","status-publish","format-standard","hentry","category-idempiere-product","category-idempiere-general-rules"],"_links":{"self":[{"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/posts\/22184","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/users\/3"}],"replies":[{"embeddable":true,"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/comments?post=22184"}],"version-history":[{"count":5,"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/posts\/22184\/revisions"}],"predecessor-version":[{"id":22237,"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/posts\/22184\/revisions\/22237"}],"wp:attachment":[{"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/media?parent=22184"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/categories?post=22184"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/tags?post=22184"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}