Manage sharing and security

The Share setting for a hosted map tile layer (item) allows you to manage the sharing level of the item and the corresponding map tile service. Restricting the sharing level is how you secure both the item in a portal and the underlying data in the data service.

You can use the share setting to:

  • Change the discoverability of a hosted layer (item) in a portal.
  • Make an item and a data service private or public.
  • Give specific groups of users or an organization access to an item and a data service.
  • Require data services to be accessed with an access token.
Item page sharing
Hosted map tile layer item page in ArcGIS portal showing sharing settings.

How to set the sharing level

When you create a new data service, the hosted layer (item) and data service sharing level (privacy setting) is set to Owner. The item and data service are only available to you. This setting requires that applications provide a valid access token to authenticate requests to view the item or access the data service.

The steps to change the sharing properties are:

  1. Sign in to your portal:

  2. Find the item.
  3. Use the item page to change the sharing setting.

Types of sharing levels

The following is a list of the sharing levels available for the different types of ArcGIS products:

  • Owner (private): Only the owner has access. The hosted layer (item) and data service are private and will not be visible or accessible to others. A valid access token or scoped API key is required. Learn more about scoping items to an API key in API keys.

Code examples

You can use data management tools to manage the sharing level of a hosted map tile layer (item) or you can use the ArcGIS REST APIs. The following examples illustrate how to set the sharing level of a hosted map tile layer (item).

Set sharing to private

Restrict the hosted layer (item) and data service access to the owner only. An access token is required to access the service.

Use dark colors for code blocksCopy
1
2
3
4
5
6
7
POST https://{host}/sharing/rest/content/users/{organizationId}/items/{itemId}/share HTTP/1.1
Content-Type: application/x-www-form-urlencoded

everyone=false
&org=false
&groups=
&token={access_token}

Set sharing to group

Restrict the hosted layer (item) and data service access to private or public groups in the organization. An access token is required to access the service.

This sharing level is not available.

Set sharing to organization

Restrict the hosted layer (item) and data service access to members of the organization. An access token is required to access the service.

This sharing level is not available.

Set sharing to public

Allow unrestricted access to the hosted layer (item) and data service. An access token is not required to access the service.

This sharing level is not available.

Tutorials

Import data to create a feature layer

Use data management tools to import files and create a feature layer in a feature service.


Define a new feature layer

Use data management tools to define and create a new empty feature layer in a feature service.


Manage a feature layer

Use a hosted feature layer item to set the properties and settings of a feature layer in a feature service.


Create a vector tile service

Use data management tools to create a new vector tile service from a feature service.


Create a map tile service

Use ArcGIS Online or scripting APIs to publish a map tile service.


Workflows

Services

API support

Use data management tools or Client APIs to create, manage, and access data services. The table below outlines the level of support for each API.

CreateManageAccess
ArcGIS Maps SDK for JavaScript1
ArcGIS Maps SDK for Kotlin1
ArcGIS Maps SDK for Swift1
ArcGIS Maps SDK for Java1
ArcGIS Maps SDK for .NET1
ArcGIS Maps SDK for Qt1
ArcGIS API for Python
ArcGIS REST JS
Esri Leaflet2
MapLibre GL JS23
OpenLayers23
Full supportPartial supportNo support
  • 1. Use portal class and direct REST API requests
  • 2. Access via ArcGIS REST JS
  • 3. Requires manually setting styles for renderers

Tools

Your browser is no longer supported. Please upgrade your browser for the best experience. See our browser deprecation post for more details.