Add and register an app

Adding a URL reference to an existing app is an effective way to share your work with members of your organization and the general public (depending on your sharing privileges). In addition to the URL, you can share other details such as the type of app, its purpose, a summary and description, and a .zip file with the code you used to create the app. As an app developer with an organizational account, you can also register apps with the platform.

Adding an app to ArcGIS Online only adds a reference to the app URL; ArcGIS Online does not store the app files.

Tip:

Another way to share apps with members of your organization and the general public is to create apps with maps and gallery apps with groups.

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 privileges to create 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 or any type of generic app for which you don't have details about the application's purpose, API, SDK, or URL address.
  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. Type a title.
  8. Choose a folder in My Content where you want to save the item.
  9. If the organization has set up 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; 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 have added previously.

  11. Optionally, add a summary that describes the app.
  12. Click Save.

Once you add the app, it appears in your content.

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

Register an app

As a developer with an organizational account, you can register your app with the platform to generate an app ID. Use the app ID in the app to collect usage statistics and to allow users to sign in to the platform with OAuth 2.0, a standardized authorization framework. With OAuth 2.0, apps guide the user to sign in to the platform through a platform-hosted login page. It also allows the app to work with user content associated with their organization as well as work with other ArcGIS Online capabilities such as geocoding, routing, and GeoEnrichment. To learn more about authentication and OAuth 2.0, see ArcGIS Developer.

Before you can register an app, you must add it to ArcGIS Online. See the section above for details. After you've added it, follow the steps below to register the app and get an app ID and app secret. If you've added a generic type of app, the app is automatically registered.

Note:

The implementation pattern for user logins differs slightly depending on whether you are developing a web-based app or a native app. ArcGIS Developer documentation includes details and code samples for both web-based apps and native apps.

  1. Verify that you are signed in with an organizational account and have privileges to create content.
  2. From the My Content tab of the content page, click the title of the app you want to register.

    Clicking the app name opens its item page.

  3. Click the Settings tab, scroll down to the App Registration section, and click Register.
  4. Select the type of app: browser, native, server, or multiple.
  5. For each redirect URI, provide the address in the format ["https://<server>[:port]"] and click Add.

    Redirect URIs are valid addresses that users of the app can be redirected to after they successfully sign in.

  6. To remove a URI you previously added, select it, click Delete, and click Register.

View and update app registration information

Once you register the app, you can view registration information—which includes an app ID and an app secret—update the redirect URIs, and reset the secret. You can also view usage information about who has signed in to the app and the number of credits they've consumed, as well as unregister the app.

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.

  1. Verify that you are signed in to your organizational account and click the My Content tab of the content page.
  2. Click the title of the registered app.
  3. On the item page, click the Settings tab.
  4. Scroll down to the Application Settings section and click Registered Info.

    You can view the following details: app ID, app secret, app type, and redirect URIs.

  5. To update the redirect URIs, click Update and do the following:
    1. To add a redirect URI, provide the address and click Add.
    2. To remove a redirect URl, select the URI address and click Delete.
    3. Click Update and click Save.
  6. To reset the app secret, click Update and do the following:
    1. Click Reset Secret.

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

    2. Click Yes to confirm the resetting of the app secret.
    3. Click Update and click Save.
  7. To view usage information about who has signed in to an app or the number of credits they've consumed, click Application Usage and choose to show credits or users, and choose the time period.
  8. To unregister an app, click Unregister App.

    The app is no longer registered. You do not need to save the item page.

Related topics