com.duosecurity.service

Class DuoConnector

java.lang.Object

com.duosecurity.service.DuoConnector

public class DuoConnector
extends Object

Field Summary

Fields

Modifier and Type	Field and Description
protected retrofit2.Retrofit	retrofit

Constructor Summary

Constructors

Constructor and Description
DuoConnector(String apiHost, String[] caCerts) DuoConnector Constructor.

Method Summary

Modifier and Type	Method and Description
HealthCheckResponse	duoHealthcheck(String clientId, String clientAssertion) Send Health Check request.
TokenResponse	exchangeAuthorizationCodeFor2FAResult(String userAgent, String grantType, String duoCode, String redirectUri, String clientAssertionType, String clientAssertion) Send request to exchange duoCode for an encoded JWT.

Methods inherited from class java.lang.Object

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

Field Detail

retrofit

protected retrofit2.Retrofit retrofit

Constructor Detail

DuoConnector

public DuoConnector(String apiHost,
                    String[] caCerts)
             throws DuoException

DuoConnector Constructor.

Parameters:

apiHost - This value is the api host provided by Duo in the admin panel.

caCerts - CA Certificates used to connect to Duo

Throws:

DuoException - For issues getting and validating the URL

Method Detail

duoHealthcheck

public HealthCheckResponse duoHealthcheck(String clientId,
                                          String clientAssertion)
                                   throws DuoException

Send Health Check request.

Parameters:

clientId - The client id provided by Duo in the admin panel

clientAssertion - A JWT the Duo Health Check endpoint needs

Returns:

HealthCheckResponse Returns result from the Health Check

Throws:

DuoException - For issues sending or receiving the request

exchangeAuthorizationCodeFor2FAResult

public TokenResponse exchangeAuthorizationCodeFor2FAResult(String userAgent,
                                                           String grantType,
                                                           String duoCode,
                                                           String redirectUri,
                                                           String clientAssertionType,
                                                           String clientAssertion)
                                                    throws DuoException

Send request to exchange duoCode for an encoded JWT.

Parameters:

userAgent - A user agent string

grantType - A string that tells what type of exchange that will occur

duoCode - An authentication session transaction id

redirectUri - The URL to redirect back to after a successful auth

clientAssertionType - The type of client assertion used

clientAssertion - JWT that holds information to verify that the owner of the duoCode is authorized to have it

Returns:

TokenResponse Returns resulting response containing the JWT

Throws:

DuoException - For issues sending or receiving the request, or failing to exchange a token