Skip to main content
Version: NG-3.1

Accessing vuSmartMaps

Overview​

Accessing vuSmartMaps explains how users log in to the vuSmartMaps platform and start using the homepage after successful authentication. It covers secure login using username or email, password, and captcha; Multi-Factor Authentication (MFA), if enabled; password reset; password change; sign out; and key homepage controls such as the left navigation menu, license expiry indicator, user-specific timezone, alert pop-ups, Customer Service Panel, and Recently Viewed Pages.

To use vuSmartMaps, users need a modern internet browser. Chrome Version 109 or higher is recommended. Authentication helps protect platform access by allowing only authorized users to enter the system. After successful login and authentication, users are redirected to their personalized homepage, where they can access platform modules, view recently visited pages, check license status, adjust timezone preferences, and manage user-specific alert pop-up settings.

Use this chapter when users need to log in to vuSmartMaps for the first time, complete MFA, understand OTP behavior or OTP errors, reset a forgotten password, change the current password, sign out securely, open the homepage, use the left navigation menu, check license expiry details, update user-specific timezone, configure alert pop-ups, access the Customer Service Panel, or reopen recently viewed pages.

note

For example, a NOC engineer starting a shift can log in to vuSmartMaps, complete MFA if required, and use the left navigation menu to open the required monitoring pages such as Alert Console. From the homepage, the engineer can also check license expiry status, confirm the user-specific timezone, and configure alert pop-ups for important alerts.

Comprehensive Understanding​

Login Page​

The login page is shown when users open the vuSmartMaps URL in the browser.

The URL format is: https://a.b.c.d/vunet

Here, a.b.c.d represents the system IP address or domain name where vuSmartMaps is hosted.

The login page contains:

  • Username or email
  • Password
  • Captcha
  • Sign In button
  • Forgot password? option

The Username, Password, and Captcha fields are mandatory. Username is case-insensitive. Password is case-sensitive. Captcha confirms that the user is human and helps prevent automated attacks and brute-force attempts.

Multi-Factor Authentication Page​

After users enter the correct username and password, vuSmartMaps can show an authentication page if MFA is enabled.

The MFA page contains:

  • OTP input field
  • Verify button
  • Error messages such as Failed to send OTP or Invalid OTP

MFA adds an extra layer of security after password authentication.

Password Reset Pages​

The password reset flow starts from the Forgot password? option on the login page.

It includes:

  • A page to enter username or email.
  • A confirmation message after requesting reset instructions.
  • A password reset email with a reset link.
  • A page to enter and confirm a new password.

The reset link is valid for five minutes.

Change Password Page​

The Change password option is available from the Profile section in the top-right corner, if the administrator has granted permission.

The page contains:

  • Current password
  • New password
  • Confirm password
  • Change Password button

vuSmartMaps Homepage​

After successful login and authentication, users are redirected to the homepage. The homepage may differ from user to user based on dashboard requirements configured through User Management.

The homepage contains two main sections:

  • Customer Service Panel
  • Recently Viewed Pages

It also provides access to the left navigation menu and top-right user controls.

Left Navigation Menu​

The Toggle Menu at the top-left opens the left navigation menu. It provides access to platform modules and features. Menu visibility can depend on user roles. Admin users have complete access to menu navigation. End users must contact the administrator for additional access.

The source document lists these menu areas:

  • Home
  • Dashboards
    • Playlists
    • Snapshots
    • Library panels
  • Observability Hub
    • Alert Console
    • Reports
    • Data Explorer
    • Application Performance Monitoring
    • AI Explorer
    • Smart-Frames
  • Observability Studios
    • Notification Studio
    • Alert Configuration Studio
    • Reports Studio
    • UTM Studio
    • Insights Studio
    • Mobile Dashboards Studio
    • AI/ML Modelling Workspace
    • Data Modelling Workspace
    • AI Studio
    • Smart-Frame Studio
    • APM Studio
  • Integrations
    • O11ySources
    • Application Workbench
  • Data Studio
    • Tables & Data Storage
    • Data Retention
    • Data Sources
    • Data Enrichment
    • ContextStreams
    • Host Landscape
    • Extract Data
    • SNMP Definitions
  • Platform Settings
    • Definitions
    • Platform Configurations
    • User Federation
    • Resource Manager
    • Plugin Manager
    • Service Accounts
  • Account Management
    • Users & Roles
    • License Manager
    • About
  • Explore
  • Apps
    • vuSmartMaps
    • vuCoreML
    • vuLogDna

License Expiry Indicator​

The license expiry indicator appears in the top bar on the right-hand side. It becomes visible 90 days before license expiry.

When users click the indicator, a pop-up opens with more license expiry details. The indicator uses colors:

  • Yellow: 46 to 90 days remaining.
  • Amber: 45 or fewer days remaining.

Clicking the blue arrow in the pop-up opens the License Manager page.

User-Specific Timezone​

The user-specific timezone icon appears at the top-right corner. It shows the timezone set in the user profile. Users can change the timezone from Preferences. By default, it is set to Default. The selected timezone is displayed in the top-right corner of all pages.

The user-specific timezone controls how timestamp and datetime fields appear in the UI.

Alert Pop-ups​

Alert Pop-ups show real-time alerts with a buzzer sound. They help users notice critical system events quickly. Alert Pop-up settings covered in this document are user-specific settings. Global preferences are managed from Platform Configurations. Users can open user-specific Alert Pop-up settings from the top-right Admin section by going to Preferences > Alert Pop-ups.

The settings include:

  • Global Settings
  • Custom Settings
  • Conditions
  • Severity levels
  • Duration
  • Save

Global Settings applies global configurations. Custom Settings allows the user to override global settings and define user-specific alert pop-ups.

Customer Service Panel​

The Customer Service Panel on the homepage provides access to helpful resources. The source document specifically mentions: User Guide

Recently Viewed Pages​

Recently Viewed Pages shows the latest five pages visited by the logged-in user. This list is user-specific and helps users reopen pages without searching for them again.

Step-by-Step Instructions​

Log in to vuSmartMaps​

  1. Open Chrome Version 109 or higher.
  2. Enter the vuSmartMaps URL in this format:
    https://a.b.c.d/vunet
  3. On the login page, enter the Username or email.
  4. Enter the Password.
  5. Enter the Captcha.
  6. Click Sign In.
  7. After clicking Sign In, the system takes the user to the authentication page if MFA is enabled.
  8. After successful authentication, the user is redirected to the homepage.

Complete MFA Using SMS or Email OTP​

  1. Enter the correct username, password, and captcha.
  2. Click Sign In.
  3. The system sends a One-Time Password by SMS or email to the registered contact information.
  4. Enter the OTP within the allowed time frame.
  5. Click Verify.
  6. If the OTP is valid, the vuSmartMaps homepage opens.
  7. If the OTP is invalid, the screen displays Invalid OTP.
  8. If the OTP is entered incorrectly three times, it expires.
  9. If the OTP is not used within the assigned time, it expires.
  10. After multiple incorrect attempts, request a new OTP.

The OTP expiration time and the limit for incorrect attempts can be configured by the admin in MFA settings.

If an SMS or email OTP is entered incorrectly three times, it expires. Request a new OTP after multiple incorrect attempts or expiry.

Handle OTP Sending Failure​

If OTP sending fails, the screen displays: Failed to send OTP

OTP sending can fail when:

  • The OTP server is unavailable or down.
  • The server fails to send the OTP to the registered mobile number or email.

If this happens, try again after some time or contact the administrator.

Complete MFA Using an Authenticator App​

  1. Enter the correct username, password, and captcha.
  2. Click Sign In.
  3. Open the configured third-party authenticator app.
  4. Use the OTP generated by the app.
  5. Enter the OTP in vuSmartMaps.
  6. Click Verify.
  7. If the OTP is valid, the homepage opens.

Authenticator app OTPs do not expire like SMS or email-based OTPs.

Examples of authenticator apps mentioned in the source document are:

  • Google Authenticator
  • Microsoft Authenticator

Understand Authentication Configuration​

Authentication in vuSmartMaps is configurable. Organizations can enforce security policies based on their needs.

The authentication setup includes:

  1. User Credential Verification: Username and password are validated against the system authentication service.
  2. MFA Activation: If MFA is enabled, users must authenticate with an additional factor such as SMS/email OTP or authenticator app OTP.
  3. OTP Configuration: Admins can adjust OTP expiration times and retry limits. SMS/email delivery failures are shown to users. Authenticator app OTPs remain valid without expiration constraints.
  4. Session Management: After successful authentication, a secure session token is issued to maintain access during the session.
  5. Error Handling and Alerts: Users are notified about invalid OTP attempts and can request a new OTP if needed.

If Captcha or MFA is not visible or enabled on the login screen, contact the system administrator. These features are configurable and may be enabled or disabled based on the organization's security policies.

Reset a Forgotten Password​

  1. Go to the login page.
  2. Click Forgot password?.
  3. Enter the username or email address.
  4. Submit the request.
  5. A confirmation message appears at the top, indicating that an email with reset instructions has been sent.
  6. Open the email and click the password reset link.
  7. Enter the new password.
  8. Re-enter the new password to confirm it.
  9. Click Submit.
  10. After submitting, the password is reset.
  11. The system redirects the user to the login page.

The password reset link is valid for five minutes.

Configure SMTP for Password Reset Emails​

This section is for administrators only.

NG vuSmartMaps uses Keycloak for Identity and Access Management. Password reset emails are handled through Keycloak. To allow users to receive password reset links through the Forgot password? option, an SMTP server must be configured in Keycloak. If Gmail is used as the SMTP provider, a Gmail App Password is required when 2-Step Verification is enabled.

To configure SMTP with Gmail:

  1. Enable 2-Step Verification in Gmail.
  2. Go to myaccount.google.com.
  3. Open the Security section.
  4. Enable 2-Step Verification, if it is not already enabled.
  5. Go to myaccount.google.com/apppasswords.
  6. Sign in if prompted.
  7. Under App name, enter Keycloak.
  8. Click Create.
  9. Copy the 16-character App Password immediately. It will not be shown again.
  10. Log in to the Keycloak Admin Console.
  11. Select the required realm. The source document gives vunet as an example.
  12. Go to Realm Settings > Email.
  13. Configure these fields:
    • From: yourname@gmail.com
    • Host: smtp.gmail.com
    • Port: 587
    • Enable StartTLS: ON
    • Username: yourname@gmail.com
    • Password: Use the 16-character App Password generated earlier.
  14. Click Save before testing the connection.
  15. After saving, click Test Connection to verify the SMTP configuration.

The Test Connection option remains unavailable until the email configuration is saved.

Change Password​

  1. Go to the top-right corner of the platform.
  2. Open the Profile section.

  1. Go to Change password.
  2. Enter the Current password.
  3. Enter the New password.
  4. Confirm the new password.
  5. Click Change Password.

This helps confirm the authenticity of the request and improves security.

Users can change the password only if the administrator has granted permission. The system administrator can disable password change functionality for end users.

Sign Out​

  1. Go to the top-right corner of the platform.
  2. Click Sign out.
  3. The user is signed out of the platform.

Access the Homepage​

  1. Open the left navigation menu.
  2. Go to App > vuSmartMaps.
  3. Click vuSmartMaps.
  4. The homepage opens.

The homepage may differ by user based on user-specific dashboard requirements. This configuration is managed through User Management.

Use the Left Navigation Menu​

  1. Click the Toggle Menu at the top-left corner.
  2. Review the list of available menu items.
  3. Click the required module or feature.
  4. The selected page opens.

Menu access is based on user roles. Admin users have complete access. End users should contact the administrator for additional access.

View License Expiry Details​

  1. Check the top-right area of the top bar.
  2. If the license is within 90 days of expiry, the license expiry indicator appears.
  3. Click the indicator.
  4. A pop-up opens with detailed license expiry information.
  5. Use the color indicator to understand urgency:
    • Yellow: 46 to 90 days remaining.
    • Amber: 45 or fewer days remaining.
  6. Click the blue arrow in the pop-up to open the License Management page.

Change User-Specific Timezone​

  1. Go to the top-right corner.
  2. Open Preferences.
  3. Open the user-specific timezone setting.
  4. Select the desired timezone from the User Specific Timezone dropdown.
  5. Click Save.
  6. The selected timezone appears in the top-right corner of all pages.

By default, the user-specific timezone is set to Default. All timestamp and datetime fields shown in the UI are displayed according to the selected user-specific timezone.

Configure Alert Pop-ups​

  1. Go to the top-right Admin section.
  2. Click Preferences.
  3. Select Alert Pop-ups.
  4. The user-specific Alert Pop-ups settings modal opens.
  5. Choose one of the configuration options:
    • Select Global Settings to apply global configurations.
    • Select Custom Settings to define user-specific settings and override global settings.
  6. If using Custom Settings, enable Custom Settings. This must be enabled for pop-ups to work.
  7. Define conditions for triggering pop-ups based on severity levels.
  8. Enter conditions in JSON format.
  9. Set the duration:
    • Persistent: Pop-up remains visible until manually dismissed.
    • Timeout: Pop-up closes automatically after the defined duration.
  10. Click Save.
  11. A toast message confirms: Alert Pop-Ups configuration updated!
note

By default, the Global Settings Alert Pop-Ups option is disabled. To use global settings, ensure that Alert Pop-ups are enabled in Platform Configurations.

By default, the Custom Settings Pop-Up option is disabled. Users must enable it manually to receive alert notifications.

Example JSON format:

{"keywords": "IMPS, not found", "severity": "Critical"}, 
{"keywords": "Delay, timeout", "severity": "Error"}

Supported severity levels are:

  • Critical: Red
  • Error: Orange
  • Warning: Yellow
  • Information: Green
To receive user-specific alert pop-ups, enable Custom Settings and save the configuration from Preferences > Alert Pop-ups.

Use the Customer Service Panel​

  1. Open the vuSmartMaps homepage.
  2. Locate the Customer Service Panel.
  3. Use the available link to open the User Guide.

Use Recently Viewed Pages​

  1. Open the vuSmartMaps homepage.
  2. Locate the Recently Viewed Pages section.
  3. Review the latest five pages visited.
  4. Click a page name to revisit it.

Recently viewed pages are specific to the logged-in user.

note

If MFA or Captcha is not visible, the feature may not be enabled for the organization. Users should contact the system administrator.

If the homepage differs between users, it may be due to user-specific dashboard requirements configured through User Management.

Troubleshooting​

  1. Issue: Login page does not accept credentials.

    • Possible cause: Username, password, or captcha may be incorrect.
    • Solution: Re-enter all mandatory fields. Remember that username is case-insensitive, but password is case-sensitive.

  2. Issue: Captcha or MFA is not visible on the login screen.

    • Possible cause: Captcha or MFA may not be enabled for the organization.
    • Solution: Contact the system administrator. These features are configurable and may be enabled or disabled based on organizational security policies.

  3. Issue: OTP is invalid.

    • Possible cause: The entered OTP is incorrect.
    • Solution: Re-enter the correct OTP. If multiple incorrect attempts occur with SMS/email OTP, the OTP expires and a new OTP must be requested.

  4. Issue: OTP expired.

    • Possible cause: The OTP was not used within the assigned time or was entered incorrectly three times.
    • Solution: Request a new OTP.

  5. Issue: OTP was not received.

    • Possible cause: OTP server may be unavailable, or the server may have failed to send OTP to the registered mobile number or email.
    • Solution: Try again after some time or contact the administrator.

  6. Issue: Password reset email is not received.

    • Possible cause: SMTP may not be configured correctly in Keycloak.
    • Solution: Admin should configure SMTP settings in Keycloak and test the connection after saving the email configuration.

  7. Issue: Test Connection is unavailable in Keycloak email settings.

    • Possible cause: Email configuration has not been saved.
    • Solution: Click Save first. Then use Test Connection.

  8. Issue: Password reset link does not work.

    • Possible cause: The reset link may have expired.
    • Solution: Request a new reset link. The password reset link is valid for five minutes.

  9. Issue: User cannot change password.

    • Possible cause: Administrator may not have granted permission to change password.
    • Solution: Contact the system administrator.

  10. Issue: User cannot access some left navigation menu items.

    • Possible cause: Menu access is restricted based on user roles.
    • Solution: Contact the administrator for additional access.

  11. Issue: Alert pop-ups are not appearing.

    • Possible cause: Custom Settings may be disabled, or global Alert Pop-ups may not be enabled in Platform Configurations.
    • Solution: Enable Custom Settings for user-specific pop-ups. For global settings, ensure Alert Pop-ups are enabled in Platform Configurations.

  12. Issue: Timestamps appear in an unexpected timezone.

    • Possible cause: User-specific timezone may be set to a different value or left as Default.
    • Solution: Go to Preferences, select the required timezone, and click Save.

FAQs​

Which browser should be used to access vuSmartMaps?

vuSmartMaps requires a modern internet browser. The document recommends using Chrome Version 109 or higher.

What is the URL format for accessing vuSmartMaps?

The vuSmartMaps URL is usually in this format:

https://a.b.c.d/vunet

Here, a.b.c.d represents the system IP address or domain name where vuSmartMaps is hosted.

What details are required to log in?

Users must enter the Username or email, Password, and Captcha on the login page. All three fields are mandatory.

Is the username case-sensitive?

No. The Username is case-insensitive. However, the Password is case-sensitive.

Why is Captcha shown on the login page?

Captcha confirms that the user is human. It helps prevent automated attacks and brute-force login attempts.

What is MFA in vuSmartMaps?

Multi-Factor Authentication (MFA) adds an extra security step after username and password verification. Users must verify their identity using an OTP through SMS/email or an authenticator app.

What MFA methods are supported?

The document mentions two MFA methods:

  • SMS/Email-based OTP
  • Authenticator App OTP, such as Google Authenticator or Microsoft Authenticator
What happens if I enter the SMS or email OTP incorrectly?

If the OTP is entered incorrectly three times, it expires. A new OTP must then be requested.

What should I do if OTP sending fails?

If OTP sending fails, the screen displays "Failed to send OTP." This can happen if the OTP server is unavailable or if the server cannot send the OTP to the registered mobile number or email. Users can try again later or contact the administrator.

Do authenticator app OTPs expire?

No. The document states that OTPs generated using an authenticator app do not expire like SMS or email OTPs.

How can I reset my password?

On the login page, click Forgot password?, enter the username or email, and follow the reset instructions sent by email. The password reset link is valid for five minutes.

Why am I not receiving the password reset email?

Password reset emails are handled through Keycloak. If users are not receiving reset emails, the SMTP server may not be configured correctly. An administrator must configure SMTP in the Keycloak Admin Console.

Can every user change their password?

No. Users can change their password only if the administrator has granted permission. The administrator can disable password change functionality for end users.

What does the License Expiry Indicator show?

The License Expiry Indicator appears 90 days before license expiry on the top-right side of the top bar. It uses yellow for 46 to 90 days remaining and amber for 45 or fewer days remaining. Clicking the blue arrow in the pop-up opens the License Management page.

What are Recently Viewed Pages?

Recently Viewed Pages shows the latest five pages visited by the logged-in user. This helps users return to recently used pages without searching for them again.