You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

452 lines
28 KiB

10 years ago
  1. <?xml version="1.0"?>
  2. <doc>
  3. <assembly>
  4. <name>Microsoft.Owin.Security</name>
  5. </assembly>
  6. <members>
  7. <member name="T:Microsoft.Owin.Security.AppBuilderSecurityExtensions">
  8. <summary>
  9. Provides extensions methods for app.Property values that are only needed by implementations of authentication middleware.
  10. </summary>
  11. </member>
  12. <member name="M:Microsoft.Owin.Security.AppBuilderSecurityExtensions.GetDefaultSignInAsAuthenticationType(Owin.IAppBuilder)">
  13. <summary>
  14. Returns the previously set AuthenticationType that external sign in middleware should use when the
  15. browser navigates back to their return url.
  16. </summary>
  17. <param name="app">App builder passed to the application startup code</param>
  18. <returns></returns>
  19. </member>
  20. <member name="M:Microsoft.Owin.Security.AppBuilderSecurityExtensions.SetDefaultSignInAsAuthenticationType(Owin.IAppBuilder,System.String)">
  21. <summary>
  22. Called by middleware to change the name of the AuthenticationType that external middleware should use
  23. when the browser navigates back to their return url.
  24. </summary>
  25. <param name="app">App builder passed to the application startup code</param>
  26. <param name="authenticationType">AuthenticationType that external middleware should sign in as.</param>
  27. </member>
  28. <member name="T:Microsoft.Owin.Security.AuthenticationMode">
  29. <summary>
  30. Controls the behavior of authentication middleware
  31. </summary>
  32. </member>
  33. <member name="F:Microsoft.Owin.Security.AuthenticationMode.Active">
  34. <summary>
  35. In Active mode the authentication middleware will alter the user identity as the request arrives, and
  36. will also alter a plain 401 as the response leaves.
  37. </summary>
  38. </member>
  39. <member name="F:Microsoft.Owin.Security.AuthenticationMode.Passive">
  40. <summary>
  41. In Passive mode the authentication middleware will only provide user identity when asked, and will only
  42. alter 401 responses where the authentication type named in the extra challenge data.
  43. </summary>
  44. </member>
  45. <member name="T:Microsoft.Owin.Security.AuthenticationOptions">
  46. <summary>
  47. Base Options for all authentication middleware
  48. </summary>
  49. </member>
  50. <member name="M:Microsoft.Owin.Security.AuthenticationOptions.#ctor(System.String)">
  51. <summary>
  52. Initialize properties of AuthenticationOptions base class
  53. </summary>
  54. <param name="authenticationType">Assigned to the AuthenticationType property</param>
  55. </member>
  56. <member name="P:Microsoft.Owin.Security.AuthenticationOptions.AuthenticationType">
  57. <summary>
  58. The AuthenticationType in the options corresponds to the IIdentity AuthenticationType property. A different
  59. value may be assigned in order to use the same authentication middleware type more than once in a pipeline.
  60. </summary>
  61. </member>
  62. <member name="P:Microsoft.Owin.Security.AuthenticationOptions.AuthenticationMode">
  63. <summary>
  64. If Active the authentication middleware alter the request user coming in and
  65. alter 401 Unauthorized responses going out. If Passive the authentication middleware will only provide
  66. identity and alter responses when explicitly indicated by the AuthenticationType.
  67. </summary>
  68. </member>
  69. <member name="P:Microsoft.Owin.Security.AuthenticationOptions.Description">
  70. <summary>
  71. Additional information about the authentication type which is made available to the application.
  72. </summary>
  73. </member>
  74. <member name="T:Microsoft.Owin.Security.Constants">
  75. <summary>
  76. String constants used only by the Security assembly
  77. </summary>
  78. </member>
  79. <member name="F:Microsoft.Owin.Security.Constants.DefaultSignInAsAuthenticationType">
  80. <summary>
  81. Used by middleware extension methods to coordinate the default value Options property SignInAsAuthenticationType
  82. </summary>
  83. </member>
  84. <member name="T:Microsoft.Owin.Security.DataProtection.IDataProtectionProvider">
  85. <summary>
  86. Factory used to create IDataProtection instances
  87. </summary>
  88. </member>
  89. <member name="M:Microsoft.Owin.Security.DataProtection.IDataProtectionProvider.Create(System.String[])">
  90. <summary>
  91. Returns a new instance of IDataProtection for the provider.
  92. </summary>
  93. <param name="purposes">Additional entropy used to ensure protected data may only be unprotected for the correct purposes.</param>
  94. <returns>An instance of a data protection service</returns>
  95. </member>
  96. <member name="T:Microsoft.Owin.Security.DataProtection.IDataProtector">
  97. <summary>
  98. Service used to protect and unprotect data
  99. </summary>
  100. </member>
  101. <member name="M:Microsoft.Owin.Security.DataProtection.IDataProtector.Protect(System.Byte[])">
  102. <summary>
  103. Called to protect user data.
  104. </summary>
  105. <param name="userData">The original data that must be protected</param>
  106. <returns>A different byte array that may be unprotected or altered only by software that has access to
  107. the an identical IDataProtection service.</returns>
  108. </member>
  109. <member name="M:Microsoft.Owin.Security.DataProtection.IDataProtector.Unprotect(System.Byte[])">
  110. <summary>
  111. Called to unprotect user data
  112. </summary>
  113. <param name="protectedData">The byte array returned by a call to Protect on an identical IDataProtection service.</param>
  114. <returns>The byte array identical to the original userData passed to Protect.</returns>
  115. </member>
  116. <member name="T:Microsoft.Owin.Security.Infrastructure.AuthenticationHandler`1">
  117. <summary>
  118. Base class for the per-request work performed by most authentication middleware.
  119. </summary>
  120. <typeparam name="TOptions">Specifies which type for of AuthenticationOptions property</typeparam>
  121. </member>
  122. <member name="T:Microsoft.Owin.Security.Infrastructure.AuthenticationHandler">
  123. <summary>
  124. Base class for the per-request work performed by most authentication middleware.
  125. </summary>
  126. </member>
  127. <member name="M:Microsoft.Owin.Security.Infrastructure.AuthenticationHandler.TeardownAsync">
  128. <summary>
  129. Called once per request after Initialize and Invoke.
  130. </summary>
  131. <returns>async completion</returns>
  132. </member>
  133. <member name="M:Microsoft.Owin.Security.Infrastructure.AuthenticationHandler.InvokeAsync">
  134. <summary>
  135. Called once by common code after initialization. If an authentication middleware responds directly to
  136. specifically known paths it must override this virtual, compare the request path to it's known paths,
  137. provide any response information as appropriate, and true to stop further processing.
  138. </summary>
  139. <returns>Returning false will cause the common code to call the next middleware in line. Returning true will
  140. cause the common code to begin the async completion journey without calling the rest of the middleware
  141. pipeline.</returns>
  142. </member>
  143. <member name="M:Microsoft.Owin.Security.Infrastructure.AuthenticationHandler.AuthenticateAsync">
  144. <summary>
  145. Causes the authentication logic in AuthenticateCore to be performed for the current request
  146. at most once and returns the results. Calling Authenticate more than once will always return
  147. the original value.
  148. This method should always be called instead of calling AuthenticateCore directly.
  149. </summary>
  150. <returns>The ticket data provided by the authentication logic</returns>
  151. </member>
  152. <member name="M:Microsoft.Owin.Security.Infrastructure.AuthenticationHandler.AuthenticateCoreAsync">
  153. <summary>
  154. The core authentication logic which must be provided by the handler. Will be invoked at most
  155. once per request. Do not call directly, call the wrapping Authenticate method instead.
  156. </summary>
  157. <returns>The ticket data provided by the authentication logic</returns>
  158. </member>
  159. <member name="M:Microsoft.Owin.Security.Infrastructure.AuthenticationHandler.ApplyResponseAsync">
  160. <summary>
  161. Causes the ApplyResponseCore to be invoked at most once per request. This method will be
  162. invoked either earlier, when the response headers are sent as a result of a response write or flush,
  163. or later, as the last step when the original async call to the middleware is returning.
  164. </summary>
  165. <returns></returns>
  166. </member>
  167. <member name="M:Microsoft.Owin.Security.Infrastructure.AuthenticationHandler.ApplyResponseCoreAsync">
  168. <summary>
  169. Core method that may be overridden by handler. The default behavior is to call two common response
  170. activities, one that deals with sign-in/sign-out concerns, and a second to deal with 401 challenges.
  171. </summary>
  172. <returns></returns>
  173. </member>
  174. <member name="M:Microsoft.Owin.Security.Infrastructure.AuthenticationHandler.ApplyResponseGrantAsync">
  175. <summary>
  176. Override this method to dela with sign-in/sign-out concerns, if an authentication scheme in question
  177. deals with grant/revoke as part of it's request flow. (like setting/deleting cookies)
  178. </summary>
  179. <returns></returns>
  180. </member>
  181. <member name="M:Microsoft.Owin.Security.Infrastructure.AuthenticationHandler.ApplyResponseChallengeAsync">
  182. <summary>
  183. Override this method to dela with 401 challenge concerns, if an authentication scheme in question
  184. deals an authentication interaction as part of it's request flow. (like adding a response header, or
  185. changing the 401 result to 302 of a login page or external sign-in location.)
  186. </summary>
  187. <returns></returns>
  188. </member>
  189. <member name="M:Microsoft.Owin.Security.Infrastructure.AuthenticationHandler`1.Initialize(`0,Microsoft.Owin.IOwinContext)">
  190. <summary>
  191. Initialize is called once per request to contextualize this instance with appropriate state.
  192. </summary>
  193. <param name="options">The original options passed by the application control behavior</param>
  194. <param name="context">The utility object to observe the current request and response</param>
  195. <returns>async completion</returns>
  196. </member>
  197. <member name="T:Microsoft.Owin.Security.AuthenticationTicket">
  198. <summary>
  199. Contains user identity information as well as additional authentication state.
  200. </summary>
  201. </member>
  202. <member name="M:Microsoft.Owin.Security.AuthenticationTicket.#ctor(System.Security.Claims.ClaimsIdentity,Microsoft.Owin.Security.AuthenticationProperties)">
  203. <summary>
  204. Initializes a new instance of the <see cref="T:Microsoft.Owin.Security.AuthenticationTicket"/> class
  205. </summary>
  206. <param name="identity"></param>
  207. <param name="properties"></param>
  208. </member>
  209. <member name="P:Microsoft.Owin.Security.AuthenticationTicket.Identity">
  210. <summary>
  211. Gets the authenticated user identity.
  212. </summary>
  213. </member>
  214. <member name="P:Microsoft.Owin.Security.AuthenticationTicket.Properties">
  215. <summary>
  216. Additional state values for the authentication session.
  217. </summary>
  218. </member>
  219. <member name="T:Microsoft.Owin.Security.ICertificateValidator">
  220. <summary>
  221. Interface for providing pinned certificate validation, which checks HTTPS
  222. communication against a known good list of certificates to protect against
  223. compromised or rogue CAs issuing certificates for hosts without the
  224. knowledge of the host owner.
  225. </summary>
  226. </member>
  227. <member name="M:Microsoft.Owin.Security.ICertificateValidator.Validate(System.Object,System.Security.Cryptography.X509Certificates.X509Certificate,System.Security.Cryptography.X509Certificates.X509Chain,System.Net.Security.SslPolicyErrors)">
  228. <summary>
  229. Verifies the remote Secure Sockets Layer (SSL) certificate used for authentication.
  230. </summary>
  231. <param name="sender">An object that contains state information for this validation.</param>
  232. <param name="certificate">The certificate used to authenticate the remote party.</param>
  233. <param name="chain">The chain of certificate authorities associated with the remote certificate.</param>
  234. <param name="sslPolicyErrors">One or more errors associated with the remote certificate.</param>
  235. <returns>A Boolean value that determines whether the specified certificate is accepted for authentication.</returns>
  236. </member>
  237. <member name="T:Microsoft.Owin.Security.CertificateThumbprintValidator">
  238. <summary>
  239. Provides pinned certificate validation based on the certificate thumbprint.
  240. </summary>
  241. </member>
  242. <member name="M:Microsoft.Owin.Security.CertificateThumbprintValidator.#ctor(System.Collections.Generic.IEnumerable{System.String})">
  243. <summary>
  244. Initializes a new instance of the <see cref="T:Microsoft.Owin.Security.CertificateThumbprintValidator"/> class.
  245. </summary>
  246. <param name="validThumbprints">A set of thumbprints which are valid for an HTTPS request.</param>
  247. </member>
  248. <member name="M:Microsoft.Owin.Security.CertificateThumbprintValidator.Validate(System.Object,System.Security.Cryptography.X509Certificates.X509Certificate,System.Security.Cryptography.X509Certificates.X509Chain,System.Net.Security.SslPolicyErrors)">
  249. <summary>
  250. Validates that the certificate thumbprints in the signing chain match at least one whitelisted thumbprint.
  251. </summary>
  252. <param name="sender">An object that contains state information for this validation.</param>
  253. <param name="certificate">The certificate used to authenticate the remote party.</param>
  254. <param name="chain">The chain of certificate authorities associated with the remote certificate.</param>
  255. <param name="sslPolicyErrors">One or more errors associated with the remote certificate.</param>
  256. <returns>A Boolean value that determines whether the specified certificate is accepted for authentication.</returns>
  257. </member>
  258. <member name="T:Microsoft.Owin.Security.DataProtection.DpapiDataProtectionProvider">
  259. <summary>
  260. Used to provide the data protection services that are derived from the Data Protection API. It is the best choice of
  261. data protection when you application is not hosted by ASP.NET and all processes are running as the same domain identity.
  262. </summary>
  263. </member>
  264. <member name="M:Microsoft.Owin.Security.DataProtection.DpapiDataProtectionProvider.#ctor">
  265. <summary>
  266. Initializes a new DpapiDataProtectionProvider with a random application
  267. name. This is only useful to protect data for the duration of the
  268. current application execution.
  269. </summary>
  270. </member>
  271. <member name="M:Microsoft.Owin.Security.DataProtection.DpapiDataProtectionProvider.#ctor(System.String)">
  272. <summary>
  273. Initializes a new DpapiDataProtectionProvider which uses the given
  274. appName as part of the protection algorithm
  275. </summary>
  276. <param name="appName">A user provided value needed to round-trip secured
  277. data. The default value comes from the IAppBuilder.Properties["owin.AppName"]
  278. when self-hosted.</param>
  279. </member>
  280. <member name="M:Microsoft.Owin.Security.DataProtection.DpapiDataProtectionProvider.Create(System.String[])">
  281. <summary>
  282. Returns a new instance of IDataProtection for the provider.
  283. </summary>
  284. <param name="purposes">Additional entropy used to ensure protected data may only be unprotected for the correct purposes.</param>
  285. <returns>An instance of a data protection service</returns>
  286. </member>
  287. <member name="T:Microsoft.Owin.Security.Infrastructure.SecurityHelper">
  288. <summary>
  289. Helper code used when implementing authentication middleware
  290. </summary>
  291. </member>
  292. <member name="M:Microsoft.Owin.Security.Infrastructure.SecurityHelper.#ctor(Microsoft.Owin.IOwinContext)">
  293. <summary>
  294. Helper code used when implementing authentication middleware
  295. </summary>
  296. <param name="context"></param>
  297. </member>
  298. <member name="M:Microsoft.Owin.Security.Infrastructure.SecurityHelper.AddUserIdentity(System.Security.Principal.IIdentity)">
  299. <summary>
  300. Add an additional ClaimsIdentity to the ClaimsPrincipal in the "server.User" environment key
  301. </summary>
  302. <param name="identity"></param>
  303. </member>
  304. <member name="M:Microsoft.Owin.Security.Infrastructure.SecurityHelper.LookupChallenge(System.String,Microsoft.Owin.Security.AuthenticationMode)">
  305. <summary>
  306. Find response challenge details for a specific authentication middleware
  307. </summary>
  308. <param name="authenticationType">The authentication type to look for</param>
  309. <param name="authenticationMode">The authentication mode the middleware is running under</param>
  310. <returns>The information instructing the middleware how it should behave</returns>
  311. </member>
  312. <member name="M:Microsoft.Owin.Security.Infrastructure.SecurityHelper.LookupSignIn(System.String)">
  313. <summary>
  314. Find response sign-in details for a specific authentication middleware
  315. </summary>
  316. <param name="authenticationType">The authentication type to look for</param>
  317. <returns>The information instructing the middleware how it should behave</returns>
  318. </member>
  319. <member name="M:Microsoft.Owin.Security.Infrastructure.SecurityHelper.LookupSignOut(System.String,Microsoft.Owin.Security.AuthenticationMode)">
  320. <summary>
  321. Find response sign-out details for a specific authentication middleware
  322. </summary>
  323. <param name="authenticationType">The authentication type to look for</param>
  324. <param name="authenticationMode">The authentication mode the middleware is running under</param>
  325. <returns>The information instructing the middleware how it should behave</returns>
  326. </member>
  327. <member name="T:Microsoft.Owin.Security.Provider.BaseContext`1">
  328. <summary>
  329. Base class used for certain event contexts
  330. </summary>
  331. </member>
  332. <member name="T:Microsoft.Owin.Security.Provider.EndpointContext`1">
  333. <summary>
  334. Base class used for certain event contexts
  335. </summary>
  336. </member>
  337. <member name="M:Microsoft.Owin.Security.Provider.EndpointContext`1.#ctor(Microsoft.Owin.IOwinContext,`0)">
  338. <summary>
  339. Creates an instance of this context
  340. </summary>
  341. </member>
  342. <member name="M:Microsoft.Owin.Security.Provider.EndpointContext`1.RequestCompleted">
  343. <summary>
  344. Prevents the request from being processed further by other components.
  345. IsRequestCompleted becomes true after calling.
  346. </summary>
  347. </member>
  348. <member name="P:Microsoft.Owin.Security.Provider.EndpointContext`1.IsRequestCompleted">
  349. <summary>
  350. True if the request should not be processed further by other components.
  351. </summary>
  352. </member>
  353. <member name="T:Microsoft.Owin.Security.Resources">
  354. <summary>
  355. A strongly-typed resource class, for looking up localized strings, etc.
  356. </summary>
  357. </member>
  358. <member name="P:Microsoft.Owin.Security.Resources.ResourceManager">
  359. <summary>
  360. Returns the cached ResourceManager instance used by this class.
  361. </summary>
  362. </member>
  363. <member name="P:Microsoft.Owin.Security.Resources.Culture">
  364. <summary>
  365. Overrides the current thread's CurrentUICulture property for all
  366. resource lookups using this strongly typed resource class.
  367. </summary>
  368. </member>
  369. <member name="P:Microsoft.Owin.Security.Resources.Exception_AuthenticationTokenDoesNotProvideSyncMethods">
  370. <summary>
  371. Looks up a localized string similar to The AuthenticationTokenProvider&apos;s required synchronous events have not been registered..
  372. </summary>
  373. </member>
  374. <member name="P:Microsoft.Owin.Security.Resources.Exception_DefaultDpapiRequiresAppNameKey">
  375. <summary>
  376. Looks up a localized string similar to The default data protection provider may only be used when the IAppBuilder.Properties contains an appropriate &apos;host.AppName&apos; key..
  377. </summary>
  378. </member>
  379. <member name="P:Microsoft.Owin.Security.Resources.Exception_MissingDefaultSignInAsAuthenticationType">
  380. <summary>
  381. Looks up a localized string similar to A default value for SignInAsAuthenticationType was not found in IAppBuilder Properties. This can happen if your authentication middleware are added in the wrong order, or if one is missing..
  382. </summary>
  383. </member>
  384. <member name="P:Microsoft.Owin.Security.Resources.Exception_UnhookAuthenticationStateType">
  385. <summary>
  386. Looks up a localized string similar to The state passed to UnhookAuthentication may only be the return value from HookAuthentication..
  387. </summary>
  388. </member>
  389. <member name="T:Microsoft.Owin.Security.CertificateSubjectKeyIdentifierValidator">
  390. <summary>
  391. Provides pinned certificate validation based on the subject key identifier of the certificate.
  392. </summary>
  393. </member>
  394. <member name="M:Microsoft.Owin.Security.CertificateSubjectKeyIdentifierValidator.#ctor(System.Collections.Generic.IEnumerable{System.String})">
  395. <summary>
  396. Initializes a new instance of the <see cref="T:Microsoft.Owin.Security.CertificateSubjectKeyIdentifierValidator"/> class.
  397. </summary>
  398. <param name="validSubjectKeyIdentifiers">A set of subject key identifiers which are valid for an HTTPS request.</param>
  399. </member>
  400. <member name="M:Microsoft.Owin.Security.CertificateSubjectKeyIdentifierValidator.Validate(System.Object,System.Security.Cryptography.X509Certificates.X509Certificate,System.Security.Cryptography.X509Certificates.X509Chain,System.Net.Security.SslPolicyErrors)">
  401. <summary>
  402. Verifies the remote Secure Sockets Layer (SSL) certificate used for authentication.
  403. </summary>
  404. <param name="sender">An object that contains state information for this validation.</param>
  405. <param name="certificate">The certificate used to authenticate the remote party.</param>
  406. <param name="chain">The chain of certificate authorities associated with the remote certificate.</param>
  407. <param name="sslPolicyErrors">One or more errors associated with the remote certificate.</param>
  408. <returns>A Boolean value that determines whether the specified certificate is accepted for authentication.</returns>
  409. </member>
  410. <member name="T:Microsoft.Owin.Security.SubjectPublicKeyInfoAlgorithm">
  411. <summary>
  412. The algorithm used to generate the subject public key information blob hashes.
  413. </summary>
  414. </member>
  415. <member name="T:Microsoft.Owin.Security.CertificateSubjectPublicKeyInfoValidator">
  416. <summary>
  417. Implements a cert pinning validator passed on
  418. http://datatracker.ietf.org/doc/draft-ietf-websec-key-pinning/?include_text=1
  419. </summary>
  420. </member>
  421. <member name="M:Microsoft.Owin.Security.CertificateSubjectPublicKeyInfoValidator.#ctor(System.Collections.Generic.IEnumerable{System.String},Microsoft.Owin.Security.SubjectPublicKeyInfoAlgorithm)">
  422. <summary>
  423. Initializes a new instance of the <see cref="T:Microsoft.Owin.Security.CertificateSubjectPublicKeyInfoValidator"/> class.
  424. </summary>
  425. <param name="validBase64EncodedSubjectPublicKeyInfoHashes">A collection of valid base64 encoded hashes of the certificate public key information blob.</param>
  426. <param name="algorithm">The algorithm used to generate the hashes.</param>
  427. </member>
  428. <member name="M:Microsoft.Owin.Security.CertificateSubjectPublicKeyInfoValidator.Validate(System.Object,System.Security.Cryptography.X509Certificates.X509Certificate,System.Security.Cryptography.X509Certificates.X509Chain,System.Net.Security.SslPolicyErrors)">
  429. <summary>
  430. Validates at least one SPKI hash is known.
  431. </summary>
  432. <param name="sender">An object that contains state information for this validation.</param>
  433. <param name="certificate">The certificate used to authenticate the remote party.</param>
  434. <param name="chain">The chain of certificate authorities associated with the remote certificate.</param>
  435. <param name="sslPolicyErrors">One or more errors associated with the remote certificate.</param>
  436. <returns>A Boolean value that determines whether the specified certificate is accepted for authentication.</returns>
  437. </member>
  438. <member name="M:Microsoft.Win32.NativeMethods.CryptEncodeObject(System.UInt32,System.IntPtr,Microsoft.Win32.NativeMethods.CERT_PUBLIC_KEY_INFO@,System.Byte[],System.UInt32@)">
  439. <summary>
  440. Encodes a structure of the type indicated by the value of the lpszStructType parameter.
  441. </summary>
  442. <param name="dwCertEncodingType">Type of encoding used.</param>
  443. <param name="lpszStructType">The high-order word is zero, the low-order word specifies the integer identifier for the type of the specified structure so
  444. we can use the constants in http://msdn.microsoft.com/en-us/library/windows/desktop/aa378145%28v=vs.85%29.aspx</param>
  445. <param name="pvStructInfo">A pointer to the structure to be encoded.</param>
  446. <param name="pbEncoded">A pointer to a buffer to receive the encoded structure. This parameter can be NULL to retrieve the size of this information for memory allocation purposes.</param>
  447. <param name="pcbEncoded">A pointer to a DWORD variable that contains the size, in bytes, of the buffer pointed to by the pbEncoded parameter.</param>
  448. <returns></returns>
  449. </member>
  450. </members>
  451. </doc>