Deepnet

Create

post

Create a new Deepnet MFA.

Body

application/json; api-version=1.0

Create MFA of type deepnet

namestring · min: 1 · max: 255 · nullableRequired

The name of the target Multi Factor Authentication. This must be the actual Multi Factor Authentication name used in the RAS farm.

siteIdinteger · int32Optional

Site ID in which to modify the specified Multi Factor Authentication. If the parameter is omitted, the site ID of the Licensing Server will be used.

descriptionstring · nullableOptional

A user-defined Multi Factor Authentication description.

enabledbooleanOptional

Enable or disable the Multi Factor Authentication upon creation. If the parameter is omitted, the Multi Factor Authentication is initialised as Disabled.

activateEmailboolean · nullableOptional

Whether the activation email is enabled or disabled.

activateSMSboolean · nullableOptional

Whether the activation SMS is enabled or disabled.

appstring · max: 255 · nullableOptional

A value that represents the application name.

appIDstring · max: 255 · nullableOptional

A value that represents the application ID.

authModestring · enumOptional

Deepnet Authentication Mode

Possible values:

deepnetAgentstring · max: 255 · nullableRequired

A value that represents the name of Deepnet Agent.

defaultDomainstring · max: 255 · nullableOptional

A value that represents the Default Domain.

sslboolean · nullableOptional

Whether SSL is allowed or not.

deepnetServerstring · nullableRequired

The server of the second level authentication provider.

deepnetPortinteger · int32 · nullableRequired

The port number of the second level authentication provider.

tokenTypestring · enumOptional

Token Type

Possible values:

Responses

201

Created

application/json; api-version=1.0

MFA Deepnet Settings

idinteger · int32Optional

ID of the object.

adminCreatestring · nullableOptional

User who created the object.

adminLastModstring · nullableOptional

User who last modified the object.

timeCreatestring · date-timeOptional

Time when the object was created.

timeLastModstring · date-timeOptional

Time when the object was last modified.

namestring · nullableOptional

Name

siteIdinteger · int32Optional

Site ID

descriptionstring · nullableOptional

Description

enabledbooleanOptional

Whether MFA provider is enabled or not.

typestring · enumOptional

Provider Type

Possible values:

inheritDefaultCriteriaSettingsbooleanOptional

If true default criteria restriction settings will be inherited.

activateEmailbooleanOptional

Whether the activation email is enabled or disabled.

activateSMSbooleanOptional

Whether the activation SMS is enabled or disabled.

appstring · nullableOptional

A value that represents the application name.

appIDstring · nullableOptional

A value that represents the application ID.

authModestring · enumOptional

Deepnet Authentication Mode

Possible values:

deepnetAgentstring · nullableOptional

A value that represents the name of Deepnet Agent.

defaultDomainstring · nullableOptional

A value that represents the Default Domain.

sslbooleanOptional

Whether SSL is allowed or not.

serverstring · nullableOptional

The server of the second level authentication provider.

portinteger · int32Optional

The port number of the second level authentication provider.

tokenTypestring · enumOptional

Token Type

Possible values:

401

Unauthorized

application/json; api-version=1.0

409

Conflict

application/json; api-version=1.0

post/api/MFA/Deepnet

HTTPcURLJavaScriptPython

POST /api/MFA/Deepnet HTTP/1.1
Content-Type: application/json; api-version=1.0
Accept: */*
Content-Length: 379

{
  "name": "text",
  "siteId": 1,
  "description": "text",
  "enabled": true,
  "activateEmail": true,
  "activateSMS": true,
  "app": "text",
  "appID": "text",
  "authMode": [
    "0 = MandatoryForAllUsers",
    "1 = CreateTokenForDomainAuthenticatedUsers",
    "2 = UsersWithDeepnetAcc"
  ],
  "deepnetAgent": "text",
  "defaultDomain": "text",
  "ssl": true,
  "deepnetServer": "text",
  "deepnetPort": 1,
  "tokenType": [
    "1 = MobileID",
    "3 = QuickID"
  ]
}

{
  "id": 1,
  "adminCreate": "text",
  "adminLastMod": "text",
  "timeCreate": "2026-08-08T18:05:26.867Z",
  "timeLastMod": "2026-08-08T18:05:26.867Z",
  "name": "text",
  "siteId": 1,
  "description": "text",
  "enabled": true,
  "type": [
    "1 = Deepnet",
    "2 = SafeNet",
    "3 = Radius",
    "4 = AzureRadius",
    "5 = DuoRadius",
    "6 = FortiRadius",
    "7 = TekRadius",
    "8 = GAuthTOTP",
    "9 = TOTP",
    "10 = MicrosoftTOTP",
    "11 = EmailOTP"
  ],
  "inheritDefaultCriteriaSettings": true,
  "criteria": {
    "securityPrincipals": {
      "enabled": true,
      "matchingMode": [
        "0 = IsNotOneOfTheFollowing",
        "1 = IsOneOfTheFollowing"
      ],
      "members": [
        {
          "account": "text",
          "type": [
            "1 = User",
            "2 = Group",
            "3 = ForeignSecurityPrincipal",
            "4 = Computer"
          ],
          "sid": "text"
        }
      ]
    },
    "gateways": {
      "enabled": true,
      "matchingMode": [
        "0 = IsNotOneOfTheFollowing",
        "1 = IsOneOfTheFollowing"
      ],
      "members": [
        {
          "gatewayIP": "text"
        }
      ]
    },
    "oSs": {
      "enabled": true,
      "matchingMode": [
        "0 = IsNotOneOfTheFollowing",
        "1 = IsOneOfTheFollowing"
      ],
      "allowedOSes": {
        "chrome": true,
        "android": true,
        "webClient": true,
        "iOS": true,
        "linux": true,
        "mac": true,
        "wyse": true,
        "windows": true
      }
    },
    "iPs": {
      "enabled": true,
      "matchingMode": [
        "0 = IsNotOneOfTheFollowing",
        "1 = IsOneOfTheFollowing"
      ],
      "allowedIPs": {
        "iPv4s": [
          {
            "from": "text",
            "to": "text"
          }
        ],
        "iPv6s": [
          {
            "from": "text",
            "to": "text"
          }
        ]
      }
    },
    "hardwareIDs": {
      "enabled": true,
      "matchingMode": [
        "0 = IsNotOneOfTheFollowing",
        "1 = IsOneOfTheFollowing"
      ],
      "members": [
        {
          "hardwareID": "text"
        }
      ]
    },
    "access": [
      "0 = DenyCriteriaWhen",
      "1 = AllowCriteriaWhen"
    ],
    "devices": {
      "enabled": true,
      "matchingMode": [
        "0 = IsNotOneOfTheFollowing",
        "1 = IsOneOfTheFollowing"
      ],
      "members": [
        {
          "client": "text"
        }
      ]
    }
  },
  "activateEmail": true,
  "activateSMS": true,
  "app": "text",
  "appID": "text",
  "authMode": [
    "0 = MandatoryForAllUsers",
    "1 = CreateTokenForDomainAuthenticatedUsers",
    "2 = UsersWithDeepnetAcc"
  ],
  "deepnetAgent": "text",
  "defaultDomain": "text",
  "ssl": true,
  "server": "text",
  "port": 1,
  "tokenType": [
    "1 = MobileID",
    "3 = QuickID"
  ]
}

Update

put

Update the MFA Deepnet settings.

Path parameters

idinteger · int32Required

The id for which to modify the MFA settings.

Body

application/json; api-version=1.0

Update MFA of type deepnet

namestring · min: 1 · max: 255 · nullableOptional

The new name of the target multi-factor authentication .

descriptionstring · nullableOptional

A user-defined multi-factor authentication description.

enabledboolean · nullableOptional

Enable or disable the specified multi-factor authentication in a site.

inheritDefaultCriteriaSettingsboolean · nullableOptional

If true default criteria settings will be inherited.

activateEmailboolean · nullableOptional

Whether the activation email is enabled or disabled.

activateSMSboolean · nullableOptional

Whether the activation SMS is enabled or disabled.

appstring · max: 255 · nullableOptional

A value that represents the application name.

appIDstring · max: 255 · nullableOptional

A value that represents the application ID.

authModestring · enumOptional

Deepnet Authentication Mode

Possible values:

deepnetAgentstring · max: 255 · nullableOptional

A value that represents the name of Deepnet Agent.

defaultDomainstring · max: 255 · nullableOptional

A value that represents the Default Domain.

sslboolean · nullableOptional

Whether SSL is allowed or not.

deepnetServerstring · nullableOptional

The server of the second level authentication provider.

deepnetPortinteger · int32 · nullableOptional

The port number of the second level authentication provider.

tokenTypestring · enumOptional

Token Type

Possible values:

Responses

204

No Content

No content

401

Unauthorized

application/json; api-version=1.0

404

Not Found

application/json; api-version=1.0

put/api/MFA/Deepnet/{id}

HTTPcURLJavaScriptPython

PUT /api/MFA/Deepnet/{id} HTTP/1.1
Content-Type: application/json; api-version=1.0
Accept: */*
Content-Length: 406

{
  "name": "text",
  "description": "text",
  "enabled": true,
  "inheritDefaultCriteriaSettings": true,
  "activateEmail": true,
  "activateSMS": true,
  "app": "text",
  "appID": "text",
  "authMode": [
    "0 = MandatoryForAllUsers",
    "1 = CreateTokenForDomainAuthenticatedUsers",
    "2 = UsersWithDeepnetAcc"
  ],
  "deepnetAgent": "text",
  "defaultDomain": "text",
  "ssl": true,
  "deepnetServer": "text",
  "deepnetPort": 1,
  "tokenType": [
    "1 = MobileID",
    "3 = QuickID"
  ]
}

No content