К основному содержанию
скилл CX Codex

infisical-kms — скилл для Claude Code: шифрование без ключа

Скилл объясняет агенту, как шифровать, подписывать и считать HMAC ключами Infisical KMS, которые не покидают платформу.

MIT 238 установок ★ 41 обновлён 2026-10-19

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add Infisical/ai-skills --skill infisical-kms -a claude-code
Открыть на GitHub

Что делает infisical-kms

Скилл ведёт агента по работе с Infisical KMS. Сначала проверить, что это операция с ключом, а не хранение секрета. Потом выбрать keyUsage (encrypt-decrypt, sign-verify или generate-verify-mac), алгоритм, экспортируемость и корень доверия, и только затем вызвать эндпоинты API.

Внутри SKILL.md и два справочника: references/keys-and-operations.md про создание ключей, алгоритмы, шифрование, подпись и ротацию, references/external-kms-and-kmip.md про AWS KMS, GCP KMS, KMIP, шифрование Kubernetes at-rest и Sigstore cosign. Значения алгоритмов в подсистемах записаны по-разному: у симметричных нижний регистр и дефисы (aes-256-gcm), у асимметричных и подписи UPPER_SNAKE (ECC_NIST_P256), у постквантовых ML_DSA_65, а в PKI то же самое через дефис. Переносить значение из infisical-pki нельзя.

Открытый текст и шифртекст ходят по сети в base64 в обе стороны. Операции — сетевые вызовы с лимитом на размер, поэтому крупные данные шифруют локально ключом данных, а в KMS заворачивают только его. Ротация добавляет новую версию ключа для новых вызовов; старый шифртекст остаётся на прежней. Флаг isExportable ослабляет главную гарантию — ключ можно вынуть.

Какие задачи решает

  • зашифровать поле в базе ключом, которого нет в приложении
  • подписать payload и проверить подпись на другом сервисе
  • посчитать HMAC для проверки целостности сообщения
  • обернуть крупные данные через envelope encryption, не гоняя их в KMS
  • подключить AWS KMS, GCP KMS или KMIP как корень доверия

Примеры запросов агенту

  • Зашифруй значение поля card_number ключом с keyUsage encrypt-decrypt и верни результат в base64.
  • Подпиши payload ключом sign-verify с алгоритмом RSASSA_PSS_SHA_256 и покажи запрос к API.
  • Сделай envelope encryption: ключ данных генерируется локально, KMS заворачивает только его.

Как установить infisical-kms

1Через Skills CLI (Vercel)

npx skills add Infisical/ai-skills --skill infisical-kms -a claude-code

2Вручную: положить файлы

~/.claude/skills/infisical-kms/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/infisical-kms/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы об infisical-kms

Как установить infisical-kms в Claude Code?

Выполните npx skills add Infisical/ai-skills --skill infisical-kms -a claude-code. Скилл появится в ~/.claude/skills/infisical-kms/SKILL.md.

Что делает infisical-kms?

Проводит агента по шагам работы с Infisical KMS: тип ключа, алгоритм, экспортируемость, корень доверия и вызовы encrypt, decrypt, sign, verify, generate-mac.

Чем KMS-ключ отличается от секрета в Infisical?

Секрет Infisical хранит и отдаёт по запросу. Ключ KMS остаётся на платформе: вы отправляете данные или хеш и получаете результат, а материал ключа не возвращается.

Исходный текст

SKILL.md · MIT
---
name: infisical-kms
description: "Guide for Infisical KMS — managing cryptographic keys and performing encrypt/decrypt, sign/verify, and HMAC operations without the key ever leaving the platform. Covers KMS key creation with the three key usages (encrypt-decrypt, sign-verify, generate-verify-mac), symmetric algorithms (aes-256-gcm, aes-128-gcm), asymmetric algorithms (RSA_4096, ECC_NIST_P256/P384/P521, post-quantum ML_DSA_44/65/87), signing algorithms (RSASSA_PSS, RSASSA_PKCS1_V1_5, ECDSA, ML-DSA), HMAC algorithms, key rotation, exportable keys, external KMS backing with AWS KMS or GCP KMS, KMIP server integration, Kubernetes encryption-at-rest, and Sigstore cosign signing. Use this skill when someone asks about: Infisical KMS, encrypting data with a managed key, envelope encryption, sign and verify with Infisical, HMAC, KMIP, external KMS, or 'how do I encrypt data without handling the key'. For doing cryptography with a key Infisical never releases. Not for storing a value and reading it back, which is a secret (infisical-setup), nor for X.509 certificates (infisical-pki)."
---
# Infisical KMS Guide

You are a setup assistant helping users perform cryptographic operations with keys managed by
Infisical KMS.

The defining property: **keys are not extractable from the platform** (unless explicitly created
exportable), and **data is never stored** when performing cryptographic operations. You send
plaintext or ciphertext, you get the result back, nothing is retained.

## Not this skill

The distinction is what you are protecting:

| If the user wants... | Use |
|----------------------|-----|
| To **store** a value and read it back later | `infisical-api` / `infisical-setup` — that is a secret, not a key |
| To **encrypt data** with a key they never hold | **this skill** |
| An X.509 certificate for TLS | `infisical-pki` |
| To sign **software artifacts** with an audit trail and approvals | `infisical-pki` — Code Signing |
| A short-lived database credential | `infisical-dynamic-secrets` |
| To rotate an existing third-party credential | `infisical-secret-rotation` |

The most common confusion is secrets versus keys. A **secret** is a value Infisical stores and
hands back on request. A **KMS key** is a key Infisical holds and *never* hands back — you send it
work instead. If a user says "I want to store an encryption key in Infisical," ask which they mean:
storing the key material as a secret, or having Infisical manage the key and do the crypto.

Code signing also lives in `infisical-pki`, not here, even though it is a signing operation.
Use this skill for signing arbitrary payloads; use PKI Code Signing for signing build artifacts.

## Key usages

Every KMS key has exactly one `keyUsage`, fixed at creation:

| `keyUsage` | For | Operations |
|-----------|-----|-----------|
| `encrypt-decrypt` | Protecting data | encrypt, decrypt |
| `sign-verify` | Proving authenticity | sign, verify |
| `generate-verify-mac` | Message integrity with a shared key | generate-mac, verify-mac |

You cannot sign with an `encrypt-decrypt` key or encrypt with a `sign-verify` key. Pick the usage
from what the user actually needs before choosing an algorithm.

## How to use this skill

1. **Decide it is really a key operation**, not secret storage
2. **Choose the `keyUsage`**
3. **Choose the algorithm** — see the reference for exact values
4. **Decide on exportability** — this is irreversible in effect and worth a deliberate answer
5. **Decide where the root of trust lives** — Infisical's own KMS, an external AWS/GCP KMS, or an HSM
6. **Call the operation endpoints**

## Reference files

| File | When to read |
|------|-------------|
| `references/keys-and-operations.md` | Creating keys, all algorithm values, every API endpoint, encrypt/decrypt/sign/verify/MAC, rotation, import/export |
| `references/external-kms-and-kmip.md` | Backing Infisical with AWS KMS or GCP KMS, HSM root keys, KMIP servers, Kubernetes encryption-at-rest, Sigstore cosign |

## Guiding principles

- **Base64 everything.** Plaintext and ciphertext are base64-encoded on the wire in both directions. Forgetting this is the single most common integration bug.
- **Algorithm values are literal and inconsistent between subsystems.** KMS symmetric algorithms are lowercase-hyphenated (`aes-256-gcm`); KMS asymmetric and signing algorithms are UPPER_SNAKE (`ECC_NIST_P256`, `RSASSA_PSS_SHA_256`); KMS post-quantum uses underscores (`ML_DSA_65`) while **PKI** uses hyphens (`ML-DSA-65`). Do not carry a value across from `infisical-pki`.
- **Encrypt data keys, not bulk data.** KMS operations are network calls with size limits. For large payloads use envelope encryption: generate a data key locally, encrypt the payload with it, and use KMS only to wrap the data key.
- **Keys are non-extractable by default, and that is the point.** Only set `isExportable` when there is a concrete requirement, and say plainly that it weakens the guarantee.
- **Rotation does not re-encrypt existing ciphertext.** Rotating a key adds a new version for new operations; old ciphertext stays decryptable with the old version. Do not imply rotation re-protects existing data.
- **Never print key material or plaintext** beyond obvious placeholders.

© Infisical · MIT · Infisical/ai-skills

Похожие скиллы

Все скиллы по теме «Безопасность» →
sops-encryption devops-skills Скилл sops-encryption для Claude Code учит агента шифровать конфиги и секреты Kubernetes через Mozilla SOPS с ключами AWS KMS, GCP KMS или PGP. Секреты хранятся в Git зашифрованными. CX Codex +1 442установок aws-sdk-java-v2-kms giuseppe-trisciuoglio Скилл aws-sdk-java-v2-kms для Claude Code помогает писать код для AWS KMS через AWS SDK for Java 2.x. Он включается при работе с ключами, шифрованием, подписями и интеграцией со Spring Boot. CX Codex +1 3 900установок alibabacloud-kms-secret-manage aliyun Скилл alibabacloud-kms-secret-manage помогает управлять секретами в Alibaba Cloud KMS через Aliyun CLI: создание, чтение версий, обновление и безопасное удаление. CX Codex +1 225установок aws-cloudformation-security Giuseppe Trisciuoglio Скилл aws-cloudformation-security для Claude Code собирает шаблоны CloudFormation для защиты инфраструктуры: KMS, Secrets Manager с ротацией, IAM, VPC и ACM. К каждому блоку есть команда проверки через AWS CLI. CX Codex +1 ★ 372звёзд репо creating-secrets-using-best-practices aws Скилл creating-secrets-using-best-practices для Claude Code и других агентов: ведёт по созданию секрета в AWS Secrets Manager — отдельный ключ KMS, узкие права IAM, ротация и аудит. Закрывает задачу выпуска секрета в прод. CX Codex +1 7 600установок timestream-influxdb aws Скилл timestream-influxdb для Claude Code даёт инструкции по развёртыванию и настройке Amazon Timestream for InfluxDB. Подключается при запросах по версиям V2, V3, IAM, шифрованию и схемам данных. CX Codex +1 5 100установок

Из того же набора17

Весь набор →
infisical-access-control Скилл infisical-access-control для Claude Code помогает разбираться в управлении доступом Infisical: ролях, правах на секреты, временном доступе, согласованиях и аудит-логах. CX Codex +1 267установок infisical-app-connections Скилл infisical-app-connections объясняет, как связать Infisical с внешним сервисом через App Connection и какой метод авторизации брать для AWS, GCP, Azure или GitHub. CX Codex +1 257установок infisical-secret-rotation Скилл infisical-secret-rotation помогает настроить регулярную смену существующих паролей и ключей в Infisical с записью новых значений в хранилище. CX Codex +1 255установок infisical-secret-scanning Скилл infisical-secret-scanning помогает найти утёкшие ключи в репозитории и поставить проверку до пуша: облачные источники, infisical scan, pre-commit хук. CX Codex +1 254установок infisical-pam Настраивает доступ людей и ИИ-агентов к серверам и базам через Infisical PAM без передачи паролей наружу. CX Codex +1 238установок infisical-gateway Помогает настроить Infisical Gateway и Relay, чтобы получать доступ к внутренним базам, каталогам и API без публичного адреса. CX Codex +1 238установок infisical-sso Скилл infisical-sso помогает подключить Infisical к системе управления идентичностью (Google, GitHub, Okta, Azure AD, SAML, OIDC или LDAP) — чтобы люди логинились через неё и автоматически создавались учётные записи. CX Codex +1 237установок infisical-pki Скилл infisical-pki помогает развернуть инфраструктуру PKI в Infisical: настроить центры сертификации, выпуск X.509, автопродление и синхронизацию с облачными хранилищами. CX Codex +1 235установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой