Identität (Paketschema für Windows 8)

Definiert einen global eindeutigen Bezeichner für ein Paket. Eine Paketidentität wird als Tupel von Attributen des Pakets dargestellt.

Elementhierarchie

<Paket>

<Identity>

Syntax

<Identity Name                   = A string between 3 and 50 characters in length that consists of alpha-numeric, period, and dash characters.
          ProcessorArchitecture? = "x86" | "x64" | "arm" | "neutral"
          Publisher              = A string between 1 and 8192 characters in length that fits the regular expression  of a distinguished name : "(CN|L|O|OU|E|C|S|STREET|T|G|I|SN|DC|SERIALNUMBER|(OID\.(0|[1-9][0-9]*)(\.(0|[1-9][0-9]*))+))=(([^,+="<>#;])+|".*")(, ((CN|L|O|OU|E|C|S|STREET|T|G|I|SN|DC|SERIALNUMBER|(OID\.(0|[1-9][0-9]*)(\.(0|[1-9][0-9]*))+))=(([^,+="<>#;])+|".*")))*". Further, semantic validation ensures that the string is compliant with CertNameToStr Windows API implementation of X.500 rules.

          Version                = A version string in quad notation, "Major.Minor.Build.Revision".
          ResourceId?            = A string between 1 and 30 characters in length that consists of alpha-numeric, period, and dash characters. />

Schlüssel

? optional (null oder eins)

Attribute und Elemente

Attributes

Untergeordnete Elemente

Keine

Übergeordnete Elemente

Hinweise

Wichtig Für die Zeichenfolgen Nameund ResourceID müssen die folgenden Regeln befolgt werden:

• Zulässige Eingabezeichen = ASCII-Teilmenge
  • Großbuchstaben (U+0041 bis U+005A)
  • Kleinbuchstaben (U+0061 bis U+007A)
  • Zahlen (U+0030 bis U+0039)
  • Punkt (U+002E)
  • Bindestrich (U+002D)
• Unzulässige Zeichenfolgen
  • Kann nicht gleich sein...
    • ".", "..", "con", "prn", "aux", "nul", "com1", "com2", "com3", "com4", "com5", "com6", "com7", "com8", "com9", "lpt1", "lpt2", "lpt3", "lpt4", "lpt5", "lpt6", "lpt7", "lpt8", "lpt9"
  • Kann nicht mit beginnen...
    • "con.", "prn.", "aux.", "nul.", "com1.", "com2.", "com3.", "com4.", "com5.", "com6.", "com7.", "com8.", "com9.", "lpt1.", "lpt2.", "lpt3.", "lpt4.", "lpt5.", "lpt6.", "lpt7.", "lpt8.", "lpt9.", "xn---"
  • Das Ende kann nicht mit...
    • "."
  • Kann nicht enthalten...
    • ".xn--"

Das Attribut Name wird vom Betriebssystem und von Entwicklern verwendet, um Pakete zu identifizieren. Das Name-Attribut ist nicht für die Anzeige für Endbenutzer vorgesehen.

Wenn eine App auf verschiedenen Ressourcenpaketen basiert, muss das ResourceId-Attribut für einen bestimmten Paketnamen im Benutzerkonto eindeutig sein. Hauptpaketvarianten, die auf Ressourcen-IDs basieren, dürfen nicht gleichzeitig installiert werden. Es sind jedoch mehrere gleichzeitige Varianten eines Pakets nur für Ressourcen zulässig. Beispiele für mögliche ResoureId-Attribute sind:

• Nordamerika
• Asien
• Europäische Sprachen

Das Publisher-Attribut wird anhand des Betreffnamens des Signaturzertifikats überprüft, wenn signierte Pakete geöffnet werden. Wenn das Publisher-Attribut nicht genau mit dem Namen des Betreffs übereinstimmen, ist das Paket ungültig. Sie können mehrere semantisch äquivalente Zeichenfolgendarstellungen aus dem im Zertifikat gespeicherten Betreffnamen erstellen. Verwenden Sie diese Kanonisierungsregeln, um den Publisher-Attributwert mit diesem Betreffnamen zu übereinstimmen:

• Unicode-Werte können UTF-8-codiert sein.

• Wenn der Name die Legacy-E-Mail-Komponente enthält, wird der internationalisierte Domänenname (IDN) in Unicode-Form dargestellt.

• Objektbezeichner (OIDs) mit X.500-Schlüsselnamen müssen den X.500-Schlüsselnamen verwenden (z.B. CN, nicht 2.5.4.3).

• OIDs ohne X.500-Schlüsselnamen werden mit dem Präfix "OID." identifiziert (z.B. OID.2.5.4.34).

• OID-Schlüsselnamen werden durch ein Gleichheitszeichen ohne zusätzliche Leerzeichen von ihren Werten getrennt (z. B. CN=JohnSmith).

• Mehrere RELATIVE DISTINGUISHED NAME-Einträge (RDN) werden durch ein Komma gefolgt von einem Leerzeichen (z. B. CN=JohnSmith, O=Contoso) getrennt.

• Der RDN-Wert enthält nur Anführungszeichen, wenn er führende oder nachfolgende Leerzeichen oder eines der folgenden Zeichen enthält (z.B. CN=" JohnSmith", O="C++ Inc."):

  • Komma (,)
  • Pluszeichen (+)
  • Gleichheitszeichen (=)
  • Zollmark (")
  • Schrägstrich gefolgt vom Buchstaben n (\n)
  • Kleiner als -Zeichen (<)
  • Größer als-Zeichen (>)
  • Nummernzeichen (#)
  • Semikolon (;)

• Das Anführungszeichen ist eine Zollmarkierung ("). Wenn der RDN-Wert eine Zollmarkierung enthält, muss die Zollmarkierung zusätzlich zu anführungszeichen ("") doppelte Anführungszeichen enthalten (z.B. CN="Smith"Bill"").

• Mehrwertige RDNs sind nicht zulässig (z.B. CN=JohnSmith + O=Contoso).

Diese Regeln folgen dem Verhalten der CertNameToStr-Funktion, die verwendet werden kann, um den erwarteten Publisher-Attributwert aus einem Zertifikat zu bestimmen.

Beispiele

Das folgende Beispiel ist aus dem Paketmanifest eines der SDK-Beispiele entnommen.

<Identity Name="Microsoft.SDKSamples.ApplicationDataSample" 
          Version="1.0.0.0" 
          Publisher="CN=Microsoft Corporation, O=Microsoft Corporation, L=Redmond, S=Washington, C=US" />

Anforderungen