Security Configuration

URL:
https://<notebookserveradmin>/security/config
Methods:
GET
Operations:
Update Security Configuration
Required Capability:
Administrator
Version Introduced:
10.7

Description

This resource returns the currently active security configuration of the ArcGIS Notebook Server site. A security configuration involves the following parameters and can be modified using the Update operation.

Request parameters

ParameterDetails

httpsProtocols

The TLS protocols ArcGIS Notebook Server will use. Values must be separated by commas.

cipherSuites

The cipher suites ArcGIS Notebook Server will use. Values must be separated by commas.

allowInternetCORSAccess

Setting this property to true allows web applications to access services on intranets. When this property is set to true (default), ArcGIS Notebook Server sets a response header called Access-Control-Allow-Private-Network for HTTP OPTIONS requests.

This parameter supports the Private Network Access web specification (CORS-RFC1918), which aims to protect websites accessed over a private network from making internal cross-origin (CORS) requests.

Values: true | false

authenticationMode

Specifies the authentication mode used by ArcGIS Notebook Server. When ArcGIS Notebook Server is federated with an ArcGIS Enterprise portal, this parameter can be included and set to ARCGIS_PORTAL_TOKEN .

Values: ARCGIS_TOKEN | ARCGIS_PORTAL_TOKEN

authenticationTier

The tier at which requests to access GIS services are authenticated. Do not use this directory to modify your setting. The default value when the site is first created is NOTEBOOK_SERVER , but when you federate the site with your portal, the value is changed to ARCGIS_PORTAL .

tokenServiceKey

The key used to encrypt tokens.

f

The response format. The default response format is html .

Values: html | json | pjson

Portal properties

The following optional properties (portalProperties ) are specified when federating ArcGIS Server with an ArcGIS Enterprise portal:

PropertyDetails

portalMode

Must be the value ARCGIS_PORTAL_FEDERATION .

portalSecretKey

The key obtained after federating ArcGIS Notebook Server with the portal.

portalURL

The URL of the portal in the format https://webadaptorhost.domain.com/webadaptorname .

referer

The referer specified when generating the token.

serverId

The ID of the server federated with the portal.

serverUrl

The external URL of the federated ArcGIS Notebook Server in the format https://webadaptorhost.domain.com/webadaptorname .

token

A token obtained from the portal for initial validation of ArcGIS Notebook Server.

webgisServerTrustKey

A key for establishing trust between servers that are federated with the same portal.

privateHostingServerUrl

The private URL of the portal's hosting server.

privatePortalUrl

The private URL of the portal.

JSON Response example

Use dark colors for code blocksCopy
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
{
    "serverRole": "FEDERATED_SERVER",
    "authenticationTier": "ARCGIS_PORTAL",
    "cipherSuites": "TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384, TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384, TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA, TLS_DHE_RSA_WITH_AES_256_GCM_SHA384, TLS_DHE_RSA_WITH_AES_256_CBC_SHA256, TLS_DHE_RSA_WITH_AES_256_CBC_SHA, TLS_RSA_WITH_AES_256_GCM_SHA384, TLS_RSA_WITH_AES_256_CBC_SHA256, TLS_RSA_WITH_AES_256_CBC_SHA, TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256, TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256, TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA, TLS_DHE_RSA_WITH_AES_128_GCM_SHA256, TLS_DHE_RSA_WITH_AES_128_CBC_SHA256, TLS_DHE_RSA_WITH_AES_128_CBC_SHA, TLS_RSA_WITH_AES_128_GCM_SHA256, TLS_RSA_WITH_AES_128_CBC_SHA256, TLS_RSA_WITH_AES_128_CBC_SHA",
    "serverType": "ARCGIS_NOTEBOOK_SERVER",
    "tokenServiceKey": "JqQZ5aOmOYW7eo4ux/oMZCIHkUkFhO1pTaw=",
    "httpsProtocols": "TLSv1.2",
    "authenticationMode": "ARCGIS_PORTAL_TOKEN",
    "serverFunction": "NotebookServer",
    "portalProperties": {
        "webgisServerTrustKey": "0i5Ey0cKVX+VmDIV/+4Mv2pnEwW9GUD4d8tOZk",
        "portalSecretKey": "ff9c7eec38cc44b7bb0b5408a4c6dcc7",
        "privatePortalUrl": "https://portal.domain.COM:7443/arcgis",
        "portalUrl": "https://portal.domain.com/portal",
        "serverUrl": "https://notebookserver.domain.com/dsx",
        "portalMode": "ARCGIS_PORTAL_FEDERATION",
        "privateHostingServerUrl": "https://notebookserver.domain.com:6443/arcgis",
        "serverId": "lL6KtZlHyUsIE"
    }
}

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