Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Juniper Mist AI Orgs NAC Rules API

The NAC Rules (or Auth Policies) are a set of rules that devices and users must fulfill in order to gain access to the network and use network resources.Juniper Mist Access Assurance evaluates authentication requests based on the specified policy conditions. If a user or device satisfies the conditions, Mist Access Assurance applies actions that either allow or deny access to the user or device.These actions can also apply attributes such as VLAN and role to the allowed users. Mist Access Assurance uses "NAC Tags" (or Auth Policy Labels) as the policy matching criteria and as a policy action for allowed users. NAC Tags can be managed with the [Orgs NAC Tags API Calls]($h/Orgs%20NAC%20Tags/_overview)

Juniper Mist AI Orgs NAC Rules API is one of 211 APIs that Juniper Mist AI publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Orgs NAC Rules. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

This API exposes 5 operations across 2 paths, and defines 26 schemas. It is described by OpenAPI 3.1.0, at version 2604.1.1.

Requests are made against 12 base URLs: https://api.mist.com, https://api.gc1.mist.com, https://api.ac2.mist.com, https://api.gc2.mist.com, https://api.gc4.mist.com, https://api.eu.mist.com, https://api.gc3.mist.com, https://api.ac6.mist.com, https://api.gc6.mist.com, https://api.ac5.mist.com, https://api.gc5.mist.com, https://api.gc7.mist.com.

5 operations 2 paths 26 schemas 1 DELETE2 GET1 POST1 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
2604.1.1
Base URL
https://api.mist.com/api/v1
Authentication
API Key, HTTP Basic, API Key
License
Resource Areas
1

Authentication & Security 3

Juniper Mist AI Orgs NAC Rules API declares 3 security schemes for authenticating requests. An API key is passed in the header as Authorization (apiToken). It accepts HTTP basic authentication (basicAuth). An API key is passed in the header as X-CSRFToken (csrfToken). By default, every request must be authenticated.

  • apiToken — Like many other API providers, it’s also possible to generate API Tokens to be used (in HTTP Header) for authentication. An API token ties to a Admin with equa…
  • basicAuth — While our current UI uses Session / Cookie-based authentication, it’s also possible to do Basic Auth.
  • csrfToken — This protects the website against [Cross Site Request Forgery](https://en.wikipedia.org/wiki/Cross-siterequestforgery), all the POST / PUT / DELETE APIs needs…

Paths & Operations 5

Across 2 paths, the API surfaces 5 operations — 1 DELETE, 2 GET, 1 POST, 1 PUT. Each is listed below with its method, path, parameters, and response codes.

Orgs NAC Rules 5

The NAC Rules (or Auth Policies) are a set of rules that devices and users must fulfill in order to gain access to the network and use network resources. Juniper Mist Access Assur…

GET
/api/v1/orgs/{org_id}/nacrules
listOrgNacRules
listOrgNacRules 3 params → 200400401403404429
POST
/api/v1/orgs/{org_id}/nacrules
createOrgNacRule
createOrgNacRule 1 param body → 200400401403404429
DELETE
/api/v1/orgs/{org_id}/nacrules/{nacrule_id}
deleteOrgNacRule
deleteOrgNacRule 2 params → 200400401403404429
GET
/api/v1/orgs/{org_id}/nacrules/{nacrule_id}
getOrgNacRule
getOrgNacRule 2 params → 200400401403404429
PUT
/api/v1/orgs/{org_id}/nacrules/{nacrule_id}
updateOrgNacRule
updateOrgNacRule 2 params body → 200400401403404429

Schemas 26

The contract defines 26 schemas that model the data the API accepts and returns. The most detailed are nac_rule (12 properties), nac_rule_matching (10 properties), response_http400 (1 property), response_http429 (1 property). Each schema is shown below with its type and property counts.

id
string
Unique ID of the object instance in the Mist Organization
nac_rule_matching
object
10 properties
response_http403
object
1 property
nac_rule_matching_sitegroup_ids
array
List of sitegroup ids to match
response_http404
object
1 property
nac_rule_matching_os_type
array
List of client device os types to match. Refer to [List Fingerprint Types]](/operations/listFingerprintTypes) for allowed ostype values
nac_rule_action
string
enum: allow, block
response_http400
object
1 property
nac_rule_matching_vendor
array
List of vendors to match
nac_rule_matching_port_type
string
enum: wired, wireless
nac_rule_matching_nactags
array
nac_rules
array
nac_rule_matching_mfg
array
List of client device manufacturers to match. Refer to [List Fingerprint Types]](/operations/listFingerprintTypes) for allowed mfg values
response_http429
object
1 property
nac_rule_matching_port_types
array
nac_rule_matching_site_ids
array
List of site ids to match
nac_rule_matching_family
array
List of client device families to match. Refer to [List Fingerprint Types]](/operations/listFingerprintTypes) for allowed family values
nac_rule_apply_tags
array
All optional, this goes into Access-Accept
nac_auth_type
string
enum: cert, device-auth, eap-teap, eap-tls, eap-ttls, idp, mab, eap-peap
nac_rule_guest_auth_state
string
Guest portal authorization state. enum: authorized, unknown
nac_rule
object
12 properties 2 required
response_http401
object
1 property
org_id
string
modified_time
number
When the object has been modified for the last time, in epoch
nac_rule_matching_model
array
List of client device models to match. Refer to [List Fingerprint Types]](/operations/listFingerprintTypes) for allowed model values
created_time
number
When the object has been created, in epoch

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

mist-ai-orgs-nac-rules-api-openapi.yml Raw ↑

Other APIs Juniper Mist AI publishes across the network.

Juniper Mist WebSocket Streaming API
Juniper Mist Webhooks API
Juniper Mist AI Admins API
Juniper Mist AI Admins Login API
Juniper Mist AI Admins Login - OAuth2 API
Juniper Mist AI Admins Logout API
Juniper Mist AI Admins Lookup API
Juniper Mist AI Admins Recover Password API
Juniper Mist AI Constants Definitions API
Juniper Mist AI Constants Events API
Juniper Mist AI Constants Models API
Juniper Mist AI Installer API