ServiceSecurityAuditBehavior Třída
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Určuje chování auditu událostí zabezpečení. Obecně platí, že události zabezpečení se skládají z událostí ověřování, jako je přenos, zpráva nebo vyjednávání ověřování a autorizační události. Další informace naleznete v tématu ServiceAuthorizationManager.
public ref class ServiceSecurityAuditBehavior sealed : System::ServiceModel::Description::IServiceBehavior
public sealed class ServiceSecurityAuditBehavior : System.ServiceModel.Description.IServiceBehavior
type ServiceSecurityAuditBehavior = class
interface IServiceBehavior
Public NotInheritable Class ServiceSecurityAuditBehavior
Implements IServiceBehavior
- Dědičnost
-
ServiceSecurityAuditBehavior
- Implementuje
Příklady
Následující kód vytvoří instanci ServiceHost třídy a přidá novou ServiceSecurityAuditBehavior kolekci chování.
public static void Main()
{
// Get base address from appsettings in configuration.
Uri baseAddress = new Uri(ConfigurationManager.
AppSettings["baseAddress"]);
// Create a ServiceHost for the CalculatorService type
// and provide the base address.
using (ServiceHost serviceHost = new
ServiceHost(typeof(CalculatorService), baseAddress))
{
// Create a new auditing behavior and set the log location.
ServiceSecurityAuditBehavior newAudit =
new ServiceSecurityAuditBehavior();
newAudit.AuditLogLocation =
AuditLogLocation.Application;
newAudit.MessageAuthenticationAuditLevel =
AuditLevel.SuccessOrFailure;
newAudit.ServiceAuthorizationAuditLevel =
AuditLevel.SuccessOrFailure;
newAudit.SuppressAuditFailure = false;
// Remove the old behavior and add the new.
serviceHost.Description.
Behaviors.Remove<ServiceSecurityAuditBehavior>();
serviceHost.Description.Behaviors.Add(newAudit);
// Open the ServiceHostBase to create listeners
// and start listening for messages.
serviceHost.Open();
// The service can now be accessed.
Console.WriteLine("The service is ready.");
Console.WriteLine("Press <ENTER> to terminate service.");
Console.WriteLine();
Console.ReadLine();
// Close the ServiceHostBase to shutdown the service.
serviceHost.Close();
}
}
Public Shared Sub Main()
' Get base address from appsettings in configuration.
Dim baseAddress As New Uri(ConfigurationManager.AppSettings("baseAddress"))
' Create a ServiceHost for the CalculatorService type
' and provide the base address.
Dim serviceHost As New ServiceHost(GetType(CalculatorService), baseAddress)
Try
' Create a new auditing behavior and set the log location.
Dim newAudit As New ServiceSecurityAuditBehavior()
newAudit.AuditLogLocation = AuditLogLocation.Application
newAudit.MessageAuthenticationAuditLevel = _
AuditLevel.SuccessOrFailure
newAudit.ServiceAuthorizationAuditLevel = _
AuditLevel.SuccessOrFailure
newAudit.SuppressAuditFailure = False
' Remove the old behavior and add the new.
serviceHost.Description.Behaviors.Remove(Of ServiceSecurityAuditBehavior)
serviceHost.Description.Behaviors.Add(newAudit)
' Open the ServiceHostBase to create listeners
' and start listening for messages.
serviceHost.Open()
' The service can now be accessed.
Console.WriteLine("The service is ready.")
Console.WriteLine("Press <ENTER> to terminate service.")
Console.WriteLine()
Console.ReadLine()
' Close the ServiceHostBase to shutdown the service.
serviceHost.Close()
Finally
End Try
End Sub
Poznámky
Třída ServiceSecurityAuditBehavior se používá k auditování událostí ověřování Windows Communication Foundation (WCF). Při povolení auditování je možné auditovat úspěšné nebo neúspěšné pokusy o ověření (nebo obojí). Události se zapisují do jednoho ze tří protokolů událostí: aplikace, zabezpečení nebo výchozí protokol pro verzi operačního systému. Protokoly událostí se dají zobrazit pomocí prohlížeče událostí Windows.
Pomocí této třídy určete, do kterého protokolu událostí se zapisuje, a také druhy událostí ověřování, které se mají zapisovat. Můžete také určit, jestli chcete potlačit selhání auditu nastavením SuppressAuditFailure vlastnosti na false
(výchozí hodnota je true
).
Další informace o událostech zabezpečení auditování pro aplikace WCF najdete v tématu Auditování.
Pokud chcete určit chování auditu v konfiguraci, použijte <serviceSecurityAudit>.
Konstruktory
ServiceSecurityAuditBehavior() |
Inicializuje novou instanci ServiceSecurityAuditBehavior třídy. |
Vlastnosti
AuditLogLocation |
Získá nebo nastaví umístění, kde se zapisují protokoly událostí související se zabezpečením. |
MessageAuthenticationAuditLevel |
Získá nebo nastaví typ událostí ověřování, které se mají auditovat na úrovni zprávy. |
ServiceAuthorizationAuditLevel |
Získá nebo nastaví typ autorizačních událostí pro audit na úrovni služby. |
SuppressAuditFailure |
Získá nebo nastaví hodnotu, která označuje, zda selhání auditování ovlivňuje aplikaci. |
Metody
Equals(Object) |
Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object) |
GetHashCode() |
Slouží jako výchozí funkce hash. (Zděděno od Object) |
GetType() |
Type Získá aktuální instanci. (Zděděno od Object) |
MemberwiseClone() |
Vytvoří použádnou kopii aktuálního souboru Object. (Zděděno od Object) |
ToString() |
Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object) |
Explicitní implementace rozhraní
IServiceBehavior.AddBindingParameters(ServiceDescription, ServiceHostBase, Collection<ServiceEndpoint>, BindingParameterCollection) |
Předá vlastní data do vazeb prvků, které podporují implementaci kontraktu. |
IServiceBehavior.ApplyDispatchBehavior(ServiceDescription, ServiceHostBase) |
Poskytuje možnost měnit hodnoty vlastností za běhu nebo vkládat vlastní objekty rozšíření, jako jsou obslužné rutiny chyb, zachytávání zpráv nebo zachytávání parametrů, rozšíření zabezpečení a další vlastní objekty rozšíření. |
IServiceBehavior.Validate(ServiceDescription, ServiceHostBase) |
Není implementováno. |