Settings¶

The Settings page lets you manage your profile, change your password, configure notifications, and set your language preference.

Access: All authenticated users. Navigate via Settings in the left sidebar (Infrastructure section).

Settings Tabs¶

Settings page tabs Figure 1: Settings page showing the tabs: Profile, Security, Notifications, Preferences, and API Key & CLI.

Tab	Purpose
Profile	Update display name and view account information
Security	Change your password
Notifications	Enable or disable email and in-app notification types
Preferences	Select your display language
API Key & CLI	Manage personal API tokens and advanced CLI CA fallback downloads

Profile¶

The Profile tab shows:

Display Name — editable; shown in the UI wherever your name appears
Username — read-only; your login identifier
Email — contact address; may be read-only if your account is managed via SSO

To update your display name:

Click the Profile tab.
Edit the Display Name field.
Click Save Changes.

Security¶

Change Password¶

Click the Security tab.
Enter your Current Password.
Enter your New Password (minimum 8 characters, mix of letters and numbers recommended).
Repeat the new password in Confirm Password.
Click Update Password.

Password requirements

If your platform is configured with SSO (Single Sign-On), you may not be able to change your password here — password management is handled by your identity provider.

Notifications¶

The Notifications tab lets you control which events trigger notifications.

Notification Type	Description
Request Updates	When an admin changes the status of your submitted request
Workspace Events	When a workspace starts, stops, or encounters an error
Project Changes	When you are added to or removed from a project
Storage Changes	When storage permissions affecting you are modified

Toggle each type on or off. Changes save immediately.

Preferences¶

Language¶

Select your preferred display language from the dropdown. The UI will reload in the selected language.

Available languages depend on your platform configuration. Contact your admin if your language is missing.

API Key & CLI¶

This tab is the entry point for the cscc-cli tool. It does two things:

Active API Tokens¶

The token list shows every active API token issued for your account, with prefix, last-used time, and expiry. From here you can:

Create token — generate a new token with an optional name. The full token value is shown once; copy it before closing the dialog.
CLI import — the reveal dialog includes a copyable cscc-cli login --api-url ... --token cscc_... command after the token is created.
Revoke — invalidate any token. CLI sessions using that token will stop working on their next call.

Tokens default to a 90-day lifetime, and your account is capped at 20 active tokens at a time.

One-time reveal

The cleartext token is never stored on the backend — only its SHA-256 hash. If you lose the value, revoke it and create a new one.

Advanced CLI CA Fallback¶

Official cscc-cli releases already include the platform internal root CA. Use Download CLI CA only for custom CLI builds, emergency CA rotation windows, or TLS troubleshooting. Setting CSCC_API_CA_CERT_PATH overrides the CA embedded in the official CLI binary.

The CLI setup commands use VITE_PUBLIC_API_URL or runtime apiUrl when the dashboard deployment provides one. If not, the page derives the API host by replacing a dashboard.* hostname with api.*, then appends /api/v1.

Common Questions¶

I can't change my password — the field is greyed out.

Your organisation uses Single Sign-On (SSO). Password management is handled by your identity provider (e.g., LDAP, OAuth). Contact your IT department.

I'm not receiving email notifications even though they're enabled.

Check your spam folder. If emails are not arriving, contact your admin to verify the platform's SMTP configuration is set up correctly.

I lost my API token. Can I recover it?

No — only the hash is stored. Revoke the lost token from the API Key & CLI tab and create a new one.