-
Notifications
You must be signed in to change notification settings - Fork 1.6k
/
Copy pathCertificateEmbeddingOption.xml
129 lines (122 loc) · 7.59 KB
/
CertificateEmbeddingOption.xml
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
<Type Name="CertificateEmbeddingOption" FullName="System.IO.Packaging.CertificateEmbeddingOption">
<TypeSignature Language="C#" Value="public enum CertificateEmbeddingOption" />
<TypeSignature Language="ILAsm" Value=".class public auto ansi sealed CertificateEmbeddingOption extends System.Enum" />
<TypeSignature Language="DocId" Value="T:System.IO.Packaging.CertificateEmbeddingOption" />
<TypeSignature Language="VB.NET" Value="Public Enum CertificateEmbeddingOption" />
<TypeSignature Language="F#" Value="type CertificateEmbeddingOption = " />
<TypeSignature Language="C++ CLI" Value="public enum class CertificateEmbeddingOption" />
<AssemblyInfo>
<AssemblyName>WindowsBase</AssemblyName>
<AssemblyVersion>3.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
<AssemblyVersion>5.0.0.0</AssemblyVersion>
<AssemblyVersion>6.0.0.0</AssemblyVersion>
<AssemblyVersion>7.0.0.0</AssemblyVersion>
<AssemblyVersion>8.0.0.0</AssemblyVersion>
<AssemblyVersion>9.0.0.0</AssemblyVersion>
<AssemblyVersion>10.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Base>
<BaseTypeName>System.Enum</BaseTypeName>
</Base>
<Docs>
<summary>Specifies the location where the X.509 certificate that is used in signing is stored.</summary>
<remarks>
<format type="text/markdown"><![CDATA[
## Remarks
If the certificate is `NotEmbedded` in the package, an application that verifies signatures must provide a copy of the certificate in order to verify the signatures that are signed by it.
`InSignaturePart` adds two informational elements, `<KeyName>` and `<KeyValue>`, as part of the <xref:System.Security.Cryptography.Xml.Signature.KeyInfo%2A> field of the stored digital signature. The `<KeyName>` and `<KeyValue>` elements are not processed as part of signature validation and are therefore not secure from modification. Applications should not make any assumption regarding the validity of these two elements. To avoid undetected modification and possible confusion, applications should use the `InCertificatePart` option instead of `InSignaturePart`. The `InCertificatePart` option does not provide or expose either `<KeyName>` or `<KeyValue>`.
## Examples
The following example shows how to use `CertificateEmbeddingOption` in order to set the <xref:System.IO.Packaging.PackageDigitalSignatureManager.CertificateOption%2A?displayProperty=nameWithType> property.
:::code language="csharp" source="~/snippets/csharp/System.IO.Packaging/CertificateEmbeddingOption/Overview/PackageDigitalSignature.cs" id="SnippetPackageDigSigSign":::
:::code language="vb" source="~/snippets/visualbasic/VS_Snippets_Wpf/PackageDigitalSignature/visualbasic/packagedigitalsignature.vb" id="SnippetPackageDigSigSign":::
]]></format>
</remarks>
<altmember cref="P:System.IO.Packaging.PackageDigitalSignatureManager.CertificateOption" />
<altmember cref="P:System.IO.Packaging.PackageDigitalSignature.CertificateEmbeddingOption" />
<related type="ExternalDocumentation" href="https://www.ecma-international.org/publications-and-standards/standards/ecma-376/">Open Packaging Conventions (OPC) Specification</related>
</Docs>
<Members>
<Member MemberName="InCertificatePart">
<MemberSignature Language="C#" Value="InCertificatePart" />
<MemberSignature Language="ILAsm" Value=".field public static literal valuetype System.IO.Packaging.CertificateEmbeddingOption InCertificatePart = int32(0)" />
<MemberSignature Language="DocId" Value="F:System.IO.Packaging.CertificateEmbeddingOption.InCertificatePart" />
<MemberSignature Language="VB.NET" Value="InCertificatePart" />
<MemberSignature Language="F#" Value="InCertificatePart = 0" Usage="System.IO.Packaging.CertificateEmbeddingOption.InCertificatePart" />
<MemberSignature Language="C++ CLI" Value="InCertificatePart" />
<MemberType>Field</MemberType>
<AssemblyInfo>
<AssemblyName>WindowsBase</AssemblyName>
<AssemblyVersion>3.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
<AssemblyVersion>5.0.0.0</AssemblyVersion>
<AssemblyVersion>6.0.0.0</AssemblyVersion>
<AssemblyVersion>7.0.0.0</AssemblyVersion>
<AssemblyVersion>8.0.0.0</AssemblyVersion>
<AssemblyVersion>9.0.0.0</AssemblyVersion>
<AssemblyVersion>10.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.IO.Packaging.CertificateEmbeddingOption</ReturnType>
</ReturnValue>
<MemberValue>0</MemberValue>
<Docs>
<summary>The certificate is embedded in its own <see cref="T:System.IO.Packaging.PackagePart" />.</summary>
</Docs>
</Member>
<Member MemberName="InSignaturePart">
<MemberSignature Language="C#" Value="InSignaturePart" />
<MemberSignature Language="ILAsm" Value=".field public static literal valuetype System.IO.Packaging.CertificateEmbeddingOption InSignaturePart = int32(1)" />
<MemberSignature Language="DocId" Value="F:System.IO.Packaging.CertificateEmbeddingOption.InSignaturePart" />
<MemberSignature Language="VB.NET" Value="InSignaturePart" />
<MemberSignature Language="F#" Value="InSignaturePart = 1" Usage="System.IO.Packaging.CertificateEmbeddingOption.InSignaturePart" />
<MemberSignature Language="C++ CLI" Value="InSignaturePart" />
<MemberType>Field</MemberType>
<AssemblyInfo>
<AssemblyName>WindowsBase</AssemblyName>
<AssemblyVersion>3.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
<AssemblyVersion>5.0.0.0</AssemblyVersion>
<AssemblyVersion>6.0.0.0</AssemblyVersion>
<AssemblyVersion>7.0.0.0</AssemblyVersion>
<AssemblyVersion>8.0.0.0</AssemblyVersion>
<AssemblyVersion>9.0.0.0</AssemblyVersion>
<AssemblyVersion>10.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.IO.Packaging.CertificateEmbeddingOption</ReturnType>
</ReturnValue>
<MemberValue>1</MemberValue>
<Docs>
<summary>The certificate is embedded in the <see cref="P:System.IO.Packaging.PackageDigitalSignature.SignaturePart" /> that is created for the signature being added.</summary>
</Docs>
</Member>
<Member MemberName="NotEmbedded">
<MemberSignature Language="C#" Value="NotEmbedded" />
<MemberSignature Language="ILAsm" Value=".field public static literal valuetype System.IO.Packaging.CertificateEmbeddingOption NotEmbedded = int32(2)" />
<MemberSignature Language="DocId" Value="F:System.IO.Packaging.CertificateEmbeddingOption.NotEmbedded" />
<MemberSignature Language="VB.NET" Value="NotEmbedded" />
<MemberSignature Language="F#" Value="NotEmbedded = 2" Usage="System.IO.Packaging.CertificateEmbeddingOption.NotEmbedded" />
<MemberSignature Language="C++ CLI" Value="NotEmbedded" />
<MemberType>Field</MemberType>
<AssemblyInfo>
<AssemblyName>WindowsBase</AssemblyName>
<AssemblyVersion>3.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
<AssemblyVersion>5.0.0.0</AssemblyVersion>
<AssemblyVersion>6.0.0.0</AssemblyVersion>
<AssemblyVersion>7.0.0.0</AssemblyVersion>
<AssemblyVersion>8.0.0.0</AssemblyVersion>
<AssemblyVersion>9.0.0.0</AssemblyVersion>
<AssemblyVersion>10.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.IO.Packaging.CertificateEmbeddingOption</ReturnType>
</ReturnValue>
<MemberValue>2</MemberValue>
<Docs>
<summary>The certificate in not embedded in the package.</summary>
</Docs>
</Member>
</Members>
</Type>