Freigeben über


Sn.exe (Strong Name-Tool)

Aktualisiert: April 2011

Das Strong Name-Tool (Sn.exe) erleichtert das Signieren von Assemblys mit starken Namen. Sn.exe stellt Optionen zum Verwalten von Schlüsseln, Erzeugen und Überprüfen von Signaturen bereit.

HinweisHinweis

Führen Sie auf 64-Bit-Computern die 32-Bit-Version von Sn.exe aus, indem Sie die Visual Studio-Eingabeaufforderung verwenden, und die 64-Bit-Version, indem Sie die Visual Studio x64 Win64-Eingabeaufforderung verwenden.

Dieses Tool wird automatisch mit Visual Studio und mit dem Windows SDK installiert. Um das Tool auszuführen, empfiehlt es sich, dass Sie die Visual Studio-Eingabeaufforderung oder Windows SDK-Eingabeaufforderung (CMD-Shell) verwenden. Mit diesen Hilfsprogrammen können Sie das Tool problemlos ausführen, ohne in den Installationsordner zu navigieren. Weitere Informationen finden Sie unter Visual Studio- und Windows SDK-Eingabeaufforderungen.

  • Wenn Visual Studio auf dem Computer installiert ist: Klicken Sie auf der Taskleiste auf Start, All Programs, Visual Studio und Visual Studio Tools, und klicken Sie dann auf Visual Studio Command Prompt.

    – oder –

    Wenn das Windows SDK auf Ihrem Computer installiert ist: Klicken Sie auf der Taskleiste auf Start, All Programs, klicken Sie auf den Ordner für das Windows SDK, und klicken anschließend auf Command Prompt (oder CMD Shell).

  • Geben Sie an der Eingabeaufforderung Folgendes ein:

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

Parameter

Option

Beschreibungen

-c [csp]

Legt den für das Signieren mit starken Namen zu verwendenden kryptografischen Standarddienstanbieter (Cryptographic Service Provider, CSP) fest. Diese Einstellung gilt für den gesamten Computer. Wenn Sie keinen CSP-Namen angeben, löscht Sn.exe die aktuelle Einstellung.

-d container

Löscht den angegebenen Schlüsselcontainer aus dem CSP für starke Namen.

-D Assembly1 Assembly2

Überprüft, ob sich zwei Assemblys nur in der Signatur unterscheiden. Diese Prüfung wird häufig verwendet, nachdem eine Assembly mit einem anderen Schlüsselpaar neu signiert wurde.

-e Assembly-Ausgabedatei

Extrahiert den öffentlichen Schlüssel aus Assembly und speichert ihn in Ausgabedatei.

-h

Zeigt Befehlssyntax und Optionen für das Tool an.

-i Eingabedatei Container

Installiert das Schlüsselpaar aus infile in dem angegebenen Schlüsselcontainer. Der Schlüsselcontainer befindet sich im CSP für starke Namen.

-k [Schlüsselgröße] Ausgabedatei

Generiert einen neuen RSACryptoServiceProvider-Schlüssel mit der angegebenen Größe und schreibt ihn in die angegebene Datei. Sowohl ein öffentlicher als auch ein privater Schlüssel wird in die Datei geschrieben.

Wenn Sie keine Schlüsselgröße angeben, wird standardmäßig ein 1.024-Bit-Schlüssel generiert, sofern Microsoft Enhanced Cryptographic Provider installiert ist; andernfalls wird ein 512-Bit-Schlüssel generiert.

Bei Installation von Microsoft Enhanced Cryptographic Provider unterstützt der Parameter keysize Schlüssel mit einer Länge von 384 bis 16.384 Bits in 8-Bit-Schritten. Bei Installation von Microsoft Base Cryptographic Provider unterstützt der Parameter Schlüssel mit einer Länge von 384 bis 512 Bits in 8-Bit-Schritten.

-m [y|n]

Legt fest, ob Schlüsselcontainer computerspezifisch oder benutzerspezifisch sind. Wenn Sie y angeben, sind die Schlüsselcontainer computerspezifisch. Wenn Sie n angeben, sind die Schlüsselcontainer benutzerspezifisch.

Wenn weder y noch n angegeben wird, zeigt diese Option die aktuelle Einstellung an.

-o Eingabedatei [Ausgabedatei]

Extrahiert den öffentlichen Schlüssel aus Eingabedatei und speichert ihn in einer CSV-Datei. Die einzelnen Bytes des öffentlichen Schlüssels werden durch Komma getrennt. Dieses Format eignet sich zum Hartcodieren von Schlüsselverweisen als initialisierte Arrays im Quellcode. Wenn Sie keine Ausgabedatei angeben, wird die Ausgabe dieser Option in der Zwischenablage gespeichert.

HinweisHinweis
Diese Option überprüft nicht, ob die Eingabe nur ein öffentlicher Schlüssel ist.Wenn infile ein Schlüsselpaar mit einem privaten Schlüssel enthält, wird der private Schlüssel auch extrahiert.

-p Eingabedatei Ausgabedatei

Extrahiert den öffentlichen Schlüssel aus dem Schlüsselpaar in Eingabedatei und speichert ihn in Ausgabedatei. Dieser öffentlichen Schlüssel kann zum verzögerten Signieren einer Assembly unter Verwendung der Optionen /delaysign+ und /keyfile des Assembly Linker-Tools (Al.exe) verwendet werden. Beim verzögerten Signieren einer Assembly wird während der Kompilierung nur der öffentliche Schlüssel festgelegt und Speicherplatz in der Datei reserviert, damit die Signatur hinzugefügt werden kann, sobald der private Schlüssel bekannt ist.

-pc Container Ausgabedatei

Extrahiert den öffentlichen Schlüssel aus dem Schlüsselpaar in Container und speichert ihn in Ausgabedatei.

-Pb [y|n]

Legt fest, ob die Bypassrichtlinie für starke Namen durchgesetzt wird. Wenn Sie y festlegen, werden starke Namen für voll vertrauenswürdige Assemblys beim Laden in ein voll vertrauenswürdiges AppDomain nicht geprüft. Wenn Sie n festlegen, werden starke Namen auf Korrektheit geprüft, jedoch nicht auf bestimmte starke Namen. StrongNameIdentityPermission hat keine Auswirkung auf voll vertrauenswürdige Assemblys. Sie müssen eine eigene Überprüfung der Übereinstimmung auf starke Namen durchführen.

Wenn weder y noch n festgelegt ist, zeigt diese Option die aktuelle Einstellung. Der Standardwert ist y.

HinweisHinweis
Auf 64-Bit-Computern müssen diese Parameter sowohl in der 32-Bit- als auch in der 64-Bit-Instanz von Sn.exe festgelegt werden.

-q[uiet]

Gibt den stillen Modus an, in dem die Anzeige von Erfolgsmeldungen unterdrückt wird.

-R[aAssembly Eingabedatei

Signiert eine bereits signierte oder eine verzögert signierte Assembly mit dem Schlüsselpaar in der Eingabedatei neu.

Wenn -Ra verwendet wird, werden Hashes für alle Dateien in der Assembly neu berechnet.

-Rc[aAssembly Container

Signiert eine bereits signierte oder eine verzögert signierte Assembly mit dem Schlüsselpaar in Container neu.

Wenn -Rca verwendet wird, werden Hashes für alle Dateien in der Assembly neu berechnet.

-Rh Assembly

Berechnet Hashes für alle Dateien in der Assembly neu.

-t[p] Eingabedatei

Zeigt das in Eingabedatei gespeicherte Token für den öffentlichen Schlüssel an. Eingabedatei muss einen öffentlichen Schlüssel enthalten, der zuvor von einer Schlüsselpaardatei mithilfe von -p generiert wurde. Verwenden Sie nicht die Option -t[p], um ein Token direkt aus einer Schlüsselpaardatei zu extrahieren.

Sn.exe berechnet das Token mithilfe einer Hashfunktion aus dem öffentlichen Schlüssel. Um Speicherplatz zu sparen, speichert die Common Language Runtime Token für öffentliche Schlüssel im Manifest als Teil eines Verweises auf eine weitere Assembly, wenn eine Abhängigkeit zu einer Assembly mit starkem Namen aufgezeichnet wird. Die Option -tp zeigt zusätzlich zum Token den öffentlichen Schlüssel an.

Beachten Sie, dass bei Verwendung dieser Option die Assemblysignatur nicht überprüft wird, und sie daher nicht für Entscheidungen über Vertrauensstellungen verwendet werden sollte. Durch diese Option werden nur die unformatierten Tokendaten des öffentlichen Schlüssels angezeigt.

-T[p] Assembly

Zeigt das Token des öffentlichen Schlüssels für die Assembly an. Die Assembly muss dem Namen einer Datei entsprechen, die ein Assemblymanifest enthält.

Sn.exe berechnet das Token mithilfe einer Hashfunktion aus dem öffentlichen Schlüssel. Um Speicherplatz zu sparen, speichert die Laufzeit Token für öffentliche Schlüssel im Manifest als Teil eines Verweises auf eine weitere Assembly, wenn eine Abhängigkeit zu einer Assembly mit starkem Namen aufgezeichnet wird. Die Option -Tp zeigt zusätzlich zum Token den öffentlichen Schlüssel an.

Beachten Sie, dass bei Verwendung dieser Option die Assemblysignatur nicht überprüft wird, und sie daher nicht für Entscheidungen über Vertrauensstellungen verwendet werden sollte. Durch diese Option werden nur die unformatierten Tokendaten des öffentlichen Schlüssels angezeigt.

-TSassembly infile

Signiert die vollständig oder teilweise signierte assembly mit dem Schlüsselpaar in der infile zu Testzwecken.

-TSc assembly container

Signiert die vollständig oder teilweise signierte assembly mit dem Schlüsselpaar im Schlüsselcontainer container zu Testzwecken.

-v Assembly

Überprüft den starken Namen in Assembly, wobei Assembly der Name einer Datei ist, die ein Assemblymanifest enthält.

-vf Assembly

Überprüft den starken Namen in der Assembly. Im Unterschied zur Option -v wird die Überprüfung bei -vf auch dann erzwungen, wenn diese mit der Option -Vr deaktiviert wurde.

-Vl

Listet aktuelle Einstellungen für die Überprüfung starker Namen auf dem Computer auf.

-Vr Assembly [Benutzerliste] [Eingabedatei]

Registriert Assembly für das Überspringen bei der Überprüfung. Optional können Sie eine durch Trennzeichen getrennte Liste von Benutzernamen angeben. Wenn Sie Eingabedatei angeben, bleibt die Überprüfung aktiviert, es wird jedoch der öffentliche Schlüssel in Eingabedatei bei Überprüfungsvorgängen verwendet. Assembly kann in der Form *, strongname angegeben werden, um alle Assemblys mit dem angegebenen starken Namen zu registrieren. Strongname muss als die Zeichenfolge hexadezimaler Ziffern angegeben werden, die die Tokendarstellung des öffentlichen Schlüssels angibt. Siehe die Optionen -t und -T zum Anzeigen des Tokens des öffentlichen Schlüssels.

WarnhinweisVorsicht
Verwenden Sie diese Option nur bei der Entwicklung.Das Überspringen der Überprüfung einer Assembly kann ein erhebliches Sicherheitsrisiko darstellen.Wenn die Überprüfung einer Assembly übersprungen wird, besteht die Gefahr, dass deren vollständig angegebener Assemblyname (Assemblyname, Version, Kultur und öffentliches Schlüsseltoken) als falsche Identität einer böswilligen Assembly verwendet wird.Dadurch würde auch die Überprüfung der böswilligen Assembly übersprungen.

-Vu Assembly

Hebt die Registrierung von Assembly für das Überspringen bei der Überprüfung auf. Für -Vu gelten dieselben Regeln für die Angabe der Assembly wie bei -Vr.

-Vx

Entfernt alle Einträge für das Überspringen bei der Überprüfung.

-?

Zeigt Befehlssyntax und Optionen für das Tool an.

HinweisHinweis

Bei allen Optionen für Sn.exe wird die Groß- und Kleinschreibung beachtet. Sie müssen genau wie in der vorhergehenden Tabelle eingegeben werden, um vom Tool interpretiert werden zu können.

Hinweise

Die Optionen -R und -Rc sind bei Assemblys sinnvoll, die verzögert signiert wurden. In diesem Szenario wurde während der Kompilierung nur der öffentliche Schlüssel festgelegt. Die Signierung erfolgt erst, wenn der private Schlüssel bekannt ist.

HinweisHinweis

Führen Sie für Parameter (z. B. –Vr), die auf geschützte Ressourcen wie die Registrierung schreiben, SN.exe als Administrator aus.

Beispiele

Mit dem folgenden Befehl wird ein neues, nach dem Zufallsprinzip erzeugtes Schlüsselpaar erstellt und in keyPair.snk gespeichert.

sn -k keyPair.snk

Mit dem folgenden Befehl wird der Schlüssel aus keyPair.snk im CSP für starke Namen im Container MyContainer gespeichert.

sn -i keyPair.snk MyContainer

Der folgende Befehl extrahiert den öffentlichen Schlüssel aus keyPair.snk und speichert ihn in publicKey.snk.

sn -p keyPair.snk publicKey.snk

Mit dem folgenden Befehl werden der öffentliche Schlüssel und das Token für den öffentlichen Schlüssel in publicKey.snk angezeigt.

sn -tp publicKey.snk

Mit dem folgenden Befehl wird die Assembly MyAsm.dll überprüft.

sn -v MyAsm.dll

Mit dem folgenden Befehl wird MyContainer aus dem Standard-CSP gelöscht.

sn -d MyContainer

Siehe auch

Referenz

Al.exe (Assembly Linker-Tool)

Visual Studio- und Windows SDK-Eingabeaufforderungen

Konzepte

Assemblys mit starkem Namen

Weitere Ressourcen

.NET Framework-Tools

Änderungsprotokoll

Datum

Versionsgeschichte

Grund

April 2011

Hinzugefügte Informationen zur Verwendung der Visual Studio- und Windows SDK-Eingabeaufforderungen.

Informationsergänzung.

August 2010

Informationen zum Ausführen des Tools auf 64-Bit-Computern wurden hinzugefügt.

Informationsergänzung.