1 <?xml version="1.0"?>
\r
4 <name>Microsoft.AspNetCore.DataProtection.Abstractions</name>
\r
7 <member name="T:Microsoft.AspNetCore.DataProtection.DataProtectionCommonExtensions">
\r
9 Helpful extension methods for data protection APIs.
\r
12 <member name="M:Microsoft.AspNetCore.DataProtection.DataProtectionCommonExtensions.CreateProtector(Microsoft.AspNetCore.DataProtection.IDataProtectionProvider,System.Collections.Generic.IEnumerable{System.String})">
\r
14 Creates an <see cref="T:Microsoft.AspNetCore.DataProtection.IDataProtector"/> given a list of purposes.
\r
16 <param name="provider">The <see cref="T:Microsoft.AspNetCore.DataProtection.IDataProtectionProvider"/> from which to generate the purpose chain.</param>
\r
17 <param name="purposes">The list of purposes which contribute to the purpose chain. This list must
\r
18 contain at least one element, and it may not contain null elements.</param>
\r
19 <returns>An <see cref="T:Microsoft.AspNetCore.DataProtection.IDataProtector"/> tied to the provided purpose chain.</returns>
\r
21 This is a convenience method which chains together several calls to
\r
22 <see cref="M:Microsoft.AspNetCore.DataProtection.IDataProtectionProvider.CreateProtector(System.String)"/>. See that method's
\r
23 documentation for more information.
\r
26 <member name="M:Microsoft.AspNetCore.DataProtection.DataProtectionCommonExtensions.CreateProtector(Microsoft.AspNetCore.DataProtection.IDataProtectionProvider,System.String,System.String[])">
\r
28 Creates an <see cref="T:Microsoft.AspNetCore.DataProtection.IDataProtector"/> given a list of purposes.
\r
30 <param name="provider">The <see cref="T:Microsoft.AspNetCore.DataProtection.IDataProtectionProvider"/> from which to generate the purpose chain.</param>
\r
31 <param name="purpose">The primary purpose used to create the <see cref="T:Microsoft.AspNetCore.DataProtection.IDataProtector"/>.</param>
\r
32 <param name="subPurposes">An optional list of secondary purposes which contribute to the purpose chain.
\r
33 If this list is provided it cannot contain null elements.</param>
\r
34 <returns>An <see cref="T:Microsoft.AspNetCore.DataProtection.IDataProtector"/> tied to the provided purpose chain.</returns>
\r
36 This is a convenience method which chains together several calls to
\r
37 <see cref="M:Microsoft.AspNetCore.DataProtection.IDataProtectionProvider.CreateProtector(System.String)"/>. See that method's
\r
38 documentation for more information.
\r
41 <member name="M:Microsoft.AspNetCore.DataProtection.DataProtectionCommonExtensions.GetDataProtectionProvider(System.IServiceProvider)">
\r
43 Retrieves an <see cref="T:Microsoft.AspNetCore.DataProtection.IDataProtectionProvider"/> from an <see cref="T:System.IServiceProvider"/>.
\r
45 <param name="services">The service provider from which to retrieve the <see cref="T:Microsoft.AspNetCore.DataProtection.IDataProtectionProvider"/>.</param>
\r
46 <returns>An <see cref="T:Microsoft.AspNetCore.DataProtection.IDataProtectionProvider"/>. This method is guaranteed never to return null.</returns>
\r
47 <exception cref="T:System.InvalidOperationException">If no <see cref="T:Microsoft.AspNetCore.DataProtection.IDataProtectionProvider"/> service exists in <paramref name="services"/>.</exception>
\r
49 <member name="M:Microsoft.AspNetCore.DataProtection.DataProtectionCommonExtensions.GetDataProtector(System.IServiceProvider,System.Collections.Generic.IEnumerable{System.String})">
\r
51 Retrieves an <see cref="T:Microsoft.AspNetCore.DataProtection.IDataProtector"/> from an <see cref="T:System.IServiceProvider"/> given a list of purposes.
\r
53 <param name="services">An <see cref="T:System.IServiceProvider"/> which contains the <see cref="T:Microsoft.AspNetCore.DataProtection.IDataProtectionProvider"/>
\r
54 from which to generate the purpose chain.</param>
\r
55 <param name="purposes">The list of purposes which contribute to the purpose chain. This list must
\r
56 contain at least one element, and it may not contain null elements.</param>
\r
57 <returns>An <see cref="T:Microsoft.AspNetCore.DataProtection.IDataProtector"/> tied to the provided purpose chain.</returns>
\r
59 This is a convenience method which calls <see cref="M:Microsoft.AspNetCore.DataProtection.DataProtectionCommonExtensions.GetDataProtectionProvider(System.IServiceProvider)"/>
\r
60 then <see cref="M:Microsoft.AspNetCore.DataProtection.DataProtectionCommonExtensions.CreateProtector(Microsoft.AspNetCore.DataProtection.IDataProtectionProvider,System.Collections.Generic.IEnumerable{System.String})"/>. See those methods'
\r
61 documentation for more information.
\r
64 <member name="M:Microsoft.AspNetCore.DataProtection.DataProtectionCommonExtensions.GetDataProtector(System.IServiceProvider,System.String,System.String[])">
\r
66 Retrieves an <see cref="T:Microsoft.AspNetCore.DataProtection.IDataProtector"/> from an <see cref="T:System.IServiceProvider"/> given a list of purposes.
\r
68 <param name="services">An <see cref="T:System.IServiceProvider"/> which contains the <see cref="T:Microsoft.AspNetCore.DataProtection.IDataProtectionProvider"/>
\r
69 from which to generate the purpose chain.</param>
\r
70 <param name="purpose">The primary purpose used to create the <see cref="T:Microsoft.AspNetCore.DataProtection.IDataProtector"/>.</param>
\r
71 <param name="subPurposes">An optional list of secondary purposes which contribute to the purpose chain.
\r
72 If this list is provided it cannot contain null elements.</param>
\r
73 <returns>An <see cref="T:Microsoft.AspNetCore.DataProtection.IDataProtector"/> tied to the provided purpose chain.</returns>
\r
75 This is a convenience method which calls <see cref="M:Microsoft.AspNetCore.DataProtection.DataProtectionCommonExtensions.GetDataProtectionProvider(System.IServiceProvider)"/>
\r
76 then <see cref="M:Microsoft.AspNetCore.DataProtection.DataProtectionCommonExtensions.CreateProtector(Microsoft.AspNetCore.DataProtection.IDataProtectionProvider,System.String,System.String[])"/>. See those methods'
\r
77 documentation for more information.
\r
80 <member name="M:Microsoft.AspNetCore.DataProtection.DataProtectionCommonExtensions.Protect(Microsoft.AspNetCore.DataProtection.IDataProtector,System.String)">
\r
82 Cryptographically protects a piece of plaintext data.
\r
84 <param name="protector">The data protector to use for this operation.</param>
\r
85 <param name="plaintext">The plaintext data to protect.</param>
\r
86 <returns>The protected form of the plaintext data.</returns>
\r
88 <member name="M:Microsoft.AspNetCore.DataProtection.DataProtectionCommonExtensions.Unprotect(Microsoft.AspNetCore.DataProtection.IDataProtector,System.String)">
\r
90 Cryptographically unprotects a piece of protected data.
\r
92 <param name="protector">The data protector to use for this operation.</param>
\r
93 <param name="protectedData">The protected data to unprotect.</param>
\r
94 <returns>The plaintext form of the protected data.</returns>
\r
95 <exception cref="T:System.Security.Cryptography.CryptographicException">
\r
96 Thrown if <paramref name="protectedData"/> is invalid or malformed.
\r
99 <member name="T:Microsoft.AspNetCore.DataProtection.IDataProtectionProvider">
\r
101 An interface that can be used to create <see cref="T:Microsoft.AspNetCore.DataProtection.IDataProtector"/> instances.
\r
104 <member name="M:Microsoft.AspNetCore.DataProtection.IDataProtectionProvider.CreateProtector(System.String)">
\r
106 Creates an <see cref="T:Microsoft.AspNetCore.DataProtection.IDataProtector"/> given a purpose.
\r
108 <param name="purpose">
\r
109 The purpose to be assigned to the newly-created <see cref="T:Microsoft.AspNetCore.DataProtection.IDataProtector"/>.
\r
111 <returns>An IDataProtector tied to the provided purpose.</returns>
\r
113 The <paramref name="purpose"/> parameter must be unique for the intended use case; two
\r
114 different <see cref="T:Microsoft.AspNetCore.DataProtection.IDataProtector"/> instances created with two different <paramref name="purpose"/>
\r
115 values will not be able to decipher each other's payloads. The <paramref name="purpose"/> parameter
\r
116 value is not intended to be kept secret.
\r
119 <member name="T:Microsoft.AspNetCore.DataProtection.IDataProtector">
\r
121 An interface that can provide data protection services.
\r
124 <member name="M:Microsoft.AspNetCore.DataProtection.IDataProtector.Protect(System.Byte[])">
\r
126 Cryptographically protects a piece of plaintext data.
\r
128 <param name="plaintext">The plaintext data to protect.</param>
\r
129 <returns>The protected form of the plaintext data.</returns>
\r
131 <member name="M:Microsoft.AspNetCore.DataProtection.IDataProtector.Unprotect(System.Byte[])">
\r
133 Cryptographically unprotects a piece of protected data.
\r
135 <param name="protectedData">The protected data to unprotect.</param>
\r
136 <returns>The plaintext form of the protected data.</returns>
\r
137 <exception cref="T:System.Security.Cryptography.CryptographicException">
\r
138 Thrown if the protected data is invalid or malformed.
\r
141 <member name="T:Microsoft.AspNetCore.DataProtection.Infrastructure.IApplicationDiscriminator">
\r
143 Provides information used to discriminate applications.
\r
146 This type supports the data protection system and is not intended to be used
\r
150 <member name="P:Microsoft.AspNetCore.DataProtection.Infrastructure.IApplicationDiscriminator.Discriminator">
\r
152 An identifier that uniquely discriminates this application from all other
\r
153 applications on the machine.
\r
156 <member name="M:Microsoft.AspNetCore.DataProtection.ExceptionExtensions.RequiresHomogenization(System.Exception)">
\r
158 Determines whether an exception must be homogenized by being wrapped inside a
\r
159 CryptographicException before being rethrown.
\r
162 <member name="P:Microsoft.AspNetCore.DataProtection.Abstractions.Resources.CryptCommon_PayloadInvalid">
\r
163 <summary>The payload was invalid.</summary>
\r
165 <member name="P:Microsoft.AspNetCore.DataProtection.Abstractions.Resources.DataProtectionExtensions_NullPurposesCollection">
\r
166 <summary>The purposes collection cannot be null or empty and cannot contain null elements.</summary>
\r
168 <member name="P:Microsoft.AspNetCore.DataProtection.Abstractions.Resources.CryptCommon_GenericError">
\r
169 <summary>An error occurred during a cryptographic operation.</summary>
\r
171 <member name="P:Microsoft.AspNetCore.DataProtection.Abstractions.Resources.DataProtectionExtensions_NoService">
\r
172 <summary>No service for type '{0}' has been registered.</summary>
\r
174 <member name="M:Microsoft.AspNetCore.DataProtection.Abstractions.Resources.FormatDataProtectionExtensions_NoService(System.Object)">
\r
175 <summary>No service for type '{0}' has been registered.</summary>
\r
177 <member name="F:Microsoft.Extensions.WebEncoders.Sources.EncoderResources.WebEncoders_InvalidCountOffsetOrLength">
\r
179 Invalid {0}, {1} or {2} length.
\r
182 <member name="F:Microsoft.Extensions.WebEncoders.Sources.EncoderResources.WebEncoders_MalformedInput">
\r
184 Malformed input: {0} is an invalid input length.
\r
187 <member name="M:Microsoft.Extensions.WebEncoders.Sources.EncoderResources.FormatWebEncoders_InvalidCountOffsetOrLength(System.Object,System.Object,System.Object)">
\r
189 Invalid {0}, {1} or {2} length.
\r
192 <member name="M:Microsoft.Extensions.WebEncoders.Sources.EncoderResources.FormatWebEncoders_MalformedInput(System.Object)">
\r
194 Malformed input: {0} is an invalid input length.
\r
197 <member name="T:Microsoft.Extensions.Internal.WebEncoders">
\r
199 Contains utility APIs to assist with common encoding and decoding operations.
\r
202 <member name="M:Microsoft.Extensions.Internal.WebEncoders.Base64UrlDecode(System.String)">
\r
204 Decodes a base64url-encoded string.
\r
206 <param name="input">The base64url-encoded input to decode.</param>
\r
207 <returns>The base64url-decoded form of the input.</returns>
\r
209 The input must not contain any whitespace or padding characters.
\r
210 Throws <see cref="T:System.FormatException"/> if the input is malformed.
\r
213 <member name="M:Microsoft.Extensions.Internal.WebEncoders.Base64UrlDecode(System.String,System.Int32,System.Int32)">
\r
215 Decodes a base64url-encoded substring of a given string.
\r
217 <param name="input">A string containing the base64url-encoded input to decode.</param>
\r
218 <param name="offset">The position in <paramref name="input"/> at which decoding should begin.</param>
\r
219 <param name="count">The number of characters in <paramref name="input"/> to decode.</param>
\r
220 <returns>The base64url-decoded form of the input.</returns>
\r
222 The input must not contain any whitespace or padding characters.
\r
223 Throws <see cref="T:System.FormatException"/> if the input is malformed.
\r
226 <member name="M:Microsoft.Extensions.Internal.WebEncoders.Base64UrlDecode(System.String,System.Int32,System.Char[],System.Int32,System.Int32)">
\r
228 Decodes a base64url-encoded <paramref name="input"/> into a <c>byte[]</c>.
\r
230 <param name="input">A string containing the base64url-encoded input to decode.</param>
\r
231 <param name="offset">The position in <paramref name="input"/> at which decoding should begin.</param>
\r
232 <param name="buffer">
\r
233 Scratch buffer to hold the <see cref="T:System.Char"/>s to decode. Array must be large enough to hold
\r
234 <paramref name="bufferOffset"/> and <paramref name="count"/> characters as well as Base64 padding
\r
235 characters. Content is not preserved.
\r
237 <param name="bufferOffset">
\r
238 The offset into <paramref name="buffer"/> at which to begin writing the <see cref="T:System.Char"/>s to decode.
\r
240 <param name="count">The number of characters in <paramref name="input"/> to decode.</param>
\r
241 <returns>The base64url-decoded form of the <paramref name="input"/>.</returns>
\r
243 The input must not contain any whitespace or padding characters.
\r
244 Throws <see cref="T:System.FormatException"/> if the input is malformed.
\r
247 <member name="M:Microsoft.Extensions.Internal.WebEncoders.GetArraySizeRequiredToDecode(System.Int32)">
\r
249 Gets the minimum <c>char[]</c> size required for decoding of <paramref name="count"/> characters
\r
250 with the <see cref="M:Microsoft.Extensions.Internal.WebEncoders.Base64UrlDecode(System.String,System.Int32,System.Char[],System.Int32,System.Int32)"/> method.
\r
252 <param name="count">The number of characters to decode.</param>
\r
254 The minimum <c>char[]</c> size required for decoding of <paramref name="count"/> characters.
\r
257 <member name="M:Microsoft.Extensions.Internal.WebEncoders.Base64UrlEncode(System.Byte[])">
\r
259 Encodes <paramref name="input"/> using base64url encoding.
\r
261 <param name="input">The binary input to encode.</param>
\r
262 <returns>The base64url-encoded form of <paramref name="input"/>.</returns>
\r
264 <member name="M:Microsoft.Extensions.Internal.WebEncoders.Base64UrlEncode(System.Byte[],System.Int32,System.Int32)">
\r
266 Encodes <paramref name="input"/> using base64url encoding.
\r
268 <param name="input">The binary input to encode.</param>
\r
269 <param name="offset">The offset into <paramref name="input"/> at which to begin encoding.</param>
\r
270 <param name="count">The number of bytes from <paramref name="input"/> to encode.</param>
\r
271 <returns>The base64url-encoded form of <paramref name="input"/>.</returns>
\r
273 <member name="M:Microsoft.Extensions.Internal.WebEncoders.Base64UrlEncode(System.Byte[],System.Int32,System.Char[],System.Int32,System.Int32)">
\r
275 Encodes <paramref name="input"/> using base64url encoding.
\r
277 <param name="input">The binary input to encode.</param>
\r
278 <param name="offset">The offset into <paramref name="input"/> at which to begin encoding.</param>
\r
279 <param name="output">
\r
280 Buffer to receive the base64url-encoded form of <paramref name="input"/>. Array must be large enough to
\r
281 hold <paramref name="outputOffset"/> characters and the full base64-encoded form of
\r
282 <paramref name="input"/>, including padding characters.
\r
284 <param name="outputOffset">
\r
285 The offset into <paramref name="output"/> at which to begin writing the base64url-encoded form of
\r
286 <paramref name="input"/>.
\r
288 <param name="count">The number of <c>byte</c>s from <paramref name="input"/> to encode.</param>
\r
290 The number of characters written to <paramref name="output"/>, less any padding characters.
\r
293 <member name="M:Microsoft.Extensions.Internal.WebEncoders.GetArraySizeRequiredToEncode(System.Int32)">
\r
295 Get the minimum output <c>char[]</c> size required for encoding <paramref name="count"/>
\r
296 <see cref="T:System.Byte"/>s with the <see cref="M:Microsoft.Extensions.Internal.WebEncoders.Base64UrlEncode(System.Byte[],System.Int32,System.Char[],System.Int32,System.Int32)"/> method.
\r
298 <param name="count">The number of characters to encode.</param>
\r
300 The minimum output <c>char[]</c> size required for encoding <paramref name="count"/> <see cref="T:System.Byte"/>s.
\r
303 <member name="M:Microsoft.Extensions.Internal.WebEncoders.Base64UrlEncode(System.ReadOnlySpan{System.Byte})">
\r
305 Encodes <paramref name="input"/> using base64url encoding.
\r
307 <param name="input">The binary input to encode.</param>
\r
308 <returns>The base64url-encoded form of <paramref name="input"/>.</returns>
\r