共享与访问控制#

Graphistry 提供了强大的工具，用于安全地可视化和共享图数据。了解如何管理隐私设置并适当共享可视化对于协作工作和数据安全至关重要。本指南将帮助您了解如何使用 Graphistry API 控制隐私设置。更多示例，请参阅共享教程笔记本。

隐私设置概述#

您可以完全控制谁可以查看或编辑您的可视化。默认情况下，Graphistry 可视化是公开的但未列出的，这意味着您需要获得可视化的秘密 ID 才能知道它的位置，但不需要登录即可查看。您可以在使用plot()方法创建图表时调整隐私设置。

关键隐私级别包括：

私有: 只有你可以查看这个可视化。
组织 (`”org”`): 您组织中的任何人都可以查看可视化。
公开 (未列出): 任何拥有链接的人都可以查看可视化。Graphistry 不会公开可视化列表，因此这相当于许多平台中的未列出隐私模式。
自定义分享: 与个别用户分享（需要额外配置）。

与他人共享时，您还可以配置诸如查看者与编辑者等设置。

隐私入门：公开（未列出）#

在调整隐私设置之前，请确保您已在Graphistry注册：

import graphistry

graphistry.register(api=3, username='my_username', password='my_password')

默认情况下，您创建的任何图表都是公开的（未列出），这意味着其他人不会知道您的可视化，但如果您分享链接，他们可以在不登录的情况下查看。

创建私有可视化#

您可以通过调用graphistry.privacy()将可视化设置为更严格的模式：

graphistry.privacy()


# Sample data
edges = pd.DataFrame({
    'src': ['A', 'B', 'C'],
    'dst': ['B', 'C', 'A']
})

# Create a private plot
plot_url = graphistry.edges(edges, 'src', 'dst').plot(render=False)

print(f"Private visualization URL: {plot_url}")

如果您登录到个人账户，只有您可以访问此图表。如果您登录到一个组织，该可视化将仅对组织成员可见。当其他人获得URL时，他们将无法查看，直到您调整隐私设置。

使可视化公开#

使任何拥有链接的人都可以访问可视化：

graphistry.privacy(mode='public')

# Create a public plot
plot_url = graphistry.edges(edges, 'src', 'dst').plot(render=False)

print(f"Public visualization URL: {plot_url}")

此设置在与外部协作者共享或将可视化嵌入公共网站时非常有用。

控制编辑权限#

默认情况下，共享的可视化内容可以由同一组织的成员编辑。要允许其他人编辑或与可视化设置进行交互，或设置为只读，您可以重新配置策略：

VIEW = '10'
EDIT = '20'
graphistry.privacy(mode='organization', mode_action=EDIT)

# Allow others to edit the plot
plot_url = graphistry.edges(edges, 'src', 'dst').plot(render=False)

print(f"Editable visualization URL: {plot_url}")

理解隐私级别#

私有: 仅创建者可访问。
组织 (`”org”`): 您Graphistry组织内的所有用户均可访问。
公开: 未在任何公共索引中列出，但任何拥有链接的人都可以访问。请谨慎使用，因为这允许广泛的访问。
自定义: 与特定用户共享的高级配置。

数据隐私的最佳实践#

使用组织共享进行内部协作：将数据保持在您公司的控制之下。
限制公共分享：只有在数据非敏感且旨在广泛分发的情况下，才将可视化公开。
定期审查共享的可视化：定期检查哪些可视化是共享的，并根据需要调整隐私设置。
使用安全的方法分享链接：在分享URL时，使用安全渠道以防止未经授权的访问。

高级功能#

查看各个参数的文档和教程以获取更高级的使用模式：

邀请个别用户，包括可选的电子邮件通知，使用参数 invited_users 和 notify
使用嵌套的隐私设置 (g2 = g1.privacy())

附加资源#

有关更详细的示例和高级功能，请参阅官方文档或GitHub仓库中的Graphistry共享教程。

共享教程笔记本: https://github.com/graphistry/pygraphistry/blob/master/demos/more_examples/graphistry_features/sharing_tutorial.ipynb

本教程涵盖的主题包括：

创建自定义分享链接
在网页应用程序中嵌入可视化
使用访问令牌进行安全共享
高级隐私配置

结论#

在Graphistry中管理隐私和共享设置既简单又灵活。通过理解和利用这些功能，您可以在保持对数据控制的同时，安全地与他人协作。

记住要：

根据您的需求选择合适的隐私级别。
在公开可视化时要小心。
定期审核您共享的可视化内容。
使用 graphistry.privacy() 来了解您的数据处理情况。

共享与访问控制

目录