IP Source
This document provides that provides the API documentation for managing conditional factor configurations for IP sources in ManageEngine ID360.
Download IP Source OpenAPI Document
End Points
List IP Sources
Create IP Source
Bulk delete IP Sources
Get IP Source by ID
Update IP Source by ID
Delete IP Source by ID
List Conditional Access Policies for a Specific IP Source
Attribute
id
string
Unique identifier for the conditional factor configuration.
display_name
string
Display name for the conditional factor configuration.
ca_policies_usage_count
integer
Number of conditional access policies using this factor.
last_modified_time
date-time
Last modified time of the configuration.
is_trusted_source
boolean
Indicates if the source is trusted.
ip_addresses
string
Comma-separated list of IP addresses.
ip_address_ranges
array
from
string
Start of the IP address range.
to
string
End of the IP address range.
{
"id": "20000000001",
"display_name": "Corp Network",
"ca_policies_usage_count": 5,
"last_modified_time": "2023-10-01T12:00:00Z",
"is_trusted_source": true,
"ip_addresses": "10.0.0.1,10.0.0.2,10.0.0.3",
"ip_address_ranges": [
{
"from": "10.0.0.1",
"to": "10.0.0.200"
}
]
}
List IP Sources
List all conditional factor configurations for IP sources.
OAuth Scope : id360.conditional_factor_config.read,id360.conditional_factor_config.all
Query Parameters
fields
Comma-separated list of fields to include in the response.
eg: id,name,description,is_enabled,assignment,access_type,endpoint_settings,advanced_settings
eg: id,name,description,is_enabled,assignment,access_type,endpoint_settings,advanced_settings
from
Start index for pagination.
limit
Maximum number of records to return in the response.
eg: 50
eg: 50
filter
Filter users based on a the provided SCIM filter query. Refer to filter section for more details
eg: name eq "Policy 01"
eg: name eq "Policy 01"
headers_data = Map();
headers_data.put("Accept", "application/json");
headers_data.put("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f");
response = invokeUrl
[
url: "https://id360.manageengine.com/api/v1/protection/conditionalfactor-configs/ipsources"
type: GET
headers: headers_data
connection: <connection_name>
];
info response;
OkHttpClient client = new OkHttpClient();
Request request = new Request.Builder()
.url("https://id360.manageengine.com/api/v1/protection/conditionalfactor-configs/ipsources")
.get()
.addHeader("Accept", "application/json")
.addHeader("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f")
.build();
Response response = client.newCall(request).execute();
const options = {
method: 'GET',
headers: {
Accept: 'application/json',
Authorization: 'Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'
}
};
fetch('https://id360.manageengine.com/api/v1/protection/conditionalfactor-configs/ipsources', options)
.then(response => response.json())
.then(response => console.log(response))
.catch(err => console.error(err));
import http.client
conn = http.client.HTTPSConnection("id360.manageengine.com")
headers = {
'Accept': "application/json",
'Authorization': "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f"
}
conn.request("GET", "/api/v1/protection/conditionalfactor-configs/ipsources", headers=headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
const http = require("https");
const options = {
"method": "GET",
"hostname": "id360.manageengine.com",
"port": null,
"path": "/api/v1/protection/conditionalfactor-configs/ipsources",
"headers": {
"Accept": "application/json",
"Authorization": "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f"
}
};
const req = http.request(options, function (res) {
const chunks = [];
res.on("data", function (chunk) {
chunks.push(chunk);
});
res.on("end", function () {
const body = Buffer.concat(chunks);
console.log(body.toString());
});
});
req.end();
curl --request GET \
--url https://id360.manageengine.com/api/v1/protection/conditionalfactor-configs/ipsources \
--header 'Accept: application/json' \
--header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'
{
"data": [
{
"id": "20000000001",
"display_name": "Corp Network",
"ca_policies_usage_count": 5,
"last_modified_time": "2023-10-01T12:00:00Z",
"is_trusted_source": true,
"ip_addresses": "10.0.0.1,10.0.0.2,10.0.0.3",
"ip_address_ranges": [
{
"from": "10.0.0.1",
"to": "10.0.0.200"
}
]
},
{
"id": "20000000002",
"display_name": "Remote Office",
"ca_policies_usage_count": 3,
"last_modified_time": "2023-10-01T12:00:00Z",
"is_trusted_source": false,
"ip_addresses": "110.0.0.1,110.0.0.2,110.0.0.3",
"ip_address_ranges": [
{
"from": "110.0.0.1",
"to": "110.0.0.200"
}
]
}
],
"meta": {
"start_index": 1,
"limit": 100,
"total_no_of_objects": 3
}
}
{
"error": {
"code": "00000101",
"title": "Unauthorized",
"detail": "The OAuth token is invalid."
}
}
{
"error": {
"code": "00000000",
"title": "Internal Server Error",
"detail": "An unexpected internal error has occurred on the server. Please try again later."
}
}
Create IP Source
Create a conditional factor configuration for IP sources.
OAuth Scope : id360.conditional_factor_config.create,id360.conditional_factor_config.all
Arguments
display_name
string
Display name for the conditional factor configuration.
is_trusted_source
boolean
Indicates if the source is trusted.
ip_addresses
string
Comma-separated list of IP addresses.
ip_address_ranges
array
from
string
Start of the IP address range.
to
string
End of the IP address range.
parameters_data='{"field1":"value1","field2":"value2"}';
headers_data = Map();
headers_data.put("Accept", "application/json");
headers_data.put("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f");
response = invokeUrl
[
url: "https://id360.manageengine.com/api/v1/protection/conditionalfactor-configs/ipsources"
type: POST
headers: headers_data
content-type: application/json
parameters: parameters_data
connection: <connection_name>
];
info response;
OkHttpClient client = new OkHttpClient();
MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "{\"field1\":\"value1\",\"field2\":\"value2\"}");
Request request = new Request.Builder()
.url("https://id360.manageengine.com/api/v1/protection/conditionalfactor-configs/ipsources")
.post(body)
.addHeader("Accept", "application/json")
.addHeader("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f")
.addHeader("content-type", "application/json")
.build();
Response response = client.newCall(request).execute();
const options = {
method: 'POST',
headers: {
Accept: 'application/json',
Authorization: 'Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f',
'content-type': 'application/json'
},
body: '{"field1":"value1","field2":"value2"}'
};
fetch('https://id360.manageengine.com/api/v1/protection/conditionalfactor-configs/ipsources', options)
.then(response => response.json())
.then(response => console.log(response))
.catch(err => console.error(err));
import http.client
conn = http.client.HTTPSConnection("id360.manageengine.com")
payload = "{\"field1\":\"value1\",\"field2\":\"value2\"}"
headers = {
'Accept': "application/json",
'Authorization': "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f",
'content-type': "application/json"
}
conn.request("POST", "/api/v1/protection/conditionalfactor-configs/ipsources", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
const http = require("https");
const options = {
"method": "POST",
"hostname": "id360.manageengine.com",
"port": null,
"path": "/api/v1/protection/conditionalfactor-configs/ipsources",
"headers": {
"Accept": "application/json",
"Authorization": "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f",
"content-type": "application/json"
}
};
const req = http.request(options, function (res) {
const chunks = [];
res.on("data", function (chunk) {
chunks.push(chunk);
});
res.on("end", function () {
const body = Buffer.concat(chunks);
console.log(body.toString());
});
});
req.write(JSON.stringify({field1: 'value1', field2: 'value2'}));
req.end();
curl --request POST \
--url https://id360.manageengine.com/api/v1/protection/conditionalfactor-configs/ipsources \
--header 'Accept: application/json' \
--header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f' \
--header 'content-type: application/json' \
--data '{"field1":"value1","field2":"value2"}'
{
"display_name": "Corp Network",
"is_trusted_source": true,
"ip_addresses": "10.0.0.1,10.0.0.2,10.0.0.3",
"ip_address_ranges": [
{
"from": "10.0.0.1",
"to": "10.0.0.200"
}
]
}
{
"id": "20000000001",
"display_name": "Corp Network",
"ca_policies_usage_count": 5,
"last_modified_time": "2023-10-01T12:00:00Z",
"is_trusted_source": true,
"ip_addresses": "10.0.0.1,10.0.0.2,10.0.0.3",
"ip_address_ranges": [
{
"from": "10.0.0.1",
"to": "10.0.0.200"
}
]
}
{
"error": {
"code": "00000101",
"title": "Unauthorized",
"detail": "The OAuth token is invalid."
}
}
{
"error": {
"code": "00000000",
"title": "Internal Server Error",
"detail": "An unexpected internal error has occurred on the server. Please try again later."
}
}
Bulk delete IP Sources
Bulk delete conditional factor configurations for IP sources.
OAuth Scope : id360.conditional_factor_config.delete,id360.conditional_factor_config.all
Query Parameters
ids
(Required)
Comma-separated list of IDs to be deleted
headers_data = Map();
headers_data.put("Accept", "application/json");
headers_data.put("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f");
response = invokeUrl
[
url: "https://id360.manageengine.com/api/v1/protection/conditionalfactor-configs/ipsources?ids=2000000000001,2000000000002"
type: DELETE
headers: headers_data
connection: <connection_name>
];
info response;
OkHttpClient client = new OkHttpClient();
Request request = new Request.Builder()
.url("https://id360.manageengine.com/api/v1/protection/conditionalfactor-configs/ipsources?ids=2000000000001%2C2000000000002")
.delete(null)
.addHeader("Accept", "application/json")
.addHeader("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f")
.build();
Response response = client.newCall(request).execute();
const options = {
method: 'DELETE',
headers: {
Accept: 'application/json',
Authorization: 'Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'
}
};
fetch('https://id360.manageengine.com/api/v1/protection/conditionalfactor-configs/ipsources?ids=2000000000001%2C2000000000002', options)
.then(response => response.json())
.then(response => console.log(response))
.catch(err => console.error(err));
import http.client
conn = http.client.HTTPSConnection("id360.manageengine.com")
headers = {
'Accept': "application/json",
'Authorization': "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f"
}
conn.request("DELETE", "/api/v1/protection/conditionalfactor-configs/ipsources?ids=2000000000001%2C2000000000002", headers=headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
const http = require("https");
const options = {
"method": "DELETE",
"hostname": "id360.manageengine.com",
"port": null,
"path": "/api/v1/protection/conditionalfactor-configs/ipsources?ids=2000000000001%2C2000000000002",
"headers": {
"Accept": "application/json",
"Authorization": "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f"
}
};
const req = http.request(options, function (res) {
const chunks = [];
res.on("data", function (chunk) {
chunks.push(chunk);
});
res.on("end", function () {
const body = Buffer.concat(chunks);
console.log(body.toString());
});
});
req.end();
curl --request DELETE \
--url 'https://id360.manageengine.com/api/v1/protection/conditionalfactor-configs/ipsources?ids=2000000000001%2C2000000000002' \
--header 'Accept: application/json' \
--header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'
[
{
"resource_id": "2000000000001",
"status": 204
},
{
"resource_id": "2000000000002",
"status": 404,
"error": {
"code": "*****",
"title": "Conditional Factor Config Not Found",
"detail": "The conditional factor configuration with the specified ID does not exist."
}
}
]
{
"error": {
"code": "00000101",
"title": "Unauthorized",
"detail": "The OAuth token is invalid."
}
}
{
"error": {
"code": "00000000",
"title": "Internal Server Error",
"detail": "An unexpected internal error has occurred on the server. Please try again later."
}
}
Get IP Source by ID
Retrieve a conditional factor configuration for IP sources by its ID.
OAuth Scope : id360.conditional_factor_config.read,id360.conditional_factor_config.all
headers_data = Map();
headers_data.put("Accept", "application/json");
headers_data.put("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f");
response = invokeUrl
[
url: "https://id360.manageengine.com/api/v1/protection/conditionalfactor-configs/ipsources/2000000000001"
type: GET
headers: headers_data
connection: <connection_name>
];
info response;
OkHttpClient client = new OkHttpClient();
Request request = new Request.Builder()
.url("https://id360.manageengine.com/api/v1/protection/conditionalfactor-configs/ipsources/2000000000001")
.get()
.addHeader("Accept", "application/json")
.addHeader("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f")
.build();
Response response = client.newCall(request).execute();
const options = {
method: 'GET',
headers: {
Accept: 'application/json',
Authorization: 'Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'
}
};
fetch('https://id360.manageengine.com/api/v1/protection/conditionalfactor-configs/ipsources/2000000000001', options)
.then(response => response.json())
.then(response => console.log(response))
.catch(err => console.error(err));
import http.client
conn = http.client.HTTPSConnection("id360.manageengine.com")
headers = {
'Accept': "application/json",
'Authorization': "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f"
}
conn.request("GET", "/api/v1/protection/conditionalfactor-configs/ipsources/2000000000001", headers=headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
const http = require("https");
const options = {
"method": "GET",
"hostname": "id360.manageengine.com",
"port": null,
"path": "/api/v1/protection/conditionalfactor-configs/ipsources/2000000000001",
"headers": {
"Accept": "application/json",
"Authorization": "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f"
}
};
const req = http.request(options, function (res) {
const chunks = [];
res.on("data", function (chunk) {
chunks.push(chunk);
});
res.on("end", function () {
const body = Buffer.concat(chunks);
console.log(body.toString());
});
});
req.end();
curl --request GET \
--url https://id360.manageengine.com/api/v1/protection/conditionalfactor-configs/ipsources/2000000000001 \
--header 'Accept: application/json' \
--header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'
{
"id": "20000000001",
"display_name": "Corp Network",
"ca_policies_usage_count": 5,
"last_modified_time": "2023-10-01T12:00:00Z",
"is_trusted_source": true,
"ip_addresses": "10.0.0.1,10.0.0.2,10.0.0.3",
"ip_address_ranges": [
{
"from": "10.0.0.1",
"to": "10.0.0.200"
}
]
}
{
"error": {
"code": "00000101",
"title": "Unauthorized",
"detail": "The OAuth token is invalid."
}
}
{
"error": {
"code": "*****",
"title": "Conditional Factor Config Not Found",
"detail": "The conditional factor configuration with the specified ID does not exist."
}
}
{
"error": {
"code": "00000000",
"title": "Internal Server Error",
"detail": "An unexpected internal error has occurred on the server. Please try again later."
}
}
Update IP Source by ID
Update a conditional factor configuration for IP sources by its ID.
OAuth Scope : id360.conditional_factor_config.update,id360.conditional_factor_config.all
Arguments
display_name
string
Display name for the conditional factor configuration.
is_trusted_source
boolean
Indicates if the source is trusted.
ip_addresses
string
Comma-separated list of IP addresses.
ip_address_ranges
array
from
string
Start of the IP address range.
to
string
End of the IP address range.
parameters_data='{"display_name":"Corp Network","is_trusted_source":true,"ip_addresses":"10.0.0.1,10.0.0.2,10.0.0.3","ip_address_ranges":[{"from":"10.0.0.1","to":"10.0.0.200"}]}';
headers_data = Map();
headers_data.put("Accept", "application/json");
headers_data.put("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f");
response = invokeUrl
[
url: "https://id360.manageengine.com/api/v1/protection/conditionalfactor-configs/ipsources/2000000000001"
type: PATCH
headers: headers_data
content-type: application/json
parameters: parameters_data
connection: <connection_name>
];
info response;
OkHttpClient client = new OkHttpClient();
MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "{\"display_name\":\"Corp Network\",\"is_trusted_source\":true,\"ip_addresses\":\"10.0.0.1,10.0.0.2,10.0.0.3\",\"ip_address_ranges\":[{\"from\":\"10.0.0.1\",\"to\":\"10.0.0.200\"}]}");
Request request = new Request.Builder()
.url("https://id360.manageengine.com/api/v1/protection/conditionalfactor-configs/ipsources/2000000000001")
.patch(body)
.addHeader("Accept", "application/json")
.addHeader("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f")
.addHeader("content-type", "application/json")
.build();
Response response = client.newCall(request).execute();
const options = {
method: 'PATCH',
headers: {
Accept: 'application/json',
Authorization: 'Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f',
'content-type': 'application/json'
},
body: '{"display_name":"Corp Network","is_trusted_source":true,"ip_addresses":"10.0.0.1,10.0.0.2,10.0.0.3","ip_address_ranges":[{"from":"10.0.0.1","to":"10.0.0.200"}]}'
};
fetch('https://id360.manageengine.com/api/v1/protection/conditionalfactor-configs/ipsources/2000000000001', options)
.then(response => response.json())
.then(response => console.log(response))
.catch(err => console.error(err));
import http.client
conn = http.client.HTTPSConnection("id360.manageengine.com")
payload = "{\"display_name\":\"Corp Network\",\"is_trusted_source\":true,\"ip_addresses\":\"10.0.0.1,10.0.0.2,10.0.0.3\",\"ip_address_ranges\":[{\"from\":\"10.0.0.1\",\"to\":\"10.0.0.200\"}]}"
headers = {
'Accept': "application/json",
'Authorization': "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f",
'content-type': "application/json"
}
conn.request("PATCH", "/api/v1/protection/conditionalfactor-configs/ipsources/2000000000001", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
const http = require("https");
const options = {
"method": "PATCH",
"hostname": "id360.manageengine.com",
"port": null,
"path": "/api/v1/protection/conditionalfactor-configs/ipsources/2000000000001",
"headers": {
"Accept": "application/json",
"Authorization": "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f",
"content-type": "application/json"
}
};
const req = http.request(options, function (res) {
const chunks = [];
res.on("data", function (chunk) {
chunks.push(chunk);
});
res.on("end", function () {
const body = Buffer.concat(chunks);
console.log(body.toString());
});
});
req.write(JSON.stringify({
display_name: 'Corp Network',
is_trusted_source: true,
ip_addresses: '10.0.0.1,10.0.0.2,10.0.0.3',
ip_address_ranges: [{from: '10.0.0.1', to: '10.0.0.200'}]
}));
req.end();
curl --request PATCH \
--url https://id360.manageengine.com/api/v1/protection/conditionalfactor-configs/ipsources/2000000000001 \
--header 'Accept: application/json' \
--header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f' \
--header 'content-type: application/json' \
--data '{"display_name":"Corp Network","is_trusted_source":true,"ip_addresses":"10.0.0.1,10.0.0.2,10.0.0.3","ip_address_ranges":[{"from":"10.0.0.1","to":"10.0.0.200"}]}'
{
"display_name": "Corp Network",
"is_trusted_source": true,
"ip_addresses": "10.0.0.1,10.0.0.2,10.0.0.3",
"ip_address_ranges": [
{
"from": "10.0.0.1",
"to": "10.0.0.200"
}
]
}
{
"id": "20000000001",
"display_name": "Corp Network",
"ca_policies_usage_count": 5,
"last_modified_time": "2023-10-01T12:00:00Z",
"is_trusted_source": true,
"ip_addresses": "10.0.0.1,10.0.0.2,10.0.0.3",
"ip_address_ranges": [
{
"from": "10.0.0.1",
"to": "10.0.0.200"
}
]
}
{
"error": {
"code": "00000101",
"title": "Unauthorized",
"detail": "The OAuth token is invalid."
}
}
{
"error": {
"code": "*****",
"title": "Conditional Factor Config Not Found",
"detail": "The conditional factor configuration with the specified ID does not exist."
}
}
{
"error": {
"code": "00000000",
"title": "Internal Server Error",
"detail": "An unexpected internal error has occurred on the server. Please try again later."
}
}
Delete IP Source by ID
Delete a conditional factor configuration for IP sources by its ID.
OAuth Scope : id360.conditional_factor_config.delete,id360.conditional_factor_config.all
headers_data = Map();
headers_data.put("Accept", "application/json");
headers_data.put("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f");
response = invokeUrl
[
url: "https://id360.manageengine.com/api/v1/protection/conditionalfactor-configs/ipsources/2000000000001"
type: DELETE
headers: headers_data
connection: <connection_name>
];
info response;
OkHttpClient client = new OkHttpClient();
Request request = new Request.Builder()
.url("https://id360.manageengine.com/api/v1/protection/conditionalfactor-configs/ipsources/2000000000001")
.delete(null)
.addHeader("Accept", "application/json")
.addHeader("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f")
.build();
Response response = client.newCall(request).execute();
const options = {
method: 'DELETE',
headers: {
Accept: 'application/json',
Authorization: 'Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'
}
};
fetch('https://id360.manageengine.com/api/v1/protection/conditionalfactor-configs/ipsources/2000000000001', options)
.then(response => response.json())
.then(response => console.log(response))
.catch(err => console.error(err));
import http.client
conn = http.client.HTTPSConnection("id360.manageengine.com")
headers = {
'Accept': "application/json",
'Authorization': "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f"
}
conn.request("DELETE", "/api/v1/protection/conditionalfactor-configs/ipsources/2000000000001", headers=headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
const http = require("https");
const options = {
"method": "DELETE",
"hostname": "id360.manageengine.com",
"port": null,
"path": "/api/v1/protection/conditionalfactor-configs/ipsources/2000000000001",
"headers": {
"Accept": "application/json",
"Authorization": "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f"
}
};
const req = http.request(options, function (res) {
const chunks = [];
res.on("data", function (chunk) {
chunks.push(chunk);
});
res.on("end", function () {
const body = Buffer.concat(chunks);
console.log(body.toString());
});
});
req.end();
curl --request DELETE \
--url https://id360.manageengine.com/api/v1/protection/conditionalfactor-configs/ipsources/2000000000001 \
--header 'Accept: application/json' \
--header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'
{
"error": {
"code": "00000101",
"title": "Unauthorized",
"detail": "The OAuth token is invalid."
}
}
{
"error": {
"code": "*****",
"title": "Conditional Factor Config Not Found",
"detail": "The conditional factor configuration with the specified ID does not exist."
}
}
{
"error": {
"code": "00000000",
"title": "Internal Server Error",
"detail": "An unexpected internal error has occurred on the server. Please try again later."
}
}
List Conditional Access Policies for a Specific IP Source
List all conditional access policies associated with a specific conditional factor configuration for IP sources.
OAuth Scope : id360.conditional_factor_config.read,id360.conditional_factor_config.all
Query Parameters
from
Start index for pagination.
limit
Maximum number of records to return in the response.
eg: 50
eg: 50
filter
Filter users based on a the provided SCIM filter query. Refer to filter section for more details
eg: name eq "Policy 01"
eg: name eq "Policy 01"
headers_data = Map();
headers_data.put("Accept", "application/json");
headers_data.put("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f");
response = invokeUrl
[
url: "https://id360.manageengine.com/api/v1/protection/conditionalfactor-configs/ipsources/2000000000001/conditional-access-policies"
type: GET
headers: headers_data
connection: <connection_name>
];
info response;
OkHttpClient client = new OkHttpClient();
Request request = new Request.Builder()
.url("https://id360.manageengine.com/api/v1/protection/conditionalfactor-configs/ipsources/2000000000001/conditional-access-policies")
.get()
.addHeader("Accept", "application/json")
.addHeader("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f")
.build();
Response response = client.newCall(request).execute();
const options = {
method: 'GET',
headers: {
Accept: 'application/json',
Authorization: 'Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'
}
};
fetch('https://id360.manageengine.com/api/v1/protection/conditionalfactor-configs/ipsources/2000000000001/conditional-access-policies', options)
.then(response => response.json())
.then(response => console.log(response))
.catch(err => console.error(err));
import http.client
conn = http.client.HTTPSConnection("id360.manageengine.com")
headers = {
'Accept': "application/json",
'Authorization': "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f"
}
conn.request("GET", "/api/v1/protection/conditionalfactor-configs/ipsources/2000000000001/conditional-access-policies", headers=headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
const http = require("https");
const options = {
"method": "GET",
"hostname": "id360.manageengine.com",
"port": null,
"path": "/api/v1/protection/conditionalfactor-configs/ipsources/2000000000001/conditional-access-policies",
"headers": {
"Accept": "application/json",
"Authorization": "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f"
}
};
const req = http.request(options, function (res) {
const chunks = [];
res.on("data", function (chunk) {
chunks.push(chunk);
});
res.on("end", function () {
const body = Buffer.concat(chunks);
console.log(body.toString());
});
});
req.end();
curl --request GET \
--url https://id360.manageengine.com/api/v1/protection/conditionalfactor-configs/ipsources/2000000000001/conditional-access-policies \
--header 'Accept: application/json' \
--header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'
{
"data": [
[
{
"id": "2000000000001",
"name": "Policy 01",
"associated_endpoints": [
"Computer Devices",
"VPN & Radius Endpoints"
]
},
{
"id": "2000000000002",
"name": "Policy 02",
"associated_endpoints": [
"All Endpoints"
]
},
{
"id": "2000000000003",
"name": "Policy 03",
"associated_endpoints": [
"Computer Devices"
]
}
]
],
"meta": {
"start_index": 1,
"limit": 100,
"total_no_of_objects": 3
}
}
{
"error": {
"code": "00000101",
"title": "Unauthorized",
"detail": "The OAuth token is invalid."
}
}
{
"error": {
"code": "*****",
"title": "Conditional Factor Config Not Found",
"detail": "The conditional factor configuration with the specified ID does not exist."
}
}
{
"error": {
"code": "00000000",
"title": "Internal Server Error",
"detail": "An unexpected internal error has occurred on the server. Please try again later."
}
}