ArcGIS Enterprise
All steps in the Security and authentication guide apply to the latest version of ArcGIS Enterprise (12.0).
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
API key authentication is a type of authentication that uses an API key to authenticate requests to ArcGIS services and secure portal items. . - Enterprise versions prior to 11.4 do not support privileges
Privileges are a set of permissions assigned to ArcGIS accounts, developer credentials, and applications that grant access to secure resources and functionality in ArcGIS. or itemAn item, also known as a content item, is a resource stored in a portal such as a web map, hosted layer, style, script tool, file, or notebook. access for app authenticationApp authentication is a type of authentication that grants a short-lived access token based on an OAuth 2.0 client ID and client secret, authorizing an application to access ArcGIS services and items. . - Enterprise versions prior to 11.5 do not support portal service
A portal service provides the functionality to securely create, access, and manage content, data services, users, and groups in a portal. The service can be hosted by Esri or in ArcGIS Enterprise. privileges for developer credentials.
Certain workflows, such as user authentication
Create developer credentials
In versions of ArcGIS Enterprise prior to 11.4, the only type of developer credentials available is OAuth credentialsclient_id, client_secret, and redirect URIs. They are a type of developer credential.
The steps to create developer credentials depend on the type of authentication you are implementing:
-
Sign in to your ArcGIS Enterprise portal
ArcGIS portal, also known as a portal, is a website with applications and tools that can be used to create, manage, access, and share geospatial content and data. It supports security and authentication, developer credentials, content and data service management, user and group management, and site administration. A portal can be hosted in Esri's infrastructure or your own infrastructure. . -
Click Content > My content > New item and select Developer credentials
Developer credentials are a type of item in a portal that contains parameters for authentication. There are two types of developer credentials: API key credentials and OAuth 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
-
Find the developer credentials in your ArcGIS Enterprise portal and navigate to their item page
An item page is a web page in ArcGIS Online or the developer dashboard used to access and manage the properties for an item and the content it references such as a web map, hosted layer, or file. . -
Scroll down to Credentials and copy the Client ID value. If you are implementing app authentication
App authentication is a type of authentication that grants a short-lived access token based on an OAuth 2.0 client ID and client secret, authorizing an application to access ArcGIS services and items. , copy the Client Secret value as well. -
Use the credentials in your application to implement authentication. The recommended workflow is user authentication
User authentication is a type of authentication that allows users with an ArcGIS account to sign into an application and allow it to access ArcGIS content, services, and resources on their behalf. The typical authorization protocol used is OAuth2.0. .
Manage developer credentials
In versions of ArcGIS Enterprise prior to 11.4, developer credentials do not support privileges
Add a redirect URL
-
Find the developer credentials in your ArcGIS Enterprise portal and navigate to their item page
An item page is a web page in ArcGIS Online or the developer dashboard used to access and manage the properties for an item and the content it references such as a web map, hosted layer, or file. . -
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
An item page is a web page in ArcGIS Online or the developer dashboard used to access and manage the properties for an item and the content it references such as a web map, hosted layer, or file. . -
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
An item page is a web page in ArcGIS Online or the developer dashboard used to access and manage the properties for an item and the content it references such as a web map, hosted layer, or file. . -
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.