跳转到主要内容

跟踪不同的事件并将它们写入审计日志。

项目描述

Finger Pointing

指认

生活、宇宙和一切

指认是一个基本的审计记录器,帮助您记录用户登录/注销和内容类型对象生命周期等事件。所有事件都记录到标准的Zope日志中,并可选项地记录到专门的审计日志文件中。

其他功能包括

  • 通过控制面板配置

  • 具有相应权限的用户可以轻松地可视化日志条目

  • 支持Cloudflare的CF-Connecting-IP请求头,以记录真实客户端IP地址

  • 支持基于审计日志文件大小的自动日志轮换

翻译

本产品已翻译成

  • 巴西葡萄牙语

  • 简体中文

  • 法语

  • 德语

  • 西班牙语

大部分无害

http://img.shields.io/pypi/v/collective.fingerpointing.svg https://img.shields.io/travis/collective/collective.fingerpointing/master.svg https://img.shields.io/coveralls/collective/collective.fingerpointing/master.svg

有想法?发现错误?通过提交支持工单让我们知道。

已知问题

在CDN后面运行您的站点可能会导致记录的IP地址不一致。

别慌

安装

要在基于buildout的安装中启用此包

编辑您的buildout.cfg并将其添加到其中

[buildout]
...
eggs =
    collective.fingerpointing

默认情况下,指认将审计事件记录到Zope事件日志中。要启用记录到单独的文件,请使用以下配置

[instance]
zope-conf-additional +=
    <product-config collective.fingerpointing>
        audit-log ${buildout:directory}/var/log/audit.log
        audit-log-max-size 10485760
        audit-log-old-files 30
    </product-config>
audit-log

审计日志的文件名。添加文件名以创建指认审计文件。

audit-log-max-size

审计日志文件的最大大小(以字节为单位)。添加此最大大小启用日志轮换。

audit-log-old-files

当启用日志轮换时,要保留的以前日志文件的数量。默认值为1。

更新配置后,您需要运行‘’bin/buildout’’,这将负责更新您的系统。

转到Plone站点中的“站点设置”页面,并单击“插件”链接。

勾选指认旁边的框,然后单击“激活”按钮。

使用

转到“站点设置”,选择“指认”,并启用您想关注的事件。

https://raw.githubusercontent.com/collective/collective.fingerpointing/master/docs/controlpanel.png

指认控制面板配置。

指认将开始记录所选事件

# bin/instance fg
2016-09-26 15:23:36 INFO ZServer HTTP server started at Mon Sep 26 15:23:36 2016
    Hostname: 0.0.0.0
    Port: 8080
2016-09-26 15:23:41 INFO collective.fingerpointing Logging audit information to /home/hvelarde/collective/fingerpointing/var/log/audit.log
2016-09-26 15:23:49 INFO Plone OpenID system packages not installed, OpenID support not available
2016-09-26 15:23:56 INFO Zope Ready to handle requests
2016-09-26 15:24:19 INFO collective.fingerpointing user=admin ip=127.0.0.1 action=logout
2016-09-26 15:24:28 INFO collective.fingerpointing user=admin ip=127.0.0.1 action=login

这些事件也记录在var/log/audit.log

2016-09-26 15:24:19,717 - INFO - user=admin ip=127.0.0.1 action=logout
2016-09-26 15:24:28,415 - INFO - user=admin ip=127.0.0.1 action=login

对于具有《collective.fingerpointing:查看审计日志》权限的用户,用户菜单中可用审计日志视图

Finger Pointing

指认审计日志视图。

如果您没有指定指认审计日志文件名,您将看到一条警告。但是,审计事件将正常记录到Zope事件日志中

# bin/instance fg
2016-09-26 15:58:32 INFO ZServer HTTP server started at Mon Sep 26 15:58:32 2016
    Hostname: 0.0.0.0
    Port: 8080
2016-09-26 15:58:35 WARNING collective.fingerpointing No audit log file specified; audit log view will be disabled
2016-09-26 15:58:40 INFO Plone OpenID system packages not installed, OpenID support not available
2016-09-26 15:58:45 INFO Zope Ready to handle requests
2016-09-26 15:58:48 INFO collective.fingerpointing user=admin ip=127.0.0.1 action=logout
2016-09-26 15:58:54 INFO collective.fingerpointing user=admin ip=127.0.0.1 action=login

分享并享受

没有以下人员的贡献,本包将无法实现

您可以在GitHub上找到包贡献者的更新列表。

变更日志

1.8.3 (2022-05-06)

  • 设置CI:在4.3,5.1,5.2,6.0中进行测试。[maurits]

  • 修复Plone 6中的ImportError。[maurits]

1.8.2 (2020-03-16)

  • 修复法语翻译中的错误。[laulaz]

  • workflow_logger中显示对象的完整路径而不是仅显示对象ID。[gbastien]

1.8.1 (2019-11-22)

  • 当在Plone 5.2中安装了指认并一起运行plone-compile-resources时,不要失败。[jensens]

  • 完成法语翻译。[gbastien]

1.8 (2018-10-11)

  • 避免在查看审计日志时出现TypeError(修复#91)。[jianaijun]

  • 更新简体中文翻译。[jianaijun]

1.7 (2018-04-23)

  • 停止支持Plone 5.0。[hvelarde]

  • 当添加Plone站点时避免ComponentLookupError(修复#85)。[hvelarde]

  • 记录卸载配置文件信息时,不要失败。[hvelarde]

  • 修复Plone 5.1下控制面板配置单元的卸载。[hvelarde]

1.6 (2018-03-28)

  • 避免在PAS事件上出现TypeError(修复#78)。[hvelarde]

1.6rc2 (2018-03-22)

  • 修复配置文件版本号。[hvelarde]

1.6rc1 (2018-03-22)

  • 更新i18n、巴西葡萄牙语和西班牙语翻译。[hvelarde]

  • 代码清理和重构,避免在注册表订阅者上出现UnicodeEncodeError(参考#74)。[hvelarde]

  • 记录通用设置配置文件导入;这对于审计插件安装/卸载很有用(实现#32)。[hvelarde]

  • 将标签大小设置为可翻译的,完成法语翻译。[gbastien]

1.5rc1 (2017-11-24)

  • 更新i18n、巴西葡萄牙语、德语和西班牙语翻译。[hvelarde, jensens]

  • 锁定文件现在更安全,并且更健壮。[jensens]

  • 重构记录器模块以提高可测试性。[jensens]

  • 在审计日志中添加搜索和分页功能(实现#17)。[jensens]

1.4b3 (2017-11-21)

  • 通过订阅IObjectAddedEvent修复生命周期记录器的对象位置(修复#66)。[jensens]

  • 如果未安装plone.app.iterate,则启动时不会失败(修复#64)。[jensens]

  • 审查并更新德语翻译。[jensens]

1.4b2 (2017-09-20)

  • 添加法语翻译。[gbastien]

1.4b1 (2017-06-26)

  • 修复从匿名用户记录活动时出现的AttributeError(修复#57)。[keul]

  • 添加对请求头HTTP_X_FORWARDED_FOR的支持,以记录真实客户端IP地址。[keul]

1.3b2 (2017-05-25)

  • 避免在注册升级步骤时出现可能的ConfigurationConflictError。[hvelarde]

1.3b1 (2017-05-25)

  • 添加对Cloudflare的请求头CF-Connecting-IP的支持,以记录真实客户端IP地址。[hvelarde]

  • 现在我们使用plone.api来获取用户的id,而不是在请求上的AUTHENTICATED_USER键。此外,我们现在使用getClientAddr()函数来获取远程IP地址。这些更改简化了测试。

  • 添加对记录工作流转换的支持。[hvelarde]

  • 修复在plonectl添加用户时出现的ComponentLookupError。[jianaijun]

1.2b1 (2016-09-28)

  • 使用zope-conf-additional选项配置日志轮换。请注意,现在默认情况下轮换是禁用的。[rene, hvelarde]

1.1b1 (2016-07-07)

  • 停止支持Plone 4.2。[hvelarde]

  • 记录组删除操作。如果您使用Plone < 4.3.8,您可能需要更新Products.PlonePASProducts.PluggableAuthService的版本。[fRiSi]

1.0b4 (2016-07-07)

  • 避免日志消息中的UnicodeEncodeError。[jianaijun, rodfersou]

  • 支持在指定时间间隔自动轮换审计日志文件;每天创建一个新文件,并维护最多30个备份文件(关闭#9)。[hvelarde]

  • 使用对象表示法记录生命周期事件;这修复了基于Archetypes的对象被输出到日志的问题(参考#8和修复#38)。[hvelarde]

  • 包现在与Plone 5.0和Plone 5.1兼容。[hvelarde]

1.0b3 (2016-04-19)

  • 添加简体中文翻译。[jianaijun]

  • 包不再在运行交互式控制台(bin/instance debug)时引发AttributeError(修复#30)。[hvelarde]

  • 清理审计日志消息。 [hvelarde]

  • 禁用审计日志视图中左右栏的渲染。 [hvelarde]

  • 审计日志条目现在以相反的顺序显示(最新条目首先)。 [hvelarde]

1.0b2 (2016-03-18)

  • 即使 Zope 的 event-log-level 在 INFO 以上,也要记录到 audit.log 文件中(修复了 #25)。 [fRiSi]

  • 添加德语翻译。 [fRiSi]

  • 修复审计日志视图的输出。 [pcdummy, hvelarde]

  • 添加巴西葡萄牙语和西班牙语翻译。 [hvelarde]

  • “查看审计日志”操作现在出现在“注销”之前(修复了 #18)。 [pcdummy, hvelarde]

  • 使用 main_template 进行审计日志视图。 [pcdummy]

  • 在运行第三方测试时避免 TypeError(修复了 #2)。 [hvelarde]

1.0b1 (2016-03-09)

  • 添加审计.log 文件的视图 @@fingerpointing-audit-log 并将其链接到 portal_actions。 [pcdummy, hvelarde]

  • 使控制面板配置组件对站点管理员角色可用(关闭 #15)。 [hvelarde]

  • 在删除 Plone 站点时避免 ComponentLookupError(修复了 #4)。 [hvelarde]

  • 删除未使用的 plone.directives.form 依赖,该依赖引入了 Grok 包。 [vangheem]

  • 现在将审计信息记录到名为 audit.log 的文件中,而不是标准 event.log 内。 [pcdummy]

  • 该包现在与 Plone 5 兼容。 [hvelarde]

  • 在包尚未安装时忽略由订阅者尝试访问不存在的注册记录引起的错误(修复了 #1)。 [hvelarde]

1.0a1 (2015-06-08)

  • 初始发布。

项目详情


下载文件

下载您平台上的文件。如果您不确定要选择哪个,请了解更多关于 安装包 的信息。

源代码分发包

collective.fingerpointing-1.8.3.tar.gz (88.1 kB 查看哈希)

上传于

构建分发

collective.fingerpointing-1.8.3-py2.py3-none-any.whl (67.9 kB 查看哈希值)

上传于 Python 2 Python 3

由以下支持