Utilisez ce point d'accès pour obtenir des détails sur votre ou vos configuration(s) de pilotage :
- Informations sur la configuration de la direction
- Exceptions pour la configuration de pilotage
- Configuration du pilotage sur site et hors site et informations sur les exceptions si la configuration a activé le pilotage en fonction de la localisation.
Point final de la demande
https://<tenant-URL>/api/v1/steeringconfig
Valid query parameters are:
| Clé | Value | Description |
|---|---|---|
token | string | Il s'agit d'une obligation. Le jeton obtenu sur la page de l'API REST dans l'interface utilisateur de Netskope ( Settings > Tools > Rest API v1) est nécessaire. Nous vous recommandons de placer le jeton dans le corps de la demande, et non dans l'URL du point final. |
config | Chaîne de caractères codée en URL | Filtre les résultats par le nom de configuration de direction. Utilisez une valeur config (nom) de l’API steeringconfiglist . |
config_id | Entier positif (spécifique à une configuration de pilotage) | Filtre les résultats par l’ID de configuration de direction. Utilisez une valeur config_id de l’API steeringconfiglist . |
limit | Entier positif inférieur à 10000 | Les réponses de l'API REST peuvent renvoyer jusqu'à 10000 enregistrements dans une seule réponse. Vous pouvez utiliser la pagination pour obtenir davantage de résultats. |
skip | Nombre entier positif | Passez certains enregistrements (utile pour la pagination en combinaison avec limit). |
Note
Si vous n'utilisez pas config ou config_id, vous obtiendrez toutes les informations relatives à la configuration de la direction.
Exemple de demande avec réponse en utilisant le pilotage basé sur la localisation
Notez que le nom de la configuration transmis dans les paramètres est codé en URL.
POST 'https://<tenant-URL>/api/v1/steeringconfig?config=location%20based%20steering
{
"token": "f32a973eddd7bc1602fc0f48dc0a"
}
{
"status": "success",
"msg": "",
"data": [
{
"steering_config": "location based steering",
"enabled": true,
"location_based_steering": true,
"private_apps_enabled": false,
"priority": "2",
"on_prem": {
"steered_traffic": {
"data": [
{
"app_id": "101",
"app_name": "Adrenalin",
"disabled": "0",
"app_domains": "adrenalin.com",
"app_category": "HR",
"modify_time": "2019-08-19 17:38:15",
"app_cci": "31",
"app_ccl": "poor"
},
{
"app_id": "105",
"app_name": "ProcessManagement",
"disabled": "0",
"app_domains": "processmanagement.com",
"app_category": "Business Process Management",
"modify_time": "2019-08-19 17:38:15",
"app_cci": "63",
"app_ccl": "medium"
}
],
"count": 2
},
"exceptions": {
"applictions": {
"data": [
],
"count": 0
},
"domains": {
"data": [
],
"count": 0
},
"src_netloc": {
"data": [
],
"count": 0
},
"dst_netloc": {
"data": [
{
"notes": "on-prem: [default destination location]",
"dst_netloc": [
"Local IP address range"
]
}
],
"count": 1
},
"countries": {
"data": [
],
"count": 0
},
"cert_pinned_apps": {
"data": [
{
"notes": "on-prem: [default ssl pinned app]",
"app_name": "Amazon CloudDrive",
"enabled": true,
"data": {
"custom": false,
"appName": "Amazon CloudDrive",
"android": {
"action": "1",
"processes": [
"com.amazon.clouddrive",
"com.amazon.clouddrive"
],
"enabled": true,
"domains": [
"drive.amazonaws.com",
"us-east-1.amazonaws.com",
"us-west-2.amazonaws.com",
"drive.amazon.com",
"amazon.ca",
"amazon.in",
"amazon.co.uk"
]
},
"mac": {
"action": "1",
"processes": [
"Amazon Cloud Dr",
"Amazon Cloud Drive Sync Service",
"Amazon Cloud Drive"
],
"enabled": true,
"managed_device": false,
"tunnel": false,
"tunnel_domains": [
]
},
"windows": {
"action": "1",
"processes": [
"AmazonCloudDriveW.exe",
"AmazonCloudDrive.exe"
],
"enabled": true,
"managed_device": false,
"tunnel": false,
"tunnel_domains": [
]
},
"ios": {
"action": "1",
"processes": [
],
"enabled": false,
"domains": [
"drive.amazonaws.com",
"us-east-1.amazonaws.com",
"us-west-2.amazonaws.com",
"drive.amazon.com",
"amazon.ca",
"amazon.in",
"amazon.co.uk"
]
}
}
}
],
"count": 1
}
}
},
"off_prem": {
"steered_traffic": {
"data": [
],
"count": 0
},
"exceptions": {
"categories": {
"data": [
{
"categories": [
"Finance/Accounting",
"Internet Telephony",
"Streaming & Downloadable Audio",
"Streaming & Downloadable Video",
"Telecom and Call Center",
"Web Conferencing"
],
"notes": "off-prem: [default categories]"
}
],
"count": 1
},
"domains": {
"data": [
{
"domains": [
"android.clients.google.com",
"apple.com",
"gs.apple.com",
"itunes.apple.com",
"play.google.com",
"webex.com",
"youtube.com"
],
"notes": "off-prem: [default domains]"
}
],
"count": 1
},
"src_netloc": {
"data": [
],
"count": 0
},
"dst_netloc": {
"data": [
{
"notes": "off-prem: [default destination location]",
"dst_netloc": [
"Local IP address range"
]
}
],
"count": 1
},
"countries": {
"data": [
],
"count": 0
},
"cert_pinned_apps": {
"data": [
{
"notes": "off-prem: [default ssl pinned app]",
"app_name": "Amazon CloudDrive",
"enabled": true,
"data": {
"custom": false,
"appName": "Amazon CloudDrive",
"android": {
"action": "1",
"processes": [
"com.amazon.clouddrive",
"com.amazon.clouddrive"
],
"enabled": true,
"domains": [
"drive.amazonaws.com",
"us-east-1.amazonaws.com",
"us-west-2.amazonaws.com",
"drive.amazon.com",
"amazon.ca",
"amazon.in",
"amazon.co.uk"
]
},
"mac": {
"action": "1",
"processes": [
"Amazon Cloud Dr",
"Amazon Cloud Drive Sync Service",
"Amazon Cloud Drive"
],
"enabled": true,
"managed_device": false,
"tunnel": false,
"tunnel_domains": [
]
},
"windows": {
"action": "1",
"processes": [
"AmazonCloudDriveW.exe",
"AmazonCloudDrive.exe"
],
"enabled": true,
"managed_device": false,
"tunnel": false,
"tunnel_domains": [
]
},
"ios": {
"action": "1",
"processes": [
],
"enabled": false,
"domains": [
"drive.amazonaws.com",
"us-east-1.amazonaws.com",
"us-west-2.amazonaws.com",
"drive.amazon.com",
"amazon.ca",
"amazon.in",
"amazon.co.uk"
]
}
}
}
],
"count": 1
}
}
}
}
]
}
Exemple de demande avec réponse utilisant l'ID de configuration
POST 'https://<tenant-URL>/api/v1/steeringconfig?config_id=2
{
"token": "f32a973eddd7bc1602fc0f48dc0a"
}
{
status: "success",
msg: "",
data: [
{
steering_config: "web",
enabled: true,
location_based_steering: false,
private_apps_enabled: false,
priority: "1",
traffic_type: "web",
steered_traffic: {
data: [
],
count: 0
},
exceptions: {
categories: {
data: [
{
categories: [
"Adult Content - Other",
"Advocacy Groups & Trade Associations"
],
notes: "bypass categories"
}
],
count: 1
},
domains: {
data: [
{
domains: [
],
notes: null
},
{
domains: [
"www.facebook.com",
"www.google.com"
],
notes: "bypass google and facebook"
}
],
count: 2
},
src_netloc: {
data: [
{
notes: "bypass source locations",
src_netloc: [
"Any network 2",
"Lab Subnet"
]
}
],
count: 1
},
dst_netloc: {
data: [
{
notes: "default destination location",
dst_netloc: [
"Local IP address range"
]
},
{
notes: "bypass destination locations",
dst_netloc: [
"162.16.192.65-range OUTside",
"nw_location"
]
}
],
count: 2
},
countries: {
data: [
{
notes: "bypass traffic from these countries",
countries: [
"Andorra",
"American Samoa"
]
}
],
count: 1
},
cert_pinned_apps: {
data: [
{
notes: "default ssl pinned app",
app_name: "Amazon CloudDrive",
enabled: true,
data: {
custom: false,
appName: "Amazon CloudDrive",
android: {
action: "1",
processes: [
"com.amazon.clouddrive",
"com.amazon.clouddrive"
],
enabled: true,
domains: [
"drive.amazonaws.com",
"us-east-1.amazonaws.com",
"us-west-2.amazonaws.com",
"drive.amazon.com",
"amazon.ca",
"amazon.in",
"amazon.co.uk"
]
},
mac: {
action: "1",
processes: [
"Amazon Cloud Dr",
"Amazon Cloud Drive Sync Service",
"Amazon Cloud Drive"
],
enabled: true,
managed_device: false,
tunnel: false,
tunnel_domains: [
]
},
windows: {
action: "1",
processes: [
"AmazonCloudDriveW.exe",
"AmazonCloudDrive.exe"
],
enabled: true,
managed_device: false,
tunnel: false,
tunnel_domains: [
]
},
ios: {
action: "1",
processes: [
],
enabled: false,
domains: [
"drive.amazonaws.com",
"us-east-1.amazonaws.com",
"us-west-2.amazonaws.com",
"drive.amazon.com",
"amazon.ca",
"amazon.in",
"amazon.co.uk"
]
}
}
},
{
notes: "default ssl pinned app",
app_name: "Ablaze",
enabled: true,
data: {
custom: false,
appName: "Adrenalin",
windows: {
action: "1",
processes: [
"Adrnln.exe"
],
enabled: true,
managed_device: false,
tunnel: false,
tunnel_domains: [
]
},
mac: {
action: "1",
managed_device: false,
tunnel: false,
tunnel_domains: [
],
processes: [
],
enabled: false,
domains: [
"adrenalin.com"
]
},
android: {
action: "1",
processes: [
],
enabled: false,
domains: [
"adrenalin.com"
]
},
ios: {
action: "1",
processes: [
],
enabled: false,
domains: [
"adrenalin.com"
]
}
}
}
],
count: 2
}
}
}
]
}