(0) exportieren Drucken
Alle erweitern
Dieser Artikel wurde maschinell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen. Weitere Informationen
Übersetzung
Original

ClientCredentials-Klasse

Ermöglicht es dem Benutzer, die Client- und Dienstanmeldeinformationen sowie die auf der Clientseite der Kommunikation zu verwendenden Authentifizierungseinstellungen für die Dienstanmeldeinformationen zu konfigurieren.

System.Object
  System.ServiceModel.Security.SecurityCredentialsManager
    System.ServiceModel.Description.ClientCredentials

Namespace:  System.ServiceModel.Description
Assembly:  System.ServiceModel (in System.ServiceModel.dll)

public class ClientCredentials : SecurityCredentialsManager, 
	IEndpointBehavior

Der ClientCredentials-Typ macht die folgenden Member verfügbar.

  NameBeschreibung
Öffentliche MethodeUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsClientCredentials()Initialisiert eine neue Instanz der ClientCredentials-Klasse.
Geschützte MethodeUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsClientCredentials(ClientCredentials)Dies ist ein Kopierkonstruktor.
Zum Seitenanfang

  NameBeschreibung
Öffentliche EigenschaftClientCertificateRuft ein Objekt ab, mit dem Sie das vom Client für die Authentifizierung des Diensts verwendete X.509-Zertifikat bereitstellen können.
Öffentliche EigenschaftUnterstützt in .NET für Windows Store-AppsHttpDigestRuft die aktuellen HTTP-Digestanmeldeinformationen ab.
Öffentliche EigenschaftIssuedTokenGeben Sie mithilfe dieser Eigenschaft die Endpunktadresse und die Bindung an, die beim Kontaktieren des lokalen Sicherheitstokendiensts verwendet werden sollen. Diese Informationen werden verwendet, wenn ein Dienst die Authentifizierung mit einem ausgestellten Token erfordert. In der Richtlinie des Diensts (durch eine Bindung auf dem Client dargestellt) ist jedoch nicht explizit angegeben, wie und wo das ausgestellte Token abgerufen werden kann.
Öffentliche EigenschaftPeerSteuert die Anmeldeinformationen, mit denen sich ein Peerknoten gegenüber anderen Knoten im Netz authentifiziert, sowie die Authentifizierungseinstellungen, mit denen ein Peerknoten andere Peerknoten authentifiziert.
Öffentliche EigenschaftSecurityTokenHandlerCollectionManagerRuft den Sicherheitstokenhandler für die Clientanmeldeinformationen ab oder legt diesen fest.
Öffentliche EigenschaftServiceCertificateRuft ein Objekt ab, mit dem das X.509-Zertifikat eines Diensts angegeben wird.
Öffentliche EigenschaftSupportInteractiveDient zum Abrufen oder Festlegen eines Werts, der angibt, ob das System den Benutzer ggf. interaktiv zur Eingabe von Anmeldeinformationen auffordern darf. Bei einem Szenario der mittleren Ebene könnte es z. B. wünschenswert sein, den Wert auf false festzulegen.
Öffentliche EigenschaftUseIdentityConfigurationRuft ab oder legt fest, ob die Clientanmeldeinformationen die Identitätskonfiguration verwenden.
Öffentliche EigenschaftUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsUserNameRuft ein Anmeldeinformationsobjekt ab, mit dem Sie den Benutzernamen und das Kennwort festlegen können, die der Client verwendet, um sich dem Dienst gegenüber zu authentifizieren.
Öffentliche EigenschaftUnterstützt in .NET für Windows Store-AppsWindowsRuft ein Objekt zur Steuerung der Windows-Anmeldeinformationen ab, die der Client verwendet, um sich dem Dienst gegenüber zu authentifizieren.
Zum Seitenanfang

  NameBeschreibung
Öffentliche MethodeUnterstützt in .NET für Windows Store-AppsApplyClientBehaviorWendet das angegebene Clientverhalten auf den Endpunkt an.
Öffentliche MethodeUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsCloneErstellt eine neue Kopie dieser ClientCredentials-Instanz.
Geschützte MethodeUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsCloneCoreErstellt eine neue Kopie dieser ClientCredentials-Instanz.
Öffentliche MethodeCreateSecurityTokenManagerErstellt einen Sicherheitstoken-Manager für diese Instanz. Diese Methode wird nur selten explizit aufgerufen. In der Regel wird sie in Szenarien zur Erweiterbarkeit verwendet und vom System selbst aufgerufen. (Überschreibt SecurityCredentialsManager.CreateSecurityTokenManager().)
Öffentliche MethodeUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsEquals(Object)Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist. (Von Object geerbt.)
Geschützte MethodeUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsFinalize Gibt einem Objekt Gelegenheit, Ressourcen freizugeben und andere Bereinigungen durchzuführen, bevor es von der Garbage Collection freigegeben wird. (Von Object geerbt.)
Öffentliche MethodeUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsGetHashCodeFungiert als die Standardhashfunktion. (Von Object geerbt.)
Geschützte MethodeGetInfoCardSecurityTokenGeneriert mit dem CardSpace-System, der angegebenen Richtlinienkette und dem Tokenserialisierungsprogramm ein Sicherheitstoken und gibt es zurück.
Öffentliche MethodeUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsGetTypeRuft den Type der aktuellen Instanz ab. (Von Object geerbt.)
Geschützte MethodeUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsMemberwiseCloneErstellt eine flache Kopie des aktuellen Object. (Von Object geerbt.)
Öffentliche MethodeUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsToStringGibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Von Object geerbt.)
Zum Seitenanfang

  NameBeschreibung
Explizite SchnittstellenimplementierungPrivate MethodeUnterstützt in .NET für Windows Store-AppsIEndpointBehavior.AddBindingParametersFügt diese Instanz dieser Klasse einer Bindungsparameterauflistung hinzu.
Explizite SchnittstellenimplementierungPrivate MethodeUnterstützt in .NET für Windows Store-AppsIEndpointBehavior.ApplyDispatchBehaviorImplementiert eine Änderung oder eine Erweiterung des Diensts in einem Endpunkt.
Explizite SchnittstellenimplementierungPrivate MethodeUnterstützt in .NET für Windows Store-AppsIEndpointBehavior.ValidateFür zukünftige Verwendung reserviert.
Zum Seitenanfang

Der Zugriff auf die ClientCredentials erfolgt über die ClientCredentials-Eigenschaft der ClientBase<TChannel>-Klasse.

Der Behaviors-Auflistung wird ein ClientCredentials-Objekt hinzugefügt. Die ClientCredentials-Eigenschaft ist eine Fassade (ein bekanntes Entwurfsmuster) über einem Eintrag in dieser Auflistung. Viele Eigenschaften in diesen Klassen geben Objekte zurück, die hauptsächlich aus Eigenschaften bestehen. Diese Objekte können für die Konfiguration verwendet werden: Nach dem get des Objekts können Sie es durch Aufrufen seiner Member zum set von Eigenschaften verwenden.

Im folgenden Codebeispiel wird gezeigt, wie Sie diese Klasse überschreiben und Ihre eigenen benutzerdefinierten Clientanmeldeinformationen mit einem benutzerdefinierten Clientsicherheitstoken-Manager implementieren.

Wichtiger HinweisWichtig

Wichtig: Beachten Sie, dass die CreateSecurityTokenManager-Methode überschrieben wird, um einen benutzerdefinierten Sicherheitstokenmanager zu erstellen. Der vom ClientCredentialsSecurityTokenManager abgeleitete Sicherheitstokenmanager muss einen benutzerdefinierten Sicherheitstokenanbieter zurückgeben, der vom [System.IdentityModel.Selectors.SecurityTokenProvider] abgeleitet wurde, um das eigentliche Sicherheitstoken zu erstellen. Wenn Sie diesem Muster zum Erstellen von Sicherheitstokens nicht folgen, läuft die Anwendung Gefahr, Sicherheitsangriffen (insbesondere Rechteerweiterungen) ausgesetzt zu sein. Dieses Codierungsmuster stellt sicher, dass die richtigen Anmeldeinformationen verwendet werden, wenn Channelfactorys zwischengespeichert werden.


public class MyClientCredentials : ClientCredentials
{
    string creditCardNumber;

    public MyClientCredentials()
    {
        // Perform client credentials initialization.
    }

    protected MyClientCredentials(MyClientCredentials other)
        : base(other)
    {
        // Clone fields defined in this class.
        this.creditCardNumber = other.creditCardNumber;
    }

    public string CreditCardNumber
    {
        get
        {
            return this.creditCardNumber;
        }
        set
        {
            if (value == null)
            {
                throw new ArgumentNullException("value");
            }
            this.creditCardNumber = value;
        }
    }

    public override SecurityTokenManager CreateSecurityTokenManager()
    {
        // Return your implementation of the SecurityTokenManager.
        return new MyClientCredentialsSecurityTokenManager(this);
    }

    protected override ClientCredentials CloneCore()
    {
        // Implement the cloning functionality.
        return new MyClientCredentials(this);
    }
}


.NET Framework

Unterstützt in: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0

.NET Framework Client Profile

Unterstützt in: 4, 3.5 SP1

Portable Klassenbibliothek

Unterstützt in: Portable Klassenbibliothek

.NET für Windows Store-Apps

Unterstützt in: Windows 8

.NET für Windows Phone-Apps

Unterstützt in: Windows Phone 8, Silverlight 8.1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core-Rolle wird nicht unterstützt), Windows Server 2008 R2 (Server Core-Rolle wird mit SP1 oder höher unterstützt; Itanium wird nicht unterstützt)

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.

Alle öffentlichen static (Shared in Visual Basic)-Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

Community-Beiträge

HINZUFÜGEN
Anzeigen:
© 2014 Microsoft