IIJセキュアエンドポイントサービス APIリファレンス

POST log_download_url

API情報

HTTPメソッドAPI名パス目的
POSTlog_download_url/r/[APIVersion]/[ServiceCode]/[ChildServiceCode]/log_download_url.json

ログダウンロード用URLの発行

APIバージョン:20190625

個別パラメータ
URL
パラメータ必須タイプ説明例
APIVersion〇StringAPIバージョン20190625
ServiceCode〇Stringログダウンロード用URLを発行する対象契約の親サービスコードyemXXXXXXXX
ChildServiceCode〇Stringログダウンロード用URLを発行する対象契約の子サービスコード

yesXXXXXXXX

yecXXXXXXXX

yelXXXXXXXX

HTTPリクエストボディ
パラメータ必須タイプ説明例
LogDate〇String

ダウンロード対象とするログの日付(YYYYMMDD)
現在の日付から過去35日以内の日付を指定してください

20190624
Acl String

ダウンロードを許可するIPアドレス (IPアドレス, IPアドレス/ネットマスク)
指定したIPアドレスからのアクセス時のみログがダウンロードができます

192.168.0.1

192.168.0.0/24

レスポンス
パラメータタイプ説明例
APIResult.EncryptKeyStringログダウンロード用URLにアクセスする際に利用する暗号化用のキー

英数字及び以下の記号の12桁

  •  _-%@!?^
APIResult.LogDownloadURLString

ログダウンロード用URL
ログダウンロード用URLの末尾はログダウンロード用のユニークID
有効期限は発行してから1時間

https://api.secureep.jp/public_api/v1/log-download/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
エラーコード
エラーHTTP Status CodeErrorTypeErrorMessageErrorDetail.Reason意味備考
パラメータエラー200BadRequestSpecified parameter has some errors.Required parameter 'LogDate' not found.リクエストパラメータにLogDateが存在しない 
Parameter 'LogDate' must be of yyyymmdd format.リクエストパラメータのLogDateのフォーマットエラー 
Parameter 'LogDate' must be in the past 35 days.リクエストパラメータのLogDateが過去35日以内の日付ではない 
Parameter 'Acl' must be IPv4 ipaddress or network address.リクエストパラメータのAclのフォーマットエラー 
Log download is not provided for [ChildServiceCode].指定された子サービスコードがログダウンロードに対応していないIT資産管理/CE(yeoXXXXXXXX)はログダウンロードに対応していません
存在しない200NotFoundSpecified child service code is not contracted.[ServiceCode] is not found under [ChildServiceCode].

指定された子サービスコードが親サービスコードの配下に存在しない

 
システム障害200SystemErrorSystem error occurred. API設備のシステム障害サポートセンターへお問い合わせください
制限
  • なし
サンプル
リクエスト  
POST /r/[APIVersion]/[ServiceCode]/[ChildServiceCode]/log_download_url.json HTTP/1.1
Host: ep.api.iij.jp
x-iijapi-Expire: 2019-06-06T09:52:01Z
x-iijapi-SignatureMethod: [SignatureMethod]
x-iijapi-SignatureVersion: [SignatureVersion]
Authorization:IIJAPI [AccessKeyId]:[Signature]
Content-Type: application/json
 
{"LogDate":"xxxxxxxx","Acl":"xxx.xxx.xxx.xxx"}
レスポンス
{
  "APIResult": {
    "EncryptKey": "xxxxxxxxxxxx",
    "LogDownloadURL": "https://api.secureep.jp/public_api/v1/log-download/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "RequestId": "xxxxxxxx-xxxxxxxx-xxxxxxxx-xxxxxxxx-xxxxxxxx"
  }
}

ログダウンロード

ログのダウンロードを行うには本ページのlog_download_urlを利用し、ログをダウンロードするためのURLを取得して以下の形式でAPIにアクセスしてください。

API情報
HTTPメソッドアクセス先
GET[取得したログダウンロードURL]?MasterID=XXXXXXXXXXXXXXXXXXXXXXXX
リクエストパラメータ
パラメータ必須説明例
取得したログダウンロードURL〇log_download_url で取得したLogDownloadURLの値https://api.secureep.jp/public_api/v1/log-download/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
MasterID〇

マスターIDをAES-128-CBCで暗号化した結果をbase64でエンコードした値

  • メッセージダイジェストにはMD5を利用します
  • saltは利用しません
  • passwordにはlog_download_urlで取得したEncryptKeyの値を利用します
  • 生成した値はSignature生成時のURLエンコード方法を参考にURLエンコードを実施します

生成例

echo -n [MasterID] | openssl enc -md md5 -aes-128-cbc -e -nosalt -pass pass:[password] -base64
パラメータ意味例
MasterIDIIJサービスオンラインにログインするためのIDSAXXXXXXX
passwordlog_download_url で取得したEncryptKeyの値

英数字及び以下の記号の12桁

  •  _-%@!?^
レスポンス
  • 指定した日付のログをzip形式でダウンロードできます
エラーコード
エラーHTTP Status CodeErrorTypeErrorMessageErrorDetail.Reason意味備考
クエリパラメータ不正400BadRequestThere are invalid parameters. 
以下のいずれかの場合
  • クエリパラメータが存在しない
  • 不正なクエリパラメータが含まれている
 
認証エラー403PermissionDeniedAccess denied to specified log. 

以下のいずれかの場合

  • 許可されていないIPアドレスからのアクセス
  • URLの有効期限切れ
  • MasterIDが正しくない
 
パラメータエラー404NotFoundLog download request not found. 

ログダウンロード用IDが正しくない

 
URL不正URL is not valid. 

以下のいずれかの場合

  • アクセスURLが正しくない
  • 存在しないAPIが指定された
 
システム障害500SystemErrorSystem error occurred. 

API設備のシステム障害

IIJサポートセンターへお問い合わせください