com.duosecurity.client

Class Http

java.lang.Object

com.duosecurity.client.Http

Direct Known Subclasses:

Accounts, Admin, Auth

public class Http
extends Object

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected static class	Http.ClientBuilder<T extends Http> Builder for an Http client object.
static class	Http.HttpBuilder

Field Summary

Fields

Modifier and Type	Field and Description
static int	BACKOFF_FACTOR
static int	DEFAULT_TIMEOUT_SECS
static okhttp3.MediaType	FORM_ENCODED
static int	INITIAL_BACKOFF_MS
static okhttp3.MediaType	JSON_ENCODED
static int	MAX_BACKOFF_MS
static SimpleDateFormat	RFC_2822_DATE_FORMAT
protected int	sigVersion
static String	UserAgentString

Constructor Summary

Constructors

Modifier	Constructor and Description
	Http(String inMethod, String inHost, String inUri) Deprecated. Use the HttpBuilder instead
protected	Http(String inMethod, String inHost, String inUri, int timeout) Deprecated. Use the HttpBuilder instead

Method Summary

Modifier and Type	Method and Description
void	addAdditionalDuoHeader(Map<String,String> inAdditionalDuoHeaders)
void	addHeader(String name, String value)
void	addParam(String name, Integer value)
void	addParam(String name, org.json.JSONObject value)
void	addParam(String name, List<Object> value)
void	addParam(String name, String value)
protected String	canonRequest(String date, int sigVersion)
okhttp3.Response	executeHttpRequest() Creates and executes a HTTP request.
Object	executeJSONRequest() Executes JSON request.
Object	executeRequest()
String	executeRequestRaw()
int	nextRandomInt(int bound)
void	setProxy(String host, int port) Creates a new proxy.
protected String	signHMAC(String skey, String msg)
void	signRequest(String ikey, String skey)
void	signRequest(String ikey, String skey, int inSigVersion) Signs Duo request.
protected void	sleep(long ms)
void	useCustomCertificates(String[] customCaCerts) Use custom CA certificates for certificate pinning.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

BACKOFF_FACTOR

public static final int BACKOFF_FACTOR

See Also:

Constant Field Values

INITIAL_BACKOFF_MS

public static final int INITIAL_BACKOFF_MS

See Also:

Constant Field Values

MAX_BACKOFF_MS

public static final int MAX_BACKOFF_MS

See Also:

Constant Field Values

DEFAULT_TIMEOUT_SECS

public static final int DEFAULT_TIMEOUT_SECS

See Also:

Constant Field Values

UserAgentString

public static final String UserAgentString

See Also:

Constant Field Values

sigVersion

protected int sigVersion

RFC_2822_DATE_FORMAT

public static SimpleDateFormat RFC_2822_DATE_FORMAT

FORM_ENCODED

public static okhttp3.MediaType FORM_ENCODED

JSON_ENCODED

public static okhttp3.MediaType JSON_ENCODED

Constructor Detail

Http

public Http(String inMethod,
            String inHost,
            String inUri)

Deprecated. Use the HttpBuilder instead

Http constructor.

Parameters:

inMethod - The method for the http request

inHost - The api host provided by Duo and found in the Duo admin panel

inUri - The endpoint for the request

Http

protected Http(String inMethod,
               String inHost,
               String inUri,
               int timeout)

Deprecated. Use the HttpBuilder instead

Http constructor.

Parameters:

inMethod - The method for the http request

inHost - The api host provided by Duo and found in the Duo admin panel

inUri - The endpoint for the request

timeout - The timeout for the http request

Method Detail

executeJSONRequest

public Object executeJSONRequest()
                          throws Exception

Executes JSON request.

Returns:

The result of the JSON request

Throws:

Exception - If the result was not OK

executeRequestRaw

public String executeRequestRaw()
                         throws Exception

Throws:

Exception

executeHttpRequest

public okhttp3.Response executeHttpRequest()
                                    throws Exception

Creates and executes a HTTP request.

Returns:

The result of the HTTP request

Throws:

UnsupportedEncodingException - For http methods that are not supported

Exception

executeRequest

public Object executeRequest()
                      throws Exception

Throws:

Exception

sleep

protected void sleep(long ms)
              throws Exception

Throws:

Exception

signRequest

public void signRequest(String ikey,
                        String skey)
                 throws UnsupportedEncodingException

Throws:

UnsupportedEncodingException

signRequest

public void signRequest(String ikey,
                        String skey,
                        int inSigVersion)
                 throws UnsupportedEncodingException

Signs Duo request.

Parameters:

ikey - Integration key provided by Duo and found in the admin panel

skey - Secret key provided by Duo and found in the admin panel

inSigVersion - The version of signature used

Throws:

UnsupportedEncodingException - For unsupported encodings

signHMAC

protected String signHMAC(String skey,
                          String msg)

addHeader

public void addHeader(String name,
                      String value)

addParam

public void addParam(String name,
                     String value)

addParam

public void addParam(String name,
                     Integer value)

addParam

public void addParam(String name,
                     org.json.JSONObject value)

addParam

public void addParam(String name,
                     List<Object> value)

addAdditionalDuoHeader

public void addAdditionalDuoHeader(Map<String,String> inAdditionalDuoHeaders)

setProxy

public void setProxy(String host,
                     int port)

Creates a new proxy.

Parameters:

host - The proxy host

port - The port of the proxy

useCustomCertificates

public void useCustomCertificates(String[] customCaCerts)

Use custom CA certificates for certificate pinning.

Parameters:

customCaCerts - The CA certificates to pin

canonRequest

protected String canonRequest(String date,
                              int sigVersion)
                       throws UnsupportedEncodingException

Throws:

UnsupportedEncodingException

nextRandomInt

public int nextRandomInt(int bound)