Manage sharing and security

The Share setting for a hosted map tile layerA hosted map tile layer is a hosted layer (item) in a portal that is used to manage the properties and settings of a map tile service.Learn more (item) allows you to manage the sharing level of the 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.Learn more and the corresponding map tile serviceA map tile service, formerly known as image tile service, is a data service that provides access to static, pre-rendered mao tiles. The tiles are typical in PNG format. Map tiles are typically retrieved by specifying a specific level, row, and column value.Learn more. 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 layerA hosted layer is an item in a portal that contains the properties and settings for a hosted data service or a layer in a hosted data service.Learn more (item) in a portal.
• Make an 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.Learn more and a data serviceData services, also known as hosted data services, are services created dynamically to store and provide access to your data in ArcGIS. Examples are feature services, vector tile services, map tile services, image services, and scene services.Learn more private or public.
• Give specific groups of users or an organization access to an 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.Learn more and a data serviceData services, also known as hosted data services, are services created dynamically to store and provide access to your data in ArcGIS. Examples are feature services, vector tile services, map tile services, image services, and scene services.Learn more.
• Require data services to be accessed with an access tokenAn access token is an authorization string that provides access to secure ArcGIS content, data, and services. Its capabilities are determined by the privileges it supports. It is obtained by implementing API key authentication, User authentication, or App authentication.Learn more.

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 tokenAn access token is an authorization string that provides access to secure ArcGIS content, data, and services. Its capabilities are determined by the privileges it supports. It is obtained by implementing API key authentication, User authentication, or App authentication.Learn more 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 portalArcGIS 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.Learn more:

   • ArcGIS Location Platform: Go to https://location.arcgis.com > My portal.
   • ArcGIS Online: Go to https://www.arcgis.com/home/signin.html.
   • ArcGIS Enterprise: Go to your portal URL. Learn more at ArcGIS Enterprise > Use > Get started > Access.
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:

Code examples

You can use data management tools to manage the sharing level of a hosted map tile layer (item)A hosted map tile layer is a hosted layer (item) in a portal that is used to manage the properties and settings of a map tile service.Learn more 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)A hosted map tile layer is a hosted layer (item) in a portal that is used to manage the properties and settings of a map tile service.Learn more.

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}

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}

1
2
3
4
5
6
7
POST https://{host}/{webadaptor}/sharing/rest/content/users/{username}/items/{itemid}/share HTTP/1.1
Content-Type: application/x-www-form-urlencoded

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

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={groupId}
&token={access_token}

1
2
3
4
5
6
7
POST https://{host}/{webadaptor}/sharing/rest/content/users/{username}/items/{itemid}/share HTTP/1.1
Content-Type: application/x-www-form-urlencoded

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

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=true
&groups=
&token={access_token}

1
2
3
4
5
6
7
POST https://{host}/{webadaptor}/sharing/rest/content/users/{username}/items/{itemid}/share HTTP/1.1
Content-Type: application/x-www-form-urlencoded

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

1
2
3
4
5
POST https://{host}/sharing/rest/content/users/{organizationId}/items/{itemId}/share HTTP/1.1
Content-Type: application/x-www-form-urlencoded

everyone=true
&token={access_token}

1
2
3
4
5
POST https://{host}/{webadaptor}/sharing/rest/content/users/{username}/items/{itemid}/share HTTP/1.1
Content-Type: application/x-www-form-urlencoded

everyone=true
&token={access_token}

Tutorials

Import data to create a feature layer

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

ArcGIS portal

Define a new feature layer

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

ArcGIS portalPython APIREST JS

Manage a feature layer

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

ArcGIS portal

Create a vector tile service

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

ArcGIS portalPython APIREST JS

Create a map tile service

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

ArcGIS portalPython APIREST JS

Workflows

Create a feature service for an app

Learn how to import parcel data, create and style a feature layer, and then access the features in an app.

Create a feature layer view for an editor app

Learn how to import parcel data, create and style a feature layer view, and then access the features in an editing app.

Create a vector tile service for an app

Learn how to import parcel data, style a feature layer, and then create a vector tile service for an app.

Create a map tile service for an app

Learn how to import contour data, style a feature layer, and create a map tile service for an app.

Services

API support

Use data management toolsData management tools are ArcGIS software applications and functionality in portal and ArcGIS Pro that can be used by developers to create, manage, and edit content and data such as web maps, hosted layers, and data services for their applications.Learn more or Client APIsA Client API is a web, native, or scripting Application Programming Interface (including all ArcGIS, open source, and third-party APIs) that has mapping capabilities and can be used to access ArcGIS location services.Learn more to create, manage, and access data servicesData services, also known as hosted data services, are services created dynamically to store and provide access to your data in ArcGIS. Examples are feature services, vector tile services, map tile services, image services, and scene services.Learn more. The table below outlines the level of support for each API.

Tools