Add and register an app

You can add existing web apps as items to your organization so members can search and discover them. When you add an app as an item, you are sharing the URL to the app; the portal does not host the app files.

As an app developer, you can also add and register apps to generate an app ID. This involves registering an OAuth application so that users can sign in to ArcGIS Enterprise through the Enterprise login page. See the Add and register an app using developer credentials section below for more information.

Tip:

Another way to share apps with members of your organization is to publish a web app you create from a map. For more information, see Create apps from maps.

Add an app from a URL

Follow these steps to add an item that uses a URL to access an app on the web:

1. Verify that you are signed in and have the privilege to create, update, and delete content.
2. From the My content tab of the content page, click New item and click Application.
3. Choose the type of app:
   • Web mapping—A web app built with a web API, such as JavaScript.
   • Desktop—An app for desktops built on a desktop platform, such as Java or .NET (Microsoft Windows Desktop).
   • Mobile—A downloadable app built for mobile devices with an SDK, such as iOS or Android.
   • Other application—A desktop application, Python script, or any type of generic app for which you don't have details about the application's purpose, API, SDK, or URL address.

   If you're signed in as an administrator, additional options are available for ArcGIS Web AppBuilder and ArcGIS Experience Builder apps.

4. For web mapping, desktop, or mobile, type the URL of the app, for example, https://<myServer>/myWebMapApp.
5. For desktop apps, click Browse and choose the .zip file that contains the app.
6. Click Next.
7. Provide a title.
8. Choose a folder in My content where you want to save the item.

   Alternatively, you can choose Create new folder from the menu and type a folder name to save the item in a new folder.

9. If your organization administrator configured content categories, click Assign categories and select up to 20 categories to help people find the item.

   You can also start typing a category name to narrow the list of categories.

10. Optionally, type tags that describe the item.

    Separate the terms with commas (for example, Federal land is considered one tag, and Federal, land is considered two tags).

    As you type, you can select any of the suggested tags that appear; suggestions are generated from tags you previously added.

11. Optionally, add a summary that describes the app.
12. If your administrator has configured a classification schema, classify the item as needed under Classification.

    If your administrator has defined a schema help document, you can access it by clicking Information at the top of the classification form. Refer to this document for details about the classification options.

    Note:

    Classifying an item does not restrict access to it. The classification you assign to the item, which appears on the item page, provides a visual indication of the extent of security and safeguarding it warrants and can help organization members identify the correct way to interact with it. You need to set the appropriate sharing level to restrict access to the item.

13. Click Save.

Once you add the app, it appears in your content. If you need to register it later, you can do so from the Settings tab of the app's item page. See the Add and register an app using developer credentials section below for more information.

You can configure the item details, attach code if required, and share the app if you have sharing privileges.

Add and register an app using developer credentials

As a developer, you can add and register your app to generate an app ID. Use the app ID in the app to allow users to sign in to ArcGIS Enterprise with OAuth 2.0, a standardized authorization framework. With OAuth 2.0, apps guide the user to sign in to ArcGIS Enterprise through an Enterprise login page. It also allows the app to work with user content associated with their organization as well as work with any enabled capabilities such as geocoding, routing, and GeoEnrichment. To learn more about authentication and OAuth 2.0, see Esri Developer.

1. Verify that you are signed in with an account that has the privilege to create, update, and delete content.
2. Click the My content tab of the content page and click New item.
3. In the New item window, click Developer credentials.
4. Under Redirect URLs, provide the URL to a web page or server endpoint that will be used to redirect users after they successfully sign in. Click Add to add more redirect URLs as needed.

   The redirect URLs specified during authorization must match one of the registered URLs; otherwise, authorization will be rejected.

   A special value of urn:ietf:wg:oauth:2.0:oob can also be specified for authorization grants. This results in the authorization code being delivered to a portal URL (/oauth2/approval). This value is typically used by apps that don't have a web server or a custom URL scheme where the code can be delivered.

   The following are examples of supported redirect URL formats:

   • https://app.foo.com
   • urn:ietf:wg:oauth:2.0:oob

5. Under Application environment, choose an application environment for the app—Multiple, Native, Browser, or Server.
6. In the URL box, type a URL for your app in the format https://<myServer>/myWebMapApp.
7. Provide a title.
8. Choose a folder in My content where you want to save the item.

   Alternatively, you can choose Create new folder from the menu and type a folder name to save the item in a new folder.

9. If your organization administrator configured content categories, click Assign categories and select up to 20 categories to help people find the item.

   You can also start typing a category name to narrow the list of categories.

10. Optionally, type tags that describe the item.

    Separate the terms with commas (for example, Federal land is considered one tag, and Federal, land is considered two tags).

    As you type, you can select any of the suggested tags that appear; suggestions are generated from tags you previously added.

11. Optionally, add a summary that describes the app.
12. If your administrator has configured a classification schema, classify the item as needed under Classification.

    If your administrator has defined a schema help document, you can access it by clicking Information at the top of the classification form. Refer to this document for details about the classification options.

    Note:

    Classifying an item does not restrict access to it. The classification you assign to the item, which appears on the item page, provides a visual indication of the extent of security and safeguarding it warrants and can help organization members identify the correct way to interact with it. You need to set the appropriate sharing level to restrict access to the item.

13. Click Save.

    The app is added to your content and its item page appears. You can configure the item details, attach code if required, and share the app if you have sharing privileges.

From the Settings tab of the app’s item page, you can view registration information, which includes the app ID (Client ID), an app secret (Client Secret), and the application environments. You can also update the URL of the data source or the redirect URLs , reset the secret, unregister the application, or copy or renew the temporary app token.

Note:

Resetting the app secret invalidates all existing user and app tokens issued for the app. Users must sign in to the app again, and apps configured with the secret may need to be updated.