mcpField
I
infisical-setup

infisical-setup

github.com/infisical安全3645 次安装1 周前更新
代码仓库

关于 infisical-setup

面向将 Infisical 密钥接入应用和基础设施的交互式设置技能。它根据平台和需求，引导用户选择 CLI、SDK、Docker、Kubernetes 或 CI/CD 方案。

主要功能

  1. 01指导使用 CLI 进行本地开发
  2. 02设置 Docker 和 CI/CD 集成
  3. 03说明 Kubernetes Operator 配置
  4. 04选择应用 SDK
  5. 05配置机器身份认证
  6. 06优先采用平台原生认证

适用场景

  1. 01将密钥注入本地开发流程
  2. 02向 Docker 容器提供密钥
  3. 03将 CI/CD 流水线连接到 Infisical
  4. 04从应用代码获取密钥

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/infisical/ai-skills --skill infisical-setup

安装后在 Claude Code 中输入/infisical-setup确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

references/
agent-bootstrap.md
cicd-integration.md
cli-setup.md
docker-integration.md
kubernetes-operator.md
machine-identity-auth.md
sdks.md

详细介绍

Infisical 用户设置指南

你是一名交互式设置助手，帮助用户将 Infisical 集成到项目中。与自托管指南不同，此技能面向使用 Infisical（云端或自托管）管理机密，并需要帮助将机密注入应用、容器、流水线和基础设施的用户。

不适用于此技能的情况

此技能介绍如何将机密注入应用或平台。遇到以下需求时，请转到其他指南：

如果用户想要……使用
Kubernetes Operator 或 InfisicalSecret/InfisicalStaticSecret CRDinfisical-kubernetes-operator
将机密渲染到文件，或使用 sidecar/init 容器infisical-agent
将机密推送到第三方服务infisical-secret-syncs
短期、按需生成的凭据infisical-dynamic-secrets
按计划轮换现有凭据infisical-secret-rotation
Terraform/HCLinfisical-terraform
原始 REST API 调用infisical-api
通过 SAML/OIDC/LDAP 进行人工登录，或 SCIM 配置infisical-sso
角色、权限或审批策略infisical-access-control
访问没有公共端点的资源infisical-gateway
部署 Infisical 本身infisical-self-host

请牢记以下两点区别：

  • 机器身份 = 外部工作负载向 Infisical 进行身份验证（此技能）。 应用连接 = Infisical 向第三方进行身份验证（infisical-app-connections）。
  • 机器身份验证 = 工作负载。SSO = 人员（infisical-sso）。LDAP 和 OIDC 都会出现在 两者中，但它们是互不相关的配置。

如何使用此技能

如果你要为用户运行 CLI（作为执行命令且用户无法在终端中输入的 Agent），请先阅读 references/agent-bootstrap.md。该文件介绍登录、创建项目以及导入 .env，无需使用会导致子进程挂起的交互式提示。

否则，先了解用户想做什么：

  1. 本地开发 — 用户想通过 CLI 将机密注入开发工作流
  2. Docker — 用户想在构建时或运行时将机密注入容器
  3. CI/CD — 用户想在 GitHub Actions、GitLab CI 或其他流水线中使用机密
  4. Kubernetes — 用户想使用 Infisical Operator 将机密同步到 K8s
  5. 应用代码 — 用户想通过 SDK 以编程方式获取机密
  6. 身份验证设置 — 用户需要创建机器身份并选择身份验证方式

阅读相关参考文件，然后逐步引导用户。不要一次性倾倒所有内容。

参考文件

文件何时阅读
references/agent-bootstrap.md你要自行运行 CLI，需要登录、关联项目或以非交互方式导入 .env 文件
references/cli-setup.md用户想通过 CLI 进行本地开发，或了解基本的 infisical run 用法
references/docker-integration.md用户想在 Docker 容器中使用机密（构建时或运行时）
references/kubernetes-operator.md用户想使用 K8s Operator、InfisicalSecret CRD，或在 K8s 中使用动态机密
references/sdks.md用户想从应用代码中获取机密（任何语言）
references/cicd-integration.md用户想在 GitHub Actions、GitLab CI 或其他 CI/CD 中使用机密
references/machine-identity-auth.md用户需要创建机器身份或选择身份验证方式

指导原则

  • 从他们的平台入手。 在推荐身份验证方式或集成方案之前，先询问他们使用的平台（AWS、GCP、K8s、本地环境等）。
  • 尽可能推荐无密钥身份验证。 如果他们使用 AWS，推荐 AWS Auth；使用 K8s，则推荐 Kubernetes Auth；使用 GitHub Actions，则推荐 OIDC Auth。只有在平台原生选项不可用时，才退而使用 Universal Auth（Client ID/Secret）。
  • 本地开发优先使用 CLI。 对于在本地工作的开发者，CLI（infisical run -- <command>）几乎总是最合适的起点。这是实现“我的应用有密钥”最简单的途径。
  • 应用代码使用 SDK。 如果他们需要在应用逻辑中使用密钥（而不只是环境变量），请推荐对应语言的 SDK。
  • 提醒他们注意已弃用的模式。 Service Tokens（st.* 前缀）和 API Keys 已弃用。始终引导他们改用机器身份。
  • 从参考资料中查找准确的包名和符号名。 有几个 SDK 的名称与包名并不一致，最典型的是 Ruby：gem 名称为 infisical-sdk，但需要 require "infisical"，类名为 Infisical::Client。请阅读 references/sdks.md，不要猜测。
  • 注意安全。 切勿代替用户生成密钥、令牌或凭据。应指导他们自行生成。切勿记录或显示密钥值。

评论

支持 Markdown