NetworkCredential Kelas

Definisi

Ruang nama:

System.Net

Rakitan:

netstandard.dll, System.Net.Primitives.dll

Sumber:

NetworkCredential.cs

Menyediakan kredensial untuk skema autentikasi berbasis kata sandi seperti autentikasi dasar, hash, NTLM, dan Kerberos.

public ref class NetworkCredential : System::Net::ICredentials, System::Net::ICredentialsByHost

public class NetworkCredential : System.Net.ICredentials, System.Net.ICredentialsByHost

type NetworkCredential = class
    interface ICredentials
    interface ICredentialsByHost

Public Class NetworkCredential
Implements ICredentials, ICredentialsByHost

Warisan

Object

NetworkCredential

Penerapan

ICredentials ICredentialsByHost

Contoh

Contoh kode berikut mengaitkan NetworkCredential objek dengan sekumpulan Pengidentifikasi Sumber Daya Seragam (URI) dalam CredentialCache. Kemudian meneruskan CredentialCache ke HttpClient objek, yang menggunakannya untuk mengautentikasi permintaan ke server Internet.

NetworkCredential myCred = new NetworkCredential(
    SecurelyStoredUserName,SecurelyStoredPassword,SecurelyStoredDomain);

CredentialCache myCache = new CredentialCache();

myCache.Add(new Uri("http://www.contoso.com"), "Basic", myCred);
myCache.Add(new Uri("http://app.contoso.com"), "Basic", myCred);

// HttpClient lifecycle management best practices:
// https://learn.microsoft.com/dotnet/fundamentals/networking/http/httpclient-guidelines#recommended-use
HttpClient client = new HttpClient(new HttpClientHandler
{
    Credentials = myCache
});

Dim myCred As New NetworkCredential(SecurelyStoredUserName, SecurelyStoredPassword, SecurelyStoredDomain)

Dim myCache As New CredentialCache()

myCache.Add(New Uri("http://www.contoso.com"), "Basic", myCred)
myCache.Add(New Uri("http://app.contoso.com"), "Basic", myCred)
       
' HttpClient lifecycle management best practices:
' https://learn.microsoft.com/dotnet/fundamentals/networking/http/httpclient-guidelines#recommended-use
Dim client As New HttpClient(New HttpClientHandler With
{
    .Credentials = myCache
})

Keterangan

Kelas NetworkCredential ini adalah kelas dasar yang memasok kredensial dalam skema autentikasi berbasis kata sandi seperti dasar, hash, NTLM, dan Kerberos. Kelas yang mengimplementasikan ICredentials antarmuka, seperti CredentialCache kelas, mengembalikan NetworkCredential objek.

Note

Pada platform Unix, penggunaan autentikasi NTLM mungkin memerlukan penginstalan plugin NTLM untuk lapisan GSSAPI yang digunakan oleh implementasi. Pada distribusi Ubuntu, paket disebut gss-ntlmssp. Atau, aplikasi dapat memilih implementasi terkelola NTLM dengan mengatur properti _UseManagedNtlm .csproj (hanya .NET 9+), atau mengatur sakelar AppContext System.Net.Security.UseManagedNtlm.

Pada Windows, autentikasi NTLM dan Negosiasi (Kerberos) selalu bergantung pada GSSAPI sistem operasi.

Kelas ini tidak mendukung metode autentikasi berbasis kunci publik seperti autentikasi klien Secure Sockets Layer (SSL).

Konstruktor

Nama	Deskripsi
NetworkCredential()	Menginisialisasi instans baru dari kelas NetworkCredential.
NetworkCredential(String, SecureString, String)	Menginisialisasi instans NetworkCredential baru kelas dengan nama pengguna, kata sandi, dan domain yang ditentukan.
NetworkCredential(String, SecureString)	Menginisialisasi instans NetworkCredential baru kelas dengan nama pengguna dan kata sandi yang ditentukan.
NetworkCredential(String, String, String)	Menginisialisasi instans NetworkCredential baru kelas dengan nama pengguna, kata sandi, dan domain yang ditentukan.
NetworkCredential(String, String)	Menginisialisasi instans NetworkCredential baru kelas dengan nama pengguna dan kata sandi yang ditentukan.

Properti

Nama	Deskripsi
Domain	Mendapatkan atau mengatur domain atau nama komputer yang memverifikasi kredensial.
Password	Mendapatkan atau mengatur kata sandi untuk nama pengguna yang terkait dengan kredensial.
SecurePassword	Mendapatkan atau mengatur kata sandi sebagai SecureString instans.
UserName	Mendapatkan atau mengatur nama pengguna yang terkait dengan kredensial.

Metode

Nama	Deskripsi
Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
GetCredential(String, Int32, String)	Mengembalikan instans NetworkCredential kelas untuk host, port, dan jenis autentikasi yang ditentukan.
GetCredential(Uri, String)	Mengembalikan instans NetworkCredential kelas untuk Pengidentifikasi Sumber Daya Seragam (URI) dan jenis autentikasi yang ditentukan.
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetType()	Mendapatkan Type instans saat ini. (Diperoleh dari Object)
MemberwiseClone()	Membuat salinan dangkal dari Objectsaat ini. (Diperoleh dari Object)
ToString()	Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object)