When you use Security Filters, you normally set the Require user authentication option on the Security > Require Sign-In pane. Once a user signs in, AppSheet knows the user's email address. You can then use the user's email address to filter the data shown to that user.
When you use Security Filters, you often include a field in each record that identifies the "owner" of the record. Typically this field contains the owner's email address. When adding a new record to a table, you can use the USEREMAIL() function in that field's InitialValue property to initialize it with the user's email address.
Security filters are optional yes/no expressions associated with each table in the app. They typically use the user's email address, and possibly other data values, to limit the data shown to the app user.
To limit access by User Email:
- [EmailColumn] = USEREMAIL()
To limit access by User Email Domain:
- CONTAINS(USEREMAIL(), [EmailDomainColumn])
To limit access by User Email but allow any manager to have access. Do this by creating a Managers table that contains the email addresses of all managers. Then specify a security filter like:
- OR(IN(USEREMAIL(), Managers[Email]), USEREMAIL() = [EmailColumn])
To filter based on the Department name contained in the Employees table. The security filter would be:
- IN(LOOKUP(USEREMAIL(), Employees, Email, Department), LIST("Payroll","Personnel"))
To filter the Customers table so that each sales representative sees only their own customers. If you have a separate CustomersToReps lookup table having columns CustomerId and SalesRepEmail, the security filter for the Customers table would be:
- IN([CustomerId], SELECT(CustomersToReps[CustomerId], [SalesRepEmail] = USEREMAIL()))
However, be aware that more complex Security Filters like the one above are typically inefficient when used with large datasets.
Warning: Avoid USERNAME() in Security Filters because it is unreliable. Providers like Google, only return the user's name if that user has enabled Google+ on their account.
This Security Filters video provides useful information.