Configure app items

In addition to registering the apps that you add to the organization, you can configure properties and settings for app items.

Define app properties

Define the app's properties to help people understand what type of app you shared with them and how they can use it.

Follow these steps to define properties for an app item:

1. Sign in to the organization as the item owner or an administrator.
2. Open the item page and click the Settings tab.
3. For web mapping, mobile, or desktop app templates, specify one of the following purposes:
   • Ready To Use—Choose this option if this is not an app template and if there are no configuration options present in the app.
   • Configurable—Choose this option if you are adding a configurable app template. After you save the app item's settings, you can add configuration parameters.
   • Self-configurable—Use this option to deploy an app using an internal app builder.
   • Code sample—If the purpose of the app is to provide an example that others can use to create their own apps, choose Code sample and attach the code to the app item.
4. For desktop apps, specify the platform of the app.
5. If the app is a configurable app template, choose JavaScript from the API drop-down list.

   Legacy:

   Other API options and the SDK options present for mobile apps are deprecated properties, but they have not been removed because existing app items have these properties set. You do not need to set them for new apps other than configurable app templates.

6. Click Save.

Share app code

You can attach code (as a .zip file) to your app items. This allows you to provide access to the app's source code when you share a sample or a configurable app.

Follow these steps to add a code sample file to the app item:

1. Sign in to the organization as the item owner or an administrator.
2. Open the item page and click the Settings tab.
3. Click Attach Code and upload a .zip file containing the code sample.
4. Click Save.

To update a code attachment without resetting the download counter on the item, click Update Code and upload a .zip file with the same name as the original .zip file. To attach a new file, first click Remove to delete the existing file and repeat the steps above to attach a new file. Deleting the existing file and adding a new one resets the download count on the item.

Edit the app URL

If the URL changes for a web mapping, mobile, or application extension app that you added to your organization, you can update the app item's URL to point the app item to the new URL.

Follow these steps to update the URL for an app item:

1. Sign in to the organization as the item owner or an administrator.
2. Open the item page and click the Settings tab.
3. Type or paste the new app URL into the URL field.
4. Click Save.

Disable other users' ability to make a copy of an app

The organization members with whom you share an app created using ArcGIS Instant Apps can make a copy of your app. The app item that is created in their content initially references the same map or scene and layers that your app does and has the same properties as your app, but the user can change all those settings on their copy without affecting your app.

As the owner of an app or as the organization administrator, you can prevent other users from creating copies of the app.

Follow these steps to prevent other users from creating a copy of your app:

1. Sign in to the organization as the item owner or an administrator.
2. Open the item page and click the Settings tab.
3. Uncheck the box next to the Allow others in your organization to save a copy of this item option.
4. Click Save.

Manage credentials for registered apps

You can manage the developer credentials that you included when you added the app to the organization.

From the Settings tab of the app's item page, you can manage the following:

• Reset the app secret.

  Note:

  Resetting the app secret invalidates all existing app tokens and API keys issued for the app. Apps configured with the secret may need to be updated.

• Copy or renew the temporary app token.
• Unregister the app.
• Alter the privileges that the app is granted.

  Note:

  If the credential item did not include personal privileges when it was created, you cannot add them when you edit the credentials. For information about types of privileges, refer to the Security and authentication guide in the Esri developer help.

• Alter what layers the app can access.
• Update the URL of the data source for embedded OAuth credentials.
• Update the redirect URLs for embedded OAuth credentials.
• Update the referrer URLs for embedded API key credentials.

For information to help you manage credentials, see the following related pages in the Esri Developer help:

• OAuth credentials (for app authentication)
• Tutorial: Manage API key credentials

To access and alter settings, follow the steps below:

1. Sign in to the organization as the owner of the app or an organization administrator.
2. Open the item page and click the Settings tab.
3. Scroll to the Application section and make the change that you require.
4. Click Save after each change that you make to the settings.

   Note:

   Changing more than one setting at a time before you save may result in some settings not being saved.

5. Repeat steps 3 and 4 as needed.

Customize app sign-in categories

You can customize your OAuth 2.0 application sign-in experience by using custom sign-in categories. Your app can inherit organizational custom sign-in categories, or you can create app-specific sign-in categories.

Note:

To customize app sign-in categories, your administrator must enable custom sign-in for the organization.

To create a custom sign-in category for your app, complete the following steps:

1. Confirm that you are signed in to the organization as the item owner with Create, update, and delete privileges; or as a member with the default administrator role.
2. Open the item page for the app.
3. Click the Sign-in section of the Settings tab.
4. Turn on the Enable custom sign-in for this application toggle button.
5. Click Create a custom sign-in category.

   Note:

   You can configure a maximum of 100 custom sign-in categories.

   The Create sign-in category pane appears.

6. Optionally, in the Choose how to start pane, you can choose a category other than the Organizational default. Click the drop-down arrow under Select a sign-in category to start from and choose an option.

   The sign-in methods will reflect what is authorized under the Logins section for your organizations, such as ArcGIS login, Open ID, or Social logins.

7. Click Next.
8. Provide a Title and Description for your category.

   The title you choose will appear as an option under Select account type when a user signs in to the app.

9. Click Next.
10. Optionally, use the Login types pane to enable access to login categories and alter the Title of login categories once they are enabled.

    At least one login method must be enabled to create a category.

    Tip:

    Uncheck the box next to Enable sign-in category if you want to set up the category but are not ready for users to log in with the category. You can enable the category by turning on the toggle button next to the category name in the Sign-in section of the Settings tab of the app's item page.

11. Click Create category.

    Note:

    Once you create and enable a custom sign-in category, the organizational default will not appear when users sign in to the app.

    The category appears under the Sign-in section of the Settings tab of the item page.

    Note:

    App-specific custom sign-in categories will not appear under Custom sign-in in the Security section of the organizational settings.

12. Optionally, click Preview sign-in page to see what users will see when they sign in. To update the custom sign-in category, click Configure.