User registry

User registry (user-registry) is a web application API that is developed using Flask. This API is used as the backend for user registration and the tasks related to user accounts. The current authentication method is JSON Web Token (JWT). During authentication, the user information is self-managed and received by the API client.

User data collection

Flask database tables are used to create tables of user registry data that is entered. Review the following database tables created for the user registry:

User

A table list of user data where the following parameter values are stored:

  • id: The user ID name. Required
  • phone_number: User preferred number. Optional
  • email: User email address. Required
  • password: Hash pasword for the user. Required
  • token_required: Unique access token generated after a user is created
  • Discoverable fields for the user (geoID, boundaries, polygon, etc.)

Signing up

Complete the following steps to create a user account:

  1. Navigate to the AgStack login page: user-registry.agstack.org.
  2. If you are creating a new account, select the Sign up link. A form is displayed.
  3. Complete the required fields of the form, then click Sign up. After you complete the form, the login box is displayed again.

  4. Check the email that you entered for an activation email, and click the activation link. You must verify your account by selecting the activation link.

    Notes:

    • If you have not received an activation email, select Resend Activation Email.
    • If the domain is block, you receive status code 401 with the following message: You are not allowed to register.
    • If you enter an existing email, you a receive status code 202 with the following message: User already exists. Please log in
  5. Verify that your account is created. Log in by entering the email and password that you registered. If the user account does not exist, you receive the following message: User does not exist. If the user account does exist, the password is verified. If the passwords do not match, you receive the following message: Wrong password.

Updating an user account

You can update your email, phone number, and password. Complete the following steps to update your user account:

  1. Log in to AgStack.
  2. From the AgStack Homepage, select the Account Settings tab.
  3. Edit the field that you want to update, then select Update.

Logging out

You must be logged in. When you want to log out, select the Logout tab in the header.