Skip to content
English
  • There are no suggestions because the search field is empty.

Mapping App Fields and Importing Users

How to match an app's fields to AppGovern, and how to import users from a CSV file when the app has no API.

Every app names its user fields differently. One calls it "email", another "mail", another "primaryEmail". Mapping tells AppGovern which field is which, so every app's users look the same once they arrive. You map the fields once, and each sync reads them the same way.

Map fields for a connector

  1. In the connection wizard, finish the Connect step and click Test Connection & Detect Fields. AppGovern calls the app and lists the fields it returned.
  2. Click Next to open Mapping.
  3. Match the app's fields to AppGovern's user fields. At minimum, map email. Map name, username, role, status, and last login too if the app returns them.
  4. Check the preview of incoming data. If names or roles look wrong, fix the mapping before you save.
  5. Continue to Segments and save.

What you can map depends on what the app's API returns. Some apps give you last login and roles, and some do not.

Import users from a CSV file

Use this when the app has no API.

  1. Go to Application > App Connections, find the app, and click Connect.
  2. Set Connector Type to No Connection (Manual Import) and click Next.
  3. Click Download CSV template and fill it in.
  4. Upload the file under Choose CSV file.
  5. Continue through Mapping and Segments.

manual-import

CSV columns

Column What to put in it
email The person's email address
first_name, last_name, name Their name
username Their username in the app
source Use manual for a manual import
last_login When they last signed in, if you know
access user, admin, or owner
role user, admin, or owner
status Whether the account is active

Rules to know

  • Each upload holds up to 50 rows. Split larger lists into several files.
  • A row with the same email and name as an existing user updates that user.
  • A row with the same email but a different name creates a new record and a new app assignment. Keep names consistent between uploads.

Keep imported apps current

A manual import is a snapshot. Upload a fresh file whenever the app's users change, or at least before each access certification.