openziti/ziti-sdk-py

 # OpenZiti 的 Python SDK

入门指南 • 示例 • 支持 • 贡献 • 许可证

[OpenZiti](https://github.com/openziti/ziti) 的 Python SDK 是一个库，使您能够将零信任网络连接性集成到您的 Python 应用程序中，并通过 OpenZiti 网络与远程网络资源建立安全连接。该 SDK 还简化了在您的 Python 应用程序中内置安全、零信任网络连接的过程。它非常简单，只需两行代码即可完成！ OpenZiti 是一个开源项目，为在任何平台上运行的应用程序提供安全、零信任的网络连接。 更具体地说，该 SDK 允许您在应用程序级别集成零信任。这意味着您的数据永远不会暴露在应用程序环境之外，从而为您提供端到端加密以实现极致的安全性。请参阅[此处](https://netfoundry.io/docs/openziti/learn/core-concepts/zero-trust-models/overview/)了解其他零信任模型。

## 入门指南 请查看[入门指南](https://netfoundry.io/docs/openziti/get-started/)以了解如何部署您自己的 overlay 网络。 或者，您可以免费试用 [CloudZiti](https://netfoundry.io/pricing/)， 在[此处](https://netfoundry.io/docs/openziti/)查看更多详细信息。 ### 安装 SDK OpenZiti 的 Python SDK 通过 Python Package Index (PyPI) 分发，可以使用 [`pip`](https://pypi.org/project/openziti/) 包管理器进行安装。 ``` pip install openziti ``` ### 使用 Ziti Python SDK 只需两行代码，您就可以将普通的 Web 服务器转变为安全、零信任的嵌入式应用程序。 以下示例展示了入门有多么简单。 为您的应用程序提供一个主机名和端口，进行一个简单的 monkey patch，您就可以开始了。您甚至不需要知道什么是 monkey patch！但是，如果您对 monkey patch 是什么感兴趣，请展开下面的区块。

什么是 Monkey Patching？

``` cfg = dict(ztx=openziti.load('/path/to/identity.json'), service="name-of-ziti-service") openziti.monkeypatch(bindings={('127.0.0.1', 8000): cfg}) ``` 或者尝试使用我们的装饰器模式和函数注解 ``` @openziti.zitify(bindings={('127.0.0.1', 18080): {'ztx': '/path/to/identity.json', 'service': 'name-of-ziti-service'}}) def yourFunction(): ``` `binding` 字典配置了当代码尝试打开服务器 socket 时会发生什么。标准网络地址会被映射到 ziti 服务配置。例如，使用此配置 ``` bindings = { ('0.0.0.0', 8080): { 'ztx': 'my-identity.json', 'service':'my-service' } } ``` 当应用程序打开一个服务器 socket 并绑定到地址 `0.0.0.0:8080` 时，它实际上会绑定到名为 `my-service` 的 ziti 服务。 绑定地址可以使用元组、字符串或整数（端口）来指定。`('0.0.0.0', 8080)`、`'0.0.0.0:8080'`、`':8080'` 和 `8080` 都会被视为相同并进行处理。 ## 示例 通过我们的某个[示例](sample%2FREADME.md)亲自尝试一下吧 * [Flazk](sample/flask-of-ziti) * [Echo Server](sample/ziti-echo-server) * [HTTP Server](sample/ziti-http-server) * [Ziti Requests](sample/ziti-requests) * [Ziti Socket](sample/ziti-socket) * [Ziti urllib3](sample/ziti-urllib3) * [S3 Log Uploader (boto3)](sample/s3z) ## 支持 ### 寻求帮助？ 请使用这些社区资源来获取帮助。我们使用 GitHub [issues](https://github.com/openziti/ziti-sdk-py/issues) 来跟踪 bug 和功能请求，但处理这些问题的精力有限。 - 阅读[官方文档](https://netfoundry.io/docs/openziti/learn/introduction/) - 加入我们的[开发者社区](https://openziti.org) - 在 [Discourse](https://openziti.discourse.group/) 上参与讨论 ## 贡献 您想亲自动手并帮助改进 OpenZiti 吗？通过 bug 报告、bug 修复、文档等方式为 OpenZiti 开源项目做出贡献。在[此处](https://netfoundry.io/docs/openziti/policies/CONTRIBUTING.html)查看我们关于为项目做贡献的指南。 ## 许可证 [Apache 2.0](./LICENSE)

标签：OpenZiti, Python SDK, 端到端加密, 网络库, 逆向工具, 零信任网络