Administrating Users and Accounts
This section explains how users and accounts are defined and offers targeted user interfaces for survey administrators.
What is a User?
A user is an individual (a person) with login credentials. Users authenticate into the system and may be granted permissions to access one or more accounts.
Key properties of a survey user:
- Is credentialed (has an identity)
- Can belong to multiple accounts
- Can be assigned different roles per account (admin, designer, or respondent)
What is an Account?
An account represents an organization, entity, or logical grouping under which surveys are owned, administered, and responded to.
Key properties of an account:
- Owns surveys and responses
- Can have multiple users assigned
- Provides the context for user actions
In order to administrate a survey, you will need to log in with admin credentials:
Managing Users
Once you have logged in as an admin, you will be able to see all users of your survey application. Note that all admin users share common permissions and authorities—there is no options to hide any subset of users from a survey administrator.
Creating a User
Survey administrators can create and delete users. To create a user, simply write a new username into the interface below and press 'create':
Credentialing a User
Before a user can act on a survey, an administrator must create credentials and assign an appropriate role for the user.
Select a user to credential:
Internal Access Keys
An internal access key is required for survey administrators and designers. Internal access keys are JSON-formatted public–private key pairs that the user must enter into the credentials UI before acting on a survey or an account. The private (secret) half of the key pair is provided only once, upon key creation. If a user forgets or loses their key pair, another administrator must delete and regenerate their keys.
External Access Keys
External Access Keys are used by survey respondents. These keys are encrypted and stored publicly in the S3 PRIVATE bucket.
Deleting Access Keys
Administrators may delete user access keys. Below are the keys currently assigned to the selected user's account:
Deleting a User
To delete a user, select the target username from the dropdown below and click 'Delete Selected User':
Managing Accounts
Users do not act independently — they always operate within the context of an account. Below are all accounts for this survey application instance.
Creating an Account
To create an account:
Deleting an Account
Note: It is not possible to delete an account through this user interface. Account deletion is irreparably destructive. If you wish to delete an account, ask an Admin to do this directly on AWS.
Deleting an account removes all associated surveys, responses, and user assignments. This action is irreversible.