Knowledge Center

Knowledge Center > Admin > Administrator Settings > Manage Users

Manage Users

Administrators can manage Zuora user accounts in your tenant. This article explains how to create and edit user accounts and reset passwords. This article also explains how to activate and deactivate users. An inactive user cannot access your Zuora tenant.

For the specific steps to create an API role, an API user, and an OAuth Client for an API user, see Create an API User.

View Users

To view the users currently configured for your tenant:

  1. From the Profile & Settings menu, select Administration > Manage Users. The All Users page opens.
  2. Click a username to view and edit information about the user, and view the user's login history.

You can also reset the user's password, or deactivate the user. Inactive means this user cannot access your Zuora tenant anymore.

Add Users

To create a user account for your tenant:

  1. Click your username at the top right, and navigate to Administration > Manage Users.
  2. Click add single user.

You can select a Zuora Platform Role and other roles for the user. You define and manage user roles on the Manage User Roles settings page.

The Locale field controls date formatting for that user. By default, the locale is English (United States).

See Personal Settings for more information about the fields that you can set when creating a user.

Assign a Role to a User

You can assign roles to users, including custom roles that you have created.

To assign a role to a user:

  1. Click your username at the top right, and navigate to Administration > Manage Users.
  2. Click the user's First NameLast Name, or User Name. Zuora displays the user's Basic Information.
  3. Click edit.
  4. Select the roles that you want to assign to the user.
  5. Click save

Create an OAuth Client for a User

Create an OAuth Client for the users who will access Zuora REST API through the API Gateway. The Client ID and the Client Secret are generated for a new OAuth Client, and the user needs to provide the Client ID and the Client Secret in the REST request to create an access token for the API Gateway. 

The following are prerequisites to be able to create an OAuth Client:

  • The tenant level permission for Bearer Token Management is turned on.
  • The user has an API User role with the API Write Access permission.

To manage OAuth Clients for a user:

  1. Click your username at the top right, and navigate to Administration > Manage Users.
  2. Click the user's First NameLast Name, or User Name.
  3. In the OAuth Clients section, you can view or delete the existing OAuth Client for the user.
  4. Type a Client Name and Description and click create to create a new OAuth Client.
  5. Upon the successful creation, the Client ID and Client Secret are returned.
  6. Save the Client ID and Client Secret. This is only time you can see the Client Secret.
  7. Click ok to close the window.

Reset All User Passwords

To reset passwords for all users in your tenant:

  1. Click your username at the top right, and navigate to Administration > Manage Users.
  2. Click reset all users' passwords. You will be prompted to confirm the action.

Zuora will send a new password notification to all of your users.

Export User Data to a CSV File

You can export the following user data to a .csv file:

  • User ID
  • User Name
  • First Name
  • Last Name
  • Status
  • Work Email
  • Created On
  • Zuora Billing Role
  • Zuora Payments Role
  • Zuora Commerce Role
  • Zuora Platform Role
  • Zuora Finance Role
  • Zuora Reporting Role
  • Zuora Insights Role
  • Last Login

To export user data:

  1. Click your username at the top right, and navigate to Administration > Manage Users.
  2. Click Export User List. The Exports page appears with the All Users List CSV pre-selected for export.
  3. Click Export. When the export is complete, the CSV file is available for download.
  4. From the table, click the file name All Users List CSV to download the CSV file.

Use the Last Login Date to Manage User Accounts

The table of users on the All Users page includes a Last Login Attempt column, which gives you better visibility into user activity in your Zuora tenant.

Zuora recommends performing a regular review of all user accounts in your Zuora tenant. Deactivate user accounts that no longer need access to your tenant. Administrators of Zuora can use this page to review all user accounts that have been provisioned. Rows having a Status of Active represent users who currently have access to your tenant.  

From this page, you can identify and deactivate any user accounts that are no longer needed. Use the Last Login Attempt column to this page. In general, users who have not logged into your Zuora tenant for a long time often represent good candidates for deactivation. You should also deactivate users who have left your company, or who have transitioned to other roles and no longer need to access your Zuora tenant.

See Deactivate Users for how to deactivate a specific user account.

Certain actions within Zuora, such as scheduled bill runs and API calls, are tied to the specific user accounts in your tenant that initiated those actions. If you deactivate those user accounts, some actions will no longer be performed.

Deactivate Users

Zuora recommends that you deactivate any user that is no longer associated with your organization, or any user that no longer needs to access your tenant. You will not lose historical information by deactivating a user account.

To deactivate a user:

  1. Click your username at the top right, and navigate to Administration > Manage Users.
  2. Click the user's First NameLast Name, or User Name. Zuora displays the user's Basic Information.
  3. Click Deactivate User.
  4. When prompted, click Yes to confirm.

If you accidentally deactivate a user, or need to restore a user at a later time, you can revisit this page and click the Reactivate User button.

Deactivate Pending Users

Users who have not responded to the activation email will have the Pending Active status. You cannot deactivate any user who has the Pending Active status. To deactivate this user, you must change their Work Email to an email account that you have access to and resend the activation email. Once you receive the email, click the link in the email to activate the user. This changes the user's status to Active, and you can now deactivate the account in Zuora.

Last modified
11:25, 26 May 2017

Tags

Classifications

(not set)