Define governance policies

When you start creating multiple apps, either as an individual app creator or as a member of a team or organization, there are typically constraints and guidelines that should be applied to every app created. App governance policies are the means by which to express these constraints and guidelines.

The typical reasons to set up app policies are:

• Design consistency
• Corporate compliance

Manage policies as described in the following sections:

• What is a policy?
• Who can add policies?
• When are policies auto applied in the app editor?
• Access the Policies page
• Add a predefined policy
• Add a custom policy
• Configure the policy
• Review policy compliance
• Edit a policy
• Delete a policy

What is a policy?

A policy is a rule that limits how AppSheet apps are created, managed, and distributed. For example, policies might define the following limits:

• Every app must require users to sign in.
• Data can't be deleted though an AppSheet app.
• Only certain people can mark apps as deployed.
• Apps can only be shared to a specific email domain.

Policies can be applied at the organization, team, or individual level.

When you configure a policy, you define three important components:

• Condition: A constraint that is checked on each app. See also Condition expression reference for governance policies. 
• Severity:  Error or warning. This tells the platform how to handle the condition if not satisfied. 
• Stage: When should the policy be checked? 

There are also some other options, including descriptive messages

You can add a predefined policy or a custom policy. See also Predefined policy templates.

Who can add policies?

• Any individual AppSheet user account has permission to add individual policies.
• Team root and team admin accounts can create and manage team policies, and can view organization policies.
• Organization admin accounts can create and manage organization and team policies.

Organization-level policies take precedence over team-level policies, but do act as "and" clauses for team policies that have the same target (component). AppSheet will always apply the most restrictive policy statement that can be produced when combining the conditions of organization and team policies on the same component. 

For example:

• If an organization policy restricts all external users and team A’s policy restricts external users only from foo.com, then all external users are restricted for all users in the organization.

• If a organization policy restricts external users from foo.com and team A’s policy restricts all external users, then all external users are restricted for members of team A and only external users from foo.com are restricted for other teams (B, C, and so on).

Suggestions:

• When you add a policy, start by defining a lower severity level (such as Warning), so you don't immediately block users that may already be out of compliance. This is important if you want to preserve the availability of the apps they created.
• Experiment with the predefined policies. If you want to define a policy that is not predefined, try using the custom policies. Contact AppSheet Support if you need assistance. 

When are policies auto applied in the app editor?

AppSheet auto applies a policy on app editor load if the Condition setting is defined using the following format: [field] = constant This includes policies whose Condition setting contains multiple [field] = constant statements that are combined together in an AND function.

For example, the Require sign-in policy has the following condition:

[AuthRequired] = true

This condition will be auto applied in your app and turn on (and prevent you from changing) the Require user signin? setting in the app editor. 

Similarly, the Enforce FedRAMP compliance policy has the following condition:

AND(
   [EnableFirebase]=false,
   [EnableMapsAndGeocoding]=false,
   [ScanningServiceName]="System Default: Google MLKit"
)

The condition will be auto applied and configure (and prevent you from changing) the following External service settings:

• Turn off the Allow Firebase setting to prevent the use of Firebase for branding apps
• Turn off the Allow maps and geocoding setting to prevent the use of maps and geocoding
• Restrict the Barcode/QRcode scanning service setting to System Default to prevent the use of external barcode scanners

Access the Policies page

Access the Polices page to view and manage the policies that are in effect for your account, team, or organization by opening the AppSheet app editor:

• Admin > Policies in the top navigation 
• Policies from the account profile drop-down

In addition, AppSheet admins can select Policies in the left navigation of the AppSheet Admin Console (preview).

The Policies page displays.

As highlighted in the figure, the Policies page allows admins to:

• View the policies that are in effect for your account, team, or organization
• Add a new predefined or custom policy for your account, team, or organization
• Edit or delete a policy

Add a predefined policy

To add a predefined policy:

1. Access the policies page.
2. Select the scope: Organization, Team, or Account.
3. Click + Organization policy,  + Team Policy, or + Account Policy to add an organization, team, or account-specific policy, respectively.
4. Select a predefined policy template from the Policy Template drop-down.
5. Click Next.
6. Configure the policy.
7. Review policy compliance.
8. Click Save.

Add a custom policy

The custom policy template lets you create a rule based on a specific component of the AppSheet service. 

To create a custom policy:

1. Access the policies page.
2. Select the scope, Organization, Team, or Account.
3. Click + Organization policy,  + Team Policy, or + Account Policy to add an organization, team, or account-specific policy, respectively.
4. Select Custom policy from the Policy Template drop-down.
5. Click Next.
6. Configure the policy.
7. Review policy compliance.
8. Click Save.

Configure the policy

Configure the policy settings described in the following table.

Review policy compliance

When you configure the policy, in the right pane of the Define an App Policy dialog, you can review policy compliance to confirm the results are as expected for each version (latest and stable) of your app before you save the policy. 

For example:

As shown, apps are organized into two categories: Non-compliant and Compliant. For non-compliant apps, the impact to the app is dependent on the policy severity and stage settings.

Edit a policy

To edit a policy:

1. Access the policies page.
2. Select the scope: Organization, Team, or Account.
3. Select More > Edit for the policy you want to edit.
   The Define an App Policy dialog displays.
4. Edit the policy configuration, as desired.
5. Review policy compliance.
6. Click Save.

Delete a policy

To delete a policy:

1. Access the policies page.
2. Select the scope: Organization, Team, or Account.
3. Select More > Delete for the policy you want to delete.
   The Define an App Policy dialog displays.
4. Click Delete Policy to confirm the action.