Sn.exe (средство строгих имен)

  • Статья

Программа строгих имен (Sn.exe) позволяет подписывать сборки строгими именами. Программа Sn.exe предусматривает параметры для управления ключами, создания подписи и ее проверки.

Предупреждение

Строгие имена не являются средством обеспечения безопасности. Они служат только для однозначной идентификации.

Дополнительные сведения о строгом именовании и сборках со строгими именами см. в разделах Сборки со строгими именами и Практическое руководство. Подписание сборки строгим именем.

Программа строгих имен автоматически устанавливается вместе с Visual Studio. Для запуска этого средства используйте Командную строку разработчика или PowerShell для разработчиков в Visual Studio.

Примечание

На 64-разрядных компьютерах можно запустить 32-разрядную версию программы Sn.exe через командную строку разработчика для Visual Studio и 64-разрядную версию через командную строку Visual Studio x64 Win64.

В командной строке введите следующее.

Синтаксис

sn [-quiet][option [parameter(s)]]

Параметры

Параметр Описание
-a identityKeyPairFile signaturePublicKeyFile Создает данные AssemblySignatureKeyAttribute для переноса из файла ключа удостоверения в ключ подписи.
-ac identityPublicKeyFile identityKeyPairContainer signaturePublicKeyFile Создает данные AssemblySignatureKeyAttribute для переноса из контейнера ключей ключа удостоверения в ключ подписи.
-c [csp] Задается поставщик служб шифрования (CSP), используемый по умолчанию для подписывания строгим именем. Этот параметр применяется к компьютеру в целом. Если имя поставщика служб шифрования не задано, программа Sn.exe удалит текущее значение.
-d container Удаляет указанный контейнер ключей из поставщика служб шифрования со строгими именами.
-D assembly1 assembly2 Проверяет, что две сборки отличаются только подписью. Данный подход часто используется как средство проверки после того, как сборка была повторно подписана с помощью другой пары ключей.
-e assembly outfile Извлекает открытый ключ из сборки assembly и записывает его в файл outfile.
-h Отображает синтаксис команд и параметров программы.
-i infile container Устанавливает в указанный контейнер ключей пару ключей из файла infile. Контейнер ключей располагается в поставщике служб шифрования со строгими именами.
-k [keysize] outfile Создает новый ключ RSACryptoServiceProvider указанного размера и записывает его в указанный файл. В файл записываются и открытый, и закрытый ключи.

Если размер ключа не задан, по умолчанию создается 1024-разрядный ключ при условии, что установлен усовершенствованный поставщик служб шифрования (Microsoft); в противном случае создается 512-разрядный ключ.

Параметр keysize поддерживает ключи длиной от 384 до 16 384 бит с приращениями по 8 бит, если установлен усовершенствованный поставщик служб шифрования (Майкрософт). Он поддерживает ключи длиной от 384 до 512 бит с приращениями по 8 бит, если установлен базовый поставщик служб шифрования (Microsoft).
-m [y or n] Задает зависимость контейнеров ключей от компьютера или пользователя. Если задано значение y, контейнеры ключей зависят от компьютера. Если задано значение n, контейнеры ключей зависят от пользователя.

Если не задан ни один из параметров, этот параметр отобразит текущее значение.
-o infile [outfile] Извлекает открытый ключ из файла infile и сохраняет его в CSV-файле. Байты открытого ключа разделяются запятыми. Этот формат удобно применять для жесткого задания в исходном коде ссылок на ключи в виде инициализированных массивов. Если параметр outfile не указан, выходные данные будут помещены в буфер обмена. Примечание: Этот параметр не проверяет, что входные данные являются только открытым ключом. Если infile содержит пару ключей, в том числе закрытый ключ, последний также извлекается.
-p infile outfile [hashalg] Извлекает открытый ключ из пары ключей в файле infile и сохраняет его в файле outfile, при необходимости используя алгоритм RSA, указанный в параметре hashalg. Полученный открытый ключ можно использовать для отложенной подписи сборки с помощью параметров /delaysign+ и /keyfileкомпоновщика сборок (Al.exe). Если применяется отложенная подпись сборки, во время компиляции задается только открытый ключ, а в файле выделяется место для подписи, которая будет добавлена позднее, когда станет известен закрытый ключ.
-pc container outfile [hashalg] Извлекает открытый ключ из пары ключей, хранящейся в параметре container, и записывает его в файл outfile. Если указан параметр hashalg, для извлечения открытого ключа используется алгоритм RSA.
-Pb [y or n] Указывает, применяется ли политика пропускания строгих имен. Если задан параметр y, строгие имена сборок с полным доверием не проверяются при загрузке в объект AppDomain с полным доверием. Если задан параметр n, проверяется правильность строгих имен, но не проверяется их соответствие конкретному строгому имени. Класс StrongNameIdentityPermission не применяется к сборкам с полным доверием. Проверку на соответствие строгих имен необходимо выполнять отдельно.

Если не задан ни один параметр y и n, отображается текущее значение. Значение по умолчанию — y. Примечание: На 64-разрядных компьютерах этот параметр необходимо задать в 32-разрядных и 64-разрядных экземплярах Sn.exe.
-q[uiet] Задает тихий режим и отключает отображение сообщений об успешно выполненных операциях.
-R[a] assembly infile Повторно подписывает ранее подписанную сборку или сборку с отложенной подписью с помощью пары ключей, содержащейся в файле infile.

Если указан параметр -Ra, для всех файлов в сборке заново вычисляются хэши.
-Rc[a] assembly container Повторно подписывает ранее подписанную сборку или сборку с отложенной подписью с помощью пары ключей, содержащихся в контейнере container.

Если указан параметр -Rca, для всех файлов в сборке заново вычисляются хэши.
-Rh assembly Повторно вычисляет хэши для всех файлов сборки.
-t[p] infile Отображает токен открытого ключа, который хранится в файле infile. Файл infile должен содержать открытый ключ, который был ранее создан из файла пары ключей с использованием параметра -p. Не используйте параметр -t[p] для непосредственного извлечения токена из файла пары ключей.

Программа Sn.exe вычисляет токен с помощью функции хэширования открытого ключа. В целях экономии места среда CLR сохраняет токены открытого ключа в манифесте как часть ссылки на другую сборку при записи зависимости от сборки со строгим именем. При указании параметра -tp наряду с токеном отображается открытый ключ. Если атрибут AssemblySignatureKeyAttribute был применен к сборке, токен предназначается для ключа удостоверения, и отображаются имя алгоритма хэширования и ключ удостоверения.

Следует иметь в виду, что данный параметр не проверяет подпись сборки, и его не следует использовать для принятия решений о доверии. Этот параметр лишь отображает необработанные данные токена открытого ключа.
-T[p] assembly Отображает маркер открытого ключа для сборки.Сборка должна быть именем файла, содержащего манифест сборки.

Программа Sn.exe вычисляет токен с помощью функции хэширования открытого ключа. В целях экономии места среда выполнения сохраняет токены открытого ключа в манифесте как часть ссылки на другую сборку при записи зависимости от сборки со строгим именем. При указании параметра -Tp наряду с токеном отображается открытый ключ. Если атрибут AssemblySignatureKeyAttribute был применен к сборке, токен предназначается для ключа удостоверения, и отображаются имя алгоритма хэширования и ключ удостоверения.

Следует иметь в виду, что данный параметр не проверяет подпись сборки, и его не следует использовать для принятия решений о доверии. Этот параметр лишь отображает необработанные данные токена открытого ключа.
-TS assembly infile Подписывает сборку (подписанную или частично подписанную) тестовой подписью с помощью пары ключей из файла infile.
-TSc assembly container Подписывает сборку (подписанную или частично подписанную) тестовой подписью с помощью пары ключей из контейнера ключей container.
-v assembly Проверяет строгое имя в сборке assembly, где assembly представляет собой имя файла, содержащего манифест сборки.
-vf assembly Проверяет строгое имя в сборке. В отличие от параметра -v , -vf принудительно выполняет проверку, даже если она отключена с помощью параметра -Vr .
-Vk regfile.reg assembly [userlist] [infile] Создает файл регистрационных записей (файл с расширением REG), который можно использовать для регистрации указанной сборки для пропуска проверки. Правила присвоения имен сборкам, которые применяются к параметру -Vr, также применяются к параметру -Vk. Дополнительные сведения о параметрах userlist и infile см. в описании параметра –Vr.
-Vl Отображает список текущих параметров проверки строгих имен на данном компьютере.
-Vr assembly [userlist] [infile] Регистрирует сборку assembly для пропуска проверки. При необходимости можно указать разделенный запятыми список имен пользователей, для которых проверка должна пропускаться. Если задан файл infile, проверка будет выполняться, но в ней будет использоваться открытый ключ, находящийся в файле infile. Сборку можно указать в формате *, strongname, чтобы зарегистрировать все сборки с указанным строгим именем. Для параметра strongname должна быть задана строка шестнадцатеричных цифр, представляющих открытый ключ в форме токена. Сведения об отображении токена открытого ключа см. в описании параметров -t и -T. Осторожностью: Используйте этот параметр только во время разработки. При добавлении сборки в список непроверяемых сборок создается уязвимость в системе безопасности. Вредоносная сборка может использовать полное имя сборки (имя сборки, версия, язык и региональные параметры, маркер открытого ключа), добавленное в список непроверяемых, с целью подделки ее идентификации. Данный подход позволяет вредоносной сборке также избежать проверки.
-Vu assembly Отменяет регистрацию сборки assembly для пропуска проверки. Правила присвоения имен сборкам, которые применяются для параметра -Vr, также применяются к параметру -Vu.
-Vx Удаляет все записи о пропуске проверки.
-? Отображает синтаксис команд и параметров программы.

Примечание

Все параметры программы Sn.exe зависят от регистра и должны вводиться в точном соответствии с инструкциями выше, чтобы программа их правильно распознала.

Примечания

Параметры -R и –Rc можно использовать для сборок с отложенной подписью. При этом во время компиляции задается только открытый ключ, а подпись выполняется позднее, когда становится известен закрытый ключ.

Примечание

Для параметров (например, -Vr) , которые осуществляют запись в защищенные ресурсы, такие как реестр, программу SN.exe следует запускать от имени администратора.

Средство строгих имен поддерживает пары открытого и закрытого ключей, созданные с помощью идентификатора алгоритма AT_SIGNATURE. При использовании пар открытого и закрытого ключей, созданных с помощью алгоритма AT_KEYEXCHANGE, возникает ошибка.

Примеры

Следующая команда создает новую пару случайных ключей, которая сохраняется в файле keyPair.snk.

sn -k keyPair.snk

Следующая команда сохраняет ключ из файла keyPair.snk в контейнере MyContainer поставщика служб шифрования со строгими именами.

sn -i keyPair.snk MyContainer

Следующая команда извлекает открытый ключ из файла keyPair.snk и сохраняет его в файле publicKey.snk.

sn -p keyPair.snk publicKey.snk

Следующая команда отображает открытый ключ и его токен, которые содержатся в файле publicKey.snk.

sn -tp publicKey.snk

Следующая команда проверяет сборку MyAsm.dll.

sn -v MyAsm.dll

Следующая команда удаляет MyContainer из поставщика служб шифрования со строгими именами, используемого по умолчанию.

sn -d MyContainer

См. также