Account Setup

This guide walks you through setting up your VALAR account, managing your profile, inviting team members, and understanding access permissions.

​

Initial Account Setup

Your first experience with VALAR is completely automated with no manual configuration required. When you navigate to your VALAR URL, you’ll be automatically redirected to the secure login page. After authenticating with existing credentials or creating a new account, the platform handles everything behind the scenes. The system creates your profile using information from your identity provider (name, email, and profile picture), assigns you to your organization, sets up notification preferences, and redirects you to the dashboard. You’re ready to start working immediately upon successful authentication.

​

Managing Your Profile

Access your profile settings through the Settings button in the sidebar footer or navigation menu. In the Configuration Dialog that opens, click Profile under the Organization section.

​

Editing Profile Information

Click the pencil icon in the top-right corner of the Profile section to enter edit mode. All editable fields become active, allowing you to update your information. Profile Picture accepts a valid HTTP or HTTPS URL pointing to your image. The system displays a live preview as you type. Full Name is required and cannot be empty; this is how you’ll appear to other team members. Your Username is read-only and derived from your identity provider profile, so it cannot be changed through the interface. Email Address must be in valid email format and is required for communications and notifications. After making changes, click the Save button (which replaces the edit icon). The system validates your input automatically. Successful updates show a “Profile updated successfully” confirmation, while any validation errors appear below the affected fields.

​

Changing Your Password

The Password Management section appears below your profile information. Click the “Change Password” button (marked with a key icon) to initiate the process. This opens a secure password change page in a new tab, where you’ll complete the password update flow. The authentication ticket is valid for 5 days and can only be used once. Password changes are handled entirely by the identity provider’s secure system. The VALAR frontend never processes password data directly.

​

Inviting Team Members

To invite new members to your organization, open Settings and navigate to Members under the Organization section. Click the “Invite Member” button in the top-right corner (marked with a + icon). The invitation form requires two pieces of information: the invitee’s full name (how they’ll appear in the system) and their email address (where the invitation will be sent). After filling in these required fields, click “Send Invitation.” The button displays “Sending…” while processing your request. Upon successful invitation, the dialog closes and shows a “Member invited successfully” confirmation. The members list refreshes automatically to display the new invitee, and the system sends an invitation email to the provided address.

​

Invitation Workflow

The invitee receives an email containing an invitation link. Clicking this link redirects them to the authentication page where they create an account or log in with existing credentials. Upon successful authentication, they’re automatically added to your organization and their status changes from “Inactive” to “Active.” During this process, the invited person appears in your Members table with an “Inactive” status badge, allowing you to track whether they’ve accepted the invitation. You can resend the invitation at any time if needed.

​

Managing Team Members

The Members section displays your entire organization team in a searchable, sortable table. Each entry shows the member’s name, email address, status badge (Active in green or Inactive in red), last login timestamp, and available management actions. Use the search box at the top-left to filter members by name or email in real-time. Click any column header to sort by that field, or click again to reverse the sort order. Visual indicators show the current sort direction.

​

Understanding Member Status

Active members (green badge) have accepted their invitation and logged in at least once. They have full access to the application. The Last Login column shows when they most recently accessed the platform, and the Actions column provides a “Remove” button. Inactive members (red badge) have been invited but haven’t accepted yet. They cannot access the application until they complete the invitation flow. The Last Login column shows “Never,” and the Actions column provides both “Resend Invite” and “Remove” buttons.

​

Resending Invitations

For inactive members who haven’t accepted their invitation, click the “Resend Invite” button in the Actions column. This triggers a new invitation email and displays a success confirmation. Resending is useful when the original email wasn’t received, was deleted, or when the member needs a reminder.

​

Removing Members

To remove a member from your organization, locate them in the table (using search if necessary) and click the “Remove” button in the Actions column. The system displays a “Member removed successfully” confirmation and automatically refreshes the members table.

​

Permissions and Access Control

VALAR uses a scope-based permission model managed through the identity provider rather than traditional role hierarchies. All organization members receive the same base set of permissions, which includes authentication scopes (openid, profile, email, offline_access), profile management permissions (read and update own profile), and resource access permissions across measurements, ephemeris, maneuvers, and orbit solutions. All authenticated users can perform read, write, and delete operations on these resources. Special permissions exist for maneuver plan operations, including the ability to create, read, update, and approve automated maintenance plans. Currently, any authenticated user in your organization can invite new members. There’s no admin-only restriction on the invitation feature. However, the API may enforce additional permission checks server-side depending on your organization’s configuration.

​

Troubleshooting Common Issues

​

Authentication Problems

If you’re stuck on the login screen, clear your browser cache and localStorage. Open browser developer tools (F12), navigate to the Application tab, select Local Storage, and delete all authentication-related entries before refreshing the page. If you encounter an “Invalid state error,” the middleware handles this automatically. Simply try logging in again.

​

Profile Update Issues

When profile changes won’t save, check for error messages beneath each field. Verify your email is in valid format, ensure all required fields are filled, and confirm your profile picture URL uses HTTP or HTTPS protocol. Remember that usernames are read-only by design. Contact support if you need a critical username change.

​

Invitation Problems

If an invitee didn’t receive their email, verify the email address is correct and ask them to check spam or junk folders. Email delivery can take a few minutes, so wait briefly before using the “Resend Invite” button. If you receive an error about the member already existing, search your members list as the email may already be in your organization. For inactive existing members, use “Resend Invite” rather than creating a new invitation. If a removed member still has access, remember that active sessions persist until token refresh, typically within one hour. The system revokes access on their next authentication attempt.

​

Best Practices

Keep your profile information current and use a professional profile picture URL. Work email addresses are recommended for organizational communications. Regular password changes enhance security. When managing your team, double-check email addresses before sending invitations and communicate with invitees about the incoming email to prevent it from being overlooked. Regularly audit your members list to ensure only current team members have access. Remove inactive members who no longer need access, and resend invitations if they haven’t been accepted within a reasonable timeframe. For security, always log out on shared computers, use strong and unique passwords, and keep your email account secure with two-factor authentication when possible. Report any suspicious activity to your organization administrator immediately.

​

Quick Reference

​

Next Steps