Jo Shields a575963da9 Imported Upstream version 3.6.0
Former-commit-id: da6be194a6b1221998fc28233f2503bd61dd9d14
2014-08-13 10:39:27 +01:00

251 lines
17 KiB
XML

<?xml version="1.0" encoding="utf-8"?>
<Type Name="ServiceSecurityAuditBehavior" FullName="System.ServiceModel.Description.ServiceSecurityAuditBehavior">
<TypeSignature Language="C#" Value="public sealed class ServiceSecurityAuditBehavior : System.ServiceModel.Description.IServiceBehavior" />
<TypeSignature Language="ILAsm" Value=".class public auto ansi sealed beforefieldinit ServiceSecurityAuditBehavior extends System.Object implements class System.ServiceModel.Description.IServiceBehavior" />
<AssemblyInfo>
<AssemblyName>System.ServiceModel</AssemblyName>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Base>
<BaseTypeName>System.Object</BaseTypeName>
</Base>
<Interfaces>
<Interface>
<InterfaceName>System.ServiceModel.Description.IServiceBehavior</InterfaceName>
</Interface>
</Interfaces>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="T:System.ServiceModel.Description.ServiceSecurityAuditBehavior" /> class is used to audit indigo1 authentication events. When auditing is enabled, either successful or failed authentication attempts (or both) can be audited. The events are written to one of three event logs: application, security, or the default log for the operating system version. The event logs can all be viewed using the Windows Event viewer.</para>
<para>Use this class to specify which event log is written to, as well as kinds of authentication events to write. You can also specify whether to suppress audit failures by setting the <see cref="P:System.ServiceModel.Description.ServiceSecurityAuditBehavior.SuppressAuditFailure" /> property to false (the default is true).</para>
<para>crabout auditing security events for indigo2 applications, see <format type="text/html"><a href="5633f61c-a3c9-40dd-8070-1c373b66a716">Auditing Security Events</a></format>.</para>
<para>To specify audit behavior in configuration, use the <format type="text/html"><a href="ba517369-a034-4f8e-a2c4-66517716062b">&lt;serviceSecurityAudit&gt; element</a></format>.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Specifies the audit behavior of security events. In general, the security events consist of authentication events such as transport, message or negotiate authentication and authorization event. crdefault <see cref="T:System.ServiceModel.ServiceAuthorizationManager" />.</para>
</summary>
</Docs>
<Members>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public ServiceSecurityAuditBehavior ();" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor() cil managed" />
<MemberType>Constructor</MemberType>
<AssemblyInfo>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Parameters />
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The instance is created with the following default settings:</para>
<list type="bullet">
<item>
<para>
<see cref="P:System.ServiceModel.Description.ServiceSecurityAuditBehavior.AuditLogLocation" /> = <see cref="F:System.ServiceModel.AuditLogLocation.Default" />;</para>
</item>
<item>
<para>
<see cref="P:System.ServiceModel.Description.ServiceSecurityAuditBehavior.SuppressAuditFailure" /> = true;</para>
</item>
<item>
<para>
<see cref="P:System.ServiceModel.Description.ServiceSecurityAuditBehavior.ServiceAuthorizationAuditLevel" /> = <see cref="F:System.ServiceModel.AuditLevel.None" />;</para>
</item>
<item>
<para>
<see cref="P:System.ServiceModel.Description.ServiceSecurityAuditBehavior.MessageAuthenticationAuditLevel" /> = <see cref="F:System.ServiceModel.AuditLevel.None" />.</para>
</item>
</list>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Initializes a new instance of the <see cref="T:System.ServiceModel.Description.ServiceSecurityAuditBehavior" /> class. </para>
</summary>
</Docs>
</Member>
<Member MemberName="AuditLogLocation">
<MemberSignature Language="C#" Value="public System.ServiceModel.AuditLogLocation AuditLogLocation { get; set; }" />
<MemberSignature Language="ILAsm" Value=".property instance valuetype System.ServiceModel.AuditLogLocation AuditLogLocation" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.ServiceModel.AuditLogLocation</ReturnType>
</ReturnValue>
<Docs>
<value>To be added.</value>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>To be able to write to AuditLogLocation.Security, the running thread (or process) must possess SeAuditPrivilege.</para>
<para>You can also set this value using the <format type="text/html"><a href="ba517369-a034-4f8e-a2c4-66517716062b">&lt;serviceSecurityAudit&gt; element</a></format> in a client application configuration file.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets or sets the location where secure-related event logs are written. </para>
</summary>
</Docs>
</Member>
<Member MemberName="MessageAuthenticationAuditLevel">
<MemberSignature Language="C#" Value="public System.ServiceModel.AuditLevel MessageAuthenticationAuditLevel { get; set; }" />
<MemberSignature Language="ILAsm" Value=".property instance valuetype System.ServiceModel.AuditLevel MessageAuthenticationAuditLevel" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.ServiceModel.AuditLevel</ReturnType>
</ReturnValue>
<Docs>
<value>To be added.</value>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>indigo1 service applications have two levels where security can be enforced. At the <newTerm>service</newTerm> level, all methods of the service are enforced by the same security policy. Individual methods in the service can have a different (more stringent) security policy. Use the <see cref="P:System.ServiceModel.Description.ServiceSecurityAuditBehavior.MessageAuthenticationAuditLevel" /> property to control which message level events are audited.</para>
<para>You can also set this value using the <format type="text/html"><a href="ba517369-a034-4f8e-a2c4-66517716062b">&lt;serviceSecurityAudit&gt; element</a></format> in a client application configuration file.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets or sets the type of authentication events to audit at the message level.</para>
</summary>
</Docs>
</Member>
<Member MemberName="ServiceAuthorizationAuditLevel">
<MemberSignature Language="C#" Value="public System.ServiceModel.AuditLevel ServiceAuthorizationAuditLevel { get; set; }" />
<MemberSignature Language="ILAsm" Value=".property instance valuetype System.ServiceModel.AuditLevel ServiceAuthorizationAuditLevel" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.ServiceModel.AuditLevel</ReturnType>
</ReturnValue>
<Docs>
<value>To be added.</value>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>indigo1 service applications have two levels where security can be enforced. At the <newTerm>service</newTerm> level, all methods of the service are enforced by the same security policy. Individual methods in the service can have a different (more stringent) security policy. Use the <see cref="P:System.ServiceModel.Description.ServiceSecurityAuditBehavior.ServiceAuthorizationAuditLevel" /> property to control which service level events are audited.</para>
<para>You can also set this value using the <format type="text/html"><a href="ba517369-a034-4f8e-a2c4-66517716062b">&lt;serviceSecurityAudit&gt; element</a></format> in a client application configuration file.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets or sets the type of authorization events to audit at the service level.</para>
</summary>
</Docs>
</Member>
<Member MemberName="SuppressAuditFailure">
<MemberSignature Language="C#" Value="public bool SuppressAuditFailure { get; set; }" />
<MemberSignature Language="ILAsm" Value=".property instance bool SuppressAuditFailure" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Boolean</ReturnType>
</ReturnValue>
<Docs>
<value>To be added.</value>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>If this property is false, failure to audit causes an exception to be thrown and results in user request failure.</para>
<para>You can also set this value using the <format type="text/html"><a href="ba517369-a034-4f8e-a2c4-66517716062b">&lt;serviceSecurityAudit&gt; element</a></format> in a client application configuration file.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets or sets a value that indicates whether failure to audit affects the application. </para>
</summary>
</Docs>
</Member>
<Member MemberName="System.ServiceModel.Description.IServiceBehavior.AddBindingParameters">
<MemberSignature Language="C#" Value="void IServiceBehavior.AddBindingParameters (System.ServiceModel.Description.ServiceDescription description, System.ServiceModel.ServiceHostBase serviceHostBase, System.Collections.ObjectModel.Collection&lt;System.ServiceModel.Description.ServiceEndpoint&gt; endpoints, System.ServiceModel.Channels.BindingParameterCollection parameters);" />
<MemberSignature Language="ILAsm" Value=".method hidebysig newslot virtual instance void System.ServiceModel.Description.IServiceBehavior.AddBindingParameters(class System.ServiceModel.Description.ServiceDescription description, class System.ServiceModel.ServiceHostBase serviceHostBase, class System.Collections.ObjectModel.Collection`1&lt;class System.ServiceModel.Description.ServiceEndpoint&gt; endpoints, class System.ServiceModel.Channels.BindingParameterCollection parameters) cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="description" Type="System.ServiceModel.Description.ServiceDescription" />
<Parameter Name="serviceHostBase" Type="System.ServiceModel.ServiceHostBase" />
<Parameter Name="endpoints" Type="System.Collections.ObjectModel.Collection&lt;System.ServiceModel.Description.ServiceEndpoint&gt;" />
<Parameter Name="parameters" Type="System.ServiceModel.Channels.BindingParameterCollection" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Use this method to add custom data objects to the <paramref name="parameters" /> collection that binding elements can use to acquire extra information to enable them to support the contract.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Passes custom data to binding elements to support the contract implementation.</para>
</summary>
<param name="description">
<attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ServiceModel.Description.ServiceDescription" /> of the service.</param>
<param name="serviceHostBase">
<attribution license="cc4" from="Microsoft" modified="false" />The host of the service.</param>
<param name="endpoints">
<attribution license="cc4" from="Microsoft" modified="false" />The service endpoints.</param>
<param name="parameters">
<attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.ServiceModel.Channels.BindingParameterCollection" />.</param>
</Docs>
</Member>
<Member MemberName="System.ServiceModel.Description.IServiceBehavior.ApplyDispatchBehavior">
<MemberSignature Language="C#" Value="void IServiceBehavior.ApplyDispatchBehavior (System.ServiceModel.Description.ServiceDescription description, System.ServiceModel.ServiceHostBase serviceHostBase);" />
<MemberSignature Language="ILAsm" Value=".method hidebysig newslot virtual instance void System.ServiceModel.Description.IServiceBehavior.ApplyDispatchBehavior(class System.ServiceModel.Description.ServiceDescription description, class System.ServiceModel.ServiceHostBase serviceHostBase) cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="description" Type="System.ServiceModel.Description.ServiceDescription" />
<Parameter Name="serviceHostBase" Type="System.ServiceModel.ServiceHostBase" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Use this method to inspect or modify the <see cref="T:System.ServiceModel.ServiceHostBase" /> object that is being constructed to support some custom execution scenario.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Provides the ability to change run-time property values or insert custom extension objects such as error handlers, message or parameter interceptors, security extensions, and other custom extension objects.</para>
</summary>
<param name="description">
<attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ServiceModel.Description.ServiceDescription" /> of the service.</param>
<param name="serviceHostBase">
<attribution license="cc4" from="Microsoft" modified="false" />The host of the service.</param>
</Docs>
</Member>
<Member MemberName="System.ServiceModel.Description.IServiceBehavior.Validate">
<MemberSignature Language="C#" Value="void IServiceBehavior.Validate (System.ServiceModel.Description.ServiceDescription description, System.ServiceModel.ServiceHostBase serviceHostBase);" />
<MemberSignature Language="ILAsm" Value=".method hidebysig newslot virtual instance void System.ServiceModel.Description.IServiceBehavior.Validate(class System.ServiceModel.Description.ServiceDescription description, class System.ServiceModel.ServiceHostBase serviceHostBase) cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="description" Type="System.ServiceModel.Description.ServiceDescription" />
<Parameter Name="serviceHostBase" Type="System.ServiceModel.ServiceHostBase" />
</Parameters>
<Docs>
<remarks>To be added.</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Not implemented.</para>
</summary>
<param name="description">
<attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ServiceModel.Description.ServiceDescription" /> of the service.</param>
<param name="serviceHostBase">
<attribution license="cc4" from="Microsoft" modified="false" />The host of the service.</param>
</Docs>
</Member>
</Members>
</Type>