Удостоверение (схема пакета для Windows 8)

Определяет глобальный уникальный идентификатор для пакета. Удостоверение пакета представлено в виде кортежа атрибутов пакета.

Иерархия элементов

<Пакет>

<Идентифицирует>

Синтаксис

<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. />

Ключ

? необязательно (ноль или один)

Атрибуты и элементы

Атрибуты

Дочерние элементы

Отсутствует.

Родительские элементы

Remarks

Важно! Для строк Name и ResourceId необходимо соблюдать следующие правила.

• Допустимые входные символы = подмножество ASCII
  • Прописные буквы (от U + 0041 до U + 005A)
  • Строчные буквы (от U + 0061 до U + 007A)
  • Числа (от U + 0030 до U + 0039)
  • Точка (U + 002E)
  • Тире (U + 002D)
• Запрещенные строки
  • Не может быть равно...
    • ".", "..", "Con", "PRN", "AUX", "NUL", "COM1", "COM2", "COM3", "COM4", "COM5", "COM6", "COM7", "COM8", "COM9", "LPT1", "LPT2", "LPT3", "LPT4", "lpt5", "lpt6", "lpt7", "lpt8", "LPT9"
  • Не может начинаться с...
    • "Con.", "PRN.", "AUX.", "NUL.", "COM1.", "COM2.", "COM3.", "COM4"., "COM5.", "COM6.", "COM7.", "COM8.", "COM9.", "LPT1.", "LPT2.", "LPT3.", "LPT4.", "lpt5.", "lpt6.", "lpt7.", "lpt8.", "LPT9.", "xn--"
  • Не может заканчиваться на...
    • "."
  • Не может содержать...
    • ". xn--"

Атрибут Name используется операционной системой и разработчиками для обнаружения пакетов. Атрибут Name не предназначен для отображения конечным пользователям.

Если приложение основано на разных пакетах ресурсов, атрибут ResourceId должен быть уникальным в пределах учетной записи пользователя для данного имени пакета. Установка основных вариантов пакетов на основе идентификаторов ресурсов невозможна одновременно. Однако допускается несколько одновременных вариантов пакета только для ресурсов. Примеры возможных атрибутов ресауреид :

• Северная Америка
• Азия
• Европейские языки

атрибут Publisher проверяется по имени субъекта сертификата подписи при открытии подписанных пакетов. если атрибут Publisher не полностью соответствует имени субъекта, пакет является недопустимым. Можно создать несколько семантически эквивалентных строковых представлений из имени субъекта, хранящегося в сертификате. используйте эти правила канонизации, чтобы сопоставить значение атрибута Publisher с именем субъекта:

• Значения Юникода могут быть в кодировке UTF-8.

• Если имя содержит устаревший компонент электронной почты, Международный доменное имя (IDN) представлено в формате Юникод.

• Идентификаторы объектов (OID) с именами ключей X. 500 должны использовать имя ключа X. 500 (например, CN, not 2.5.4.3).

• Идентификаторы объектов без имен ключей X. 500 идентифицируются с помощью префикса OID (например, OID. 2.5.4.34).

• Имена ключей OID отделены от их значений знаками равенства без лишних пробелов (например, CN = Жохнсмис).

• Несколько записей относительного различающегося имени (RDN) разделяются запятой, за которой следует пробел (например, CN = Жохнсмис, O = Contoso).

• Значение RDN заключено в кавычки только в том случае, если оно содержит начальные или конечные пробелы или один из следующих символов (например, CN = "Жохнсмис", O = "C++ Inc."):

  • Запятая (,)
  • Знак "плюс" (+)
  • Знак равенства (=)
  • Пометка дюйм (")
  • Обратная косая черта, за которой следует буква n (\n)
  • Знак "меньше" ( < )
  • Знак "больше" ( > )
  • Знак номера (#)
  • Точка с запятой (;)

• Кавычки — это знак дюйма ("). Если значение RDN содержит знак дюйма, то знак дюйма должен содержать двойные кавычки (""), кроме заключенных в кавычки (например, CN = "Уильям" "Bill" "Иванов").

• Многозначные RDN не допускаются (например, CN = Жохнсмис + O = Contoso).

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

Примеры

Следующий пример взят из манифеста пакета одного из примеров пакета SDK.

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

Требования