リスト取得

接続拒否履歴のリストを取得します。

Request Interface

HTTP Request

GET /access-denial/log

Parameter

個別のパラメータはありません。

Site API 共通のリクエストパラメータについては、「共通パラメータ」を参照してください。

Response Interface

リクエストが正常に処理された場合、以下の JSON フォーマットでレスポンスが返却されます。

{
    "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 :Data Transfer Site ログイン時に接続拒否の場合は、loginAccountに値が設定されます。connectionIdとagentIdに値は設定されません。

*2 :HULFT-WebConnectサービスで接続拒否の場合は、connectionId、agentIdに値が設定されます。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);
});