通过Umbrella API集成安全和自动化工作流程

下载选项

  • PDF     (400.2 KB)
    在各种设备上使用 Adobe Reader 查看
  • ePub     (147.1 KB)
    在 iPhone、iPad、Android、Sony Reader 或 Windows Phone 上使用各种应用查看
  • Mobi (Kindle)     (123.2 KB)
    在 Kindle 设备上查看或在多个设备上使用 Kindle 应用查看
已更新: 2025 年 9 月 3 日
文档 ID:224766

非歧视性语言

此产品的文档集力求使用非歧视性语言。在本文档集中，非歧视性语言是指不隐含针对年龄、残障、性别、种族身份、族群身份、性取向、社会经济地位和交叉性的歧视的语言。由于产品软件的用户界面中使用的硬编码语言、基于 RFP 文档使用的语言或引用的第三方产品使用的语言，文档中可能无法确保完全使用非歧视性语言。 深入了解思科如何使用包容性语言。

关于此翻译

思科采用人工翻译与机器翻译相结合的方式将此文档翻译成不同语言，希望全球的用户都能通过各自的语言得到支持性的内容。 请注意：即使是最好的机器翻译，其准确度也不及专业翻译人员的水平。 Cisco Systems, Inc. 对于翻译的准确性不承担任何责任，并建议您总是参考英文原始文档（已提供链接）。

    简介

    本文档介绍Umbrella API平台的功能、配置选项和可用资源。

    Umbrella API概述

    Umbrella API平台为构建、扩展和与Umbrella集成提供安全环境。使用API创建跨平台工作流程，将威胁情报与其他安全解决方案聚合起来，以扩展实施、提高可视性并自动进行事件响应。

    API终端和管理

    • 所有Umbrella API终端均托管在api.umbrella.com。
    • 终端按使用案例分组,每个使用特定路径。
    • 在Admin > API keys下的Umbrella控制面板中管理API密钥，或者使用KeyAdmin API以编程方式管理API密钥。

    API使用案例和终端组

    使用按以下主要使用案例分组的粒度范围配置每个API密钥：

    • 管理API终端:调配和管理API密钥和用户，查看角色，以及管理提供商和托管提供商的客户。
    • 身份验证API终端：授权Umbrella和其他服务之间的集成。
    • 部署API终端:调配、监控和管理网络和实体，通过在现有Umbrella策略中配置网络和实体来保护它们。
    • 策略API终端:调配和管理目标列表和每个列表的目标。
    • 调查API终端:研究Umbrella解析器观察到的域、IP地址和URL。
    • 报告API终端:读取和审核有关部署的实时安全信息。应用发现API提供对基于云的应用的见解。

    API密钥访问和到期

    • 根据目标用途，将每个范围的访问级别设置为“读/写”或“只读”。
    • 根据需要将API密钥配置为在预定义的日期过期。
      1514339216091615143392160916

    身份验证和令牌生命周期

    • API凭证生成有效期为60分钟的访问令牌。
    • 身份验证过程使用OAuth 2.0客户端凭证流。
    • 在多组织或服务提供商环境中，父组织API凭证可以在授权期间为指定的子组织生成具有相同作用域的访问令牌。

    文档和资源

    • 访问综合说明和使用案例文档。
    • 每个API使用案例均记录在API参考中。
    • 所有端点和参数都列在OpenAPI规范中，并链接在每个使用案例概述的底部。
    • 如果您使用传统Umbrella API，请查看API迁移指南。
    • 使用Postman Collection for the Umbrella API进行初始测试。
    • 在Cisco developer页面的Cloud Security（云安全）部分了解其他资源、学习实验和API测试沙盒。

    支持

    有关Umbrella API的问题或其他帮助，请联系Umbrella支持部门。

    修订历史记录

    版本 发布日期 备注
    1.0
    04-Sep-2025
    初始版本
    TAC Authored

    由思科工程师提供

    此文档是否有帮助?

    Feedback反馈

    联系我们

    本文档适用于以下产品