Skip to main content

This article applies to Cloud.

Other available versions:

Version 6 | Version 5 | Version 4icon.qnmark.png

Available in:

StandardPremiumEnterprise
Small Business
Code42 Support

Users reference

This article applies to Cloud.

Other available versions:

Version 6 | Version 5 | Version 4icon.qnmark.png

Available in:

StandardPremiumEnterprise
Small Business

Overview

This reference guide includes detailed information about managing users and their devices, adding new users, and managing roles.

Users

To view the Users section, sign in to the administration console, and select Users. The Users section displays the following information about the users in your enterprise.

Users reference

Item Description Click to view
a Active Displays all active users.  
b Deactivated Displays all deactivated users.  
c Invited Displays users invited to create account, but not yet signed in.  
d Action menu Contains commands available in the user list view.  
e Add a new user Displays pane in which you enter information to add a user.  
f Run a Device Report Navigates to the Reporting web app, displaying results based the users listed.  
g Selects all the users in the list.  
h Name User's first and last name. Selected user's details
i Username User's username. Selected user's details
j

Backup Devices

Number of devices registered to this user. Includes Code42 app devices. Selected user's details
k Used Storage The amount of data this user has stored at all destinations. List of all of the user's device archives and stats, by GUID

Action menu

Command Description
Block Signs out the selected user(s) from all devices and all current administration console sessions. Prevents future sign-in to all of the user's devices and the administration console. Backup continues and archives remain active and stored. Not available when the selected user is currently blocked.
Unblock Unblock currently blocked users. Not available when the selected users are not blocked.
Reset Password Send an email containing a password reset link to the email address associated with the selected user(s).
Export All Export selected item to CSV file. If no user is selected, all users in the list are exported.

CSV export

Export all visible list items to a CSV file by selecting gear.png > Export All. If no user is selected, all users in the list are exported.

For definitions of user attributes, see the User section in the Code42 API API documentation viewer.

Field Description

userId

Identification number of the user.

orgId

Organization where the user resides.
username Login name for the user.
email Email address associated with the user's account.
displayName Name displayed in the administration console for the user.
status Status of a user is active, blocked, or deactivated.
computerCount Number of devices registered to the user.
shareDeviceCount Number of SharePlan devices associated with the user.
Deprecated—this information may no longer be accurate.
backupDeviceCount Number of devices associated with the user.
lastLoginDate Last time the user signed into the administration console.
active

Indicates if the user is active.

TRUE: Active

FALSE: Deactivated

blocked

Indicates if the user is blocked.

TRUE: Blocked

FALSE: Not blocked

warningCount Number of user devices that have not backed up within the defined warning interval specified in the organization settings.
criticalCount Number of user devices that have not backed up within the defined critical interval specified in the organization settings
targetComputer Identification number for the device used for computer-to-computer backup.
selectedFiles Total number of files selected for backup.
selectedBytes

Total number of bytes selected for backup.

lastBackupDate Date when any one of the user's devices backed up.
lastCompletedBackupDate Date when any one of the user's devices had a 100% complete backup.
archiveBytes

Total bytes the archive occupies on disk.

todoBytes

Total bytes of data remaining to back up.

todoFiles

Total number files remaining to back up.

userUid The user's UID (unique ID).
orgUid The UID (unique ID) of the user's organization.
userExtRef

Optional external reference information, such as a serial number, asset tag, employee ID, or help desk issue ID.

notes
firstName The user's first name.
lastName The user's last name.
orgName The user's organization name.
orgType

Organization type.

  • ENTERPRISE: Code42 for Enterprise
  • BUSINESS: CrashPlan for Small Business
authType The authentication method for users in this organization (LOCAL, LDAP, RADIUS, or SSO). A blank value means the default of LOCAL. 
usernameIAnEmail Whether the username is an email.
creationDate Organization creation date.
modificationDate Date when the organization was last modified.
passwordReset Whether a password reset is required.
invited Whether the user was invited to Code42 via email.
securityKeyType The type of security key for the user.
targetComputerGuid GUID of the device used for computer-to-computer backup. 
Computer-to-computer backup is deprecated.
billableByes Number of billable bytes.
quotaInBytes User's backup quota in bytes. A value of -1 means unlimited backup.
percentComplete Restore percent complete.
archiveBytesDelta The difference, in bytes, between what has been backed up and what remains to be backed up.
archiveBytesDeltaMonth

The difference, in bytes, in the archive from this month to the previous month.

archiveHistory The number of archives for the user.
emailPromo Whether the user receives promotional email.

Add a new user

You can add users by sending an email invite, manually entering their information, or by importing user information.

Command Description
Invite Users Send an invite to one or more users by sending an email invitation.
Add Users Add or import users.

Invite users

Use the Invite Users command to send an email invite to new users.

Invite

Command Description
a Search for a specific organization within your environment
b Select an organization for the user
c Click to proceed or cancel

 

When you click Select on the Invite User dialog, the following dialog is displayed:

Invite users

Item Description
a Enter email recipients for the invite email.
b Enter the reply to email to be included on the invites.
c Modify the subject line for the email invite, if necessary.
d Modify the default email message, if necessary.
e Click to send email(s) or cancel.

Add users

Use the Add a New User command to create a new user.

Add a New User

Command Description
a Search for a specific organization within your environment
b Select an organization for the user
c Click to proceed or cancel

 

When you click Select on the Add User dialog, the following dialog is displayed:

Manually Add Users

Item Description
a Add users one by one. The Code42 app must be installed on each user's device(s) in order to back up.
b Add users in bulk by uploading a text file (.CSV).
c Download a sample text file for information on how to format the text file (.CSV).
d Upload the text file (.CSV) containing the users you'd like to add. The desktop application must be installed on each user's device(s) in order to back up.

Details

To view the user details, select a user from the overview. Here you can see information about a user's device.

User details

Item Description
a User Displays the user's first and last name, if available. If first and last names were not specified when creating the user, displays the user's username.
b Organization Name of the user's organization. Click to view organization details.
c Action menu Displays actions you can perform.
d Email Address Email address associated with the user's account.
e Last Signed In Last time the user signed into the administration console.
f Date Created Date the user account was created.
g Used Storage Amount of data stored from this user account's devices. Graph shows the past 30 days. Data points are updated once per day.
Click to view a list of all the user's device archives and stats, by GUID.
h Backup Restores Number of restores initiated, files restored, and total bytes restored over the past 30 days.
Click to view Restore History.
i Operating System Operating system icon for this device. Displays Windows, Mac, or Linux.
j Device Name

The name assigned to the device by Code42. Upon initial installation, the Device Name and the Hostname are the same, but users and administrators can change the device name in the Code42 app and/or Code42 administration console.

 

If the user has multiple devices, they all appear here.

k Hostname

The name of the device as reported by the device's operating system. The hostname is a static device property that cannot be changed by Code42. Upon initial Code42 app installation, the Device Name and the Hostname are the same, but users and administrators can change the device name.

 

Hostname requires Code42 app version 6.8.2 or later. Devices running older versions of the Code42 app display "UNKNOWN."

l Destination Name of the backup destination.
m Selected Size of the files selected for backup.
n

Backup Status

Backup completion percentage to each destination. Progress bar changes color if a device is in an alert state for that destination.

  • Green indicates no alerts
  • Yellow indicates a warning backup alert
  • Red indicates a critical backup alert
o Last Activity Time since the last activity for the user's devices.
p Completed Time since the device last completed a backup to the specified destination.
q Roles Displays the roles assigned to the user.
r Reference

Displays optional information about the user.

Action menu

Command Description
Edit Edits this user's information, including name, email address, and password.
Show Deactivated Devices Displays all of this user's deactivated devices. Not available when deactivated devices are displayed.
Hide Deactivated Devices Hides this user's deactivated devices. Not available when deactivated devices are currently hidden.
View Archives Opens the Archive List view, which displays information about the archives associated with this device.
Deactivate Deactivates the user. All associated devices are deactivated. Archives for all associated devices are placed into cold storage.
Activate Activates the user. You may also want to reactivate the user's devices.
Block Blocks the user. User is signed out of all devices and all current administration console sessions. Prevents future sign in to all of the user's devices and the administration console. Not available when the selected user is currently blocked.
Unblock Unblock currently blocked users. Not available when the selected users are not blocked.
Change Organization Moves selected users to a different organization.
Reset Password Resets the selected user's password.

Edit

General

Used Detail - Edit - General

Item   Description
a First and Last Name Edits the user's first or last name1
b Email Address Edits the user's email address1
c Username Edits the user's login name1
d Password Changes the user's password1
e Backup Quota  Edits the user's storage quota

1 Changing this field while the user is signed in to the administration console may require the user to sign in again.  

Roles

User Detail - Edit - Roles

Item Description
a Available Roles Roles not currently assigned to the user. These roles are available to be assigned to the user by the admin that is currently logged in. Admins can only grant roles to users if the admin user account is assigned the role. Click a role to display the permissions associated with the selected role.
b Current Roles Roles currently assigned to the selected user. Click a role to display the permissions associated with the selected role.
c Add Role Adds the selected role(s) to the user account.
d Remove Role Removes the selected role(s) from the user account.
e Currently Assigned Permissions OR Role's Permissions When no role is selected, this field displays all permissions currently assigned to the user account.
When a role is selected from Available Roles or Current Roles, this field displays all permissions associated with the selected role.
f Cancel Reverts changes and close the Edit User pane.
g Update User Saves changes and close the Edit User pane.

Reference

User Detail - Edit - Reference

Item Description
a External Reference Specifies optional external reference information, such as a serial number, asset tag, employee ID, or help desk issue ID.
b Notes Specifies optional descriptive information.

Change organization

Move user

Item Description
a Search Searches available organizations
b Organization Selects the new parent organization
Changing organizations can affect backups
If users are moved to a different organization, it could affect their backup. For example: 
  • Different destinations offered: If the new organization does not offer the same destinations as the user's previous organization, any of the user's data from destinations that are no longer offered are put in to cold storage
  • Frequency and version settings: Any differences in the new organization's frequency and version settings are applied to the backup archive after the user device connects to the Code42 cloud instance. Depending on the new organization's frequency and version settings, some data could be removed. 
  • Auto-start backups: If the new organization has any destinations configured to auto-start, the Code42 app begins backing up to those destinations immediately. Destinations that are not configured to auto-start appear in the Code42 app for the user to select.