Users
Users extends WinnerWare with bulk user import and network-aware access controls.
Overview
This module is used when administrators need to onboard users in volume, manage trusted network ranges, and tighten sign-in behavior for unknown locations.
Key Features
- Supports bulk import from Excel or CSV-style files.
- Adds a downloadable import template.
- Supports mapping roles, teams, and additional user details during import.
- Adds known-network settings under security.
- Lets user profiles allow or deny sign-in from unknown networks.
- Supports two-factor requirements for unknown-network sign-in.
- Can show users when a lockout will expire.
How It Works
The module is split into four features:
| Admin display name | Feature ID | Purpose |
|---|---|---|
| Bulk Import Users | CloudSolutions.Users.Import | Imports users from spreadsheet data. |
| Show locked out user end time | CloudSolutions.Users.LockedoutInfo | Shows when a locked account will automatically unlock. |
| Known Networks | CloudSolutions.Users.KnownNetworks | Defines trusted network ranges and related sign-in behavior. |
| Require Two-factor Authentication From Unknown Networks | CloudSolutions.Users.KnownNetworks.TwoFactorAuthentication | Adds extra sign-in protection for unknown networks. |
The import feature uses a two-step flow: upload the file first, then review and correct the mapped user records before processing them.
The network features add site-level security settings plus a per-user override that can allow sign-in from unknown networks when needed.
Configuration
Import navigation
- Access Control -> Import Users
Import permission
| Permission | Purpose |
|---|---|
| Import using Excel | Lets administrators upload and process user import files. |
Known network navigation
- Settings -> Security -> Known Networks
Known network permissions
| Permission | Purpose |
|---|---|
| Manage Internal Network Settings | Lets administrators manage trusted network settings. |
| Edit User Access Permission | Lets administrators manage per-user access from unknown networks. |
Import workflow
The import screen expects:
.xls,.xlsx, or.csv- a single tab
- column headers in the first row
- file size of 10 MB or less
After upload, administrators can review the imported users, adjust the mapped data, and then process the final batch.
Known network settings
| Setting | Purpose |
|---|---|
| Known IP addresses | Stores individual addresses or address ranges that count as trusted networks. |
| Require explicit access from unknown networks | Restricts access from unknown networks unless the user is explicitly allowed. |
| Allow sign in from unknown networks | Per-user override that allows login from any IP address. |
| Require two-factor authentication from unknown networks | Adds extra sign-in protection when access comes from an untrusted network. |
Usage
Use this module when WinnerWare needs controlled user onboarding and stronger location-aware sign-in rules. It is especially useful for implementations that regularly import groups of users or that need to distinguish trusted internal networks from outside access.
Example setup
One clear rollout pattern is:
- enable the bulk import feature
- open Access Control -> Import Users
- download the template and prepare the spreadsheet with the required columns
- upload the file, review the mapped users, and correct any data before processing
- enable Known Networks if the tenant also needs trusted-network sign-in controls
- enable the two-factor option for unknown networks when outside access should require extra protection
Developer Notes
- The import flow supports additional mappers for roles, teams, notifications, and extended user details when the related features are enabled.
- The known-network feature reloads the tenant when security settings change.
- The module also includes a migration that corrects an older feature ID for the two-factor option.