PingOne Platform APIs

Step 13: Create the device authentication policy

   

POST {{apiPath}}/environments/{{envID}}/deviceAuthenticationPolicies

The POST {{apiPath}}/environments/{{envID}}/deviceAuthenticationPolicies operation creates a device authentication policy to specify enabled device types. In this use case, the SMS device type must be enabled in the device authentication policy to receive the text message with the one-time password (OTP) code needed to complete the MFA action.

Headers

Authorization      Bearer {{accessToken}}

Content-Type      application/json

Body

raw ( application/json )

{
    "name": "useCaseDeviceAuthPolicy__{{$timestamp}}",
    "sms": {
        "enabled": true,
        "otp": {
            "failure": {
                "count": 3,
                "coolDown": {
                    "duration": 0,
                    "timeUnit": "MINUTES"
                }
            },
            "lifeTime": {
                "duration": 30,
                "timeUnit": "MINUTES"
            }
        }
    },
    "email": {
        "enabled": true,
        "otp": {
            "failure": {
                "count": 3,
                "coolDown": {
                    "duration": 0,
                    "timeUnit": "MINUTES"
                }
            },
            "lifeTime": {
                "duration": 30,
                "timeUnit": "MINUTES"
            }
        }
    },
    "mobile": {
        "enabled": true,
        "otp": {
            "failure": {
                "count": 3,
                "coolDown": {
                    "duration": 2,
                    "timeUnit": "MINUTES"
                }
            },
            "window": {
                "stepSize": {
                    "duration": 30,
                    "timeUnit": "SECONDS"
                }
            }
        },
        "applications": [
            {
                "id": "{{webApp4MfaId}}",
                "push": {
                    "enabled": false
                },
                "otp": {
                    "enabled": true
                },
                "deviceAuthorization": {
                    "enabled": true,
                    "extraVerification": "permissive"
                },
                "autoEnrollment": {
                    "enabled": true
                },
                "integrityDetection": "permissive"
            }
        ]
    },
    "totp": {
        "enabled": true,
        "otp": {
            "failure": {
                "count": 3,
                "coolDown": {
                    "duration": 2,
                    "timeUnit": "MINUTES"
                }
            }
        }
    },
    "voice": {
        "enabled": false,
        "otp": {
            "failure": {
                "count": 3,
                "coolDown": {
                    "duration": 0,
                    "timeUnit": "MINUTES"
                }
            },
            "lifeTime": {
                "duration": 30,
                "timeUnit": "MINUTES"
            }
        }
    },
    "securityKey": {
        "enabled": true
    },
    "forSignOnPolicy": false,
    "platform": {
        "enabled": true
    },
    "default": false
}

Example Request

  • cURL

  • C#

  • Go

  • HTTP

  • Java

  • jQuery

  • NodeJS

  • Python

  • PHP

  • Ruby

  • Swift

curl --location --globoff '{{apiPath}}/environments/{{envID}}/deviceAuthenticationPolicies' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {{accessToken}}' \
--data '{
    "name": "useCaseDeviceAuthPolicy__{{$timestamp}}",
    "sms": {
        "enabled": true,
        "otp": {
            "failure": {
                "count": 3,
                "coolDown": {
                    "duration": 0,
                    "timeUnit": "MINUTES"
                }
            },
            "lifeTime": {
                "duration": 30,
                "timeUnit": "MINUTES"
            }
        }
    },
    "email": {
        "enabled": true,
        "otp": {
            "failure": {
                "count": 3,
                "coolDown": {
                    "duration": 0,
                    "timeUnit": "MINUTES"
                }
            },
            "lifeTime": {
                "duration": 30,
                "timeUnit": "MINUTES"
            }
        }
    },
    "mobile": {
        "enabled": true,
        "otp": {
            "failure": {
                "count": 3,
                "coolDown": {
                    "duration": 2,
                    "timeUnit": "MINUTES"
                }
            },
            "window": {
                "stepSize": {
                    "duration": 30,
                    "timeUnit": "SECONDS"
                }
            }
        },
        "applications": [
            {
                "id": "{{webApp4MfaId}}",
                "push": {
                    "enabled": false
                },
                "otp": {
                    "enabled": true
                },
                "deviceAuthorization": {
                    "enabled": true,
                    "extraVerification": "permissive"
                },
                "autoEnrollment": {
                    "enabled": true
                },
                "integrityDetection": "permissive"
            }
        ]
    },
    "totp": {
        "enabled": true,
        "otp": {
            "failure": {
                "count": 3,
                "coolDown": {
                    "duration": 2,
                    "timeUnit": "MINUTES"
                }
            }
        }
    },
    "voice": {
        "enabled": false,
        "otp": {
            "failure": {
                "count": 3,
                "coolDown": {
                    "duration": 0,
                    "timeUnit": "MINUTES"
                }
            },
            "lifeTime": {
                "duration": 30,
                "timeUnit": "MINUTES"
            }
        }
    },
    "securityKey": {
        "enabled": true
    },
    "forSignOnPolicy": false,
    "platform": {
        "enabled": true
    },
    "default": false
}'
var options = new RestClientOptions("{{apiPath}}/environments/{{envID}}/deviceAuthenticationPolicies")
{
  MaxTimeout = -1,
};
var client = new RestClient(options);
var request = new RestRequest("", Method.Post);
request.AddHeader("Content-Type", "application/json");
request.AddHeader("Authorization", "Bearer {{accessToken}}");
var body = @"{" + "\n" +
@"    ""name"": ""useCaseDeviceAuthPolicy__{{$timestamp}}""," + "\n" +
@"    ""sms"": {" + "\n" +
@"        ""enabled"": true," + "\n" +
@"        ""otp"": {" + "\n" +
@"            ""failure"": {" + "\n" +
@"                ""count"": 3," + "\n" +
@"                ""coolDown"": {" + "\n" +
@"                    ""duration"": 0," + "\n" +
@"                    ""timeUnit"": ""MINUTES""" + "\n" +
@"                }" + "\n" +
@"            }," + "\n" +
@"            ""lifeTime"": {" + "\n" +
@"                ""duration"": 30," + "\n" +
@"                ""timeUnit"": ""MINUTES""" + "\n" +
@"            }" + "\n" +
@"        }" + "\n" +
@"    }," + "\n" +
@"    ""email"": {" + "\n" +
@"        ""enabled"": true," + "\n" +
@"        ""otp"": {" + "\n" +
@"            ""failure"": {" + "\n" +
@"                ""count"": 3," + "\n" +
@"                ""coolDown"": {" + "\n" +
@"                    ""duration"": 0," + "\n" +
@"                    ""timeUnit"": ""MINUTES""" + "\n" +
@"                }" + "\n" +
@"            }," + "\n" +
@"            ""lifeTime"": {" + "\n" +
@"                ""duration"": 30," + "\n" +
@"                ""timeUnit"": ""MINUTES""" + "\n" +
@"            }" + "\n" +
@"        }" + "\n" +
@"    }," + "\n" +
@"    ""mobile"": {" + "\n" +
@"        ""enabled"": true," + "\n" +
@"        ""otp"": {" + "\n" +
@"            ""failure"": {" + "\n" +
@"                ""count"": 3," + "\n" +
@"                ""coolDown"": {" + "\n" +
@"                    ""duration"": 2," + "\n" +
@"                    ""timeUnit"": ""MINUTES""" + "\n" +
@"                }" + "\n" +
@"            }," + "\n" +
@"            ""window"": {" + "\n" +
@"                ""stepSize"": {" + "\n" +
@"                    ""duration"": 30," + "\n" +
@"                    ""timeUnit"": ""SECONDS""" + "\n" +
@"                }" + "\n" +
@"            }" + "\n" +
@"        }," + "\n" +
@"        ""applications"": [" + "\n" +
@"            {" + "\n" +
@"                ""id"": ""{{webApp4MfaId}}""," + "\n" +
@"                ""push"": {" + "\n" +
@"                    ""enabled"": false" + "\n" +
@"                }," + "\n" +
@"                ""otp"": {" + "\n" +
@"                    ""enabled"": true" + "\n" +
@"                }," + "\n" +
@"                ""deviceAuthorization"": {" + "\n" +
@"                    ""enabled"": true," + "\n" +
@"                    ""extraVerification"": ""permissive""" + "\n" +
@"                }," + "\n" +
@"                ""autoEnrollment"": {" + "\n" +
@"                    ""enabled"": true" + "\n" +
@"                }," + "\n" +
@"                ""integrityDetection"": ""permissive""" + "\n" +
@"            }" + "\n" +
@"        ]" + "\n" +
@"    }," + "\n" +
@"    ""totp"": {" + "\n" +
@"        ""enabled"": true," + "\n" +
@"        ""otp"": {" + "\n" +
@"            ""failure"": {" + "\n" +
@"                ""count"": 3," + "\n" +
@"                ""coolDown"": {" + "\n" +
@"                    ""duration"": 2," + "\n" +
@"                    ""timeUnit"": ""MINUTES""" + "\n" +
@"                }" + "\n" +
@"            }" + "\n" +
@"        }" + "\n" +
@"    }," + "\n" +
@"    ""voice"": {" + "\n" +
@"        ""enabled"": false," + "\n" +
@"        ""otp"": {" + "\n" +
@"            ""failure"": {" + "\n" +
@"                ""count"": 3," + "\n" +
@"                ""coolDown"": {" + "\n" +
@"                    ""duration"": 0," + "\n" +
@"                    ""timeUnit"": ""MINUTES""" + "\n" +
@"                }" + "\n" +
@"            }," + "\n" +
@"            ""lifeTime"": {" + "\n" +
@"                ""duration"": 30," + "\n" +
@"                ""timeUnit"": ""MINUTES""" + "\n" +
@"            }" + "\n" +
@"        }" + "\n" +
@"    }," + "\n" +
@"    ""securityKey"": {" + "\n" +
@"        ""enabled"": true" + "\n" +
@"    }," + "\n" +
@"    ""forSignOnPolicy"": false," + "\n" +
@"    ""platform"": {" + "\n" +
@"        ""enabled"": true" + "\n" +
@"    }," + "\n" +
@"    ""default"": false" + "\n" +
@"}";
request.AddStringBody(body, DataFormat.Json);
RestResponse response = await client.ExecuteAsync(request);
Console.WriteLine(response.Content);
package main

import (
  "fmt"
  "strings"
  "net/http"
  "io"
)

func main() {

  url := "{{apiPath}}/environments/{{envID}}/deviceAuthenticationPolicies"
  method := "POST"

  payload := strings.NewReader(`{
    "name": "useCaseDeviceAuthPolicy__{{$timestamp}}",
    "sms": {
        "enabled": true,
        "otp": {
            "failure": {
                "count": 3,
                "coolDown": {
                    "duration": 0,
                    "timeUnit": "MINUTES"
                }
            },
            "lifeTime": {
                "duration": 30,
                "timeUnit": "MINUTES"
            }
        }
    },
    "email": {
        "enabled": true,
        "otp": {
            "failure": {
                "count": 3,
                "coolDown": {
                    "duration": 0,
                    "timeUnit": "MINUTES"
                }
            },
            "lifeTime": {
                "duration": 30,
                "timeUnit": "MINUTES"
            }
        }
    },
    "mobile": {
        "enabled": true,
        "otp": {
            "failure": {
                "count": 3,
                "coolDown": {
                    "duration": 2,
                    "timeUnit": "MINUTES"
                }
            },
            "window": {
                "stepSize": {
                    "duration": 30,
                    "timeUnit": "SECONDS"
                }
            }
        },
        "applications": [
            {
                "id": "{{webApp4MfaId}}",
                "push": {
                    "enabled": false
                },
                "otp": {
                    "enabled": true
                },
                "deviceAuthorization": {
                    "enabled": true,
                    "extraVerification": "permissive"
                },
                "autoEnrollment": {
                    "enabled": true
                },
                "integrityDetection": "permissive"
            }
        ]
    },
    "totp": {
        "enabled": true,
        "otp": {
            "failure": {
                "count": 3,
                "coolDown": {
                    "duration": 2,
                    "timeUnit": "MINUTES"
                }
            }
        }
    },
    "voice": {
        "enabled": false,
        "otp": {
            "failure": {
                "count": 3,
                "coolDown": {
                    "duration": 0,
                    "timeUnit": "MINUTES"
                }
            },
            "lifeTime": {
                "duration": 30,
                "timeUnit": "MINUTES"
            }
        }
    },
    "securityKey": {
        "enabled": true
    },
    "forSignOnPolicy": false,
    "platform": {
        "enabled": true
    },
    "default": false
}`)

  client := &http.Client {
  }
  req, err := http.NewRequest(method, url, payload)

  if err != nil {
    fmt.Println(err)
    return
  }
  req.Header.Add("Content-Type", "application/json")
  req.Header.Add("Authorization", "Bearer {{accessToken}}")

  res, err := client.Do(req)
  if err != nil {
    fmt.Println(err)
    return
  }
  defer res.Body.Close()

  body, err := io.ReadAll(res.Body)
  if err != nil {
    fmt.Println(err)
    return
  }
  fmt.Println(string(body))
}
POST /environments/{{envID}}/deviceAuthenticationPolicies HTTP/1.1
Host: {{apiPath}}
Content-Type: application/json
Authorization: Bearer {{accessToken}}

{
    "name": "useCaseDeviceAuthPolicy__{{$timestamp}}",
    "sms": {
        "enabled": true,
        "otp": {
            "failure": {
                "count": 3,
                "coolDown": {
                    "duration": 0,
                    "timeUnit": "MINUTES"
                }
            },
            "lifeTime": {
                "duration": 30,
                "timeUnit": "MINUTES"
            }
        }
    },
    "email": {
        "enabled": true,
        "otp": {
            "failure": {
                "count": 3,
                "coolDown": {
                    "duration": 0,
                    "timeUnit": "MINUTES"
                }
            },
            "lifeTime": {
                "duration": 30,
                "timeUnit": "MINUTES"
            }
        }
    },
    "mobile": {
        "enabled": true,
        "otp": {
            "failure": {
                "count": 3,
                "coolDown": {
                    "duration": 2,
                    "timeUnit": "MINUTES"
                }
            },
            "window": {
                "stepSize": {
                    "duration": 30,
                    "timeUnit": "SECONDS"
                }
            }
        },
        "applications": [
            {
                "id": "{{webApp4MfaId}}",
                "push": {
                    "enabled": false
                },
                "otp": {
                    "enabled": true
                },
                "deviceAuthorization": {
                    "enabled": true,
                    "extraVerification": "permissive"
                },
                "autoEnrollment": {
                    "enabled": true
                },
                "integrityDetection": "permissive"
            }
        ]
    },
    "totp": {
        "enabled": true,
        "otp": {
            "failure": {
                "count": 3,
                "coolDown": {
                    "duration": 2,
                    "timeUnit": "MINUTES"
                }
            }
        }
    },
    "voice": {
        "enabled": false,
        "otp": {
            "failure": {
                "count": 3,
                "coolDown": {
                    "duration": 0,
                    "timeUnit": "MINUTES"
                }
            },
            "lifeTime": {
                "duration": 30,
                "timeUnit": "MINUTES"
            }
        }
    },
    "securityKey": {
        "enabled": true
    },
    "forSignOnPolicy": false,
    "platform": {
        "enabled": true
    },
    "default": false
}
OkHttpClient client = new OkHttpClient().newBuilder()
  .build();
MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "{\n    \"name\": \"useCaseDeviceAuthPolicy__{{$timestamp}}\",\n    \"sms\": {\n        \"enabled\": true,\n        \"otp\": {\n            \"failure\": {\n                \"count\": 3,\n                \"coolDown\": {\n                    \"duration\": 0,\n                    \"timeUnit\": \"MINUTES\"\n                }\n            },\n            \"lifeTime\": {\n                \"duration\": 30,\n                \"timeUnit\": \"MINUTES\"\n            }\n        }\n    },\n    \"email\": {\n        \"enabled\": true,\n        \"otp\": {\n            \"failure\": {\n                \"count\": 3,\n                \"coolDown\": {\n                    \"duration\": 0,\n                    \"timeUnit\": \"MINUTES\"\n                }\n            },\n            \"lifeTime\": {\n                \"duration\": 30,\n                \"timeUnit\": \"MINUTES\"\n            }\n        }\n    },\n    \"mobile\": {\n        \"enabled\": true,\n        \"otp\": {\n            \"failure\": {\n                \"count\": 3,\n                \"coolDown\": {\n                    \"duration\": 2,\n                    \"timeUnit\": \"MINUTES\"\n                }\n            },\n            \"window\": {\n                \"stepSize\": {\n                    \"duration\": 30,\n                    \"timeUnit\": \"SECONDS\"\n                }\n            }\n        },\n        \"applications\": [\n            {\n                \"id\": \"{{webApp4MfaId}}\",\n                \"push\": {\n                    \"enabled\": false\n                },\n                \"otp\": {\n                    \"enabled\": true\n                },\n                \"deviceAuthorization\": {\n                    \"enabled\": true,\n                    \"extraVerification\": \"permissive\"\n                },\n                \"autoEnrollment\": {\n                    \"enabled\": true\n                },\n                \"integrityDetection\": \"permissive\"\n            }\n        ]\n    },\n    \"totp\": {\n        \"enabled\": true,\n        \"otp\": {\n            \"failure\": {\n                \"count\": 3,\n                \"coolDown\": {\n                    \"duration\": 2,\n                    \"timeUnit\": \"MINUTES\"\n                }\n            }\n        }\n    },\n    \"voice\": {\n        \"enabled\": false,\n        \"otp\": {\n            \"failure\": {\n                \"count\": 3,\n                \"coolDown\": {\n                    \"duration\": 0,\n                    \"timeUnit\": \"MINUTES\"\n                }\n            },\n            \"lifeTime\": {\n                \"duration\": 30,\n                \"timeUnit\": \"MINUTES\"\n            }\n        }\n    },\n    \"securityKey\": {\n        \"enabled\": true\n    },\n    \"forSignOnPolicy\": false,\n    \"platform\": {\n        \"enabled\": true\n    },\n    \"default\": false\n}");
Request request = new Request.Builder()
  .url("{{apiPath}}/environments/{{envID}}/deviceAuthenticationPolicies")
  .method("POST", body)
  .addHeader("Content-Type", "application/json")
  .addHeader("Authorization", "Bearer {{accessToken}}")
  .build();
Response response = client.newCall(request).execute();
var settings = {
  "url": "{{apiPath}}/environments/{{envID}}/deviceAuthenticationPolicies",
  "method": "POST",
  "timeout": 0,
  "headers": {
    "Content-Type": "application/json",
    "Authorization": "Bearer {{accessToken}}"
  },
  "data": JSON.stringify({
    "name": "useCaseDeviceAuthPolicy__{{$timestamp}}",
    "sms": {
      "enabled": true,
      "otp": {
        "failure": {
          "count": 3,
          "coolDown": {
            "duration": 0,
            "timeUnit": "MINUTES"
          }
        },
        "lifeTime": {
          "duration": 30,
          "timeUnit": "MINUTES"
        }
      }
    },
    "email": {
      "enabled": true,
      "otp": {
        "failure": {
          "count": 3,
          "coolDown": {
            "duration": 0,
            "timeUnit": "MINUTES"
          }
        },
        "lifeTime": {
          "duration": 30,
          "timeUnit": "MINUTES"
        }
      }
    },
    "mobile": {
      "enabled": true,
      "otp": {
        "failure": {
          "count": 3,
          "coolDown": {
            "duration": 2,
            "timeUnit": "MINUTES"
          }
        },
        "window": {
          "stepSize": {
            "duration": 30,
            "timeUnit": "SECONDS"
          }
        }
      },
      "applications": [
        {
          "id": "{{webApp4MfaId}}",
          "push": {
            "enabled": false
          },
          "otp": {
            "enabled": true
          },
          "deviceAuthorization": {
            "enabled": true,
            "extraVerification": "permissive"
          },
          "autoEnrollment": {
            "enabled": true
          },
          "integrityDetection": "permissive"
        }
      ]
    },
    "totp": {
      "enabled": true,
      "otp": {
        "failure": {
          "count": 3,
          "coolDown": {
            "duration": 2,
            "timeUnit": "MINUTES"
          }
        }
      }
    },
    "voice": {
      "enabled": false,
      "otp": {
        "failure": {
          "count": 3,
          "coolDown": {
            "duration": 0,
            "timeUnit": "MINUTES"
          }
        },
        "lifeTime": {
          "duration": 30,
          "timeUnit": "MINUTES"
        }
      }
    },
    "securityKey": {
      "enabled": true
    },
    "forSignOnPolicy": false,
    "platform": {
      "enabled": true
    },
    "default": false
  }),
};

$.ajax(settings).done(function (response) {
  console.log(response);
});
var request = require('request');
var options = {
  'method': 'POST',
  'url': '{{apiPath}}/environments/{{envID}}/deviceAuthenticationPolicies',
  'headers': {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer {{accessToken}}'
  },
  body: JSON.stringify({
    "name": "useCaseDeviceAuthPolicy__{{$timestamp}}",
    "sms": {
      "enabled": true,
      "otp": {
        "failure": {
          "count": 3,
          "coolDown": {
            "duration": 0,
            "timeUnit": "MINUTES"
          }
        },
        "lifeTime": {
          "duration": 30,
          "timeUnit": "MINUTES"
        }
      }
    },
    "email": {
      "enabled": true,
      "otp": {
        "failure": {
          "count": 3,
          "coolDown": {
            "duration": 0,
            "timeUnit": "MINUTES"
          }
        },
        "lifeTime": {
          "duration": 30,
          "timeUnit": "MINUTES"
        }
      }
    },
    "mobile": {
      "enabled": true,
      "otp": {
        "failure": {
          "count": 3,
          "coolDown": {
            "duration": 2,
            "timeUnit": "MINUTES"
          }
        },
        "window": {
          "stepSize": {
            "duration": 30,
            "timeUnit": "SECONDS"
          }
        }
      },
      "applications": [
        {
          "id": "{{webApp4MfaId}}",
          "push": {
            "enabled": false
          },
          "otp": {
            "enabled": true
          },
          "deviceAuthorization": {
            "enabled": true,
            "extraVerification": "permissive"
          },
          "autoEnrollment": {
            "enabled": true
          },
          "integrityDetection": "permissive"
        }
      ]
    },
    "totp": {
      "enabled": true,
      "otp": {
        "failure": {
          "count": 3,
          "coolDown": {
            "duration": 2,
            "timeUnit": "MINUTES"
          }
        }
      }
    },
    "voice": {
      "enabled": false,
      "otp": {
        "failure": {
          "count": 3,
          "coolDown": {
            "duration": 0,
            "timeUnit": "MINUTES"
          }
        },
        "lifeTime": {
          "duration": 30,
          "timeUnit": "MINUTES"
        }
      }
    },
    "securityKey": {
      "enabled": true
    },
    "forSignOnPolicy": false,
    "platform": {
      "enabled": true
    },
    "default": false
  })

};
request(options, function (error, response) {
  if (error) throw new Error(error);
  console.log(response.body);
});
import requests
import json

url = "{{apiPath}}/environments/{{envID}}/deviceAuthenticationPolicies"

payload = json.dumps({
  "name": "useCaseDeviceAuthPolicy__{{$timestamp}}",
  "sms": {
    "enabled": True,
    "otp": {
      "failure": {
        "count": 3,
        "coolDown": {
          "duration": 0,
          "timeUnit": "MINUTES"
        }
      },
      "lifeTime": {
        "duration": 30,
        "timeUnit": "MINUTES"
      }
    }
  },
  "email": {
    "enabled": True,
    "otp": {
      "failure": {
        "count": 3,
        "coolDown": {
          "duration": 0,
          "timeUnit": "MINUTES"
        }
      },
      "lifeTime": {
        "duration": 30,
        "timeUnit": "MINUTES"
      }
    }
  },
  "mobile": {
    "enabled": True,
    "otp": {
      "failure": {
        "count": 3,
        "coolDown": {
          "duration": 2,
          "timeUnit": "MINUTES"
        }
      },
      "window": {
        "stepSize": {
          "duration": 30,
          "timeUnit": "SECONDS"
        }
      }
    },
    "applications": [
      {
        "id": "{{webApp4MfaId}}",
        "push": {
          "enabled": False
        },
        "otp": {
          "enabled": True
        },
        "deviceAuthorization": {
          "enabled": True,
          "extraVerification": "permissive"
        },
        "autoEnrollment": {
          "enabled": True
        },
        "integrityDetection": "permissive"
      }
    ]
  },
  "totp": {
    "enabled": True,
    "otp": {
      "failure": {
        "count": 3,
        "coolDown": {
          "duration": 2,
          "timeUnit": "MINUTES"
        }
      }
    }
  },
  "voice": {
    "enabled": False,
    "otp": {
      "failure": {
        "count": 3,
        "coolDown": {
          "duration": 0,
          "timeUnit": "MINUTES"
        }
      },
      "lifeTime": {
        "duration": 30,
        "timeUnit": "MINUTES"
      }
    }
  },
  "securityKey": {
    "enabled": True
  },
  "forSignOnPolicy": False,
  "platform": {
    "enabled": True
  },
  "default": False
})
headers = {
  'Content-Type': 'application/json',
  'Authorization': 'Bearer {{accessToken}}'
}

response = requests.request("POST", url, headers=headers, data=payload)

print(response.text)
<?php
require_once 'HTTP/Request2.php';
$request = new HTTP_Request2();
$request->setUrl('{{apiPath}}/environments/{{envID}}/deviceAuthenticationPolicies');
$request->setMethod(HTTP_Request2::METHOD_POST);
$request->setConfig(array(
  'follow_redirects' => TRUE
));
$request->setHeader(array(
  'Content-Type' => 'application/json',
  'Authorization' => 'Bearer {{accessToken}}'
));
$request->setBody('{\n    "name": "useCaseDeviceAuthPolicy__{{$timestamp}}",\n    "sms": {\n        "enabled": true,\n        "otp": {\n            "failure": {\n                "count": 3,\n                "coolDown": {\n                    "duration": 0,\n                    "timeUnit": "MINUTES"\n                }\n            },\n            "lifeTime": {\n                "duration": 30,\n                "timeUnit": "MINUTES"\n            }\n        }\n    },\n    "email": {\n        "enabled": true,\n        "otp": {\n            "failure": {\n                "count": 3,\n                "coolDown": {\n                    "duration": 0,\n                    "timeUnit": "MINUTES"\n                }\n            },\n            "lifeTime": {\n                "duration": 30,\n                "timeUnit": "MINUTES"\n            }\n        }\n    },\n    "mobile": {\n        "enabled": true,\n        "otp": {\n            "failure": {\n                "count": 3,\n                "coolDown": {\n                    "duration": 2,\n                    "timeUnit": "MINUTES"\n                }\n            },\n            "window": {\n                "stepSize": {\n                    "duration": 30,\n                    "timeUnit": "SECONDS"\n                }\n            }\n        },\n        "applications": [\n            {\n                "id": "{{webApp4MfaId}}",\n                "push": {\n                    "enabled": false\n                },\n                "otp": {\n                    "enabled": true\n                },\n                "deviceAuthorization": {\n                    "enabled": true,\n                    "extraVerification": "permissive"\n                },\n                "autoEnrollment": {\n                    "enabled": true\n                },\n                "integrityDetection": "permissive"\n            }\n        ]\n    },\n    "totp": {\n        "enabled": true,\n        "otp": {\n            "failure": {\n                "count": 3,\n                "coolDown": {\n                    "duration": 2,\n                    "timeUnit": "MINUTES"\n                }\n            }\n        }\n    },\n    "voice": {\n        "enabled": false,\n        "otp": {\n            "failure": {\n                "count": 3,\n                "coolDown": {\n                    "duration": 0,\n                    "timeUnit": "MINUTES"\n                }\n            },\n            "lifeTime": {\n                "duration": 30,\n                "timeUnit": "MINUTES"\n            }\n        }\n    },\n    "securityKey": {\n        "enabled": true\n    },\n    "forSignOnPolicy": false,\n    "platform": {\n        "enabled": true\n    },\n    "default": false\n}');
try {
  $response = $request->send();
  if ($response->getStatus() == 200) {
    echo $response->getBody();
  }
  else {
    echo 'Unexpected HTTP status: ' . $response->getStatus() . ' ' .
    $response->getReasonPhrase();
  }
}
catch(HTTP_Request2_Exception $e) {
  echo 'Error: ' . $e->getMessage();
}
require "uri"
require "json"
require "net/http"

url = URI("{{apiPath}}/environments/{{envID}}/deviceAuthenticationPolicies")

http = Net::HTTP.new(url.host, url.port);
request = Net::HTTP::Post.new(url)
request["Content-Type"] = "application/json"
request["Authorization"] = "Bearer {{accessToken}}"
request.body = JSON.dump({
  "name": "useCaseDeviceAuthPolicy__{{\$timestamp}}",
  "sms": {
    "enabled": true,
    "otp": {
      "failure": {
        "count": 3,
        "coolDown": {
          "duration": 0,
          "timeUnit": "MINUTES"
        }
      },
      "lifeTime": {
        "duration": 30,
        "timeUnit": "MINUTES"
      }
    }
  },
  "email": {
    "enabled": true,
    "otp": {
      "failure": {
        "count": 3,
        "coolDown": {
          "duration": 0,
          "timeUnit": "MINUTES"
        }
      },
      "lifeTime": {
        "duration": 30,
        "timeUnit": "MINUTES"
      }
    }
  },
  "mobile": {
    "enabled": true,
    "otp": {
      "failure": {
        "count": 3,
        "coolDown": {
          "duration": 2,
          "timeUnit": "MINUTES"
        }
      },
      "window": {
        "stepSize": {
          "duration": 30,
          "timeUnit": "SECONDS"
        }
      }
    },
    "applications": [
      {
        "id": "{{webApp4MfaId}}",
        "push": {
          "enabled": false
        },
        "otp": {
          "enabled": true
        },
        "deviceAuthorization": {
          "enabled": true,
          "extraVerification": "permissive"
        },
        "autoEnrollment": {
          "enabled": true
        },
        "integrityDetection": "permissive"
      }
    ]
  },
  "totp": {
    "enabled": true,
    "otp": {
      "failure": {
        "count": 3,
        "coolDown": {
          "duration": 2,
          "timeUnit": "MINUTES"
        }
      }
    }
  },
  "voice": {
    "enabled": false,
    "otp": {
      "failure": {
        "count": 3,
        "coolDown": {
          "duration": 0,
          "timeUnit": "MINUTES"
        }
      },
      "lifeTime": {
        "duration": 30,
        "timeUnit": "MINUTES"
      }
    }
  },
  "securityKey": {
    "enabled": true
  },
  "forSignOnPolicy": false,
  "platform": {
    "enabled": true
  },
  "default": false
})

response = http.request(request)
puts response.read_body
let parameters = "{\n    \"name\": \"useCaseDeviceAuthPolicy__{{$timestamp}}\",\n    \"sms\": {\n        \"enabled\": true,\n        \"otp\": {\n            \"failure\": {\n                \"count\": 3,\n                \"coolDown\": {\n                    \"duration\": 0,\n                    \"timeUnit\": \"MINUTES\"\n                }\n            },\n            \"lifeTime\": {\n                \"duration\": 30,\n                \"timeUnit\": \"MINUTES\"\n            }\n        }\n    },\n    \"email\": {\n        \"enabled\": true,\n        \"otp\": {\n            \"failure\": {\n                \"count\": 3,\n                \"coolDown\": {\n                    \"duration\": 0,\n                    \"timeUnit\": \"MINUTES\"\n                }\n            },\n            \"lifeTime\": {\n                \"duration\": 30,\n                \"timeUnit\": \"MINUTES\"\n            }\n        }\n    },\n    \"mobile\": {\n        \"enabled\": true,\n        \"otp\": {\n            \"failure\": {\n                \"count\": 3,\n                \"coolDown\": {\n                    \"duration\": 2,\n                    \"timeUnit\": \"MINUTES\"\n                }\n            },\n            \"window\": {\n                \"stepSize\": {\n                    \"duration\": 30,\n                    \"timeUnit\": \"SECONDS\"\n                }\n            }\n        },\n        \"applications\": [\n            {\n                \"id\": \"{{webApp4MfaId}}\",\n                \"push\": {\n                    \"enabled\": false\n                },\n                \"otp\": {\n                    \"enabled\": true\n                },\n                \"deviceAuthorization\": {\n                    \"enabled\": true,\n                    \"extraVerification\": \"permissive\"\n                },\n                \"autoEnrollment\": {\n                    \"enabled\": true\n                },\n                \"integrityDetection\": \"permissive\"\n            }\n        ]\n    },\n    \"totp\": {\n        \"enabled\": true,\n        \"otp\": {\n            \"failure\": {\n                \"count\": 3,\n                \"coolDown\": {\n                    \"duration\": 2,\n                    \"timeUnit\": \"MINUTES\"\n                }\n            }\n        }\n    },\n    \"voice\": {\n        \"enabled\": false,\n        \"otp\": {\n            \"failure\": {\n                \"count\": 3,\n                \"coolDown\": {\n                    \"duration\": 0,\n                    \"timeUnit\": \"MINUTES\"\n                }\n            },\n            \"lifeTime\": {\n                \"duration\": 30,\n                \"timeUnit\": \"MINUTES\"\n            }\n        }\n    },\n    \"securityKey\": {\n        \"enabled\": true\n    },\n    \"forSignOnPolicy\": false,\n    \"platform\": {\n        \"enabled\": true\n    },\n    \"default\": false\n}"
let postData = parameters.data(using: .utf8)

var request = URLRequest(url: URL(string: "{{apiPath}}/environments/{{envID}}/deviceAuthenticationPolicies")!,timeoutInterval: Double.infinity)
request.addValue("application/json", forHTTPHeaderField: "Content-Type")
request.addValue("Bearer {{accessToken}}", forHTTPHeaderField: "Authorization")

request.httpMethod = "POST"
request.httpBody = postData

let task = URLSession.shared.dataTask(with: request) { data, response, error in
  guard let data = data else {
    print(String(describing: error))
    return
  }
  print(String(data: data, encoding: .utf8)!)
}

task.resume()

Example Response

201 Created

{
    "_links": {
        "self": {
            "href": "https://api.pingone.com/v1/environments/abfba8f6-49eb-49f5-a5d9-80ad5c98f9f6/deviceAuthenticationPolicies/71db74e1-b12b-4ad5-92df-317227aeeb97"
        },
        "environment": {
            "href": "https://api.pingone.com/v1/environments/abfba8f6-49eb-49f5-a5d9-80ad5c98f9f6"
        }
    },
    "id": "71db74e1-b12b-4ad5-92df-317227aeeb97",
    "environment": {
        "id": "abfba8f6-49eb-49f5-a5d9-80ad5c98f9f6"
    },
    "name": "useCaseDeviceAuthPolicy__1664989429",
    "sms": {
        "enabled": true,
        "otp": {
            "failure": {
                "count": 3,
                "coolDown": {
                    "duration": 0,
                    "timeUnit": "MINUTES"
                }
            },
            "lifeTime": {
                "duration": 30,
                "timeUnit": "MINUTES"
            }
        }
    },
    "email": {
        "enabled": true,
        "otp": {
            "failure": {
                "count": 3,
                "coolDown": {
                    "duration": 0,
                    "timeUnit": "MINUTES"
                }
            },
            "lifeTime": {
                "duration": 30,
                "timeUnit": "MINUTES"
            }
        }
    },
    "mobile": {
        "enabled": true,
        "otp": {
            "failure": {
                "count": 3,
                "coolDown": {
                    "duration": 2,
                    "timeUnit": "MINUTES"
                }
            }
        },
        "applications": [
            {
                "id": "3a9867c0-c8f8-4b60-a96f-1053b90fd984",
                "push": {
                    "enabled": false
                },
                "otp": {
                    "enabled": true
                },
                "autoEnrollment": {
                    "enabled": true
                },
                "deviceAuthorization": {
                    "enabled": true,
                    "extraVerification": "permissive"
                },
                "integrityDetection": "permissive"
            }
        ]
    },
    "totp": {
        "enabled": true,
        "otp": {
            "failure": {
                "count": 3,
                "coolDown": {
                    "duration": 2,
                    "timeUnit": "MINUTES"
                }
            }
        }
    },
    "voice": {
        "enabled": false,
        "otp": {
            "failure": {
                "count": 3,
                "coolDown": {
                    "duration": 0,
                    "timeUnit": "MINUTES"
                }
            },
            "lifeTime": {
                "duration": 30,
                "timeUnit": "MINUTES"
            }
        }
    },
    "securityKey": {
        "enabled": true
    },
    "platform": {
        "enabled": true
    },
    "forSignOnPolicy": false,
    "updatedAt": "2022-10-05T17:03:49.417Z",
    "createdAt": "2022-10-05T17:03:49.417Z",
    "default": false
}