Realms

To get all apis for default realms

/api/v1/configuration/users/user-realms

Default Available:

  • /api/v1/configuration/users/user-realms/realm/Users,

  • /api/v1/configuration/users/user-realms/realm/Guest Admin,

  • /api/v1/configuration/users/user-realms/realm/Guest,

  • /api/v1/configuration/users/user-realms/realm/Guest Sponsor,

  • /api/v1/configuration/users/user-realms/realm/Cert Auth

To create a user realm:

 

Copy
POST /api/v1/configuration/users/user-realms/realm/HTTP/1.1
Host xx.xx.xx.xx
Authorization: Basic
Content-Type: application/json  
  
  
  {

    "accounting-server": "None",

    "authen-only": "false",

    "authentication-group": "",

    "authentication-policy": {

        "browser": {

            "customized": "any-user-agent",

            "user-agent-patterns": {

                "user-agent-pattern": []

            }

        },

        "certificate": {

            "cert-key-value-pairs": {

                "cert-key-value-pair": []

            },

            "customized": "allow-all-users"

        },

        "device-validation": {

            "customized": "no-attribute-validation",

            "device-attributes-android": "",

            "device-attributes-ios": ""

        },

        "host-checker": {

            "agentless-mode": "false",

            "enforce-all-policies": "false",

            "enforce-policy-list": null,

            "evaluate-all-policies": "false",

            "evaluate-logic": "all-policies-must-succeed",

            "evaluate-policy-list": null

        },

        "limits": {

            "guaranteed-minimum": null,

            "limit-concurrent-users": "false",

            "max-sessions-per-user": "1",

            "maximum": null,

            "maxuser-enable": "false",

            "maxuser-max": "1"

        },

        "password": {

            "allow-mschapv2": "false",

            "primary-password-expiration-warning-days": "14",

            "primary-password-management": "true",

            "primary-password-minimum-length": "4",

            "primary-password-restricted": "allow-passwords-of-minimum-length"

        },

        "radius-request-attributes-policies": {

            "evaluate-logic": "false",

            "selected-policies": null

        },

        "source-ip": {

            "customized": "any-ip",

            "ips": {

                "ip": []

            },

            "locations": {

                "location": []

            }

        },

        "sso": {

            "enable-sso": "true"

        }

    },

    "authentication-server": "System Local",

    "description": "Default authentication realm for users",

    "device-check-interval": "60",

    "device-server": "None",

    "directory-server": "None",

    "dynamic-policy": {

        "dynamic-policy-evaluation": "false",

        "refresh-interval": "60",

        "refresh-policies": "false",

        "refresh-roles": "false"

    },

    "editing-description": "false",

    "inbound-ifmap-attributes": "false",

    "name": "testRealm2",

    "radius-proxy": "do-not-proxy",

    "role-mapping-rules": {

        "rule": [

            {

                "name": "rule 0",

                "roles": [

                    "Users"

                ],

                "stop-rules-processing": "false",

                "user-name": {

                    "test": "is",

                    "user-names": [

                        "*"

                    ]

                }

            }

        ],

        "user-selects-role": "false",

        "user-selects-roleset": "false"

    },

    "secondary-authentication-settings": {

        "authentication-must-succeed": "true",

        "enable-adaptive-auth": "false",

        "mask-password": "false",

        "name": "-",

        "password-input": "user",

        "predefined-password": "",

        "predefined-user-name": "",

        "user-name-input": "user"

    },

    "session-migration": "false"

}

 

Mac Auth Realm

To get APIs for all mac auth realms:

api/v1/configuration/uac/mac-address-realms

Default available:

/api/v1/configuration/uac/mac-address-realms/realm/Guest Wired

To Create MAC auth Realm:

 

Copy
POST                        
/api/v1/configuration/uac/mac-address-realms/realm/HTTP/1.1
Host xx.xx.xx.xx
Authorization: Basic
Content-Type: application/json

{

    "accounting-server": "None",

    "authentication-policy": {

        "limits": {

            "guaranteed-minimum": "0",

            "limit-concurrent-users": "false",

            "maximum": null

        },

        "radius-request-attributes-policies": {

            "evaluate-logic": "false",

            "selected-policies": null

        }

    },

    "authentication-server": "Guest Wired Authentication",

    "description": "",

    "device-check-interval": "60",

    "device-server": "None",

    "directory-server": "Guest Wired Authentication",

    "dynamic-policy": {

        "dynamic-policy-evaluation": "false",

        "refresh-interval": "60",

        "refresh-policies": "false",

        "refresh-roles": "false"

    },

    "edit-rules-first": "false",

    "name": "testMacRealm",

    "role-mapping-rules": {

        "rule": [

            {

                "name": "guestRule",

                "roles": [

                    "Guest Wired Restricted"

                ],

                "stop-rules-processing": "false",

                "user-name": {

                    "test": "is",

                    "user-names": [

                        "*"

                    ]

                }

            }

        ]

    }

}