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

code-signing — правило для Claude Code: установка и суть

Правило code-signing задаёт стандарты подписи сборок и пакетов NuGet через SignClient в проектах на .NET. Применяется при настройке CI/CD.

Apache-2.0 ★ 138 обновлён 2025-03-29

Установить в Cursor · Вручную: положить файлы Все способы и платформы ↓
.cursor/rules/code-signing.mdc
Открыть на GitHub

Что делает code-signing

Правило инструктирует ассистента по настройке SignClient для .NET. Оно активируется при наличии файлов signsettings.json, appsettings.json с секцией SignClient или пакетов *.nupkg.

Внутри собраны шаблоны интеграции для GitHub Actions и Azure DevOps, структура конфигурации Azure Active Directory и правила изоляции секретов. Секреты запрещено сохранять в репозитории: инструкция предписывает брать их из переменных пайплайна.

Без установленной глобальной утилиты dotnet tool install --global SignClient запуск шагов подписи в CI завершится ошибкой.

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

  • настроить пайплайн GitHub Actions для подписи пакетов NuGet
  • сконфигурировать подключение SignClient к Azure AD
  • организовать проверку цифровой подписи перед релизом
  • добавить шаг подписи артефактов в Azure DevOps

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

  • Настрой шаг подписи nupkg через SignClient для нашего GitHub Actions workflow
  • Проверь конфигурацию в signsettings.json и перенеси секреты в переменные окружения
  • Добавь этап валидации цифровой подписи артефактов в Azure DevOps

Как установить code-signing

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

.cursor/rules/code-signing.mdc

Во frontmatter: description, globs, alwaysApply

По шагам, с командами для каждой платформы: Cursor rules: файлы .mdc, четыре режима и замена .cursorrules

Вопросы о code-signing

Как установить code-signing в Claude Code?

Сохраните правило в файл .claude/rules/code-signing.md. Для редактора Cursor используйте путь .cursor/rules/code-signing.mdc.

Когда срабатывает правило code-signing?

Оно ориентируется на маски **/signsettings.json, **/appsettings.json и **/*.nupkg. Логика применяется, если в проекте найден файл signsettings.json или блок SignClient внутри appsettings.json.

Что требует правило для запуска в CI/CD?

В сборочном скрипте требуется установка консольного инструмента SignClient и передача секрета SIGN_CLIENT_SECRET через защищённые переменные окружения.

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

code-signing.mdc · Apache-2.0
---
description: Rules and best practices for .NET code signing
globs: **/signsettings.json,**/appsettings.json,**/*.nupkg
alwaysApply: false
---

# .NET Code Signing Rules and Best Practices

## Prerequisites
These rules only apply when one of the following exists:
- `signsettings.json`
- `appsettings.json` with a `SignClient` section

## Code Signing Configuration

### SignClient Configuration
```json
{
  "SignClient": {
    "AzureAd": {
      "AADInstance": "https://login.microsoftonline.com/",
      "ClientId": "[configured in CI]",
      "TenantId": "[configured in CI]"
    },
    "Service": {
      "Url": "https://signing-service.example.com/",
      "ResourceId": "[configured in CI]"
    }
  }
}
```

## Security Best Practices
1. Never commit signing credentials to source control
2. Store signing credentials in CI/CD secret variables
3. Use environment-specific signing configurations
4. Implement proper credential rotation
5. Log signing operations for audit purposes

## CI/CD Integration

### GitHub Actions Example
```yaml
jobs:
  sign:
    runs-on: ubuntu-latest
    steps:
    - uses: actions/checkout@v4
    
    - name: Install SignClient
      run: dotnet tool install --global SignClient
    
    - name: Sign NuGet Packages
      run: |
        SignClient sign `
          --config signsettings.json `
          --input "**/*.nupkg" `
          --secret "${{ secrets.SIGN_CLIENT_SECRET }}" `
          --name "MyProject" `
          --description "Official release package"
```

### Azure DevOps Example
```yaml
steps:
- task: UseDotNet@2
  inputs:
    useGlobalJson: true

- script: dotnet tool install --global SignClient
  displayName: 'Install SignClient'

- powershell: |
    SignClient sign `
      --config signsettings.json `
      --input "$(Build.ArtifactStagingDirectory)/*.nupkg" `
      --secret "$(SignClientSecret)" `
      --name "$(Build.DefinitionName)" `
      --description "Official release package"
  displayName: 'Sign Packages'
  env:
    SignClientSecret: $(SignClientSecret)
```

## Verification
1. Implement post-signing verification
2. Check signature validity before publishing
3. Include signature verification in test pipeline
4. Document signature verification process

## Package Publishing
1. Only publish signed packages for releases
2. Implement signature verification before publishing
3. Maintain signed package archive
4. Document package signature in release notes

## Troubleshooting
1. Common signing errors and solutions
2. Credential validation steps
3. Service connectivity issues
4. Certificate expiration handling

## Maintenance
1. Regular credential rotation schedule
2. Certificate expiration monitoring
3. Signing service health checks
4. Audit log review process 

© Aaronontheweb · Apache-2.0 · Aaronontheweb/dotnet-cursor-rules

Похожие правила IDE

Все правила IDE по теме «Безопасность» →
ci-cd codewithmukesh Создаёт YAML-пайплайны CI/CD для .NET-проектов. Настраивает GitHub Actions и Azure DevOps со сборкой, тестами и публикацией. CX Codex +1 4 000установок nuget-trusted-publishing dotnet Скилл nuget-trusted-publishing настраивает публикацию пакетов в nuget.org через GitHub Actions и OIDC без постоянных API-ключей. Пригодится при переводе сборки на NuGet/login или создании нового пайплайна. CX Codex +1 4 400установок playwright-ci-caching Aaronontheweb Скилл playwright-ci-caching настраивает кэширование браузеров Playwright в GitHub Actions и Azure DevOps. Устраняет лишнюю загрузку ~400MB бинарников и сокращает сборку на 1-2 минуты в .NET-проектах. CX Codex +1 465установок tendril-release Ivy-Interactive Скилл tendril-release автоматизирует подготовку и публикацию релизов Ivy Tendril. Обновляет пакеты NuGet, собирает проект, делает PR в ветку main и запускает workflow в GitHub Actions. CX Codex +1 ★ 203звёзд репо msbuild-modernization dotnet Скилл msbuild-modernization для Claude Code переводит старые файлы проектов MSBuild в формат SDK-style. Он включается при миграции .csproj и .vbproj, в том числе при переходе с packages.config на PackageReference. CX Codex +1 4 800установок outdated codewithmukesh Скилл outdated собирает отчёт о здоровье зависимостей .NET: устаревшие NuGet-пакеты, уязвимые версии и ловушки с коммерческими лицензиями. CX Codex +1 3 900установок

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

Весь набор →
meta Правило meta задаёт, как менять файлы .mdc в репозитории: сохранять форматирование и обновлять существующие правила, а не плодить новые без причины. CX Codex +1 ★ 138звёзд репо publishing-dotnettool Правило publishing-dotnettool для Claude Code и Cursor направляет ИИ-агента при создании и публикации dotnet-инструментов в NuGet. Гарантирует семантическое версионирование, правильную упаковку и совместимость с разными версиями .NET. CX Codex +1 ★ 138звёзд репо consuming-dotnettool Правило consuming-dotnettool для Claude Code организует локальные .NET-инструменты через manifest-файл, фиксирует версии и добавляет их восстановление в CI/CD. CX Codex +1 ★ 138звёзд репо dependency-management Правило dependency-management для безопасного управления NuGet-зависимостями: проверка уязвимостей, совместимость лицензий, версионирование через dotnet CLI. Применяется к файлам проекта автоматически. CX Codex +1 ★ 138звёзд репо solution-management Правило solution-management задаёт стандарты организации решений .NET: фиксирует версии SDK, общие свойства сборки и централизованное управление NuGet-пакетами. CX Codex +1 ★ 138звёзд репо benchmarking Правило benchmarking для Claude Code учит агента писать корректные тесты производительности .NET через BenchmarkDotNet. Тесты измеряют скорость кода и отслеживают регрессии. CX Codex +1 ★ 138звёзд репо nuget-package-publishing Правило nuget-package-publishing, которое учит агента упаковывать .NET-библиотеки в NuGet по стандартам: с SPDX-лицензией, README и символами для отладки. CX Codex +1 ★ 138звёзд репо testing Правило testing задаёт стандарты написания тестов на C# с xUnit: настройку .NET 8 проектов, фикстуры, проверку покрытия кода и запуск интеграционных тестов. CX Codex +1 ★ 138звёзд репо

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

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