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.

310 lines
20 KiB

3 years ago
  1. <?xml version="1.0"?>
  2. <doc>
  3. <assembly>
  4. <name>Microsoft.IdentityModel.Protocols</name>
  5. </assembly>
  6. <members>
  7. <member name="T:Microsoft.IdentityModel.Protocols.AuthenticationProtocolMessage">
  8. <summary>
  9. base class for authentication protocol messages.
  10. </summary>
  11. </member>
  12. <member name="M:Microsoft.IdentityModel.Protocols.AuthenticationProtocolMessage.#ctor">
  13. <summary>
  14. Initializes a default instance of the <see cref="T:Microsoft.IdentityModel.Protocols.AuthenticationProtocolMessage"/> class.
  15. </summary>
  16. </member>
  17. <member name="M:Microsoft.IdentityModel.Protocols.AuthenticationProtocolMessage.BuildFormPost">
  18. <summary>
  19. Builds a form post using the current IssuerAddress and the parameters that have been set.
  20. </summary>
  21. <returns>html with head set to 'Title', body containing a hiden from with action = IssuerAddress.</returns>
  22. </member>
  23. <member name="M:Microsoft.IdentityModel.Protocols.AuthenticationProtocolMessage.BuildRedirectUrl">
  24. <summary>
  25. Builds a Url using the current IssuerAddress and the parameters that have been set.
  26. </summary>
  27. <returns>UrlEncoded string.</returns>
  28. <remarks>Each parameter &lt;Key, Value&gt; is first transformed using <see cref="M:System.Uri.EscapeDataString(System.String)"/>.</remarks>
  29. </member>
  30. <member name="M:Microsoft.IdentityModel.Protocols.AuthenticationProtocolMessage.GetParameter(System.String)">
  31. <summary>
  32. Returns a parameter.
  33. </summary>
  34. <param name="parameter">The parameter name.</param>
  35. <returns>The value of the parameter or null if the parameter does not exists.</returns>
  36. <exception cref="T:System.ArgumentNullException">If parameter is null</exception>
  37. </member>
  38. <member name="P:Microsoft.IdentityModel.Protocols.AuthenticationProtocolMessage.IssuerAddress">
  39. <summary>
  40. Gets or sets the issuer address.
  41. </summary>
  42. <exception cref="T:System.ArgumentNullException">If the 'value' is null.</exception>
  43. </member>
  44. <member name="P:Microsoft.IdentityModel.Protocols.AuthenticationProtocolMessage.Parameters">
  45. <summary>
  46. Gets the message parameters as a Dictionary.
  47. </summary>
  48. </member>
  49. <member name="P:Microsoft.IdentityModel.Protocols.AuthenticationProtocolMessage.PostTitle">
  50. <summary>
  51. Gets or sets the title used when constructing the post string.
  52. </summary>
  53. <exception cref="T:System.ArgumentNullException">If the 'value' is null.</exception>
  54. </member>
  55. <member name="M:Microsoft.IdentityModel.Protocols.AuthenticationProtocolMessage.RemoveParameter(System.String)">
  56. <summary>
  57. Removes a parameter.
  58. </summary>
  59. <param name="parameter">The parameter name.</param>
  60. <exception cref="T:System.ArgumentNullException">If 'parameter' is null or empty.</exception>
  61. </member>
  62. <member name="M:Microsoft.IdentityModel.Protocols.AuthenticationProtocolMessage.SetParameter(System.String,System.String)">
  63. <summary>
  64. Sets a parameter to the Parameters Dictionary.
  65. </summary>
  66. <param name="parameter">The parameter name.</param>
  67. <param name="value">The value to be assigned to parameter.</param>
  68. <exception cref="T:System.ArgumentNullException">If 'parameterName' is null or empty.</exception>
  69. <remarks>If null is passed as value and the parameter exists, that parameter is removed.</remarks>
  70. </member>
  71. <member name="M:Microsoft.IdentityModel.Protocols.AuthenticationProtocolMessage.SetParameters(System.Collections.Specialized.NameValueCollection)">
  72. <summary>
  73. Sets a collection parameters.
  74. </summary>
  75. <param name="nameValueCollection"></param>
  76. </member>
  77. <member name="P:Microsoft.IdentityModel.Protocols.AuthenticationProtocolMessage.ScriptButtonText">
  78. <summary>
  79. Gets or sets the script button text used when constructing the post string.
  80. </summary>
  81. <exception cref="T:System.ArgumentNullException">If the 'value' is null.</exception>
  82. </member>
  83. <member name="P:Microsoft.IdentityModel.Protocols.AuthenticationProtocolMessage.ScriptDisabledText">
  84. <summary>
  85. Gets or sets the text used when constructing the post string that will be displayed to used if script is disabled.
  86. </summary>
  87. <exception cref="T:System.ArgumentNullException">If the 'value' is null.</exception>
  88. </member>
  89. <member name="T:Microsoft.IdentityModel.Protocols.ConfigurationManager`1">
  90. <summary>
  91. Manages the retrieval of Configuration data.
  92. </summary>
  93. <typeparam name="T">The type of <see cref="T:Microsoft.IdentityModel.Protocols.IDocumentRetriever"/>.</typeparam>
  94. </member>
  95. <member name="F:Microsoft.IdentityModel.Protocols.ConfigurationManager`1.DefaultAutomaticRefreshInterval">
  96. <summary>
  97. 1 day is the default time interval that afterwards, <see cref="M:Microsoft.IdentityModel.Protocols.ConfigurationManager`1.GetConfigurationAsync"/> will obtain new configuration.
  98. </summary>
  99. </member>
  100. <member name="F:Microsoft.IdentityModel.Protocols.ConfigurationManager`1.DefaultRefreshInterval">
  101. <summary>
  102. 30 seconds is the default time interval that must pass for <see cref="M:Microsoft.IdentityModel.Protocols.ConfigurationManager`1.RequestRefresh"/> to obtain a new configuration.
  103. </summary>
  104. </member>
  105. <member name="F:Microsoft.IdentityModel.Protocols.ConfigurationManager`1.MinimumAutomaticRefreshInterval">
  106. <summary>
  107. 5 minutes is the minimum value for automatic refresh. <see cref="P:Microsoft.IdentityModel.Protocols.ConfigurationManager`1.AutomaticRefreshInterval"/> can not be set less than this value.
  108. </summary>
  109. </member>
  110. <member name="F:Microsoft.IdentityModel.Protocols.ConfigurationManager`1.MinimumRefreshInterval">
  111. <summary>
  112. 1 second is the minimum time interval that must pass for <see cref="M:Microsoft.IdentityModel.Protocols.ConfigurationManager`1.RequestRefresh"/> to obtain new configuration.
  113. </summary>
  114. </member>
  115. <member name="M:Microsoft.IdentityModel.Protocols.ConfigurationManager`1.#cctor">
  116. <summary>
  117. Static initializer for a new object. Static initializers run before the first instance of the type is created.
  118. </summary>
  119. </member>
  120. <member name="M:Microsoft.IdentityModel.Protocols.ConfigurationManager`1.#ctor(System.String,Microsoft.IdentityModel.Protocols.IConfigurationRetriever{`0})">
  121. <summary>
  122. Instantiaties a new <see cref="T:Microsoft.IdentityModel.Protocols.ConfigurationManager`1"/> that manages automatic and controls refreshing on configuration data.
  123. </summary>
  124. <param name="metadataAddress">The address to obtain configuration.</param>
  125. <param name="configRetriever">The <see cref="T:Microsoft.IdentityModel.Protocols.IConfigurationRetriever`1"/></param>
  126. </member>
  127. <member name="M:Microsoft.IdentityModel.Protocols.ConfigurationManager`1.#ctor(System.String,Microsoft.IdentityModel.Protocols.IConfigurationRetriever{`0},System.Net.Http.HttpClient)">
  128. <summary>
  129. Instantiaties a new <see cref="T:Microsoft.IdentityModel.Protocols.ConfigurationManager`1"/> that manages automatic and controls refreshing on configuration data.
  130. </summary>
  131. <param name="metadataAddress">The address to obtain configuration.</param>
  132. <param name="configRetriever">The <see cref="T:Microsoft.IdentityModel.Protocols.IConfigurationRetriever`1"/></param>
  133. <param name="httpClient">The client to use when obtaining configuration.</param>
  134. </member>
  135. <member name="M:Microsoft.IdentityModel.Protocols.ConfigurationManager`1.#ctor(System.String,Microsoft.IdentityModel.Protocols.IConfigurationRetriever{`0},Microsoft.IdentityModel.Protocols.IDocumentRetriever)">
  136. <summary>
  137. Instantiaties a new <see cref="T:Microsoft.IdentityModel.Protocols.ConfigurationManager`1"/> that manages automatic and controls refreshing on configuration data.
  138. </summary>
  139. <param name="metadataAddress">The address to obtain configuration.</param>
  140. <param name="configRetriever">The <see cref="T:Microsoft.IdentityModel.Protocols.IConfigurationRetriever`1"/></param>
  141. <param name="docRetriever">The <see cref="T:Microsoft.IdentityModel.Protocols.IDocumentRetriever"/> that reaches out to obtain the configuration.</param>
  142. <exception cref="T:System.ArgumentNullException">If 'metadataAddress' is null or empty.</exception>
  143. <exception cref="T:System.ArgumentNullException">If 'configRetriever' is null.</exception>
  144. <exception cref="T:System.ArgumentNullException">If 'docRetriever' is null.</exception>
  145. </member>
  146. <member name="P:Microsoft.IdentityModel.Protocols.ConfigurationManager`1.AutomaticRefreshInterval">
  147. <summary>
  148. Gets or sets the <see cref="T:System.TimeSpan"/> that controls how often an automatic metadata refresh should occur.
  149. </summary>
  150. </member>
  151. <member name="P:Microsoft.IdentityModel.Protocols.ConfigurationManager`1.RefreshInterval">
  152. <summary>
  153. The minimum time between retrievals, in the event that a retrieval failed, or that a refresh was explicitly requested.
  154. </summary>
  155. </member>
  156. <member name="M:Microsoft.IdentityModel.Protocols.ConfigurationManager`1.GetConfigurationAsync">
  157. <summary>
  158. Obtains an updated version of Configuration.
  159. </summary>
  160. <returns>Configuration of type T.</returns>
  161. <remarks>If the time since the last call is less than <see cref="P:Microsoft.IdentityModel.Protocols.ConfigurationManager`1.AutomaticRefreshInterval"/> then <see cref="M:Microsoft.IdentityModel.Protocols.IConfigurationRetriever`1.GetConfigurationAsync(System.String,Microsoft.IdentityModel.Protocols.IDocumentRetriever,System.Threading.CancellationToken)"/> is not called and the current Configuration is returned.</remarks>
  162. </member>
  163. <member name="M:Microsoft.IdentityModel.Protocols.ConfigurationManager`1.GetConfigurationAsync(System.Threading.CancellationToken)">
  164. <summary>
  165. Obtains an updated version of Configuration.
  166. </summary>
  167. <param name="cancel">CancellationToken</param>
  168. <returns>Configuration of type T.</returns>
  169. <remarks>If the time since the last call is less than <see cref="P:Microsoft.IdentityModel.Protocols.ConfigurationManager`1.AutomaticRefreshInterval"/> then <see cref="M:Microsoft.IdentityModel.Protocols.IConfigurationRetriever`1.GetConfigurationAsync(System.String,Microsoft.IdentityModel.Protocols.IDocumentRetriever,System.Threading.CancellationToken)"/> is not called and the current Configuration is returned.</remarks>
  170. </member>
  171. <member name="M:Microsoft.IdentityModel.Protocols.ConfigurationManager`1.RequestRefresh">
  172. <summary>
  173. Requests that then next call to <see cref="M:Microsoft.IdentityModel.Protocols.ConfigurationManager`1.GetConfigurationAsync"/> obtain new configuration.
  174. <para>If the last refresh was greater than <see cref="P:Microsoft.IdentityModel.Protocols.ConfigurationManager`1.RefreshInterval"/> then the next call to <see cref="M:Microsoft.IdentityModel.Protocols.ConfigurationManager`1.GetConfigurationAsync"/> will retrieve new configuration.</para>
  175. <para>If <see cref="P:Microsoft.IdentityModel.Protocols.ConfigurationManager`1.RefreshInterval"/> == <see cref="F:System.TimeSpan.MaxValue"/> then this method does nothing.</para>
  176. </summary>
  177. </member>
  178. <member name="T:Microsoft.IdentityModel.Protocols.FileDocumentRetriever">
  179. <summary>
  180. Reads a local file from the disk.
  181. </summary>
  182. </member>
  183. <member name="M:Microsoft.IdentityModel.Protocols.FileDocumentRetriever.#ctor">
  184. <summary>
  185. Initializes a new instance of the <see cref="T:Microsoft.IdentityModel.Protocols.FileDocumentRetriever"/> class.
  186. </summary>
  187. </member>
  188. <member name="M:Microsoft.IdentityModel.Protocols.FileDocumentRetriever.GetDocumentAsync(System.String,System.Threading.CancellationToken)">
  189. <summary>
  190. Reads a document using <see cref="T:System.IO.FileStream"/>.
  191. </summary>
  192. <param name="address">Fully qualified path to a file.</param>
  193. <param name="cancel"><see cref="T:System.Threading.CancellationToken"/> not used.</param>
  194. <returns>UTF8 decoding of bytes in the file.</returns>
  195. <exception cref="T:System.ArgumentNullException">If address is null or whitespace.</exception>
  196. <exception cref="T:System.IO.IOException">with inner expection containing the original exception.</exception>
  197. </member>
  198. <member name="T:Microsoft.IdentityModel.Protocols.HttpDocumentRetriever">
  199. <summary>
  200. Retrieves metadata information using HttpClient.
  201. </summary>
  202. </member>
  203. <member name="M:Microsoft.IdentityModel.Protocols.HttpDocumentRetriever.#ctor">
  204. <summary>
  205. Initializes a new instance of the <see cref="T:Microsoft.IdentityModel.Protocols.HttpDocumentRetriever"/> class.
  206. </summary>
  207. </member>
  208. <member name="M:Microsoft.IdentityModel.Protocols.HttpDocumentRetriever.#ctor(System.Net.Http.HttpClient)">
  209. <summary>
  210. Initializes a new instance of the <see cref="T:Microsoft.IdentityModel.Protocols.HttpDocumentRetriever"/> class with a specified httpClient.
  211. </summary>
  212. <param name="httpClient"><see cref="T:System.Net.Http.HttpClient"/></param>
  213. <exception cref="T:System.ArgumentNullException">'httpClient' is null.</exception>
  214. </member>
  215. <member name="P:Microsoft.IdentityModel.Protocols.HttpDocumentRetriever.RequireHttps">
  216. <summary>
  217. Requires Https secure channel for sending requests.. This is turned ON by default for security reasons. It is RECOMMENDED that you do not allow retrieval from http addresses by default.
  218. </summary>
  219. </member>
  220. <member name="M:Microsoft.IdentityModel.Protocols.HttpDocumentRetriever.GetDocumentAsync(System.String,System.Threading.CancellationToken)">
  221. <summary>
  222. Returns a task which contains a string converted from remote document when completed, by using the provided address.
  223. </summary>
  224. <param name="address">Location of document</param>
  225. <param name="cancel">A cancellation token that can be used by other objects or threads to receive notice of cancellation. <see cref="T:System.Threading.CancellationToken"/></param>
  226. <returns>Document as a string</returns>
  227. </member>
  228. <member name="T:Microsoft.IdentityModel.Protocols.IConfigurationManager`1">
  229. <summary>
  230. Interface that defines a model for retrieving configuration data.
  231. </summary>
  232. <typeparam name="T">The type of <see cref="T:Microsoft.IdentityModel.Protocols.IDocumentRetriever"/>.</typeparam>
  233. </member>
  234. <member name="M:Microsoft.IdentityModel.Protocols.IConfigurationManager`1.GetConfigurationAsync(System.Threading.CancellationToken)">
  235. <summary>
  236. Retrieve the current configuration, refreshing and/or caching as needed.
  237. This method will throw if the configuration cannot be retrieved, instead of returning null.
  238. </summary>
  239. <param name="cancel"><see cref="T:System.Threading.CancellationToken"/></param>
  240. <returns><see cref="T:System.Threading.Tasks.Task`1"/></returns>
  241. </member>
  242. <member name="M:Microsoft.IdentityModel.Protocols.IConfigurationManager`1.RequestRefresh">
  243. <summary>
  244. Indicate that the configuration may be stale (as indicated by failing to process incoming tokens).
  245. </summary>
  246. </member>
  247. <member name="T:Microsoft.IdentityModel.Protocols.IConfigurationRetriever`1">
  248. <summary>
  249. Interface that defines methods to retrieve configuration.
  250. </summary>
  251. <typeparam name="T">The type of the configuration metadata.</typeparam>
  252. </member>
  253. <member name="M:Microsoft.IdentityModel.Protocols.IConfigurationRetriever`1.GetConfigurationAsync(System.String,Microsoft.IdentityModel.Protocols.IDocumentRetriever,System.Threading.CancellationToken)">
  254. <summary>
  255. Retrieves a populated configuration given an address and an <see cref="T:Microsoft.IdentityModel.Protocols.IDocumentRetriever"/>.
  256. </summary>
  257. <param name="address">Address of the discovery document.</param>
  258. <param name="retriever">The <see cref="T:Microsoft.IdentityModel.Protocols.IDocumentRetriever"/> to use to read the discovery document.</param>
  259. <param name="cancel">A cancellation token that can be used by other objects or threads to receive notice of cancellation. <see cref="T:System.Threading.CancellationToken"/>.</param>
  260. </member>
  261. <member name="T:Microsoft.IdentityModel.Protocols.IDocumentRetriever">
  262. <summary>
  263. Interface that defines a document retriever that returns the document as a string.
  264. </summary>
  265. </member>
  266. <member name="M:Microsoft.IdentityModel.Protocols.IDocumentRetriever.GetDocumentAsync(System.String,System.Threading.CancellationToken)">
  267. <summary>
  268. Obtains a document from an address.
  269. </summary>
  270. <param name="address">location of document.</param>
  271. <param name="cancel"><see cref="T:System.Threading.CancellationToken"/>.</param>
  272. <returns>document as a string.</returns>
  273. </member>
  274. <member name="T:Microsoft.IdentityModel.Protocols.StaticConfigurationManager`1">
  275. <summary>
  276. This type is for users that want a fixed and static Configuration.
  277. In this case, the configuration is obtained and passed to the constructor.
  278. </summary>
  279. <typeparam name="T">must be a class.</typeparam>
  280. </member>
  281. <member name="M:Microsoft.IdentityModel.Protocols.StaticConfigurationManager`1.#ctor(`0)">
  282. <summary>
  283. Initializes an new instance of <see cref="T:Microsoft.IdentityModel.Protocols.StaticConfigurationManager`1"/> with a Configuration instance.
  284. </summary>
  285. <param name="configuration">Configuration of type OpenIdConnectConfiguration or OpenIdConnectConfiguration.</param>
  286. </member>
  287. <member name="M:Microsoft.IdentityModel.Protocols.StaticConfigurationManager`1.GetConfigurationAsync(System.Threading.CancellationToken)">
  288. <summary>
  289. Obtains an updated version of Configuration.
  290. </summary>
  291. <param name="cancel"><see cref="T:System.Threading.CancellationToken"/>.</param>
  292. <returns>Configuration of type T.</returns>
  293. </member>
  294. <member name="M:Microsoft.IdentityModel.Protocols.StaticConfigurationManager`1.RequestRefresh">
  295. <summary>
  296. For the this type, this is a no-op
  297. </summary>
  298. </member>
  299. <member name="T:Microsoft.IdentityModel.Protocols.LogMessages">
  300. <summary>
  301. Log messages and codes
  302. </summary>
  303. </member>
  304. <member name="T:Microsoft.IdentityModel.Protocols.X509CertificateValidationMode">
  305. <summary>
  306. Represents X509Certificate validation mode.
  307. </summary>
  308. </member>
  309. </members>
  310. </doc>