ArcGIS Enterprise can be used to create developer credentials and implement authentication. The features available with developer credentials created in ArcGIS Enterprise depend on the version you are using. It is highly recommended to upgrade your system to the latest version of ArcGIS Enterprise.
All steps in the Security and authentication guide apply to the latest version of ArcGIS Enterprise (11.4).
Due to system-specific limitations, some users may not be able to upgrade their version of ArcGIS Enterprise at this time. The remainder of this page explains how to create and manage developer credentials using older Enterprise versions.
Developer credentials in older ArcGIS Enterprise versions
Developer credentials in older versions of ArcGIS Enterprise have limited functionality. The exact capabilities of developer credentials vary based on the version you are using. The most important differences are:
- Enterprise versions prior to 11.4 do not support API key authentication.
- Enterprise versions prior to 11.4 do not support privileges or item access for app authentication.
Certain workflows, such as user authentication, are still supported. The steps to create and manage developer credentials on previous versions of Enterprise are listed below.
Create developer credentials
In versions of ArcGIS Enterprise prior to 11.4, the only type of developer credentials available is OAuth credentials. OAuth credentials can be used to implement user authentication or app authentication with limited functionality.
The steps to create developer credentials depend on the type of authentication you are implementing:
-
Sign in to your ArcGIS Enterprise portal.
-
Click Content > My content > New item and select Developer credentials.
-
Add a redirect URL and click Next.
-
Name the credentials and click Save to create them.
Copy the client ID and secret
The primary use case of developer credentials is to implement user authentication using a client ID and redirect URL. To access this value, you first need to Create developer credentials.
-
Find the developer credentials in your ArcGIS Enterprise portal and navigate to their item page.
-
Scroll down to Credentials and copy the Client ID value. If you are implementing app authentication, copy the Client Secret value as well.
-
Use the credentials in your application to implement authentication. The recommended workflow is user authentication.
Manage developer credentials
In versions of ArcGIS Enterprise prior to 11.4, developer credentials do not support privileges or item access. The management actions that can be performed include:
Add a redirect URL
-
Find the developer credentials in your ArcGIS Enterprise portal and navigate to their item page.
-
Click on Settings and scroll down to Application.
-
Under Redirect URLs, click Add.
-
Add the new redirect URL that you intend to use in your application.
Reset the client secret
-
Find the developer credentials in your ArcGIS Enterprise portal and navigate to their item page.
-
Click on Settings and scroll down to Application.
-
Click the Reset secret button to generate a new client secret. Your existing access tokens will be invalidated.
-
Copy the new client secret and use it in your application.
Unregister the application
You can use this action to delete the client ID and secret from developer credentials without deleting the item. This action can also be used to set the application environment.
-
Find the developer credentials in your ArcGIS Enterprise portal and navigate to their item page.
-
Click on Settings and scroll down to Application.
-
Click the Unregister application button to unregister the developer credentials. Your client ID, client secret, and existing access tokens will be invalidated.
-
To re-register the developer credentials, click Register application. Registering an application allows you to set a new Application environment.