Getting List Information

You can get a list of Connection Refusing Log.

Request Interface

HTTP Request

GET /access-denial/log

Parameter

There is no individual parameter for this request.

For details on common request parameters for Site API, refer to Common Parameter

Response Interface

If the request is processed successfully, the following response is returned in JSON format.

{
    "totalSize":10,
    "fetchSize":10,
    "startIndex":0,
    "maxResults":30,
    "accessDenialLogs":[
        {
            "loginAccount":"xxxxxxxxxxxxxxxxxxxxxx",
            "accessedAt":"xxxxxxxxxxxxxxxxxxxxxx",
            "connectionType":"xxxxxxxxxxxxxxxxxxxxxx",
            "sourceIp":"xxxxxxxxxxxxxxxxxxxxxx",
            "destinationEndpoint":"xxxxxxxxxxxxxxxxxxxxxx",
            "connectionId":["abc", "xyz"],
            "agentId":"xxxxxxxxxxxxxxxxxxxxxx",
            "userAgent":"xxxxxxxxxxxxxxxxxxxxxx",
            "denialReason":"xxxxxxxxxxxxxxxxxxxxxx",
        }
    ]
}

Property Name

Value

Description

loginAccount (*1)

string

Account (email address)

accessedAt

string

Date and time of access

connectionType

string

Connection type

sourceIp

string

Access source IP

destinationEndpoint

string

Access destination endpoint (public host name)

connectionId (*2)

array

Connection ID

agentId (*2)

string

Agent ID

userAgent

string

User agent

denialReason

string

Cause of denied access

*1 :If access was denied during the Data Transfer Site login process, a value is set to loginAccount. No values are set to connectionId and agentId.

*2 :If access was denied by the HULFT-WebConnect service, values are set to connectionId and agentId. No value is set to loginAccount.

Examples

public static void main(String[] args) {
    String host = "https://www.webconnect.hulft.com";
    String apiKey = "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx";
    try {
        URL url = new URL(host + "/api/v2/access-denial/log");
        HttpURLConnection connection = (HttpURLConnection) url.openConnection();
        connection.setRequestMethod("GET");
        connection.setRequestProperty("Authorization", "Bearer " + apiKey);
        try (BufferedReader reader = new BufferedReader(new InputStreamReader(connection.getInputStream()))) {
            String line;
            while((line = reader.readLine()) != null) {
                System.out.println(line);
            }
        }
    } catch (IOException ex) {
        // error
    }
}

// load jquery 
var host = 'https://www.webconnect.hulft.com';
var apiKey = 'xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx';
$.ajax({
  type: 'GET',
  url: host + '/api/v2/access-denial/log',
  headers: {
    Authorization: 'Bearer ' + apiKey
  }
}).done(function(data, status, xhr) {
  console.log(data);
}).fail(function(data, status, xhr) {
  console.log(data);
});