mcpField
I
infisical-user-setup-guide

infisical-user-setup-guide

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

关于 infisical-user-setup-guide

面向 Infisical 用户的交互式配置技能，帮助将密钥接入应用、容器、流水线和基础设施，并按平台与需求选择 CLI、SDK 或机器身份认证方案。

主要功能

  1. 01按平台提供集成指导
  2. 02本地开发 CLI 配置
  3. 03Docker 和 CI/CD 集成
  4. 04Kubernetes Operator 指导
  5. 05通过 SDK 获取密钥
  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-user-setup-guide

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

包含的文件

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

references/
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 都会出现在 两者中，但它们是互不相关的配置。

如何使用本技能

首先了解用户想要做什么：

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

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

参考文件

文件何时阅读
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