Identitas (skema ekstensi untuk Windows 8.1)

Artikel
07/20/2023

Menentukan pengidentifikasi unik global untuk paket. Identitas paket direpresentasikan sebagai tuple atribut paket.

Hierarki elemen

<Paket>: <Identitas>

Sintaks

<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|Description|PostalCode|POBox|Phone|X21Address|dnQualifier|(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|Description|PostalCode|POBox|Phone|X21Address|dnQualifier|(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. />

Kunci

? opsional (nol atau satu)

Atribut dan Elemen

Atribut

Atribut	Deskripsi	Jenis Data	Diperlukan
Nama	Menjelaskan isi paket. Atribut Name tidak peka huruf besar/kecil. Gunakan [DisplayName](.. . Atribut /appxmanifestschema/element-displayname.md) untuk menampilkan nama paket kepada pengguna. String ini tidak dapat diakhiri dengan titik dan tidak boleh menjadi salah satu string ini: "CON", "PRN", "AUX", "NUL", "COM1", "COM2", "COM3", "COM4", "COM5", "COM6", "COM7", "COM8", "COM9", "LPT1", "LPT2", "LPT3", "LPT4", "LPT5", "LPT6", "LPT7", "LPT8", dan "LPT9".	Panjang string antara 3 dan 50 karakter yang terdiri dari karakter alfa-numerik, titik, dan tanda hubung.	Ya
ProcessorArchitecture	Menjelaskan arsitektur kode yang terkandung dalam paket. Paket yang menyertakan kode yang dapat dieksekusi harus menyertakan atribut ini.	Atribut ini dapat memiliki salah satu nilai berikut: x86 x64 arm netral	Tidak
Publisher	Menjelaskan informasi penerbit. Atribut Publisher harus cocok dengan informasi subjek penerbit sertifikat yang digunakan untuk menandatangani paket. Untuk informasi selengkapnya lihat Mengemas aplikasi .	Panjang string antara 1 dan 8192 karakter yang sesuai dengan ekspresi reguler dari nama khusus: "(CN\| L\|O\| Unit organisasi\| E\| C\|S\| JALAN\| T\| G\| Aku \|SN\| DC\|SERIALNUMBER\| Deskripsi\| PostalCode\| POBox\| Telepon\| X21Address\|dnQualifier\| (OID\. (0\| [1-9] [0-9])(\.( 0\| [1-9] [0-9]))+))=((([^,+="<>#;]) +\|". ")(, ((CN\| L\|O\| Unit organisasi\| E\| C\|S\| JALAN\| T\| G\| Aku \|SN\| DC\|SERIALNUMBER\| Deskripsi\| PostalCode\| POBox\| Telepon\| X21Address\|dnQualifier\| (OID\. (0\| [1-9] [0-9])(\.( 0\| [1-9] [0-9]))+))=((([^,+="<>#;]) +\|". ")))*". Selanjutnya, validasi semantik memastikan bahwa string mematuhi implementasi CertNameToStr Windows API dari aturan X.500.	Ya
ResourceId	Menjelaskan jenis sumber daya UI yang terkandung dalam paket. ResourceId adalah string yang ditentukan penerbit. String ini tidak dapat diakhiri dengan titik dan tidak boleh menjadi salah satu string ini: "CON", "PRN", "AUX", "NUL", "COM1", "COM2", "COM3", "COM4", "COM5", "COM6", "COM7", "COM8", "COM9", "LPT1", "LPT2", "LPT3", "LPT4", "LPT5", "LPT6", "LPT7", "LPT8", dan "LPT9".	Panjang string antara 1 dan 30 karakter yang terdiri dari karakter alfa-numerik, titik, dan tanda hubung.	Tidak
Versi	Nomor versi paket.	String versi dalam notasi quad, "Major.Minor.Build.Revision".	Ya

Elemen Anak

Tidak ada.

Elemen Induk

Elemen Induk	Deskripsi
Paket	Menentukan elemen akar manifes paket aplikasi. Manifes menjelaskan struktur dan kemampuan perangkat lunak ke sistem.

Keterangan

Atribut Name digunakan oleh sistem operasi dan pengembang untuk mengidentifikasi paket. Atribut Name tidak dimaksudkan untuk ditampilkan kepada pengguna akhir.

Saat aplikasi didasarkan pada paket sumber daya yang berbeda, atribut ResourceId harus unik di seluruh akun pengguna untuk nama paket tertentu. Varian paket utama berdasarkan ID sumber daya tidak diizinkan untuk diinstal secara bersamaan. Namun, beberapa varian simultan dari paket khusus sumber daya diizinkan. Contoh kemungkinan atribut ResoureId meliputi:

Amerika Utara
Asia
Bahasa Eropa

Atribut Publisher divalidasi terhadap nama subjek sertifikat penandatanganan saat paket yang ditandatangani dibuka. Jika atribut Publisher tidak sama persis dengan nama subjek, paket tidak valid. Anda dapat membuat beberapa representasi string yang setara secara semantik dari nama subjek yang disimpan dalam sertifikat. Gunakan aturan kanonisisasi ini untuk mencocokkan nilai atribut Publisher dengan nama subjek tersebut:

Nilai Unicode dapat dikodekan UTF-8.
Jika nama berisi komponen email warisan, Nama Domain Internasional (IDN) diwakili dalam formulir Unicode.
Pengidentifikasi objek (OID) dengan nama kunci X.500 harus menggunakan nama kunci X.500 (misalnya, CN, bukan 2.5.4.3).
OID tanpa nama kunci X.500 diidentifikasi dengan awalan "OID." (misalnya, OID.2.5.4.34).
Nama kunci OID dipisahkan dari nilainya dengan tanda sama dengan tanpa spasi tambahan (misalnya, CN=JohnSmith).
Beberapa entri nama khusus relatif (RDN) dipisahkan oleh koma diikuti oleh spasi (misalnya, CN=JohnSmith, O=Contoso).
Nilai RDN memiliki tanda kutip di sekitarnya hanya jika berisi spasi putih di depan atau di belakang atau salah satu karakter berikut (misalnya, CN=" JohnSmith", O="C++ Inc."):
- Koma (,)
- Tanda plus (+)
- Tanda sama dengan (=)
- Tanda inci (")
- Garis miring terbelakang diikuti dengan huruf n (\n)
- Kurang dari tanda (<)
- Lebih besar dari tanda (>)
- Tanda angka (#)
- Titik koma (;)
Karakter kutipan adalah tanda inci ("). Jika nilai RDN berisi tanda inci, tanda inci harus memiliki tanda kutip ganda ("") selain diapit dalam tanda kutip (misalnya, CN="William ""Bill"" Smith").
RDN multinila tidak diizinkan (misalnya, CN=JohnSmith + O=Contoso).

Aturan ini mengikuti perilaku fungsi CertNameToStr , yang dapat digunakan untuk menentukan nilai atribut Publisher yang diharapkan dari sertifikat.

Contoh

Contoh berikut diambil dari manifes paket salah satu sampel SDK.

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

Persyaratan

	Nilai
Ruang nama	`http://schemas.microsoft.com/appx/2010/manifest`