> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blinkops.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Run Preauth

Run to discover whether a user is authorized to log in, and if so, return the user's available authentication factors.

<Note>
  External Documentation

  To learn more, visit the [Duo Auth documentation](https://duo.com/docs/authapi#/preauth).
</Note>

## Basic Parameters

<div className="integrations-table">
  | Parameter      | Description                                                                                                                                                                                                                                                                                                                                                                                                                                |
  | -------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
  | User ID        | The unique identifier for the user as generated by `Duo` upon user creation. <br /><br />Can be obtained by the `List Users` action in the Duo collection.<br />`Important To Note:` The `Duo` collection has a separate connection that requires Admin API Credentials. Please follow [our Duo documentation](https://docs.blinkops.com/docs/integrations/duo) to obtain them.                                                            |
  | User Info Type | Choose the user's information to provide. You must specify either the user ID or the username.                                                                                                                                                                                                                                                                                                                                             |
  | Username       | The Unique username that is commonly specified during user creation. This value may also represent a username alias assigned to a user. <br /><br />Can be obtained by the `List Users` action in the Duo collection.<br />`Important To Note:` The `Duo` collection has a separate connection that requires Admin API Credentials. Please follow [our Duo documentation](https://docs.blinkops.com/docs/integrations/duo) to obtain them. |
</div>

## Advanced Parameters

<div className="integrations-table">
  | Parameter                     | Description                                                                                                                                                                                                                                                                                                                                                                                                                   |
  | ----------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
  | Client Supports Verified Push | Set this parameter to **1** if your client supports `Verified Duo Push`, allowing it as an authentication method when required. <br /><br />If **not provided** or set to **0**, `Verified Duo Push` will be ignored, and the `Require Verified Duo Push` policy will be bypassed.<br /><br />For additional information regarding this parameter, please visit [Duo's documentation](https://duo.com/docs/authapi#/preauth). |
  | Hostname                      | The host name of the device accessing the application.                                                                                                                                                                                                                                                                                                                                                                        |
  | IP Address                    | The IP address of the user to be authenticated. <br /><br />If an Auth API client does not send the ipaddr value in a request, policy settings based on available IP address information, like authorized networks or user location have no effect.                                                                                                                                                                           |
  | Trusted Device Token          | Return an "allow" response for the lifetime of the `trusted_device_token`, if the token is present and the policy enables `Remembered Devices` for browser-based applications.                                                                                                                                                                                                                                                |
</div>

## Example Output

```json theme={"dark"}
{
	"stat": "OK",
	"response": {
		"devices": [
			{
				"capabilities": [
					"auto",
					"push",
					"sms",
					"phone",
					"mobile_otp"
				],
				"device": "DPFZRS9FB0D46QFTM891",
				"display_name": "iOS (XXX-XXX-0100)",
				"name": "",
				"number": "XXX-XXX-0100",
				"type": "phone"
			},
			{
				"device": "DHEKH0JJIYC1LX3AZWO4",
				"name": "0",
				"type": "token"
			}
		],
		"result": "auth",
		"status_msg": "Account is active"
	}
}
```

## Workflow Library Example

[Run Preauth with Duo Auth and Send Results Via Email](https://library.blinkops.com/workflows/run-preauth-with-duo-auth-and-send-results-via-email)

<div className="iframe-wrapper">
  <div className="iframe-media">
    <img src="https://mintcdn.com/blinkops-2/ojHYuDeYX5FWuN8a/img/Icons/play-box.svg?fit=max&auto=format&n=ojHYuDeYX5FWuN8a&q=85&s=b8af968e71438a9499c3223c9bd29fb2" alt="Workflow Library" width="16" height="16" data-path="img/Icons/play-box.svg" />

    Preview this Workflow on desktop
  </div>

  <iframe className="iframe" src="https://library.blinkops.com/workflows/run-preauth-with-duo-auth-and-send-results-via-email/canvas" />
</div>