エンタープライズイベントの取得

ガイドイベント エンタープライズイベントの取得

エンタープライズイベントの取得

エンタープライズイベントを取得するには、管理者権限を持つユーザーを認証し、stream_typeをadmin_logsに設定してGET /events APIを呼び出します。

curl https://api.box.com/2.0/events?stream_type=admin_logs \
  -H "authorization: Bearer <ACCESS_TOKEN>"

Java

// get the last two hours of unfiltered enterprise events
Date startDate = new Date(System.currentTimeMillis() - (1000 * 60 * 60 * 2));
Date endDate = new Date(System.currentTimeMillis());
EventLog eventLog = EventLog.getEnterpriseEvents(api, startDate, endDate);
for (BoxEvent event : eventLog) {
    System.out.println("Enterprise Event Created by User: "
            + event.getCreatedBy().getName()
            + " Login: " + event.getCreatedBy().getLogin()
            + " Event Type: " + event.getType()
            + " Created at: " + event.getCreatedAt().toString());
};

Python

events = client.events()
    .get_admin_events(created_after='2019-07-01T22:02:24-07:00')
 for event in events['entries']:
    print('Got {0} event that occurred at {1}'.format(event.event_type, event.created_at))

このAPIを使用するには、ユーザーは新規レポートの実行および既存レポートへのアクセスを行うのための権限を持つ、会社の管理者または共同管理者である必要があります。

エンタープライズイベントフィードでは、イベントタイプによるフィルタがサポートされています。

cURL

curl https://api.box.com/2.0/events?stream_type=admin_logs&event_type=LOGIN,FAILED_LOGIN \
  -H "authorization: Bearer <ACCESS_TOKEN>"

Python

events = client.events()
    .get_admin_events(created_after='2019-07-01T22:02:24-07:00', event_types=['ITEM_CREATE'])
 for event in events['entries']:
    print('Got {0} event that occurred at {1}'.format(event.event_type, event.created_at))

イベントタイプの完全なリストについては、以下を参照してください。

管理者イベントフィードでは、ロングポーリングがサポートされません。イベントに対するロングポーリングでは、ユーザーイベントフィードを使用します。

Boxでのイベントの保存は無期限ではありません。

ユーザーイベントは2週間から2か月間保存され、その後、保存されたユーザーイベントは削除されます。エンタープライズイベントには、APIを介した場合は1年間、Box管理コンソールのエクスポートされたレポート経由の場合は7年間アクセスできます。

このフィードでは、レイテンシよりも完全性を重視しています。つまり、Boxでは管理者イベントをユーザーフィードよりも高いレイテンシで配信することがあります。ユーザーイベントストリームとは違い、管理者イベントストリームでは、特定のイベントに対するフィルタが可能ですが、ロングポーリングはサポートされていません。

エンタープライズに対して、以下のイベントがトリガーされます。

イベント名	説明
`ACCESS_GRANTED`	ユーザーが自分のアカウントへのアクセス権限をBoxサポートに付与しました
`ACCESS_REVOKED`	ユーザーがBoxサポートの自分のアカウントへのアクセス権限を取り消しました
`ADD_DEVICE_ASSOCIATION`	デバイスの関連付けが追加されました。
`ADD_LOGIN_ACTIVITY_DEVICE`	ユーザーがまだ確認されていないデバイスからログインしています
`ADMIN_LOGIN`	管理対象ユーザーのアカウントへのログインに管理コンソールが使用されました
`APPLICATION_CREATED`	Box開発者コンソールで新しいアプリケーションが作成されます
`APPLICATION_PUBLIC_KEY_ADDED`	アプリケーションの公開キーが追加されます。
`APPLICATION_PUBLIC_KEY_DELETED`	アプリケーションの公開キーが削除されます。
`CHANGE_ADMIN_ROLE`	ユーザーの管理者ロールが変更されたとき
`CHANGE_FOLDER_PERMISSION`	フォルダに対する権限を編集します。
`COLLABORATION_ACCEPT`	招待が承認されました。
`COLLABORATION_EXPIRATION`	コラボレータの有効期限が設定されました。
`COLLABORATION_INVITE`	招待されました。
`COLLABORATION_REMOVE`	コラボレータが削除されました
`COLLABORATION_ROLE_CHANGE`	ユーザーロールが変更されました。
`COLLECTION_CREATE`	コレクションが作成されます
`COLLECTION_DELETE`	コレクションが削除されます
`COLLECTION_UPDATE`	コレクションが更新されます
`COLLECTION_ITEM_CREATE`	項目がコレクションに追加されます
`COLLECTION_ITEM_DELETE`	項目がコレクションから削除されます
`COLLECTION_ITEM_UPDATE`	コレクション内の項目が更新されます
`COMMENT_CREATE`	コメントがファイルに作成されます
`COMMENT_DELETE`	ファイルのコメントが削除されます
`CONTENT_ACCESS`	ファイルは、承認されたエンドユーザーによって、またはBoxアプリケーションでプログラムによってアクセスされます
`CONTENT_WORKFLOW_ABNORMAL_DOWNLOAD_ACTIVITY`	管理コンソールで設定されたポリシーがトリガーされます
`CONTENT_WORKFLOW_AUTOMATION_ADD`	自動化が追加されます
`CONTENT_WORKFLOW_AUTOMATION_DELETE`	自動化が削除されます
`CONTENT_WORKFLOW_POLICY_ADD`	コンテンツポリシーが追加されます
`CONTENT_WORKFLOW_SHARING_POLICY_VIOLATION`	共有ポリシー違反があります。
`CONTENT_WORKFLOW_UPLOAD_POLICY_VIOLATION`	管理者が設定したアップロードポリシーをコラボレータが違反しました。
`COPY`	コピー
`DATA_RETENTION_CREATE_RETENTION`	リテンションが作成されます
`DATA_RETENTION_REMOVE_RETENTION`	リテンションが削除されます
`DELETE`	削除
`DELETE_USER`	ユーザーが削除されました。
`DEVICE_TRUST_CHECK_FAILED`	デバイストラストチェックに失敗しました。
`DOWNLOAD`	ダウンロード
`EDIT`	編集されました。
`EDIT_USER`	ユーザーが編集されました。
`EMAIL_ALIAS_CONFIRM`	ユーザーのメールエイリアスが確認されます
`EMAIL_ALIAS_REMOVE`	ユーザーのメールエイリアスが削除されます
`ENTERPRISE_APP_AUTHORIZATION_UPDATE`	JWTアプリケーションが承認または再承認されました
`EXTERNAL_COLLAB_SECURITY_SETTINGS`	外部コラボレーションのセキュリティ設定での変更
`FAILED_LOGIN`	ログインに失敗しました。
`FILE_MARKED_MALICIOUS`	ファイルでウイルスが検出されました。イベントは、通知を希望した会社のみに送信されます。
`FILE_WATERMARKED_DOWNLOAD`	電子すかし付きファイルがダウンロードされます
`GROUP_ADD_ITEM`	項目がグループに追加されます
`GROUP_ADD_USER`	ユーザーがグループに追加されました。
`GROUP_CREATION`	新しいグループが作成されました。
`GROUP_DELETION`	グループが削除されました。
`GROUP_EDITED`	グループが編集されました。
`GROUP_REMOVE_ITEM`	管理コンソールでフォルダがグループから削除されました
`GROUP_REMOVE_USER`	ユーザーがグループから削除されました。
`ITEM_MODIFY`	項目が変更されます
`ITEM_OPEN`	項目が開かれます
`ITEM_SHARED_UPDATE`	共有リンク設定が更新されました。
`ITEM_SYNC`	フォルダが同期されました。
`ITEM_UNSYNC`	フォルダから同期対象のマークが解除されました。
`LEGAL_HOLD_ASSIGNMENT_CREATE`	リーガルホールドの割り当てが作成されます
`LEGAL_HOLD_ASSIGNMENT_DELETE`	リーガルホールドの割り当てが削除されます
`LEGAL_HOLD_POLICY_CREATE`	リーガルホールドポリシーが作成されます
`LEGAL_HOLD_POLICY_DELETE`	リーガルホールドポリシーが削除されます
`LEGAL_HOLD_POLICY_UPDATE`	リーガルホールドポリシーが更新されます
`LOCK`	ロック
`LOGIN`	ログイン
`METADATA_INSTANCE_CREATE`	メタデータインスタンスの作成
`METADATA_INSTANCE_DELETE`	メタデータインスタンスの削除
`METADATA_INSTANCE_UPDATE`	メタデータインスタンスの更新
`METADATA_TEMPLATE_CREATE`	メタデータテンプレートの作成
`METADATA_TEMPLATE_UPDATE`	メタデータテンプレートの更新
`METADATA_TEMPLATE_DELETE`	メタデータテンプレートの削除
`MOVE`	移動
`NEW_USER`	ユーザーが作成されました。
`OAUTH2_ACCESS_TOKEN_REVOKE`	OAuth 2.0アクセストークンが取り消されました
`PREVIEW`	プレビュー
`REMOVE_DEVICE_ASSOCIATION`	デバイスの関連付けが削除されました。
`REMOVE_LOGIN_ACTIVITY_DEVICE`	アプリに関連付けられたユーザーセッションが無効になりました。
`RENAME`	ファイルまたはフォルダの名前または説明が変更されます
`RETENTION_POLICY_ASSIGNMENT_ADD`	リテンションポリシー割り当てが追加されます
`SHARE`	共有リンクが有効になりました。
`SHARE_EXPIRATION`	共有リンクの有効期限が設定されました。
`SHIELD_ALERT`	会社のShieldルールに基づいて、Shieldで異常なダウンロード、セッション、場所または悪意のあるコンテンツが検出されました。詳細については、Shieldのアラートイベントを参照してください。
`SHIELD_EXTERNAL_COLLAB_ACCESS_BLOCKED`	外部コラボレーションへのアクセスがブロックされます
`SHIELD_EXTERNAL_COLLAB_ACCESS_BLOCKED_MISSING_JUSTIFICATION`	正当な理由がないため、外部コラボレーションへのアクセスがブロックされます
`SHIELD_EXTERNAL_COLLAB_INVITE_BLOCKED`	外部コラボレーションへの招待がブロックされます
`SHIELD_EXTERNAL_COLLAB_INVITE_BLOCKED_MISSING_JUSTIFICATION`	正当な理由がないため、外部コラボレーションへの招待がブロックされます
`SHIELD_EXTERNAL_COLLAB_INVITE_JUSTIFIED`	外部コラボレーションへの招待が認められます
`SHIELD_JUSTIFICATION_APPROVAL`	Shieldの正当な理由が承認されます
`STORAGE_EXPIRATION`	ファイルの自動削除が設定されました。
`TASK_ASSIGNMENT_UPDATE`	タスク割り当ての更新
`TASK_ASSIGNMENT_CREATE`	タスク割り当てが作成されます
`TASK_ASSIGNMENT_DELETE`	タスク割り当てが削除されます
`TASK_CREATE`	タスクが作成されます。
`TASK_UPDATE`	タスクのコメントが編集されます
`TERMS_OF_SERVICE_ACCEPT`	利用規約が承諾されました。
`TERMS_OF_SERVICE_REJECT`	利用規約が拒否されました。
`UNDELETE`	復元されました。
`UNLOCK`	ロックの解除
`UNSHARE`	共有リンクが削除されました。
`UPDATE_COLLABORATION_EXPIRATION`	コラボレータの有効期限が延長されます。
`UPDATE_SHARE_EXPIRATION`	共有リンクの有効期限が延長されます。
`UPLOAD`	アップロード
`USER_AUTHENTICATE_OAUTH2_ACCESS_TOKEN_CREATE`	OAuth 2.0アクセストークンが作成されました。
`WATERMARK_LABEL_CREATE`	電子すかしがファイルに追加されます
`WATERMARK_LABEL_DELETE`	電子すかしがファイルから削除されます

場合によっては、イベントフィードには、IDが2のユーザーが表示される可能性があります。これは、匿名ユーザーを表すBoxの内部識別子です。

匿名ユーザーは、ログインしていないユーザーです。この状況は、ユーザーがコンテンツを操作し、最初にログインを求められない場合にいつでも発生する可能性があります。たとえば、ユーザーが、公開共有リンクを使用してファイルをダウンロードするときなどです。

エンタープライズイベントの取得

エンタープライズイベントの取得

イベントタイプによるフィルタ

制限

イベントタイプ

匿名ユーザー

Related APIs

Related Guides