NetworkCredential Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Fornece credenciais para esquemas de autenticação baseados em senha, como autenticação básica, digest, NTLM e Kerberos.
public ref class NetworkCredential : System::Net::ICredentials, System::Net::ICredentialsByHost
public ref class NetworkCredential : System::Net::ICredentials
public class NetworkCredential : System.Net.ICredentials, System.Net.ICredentialsByHost
public class NetworkCredential : System.Net.ICredentials
type NetworkCredential = class
interface ICredentials
interface ICredentialsByHost
type NetworkCredential = class
interface ICredentials
Public Class NetworkCredential
Implements ICredentials, ICredentialsByHost
Public Class NetworkCredential
Implements ICredentials
- Herança
-
NetworkCredential
- Implementações
Exemplos
O exemplo de código a seguir associa um NetworkCredential objeto a um conjunto de URIs (Uniform Resource Identifiers) em um CredentialCache. Em seguida, ele passa para CredentialCache um HttpClient objeto, que o usa para autenticar solicitações em um servidor da 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
})
Comentários
A NetworkCredential classe é uma classe base que fornece credenciais em esquemas de autenticação baseados em senha, como basic, digest, NTLM e Kerberos. Classes que implementam a ICredentials interface, como a CredentialCache classe, retornam NetworkCredential objetos.
Note
Em plataformas Unix, o uso da autenticação NTLM pode exigir a instalação do plug-in NTLM para a camada GSSAPI usada pela implementação. Nas distribuições do Ubuntu, o pacote é chamado gss-ntlmssp. Como alternativa, os aplicativos podem optar por uma implementação gerenciada do NTLM definindo a propriedade .csproj _UseManagedNtlm (somente .NET 9+ ) ou definindo a opção System.Net.Security.UseManagedNtlm AppContext.
Em Windows, a autenticação NTLM e Negotiate (Kerberos) sempre depende do GSSAPI do sistema operacional.
Essa classe não dá suporte a métodos de autenticação baseados em chave pública, como autenticação de cliente SSL (Secure Sockets Layer).
Construtores
| Nome | Description |
|---|---|
| NetworkCredential() |
Inicializa uma nova instância da classe NetworkCredential. |
| NetworkCredential(String, SecureString, String) |
Inicializa uma nova instância da NetworkCredential classe com o nome de usuário, a senha e o domínio especificados. |
| NetworkCredential(String, SecureString) |
Inicializa uma nova instância da NetworkCredential classe com o nome de usuário e a senha especificados. |
| NetworkCredential(String, String, String) |
Inicializa uma nova instância da NetworkCredential classe com o nome de usuário, a senha e o domínio especificados. |
| NetworkCredential(String, String) |
Inicializa uma nova instância da NetworkCredential classe com o nome de usuário e a senha especificados. |
Propriedades
| Nome | Description |
|---|---|
| Domain |
Obtém ou define o nome do computador ou domínio que verifica as credenciais. |
| Password |
Obtém ou define a senha do nome de usuário associado às credenciais. |
| SecurePassword |
Obtém ou define a senha como uma SecureString instância. |
| UserName |
Obtém ou define o nome de usuário associado às credenciais. |
Métodos
| Nome | Description |
|---|---|
| Equals(Object) |
Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object) |
| GetCredential(String, Int32, String) |
Retorna uma instância da NetworkCredential classe para o host, a porta e o tipo de autenticação especificados. |
| GetCredential(Uri, String) |
Retorna uma instância da NetworkCredential classe para o URI (Uniform Resource Identifier) e o tipo de autenticação especificados. |
| GetHashCode() |
Serve como a função hash predefinida. (Herdado de Object) |
| GetType() |
Obtém o Type da instância atual. (Herdado de Object) |
| MemberwiseClone() |
Cria uma cópia superficial do Objectatual. (Herdado de Object) |
| ToString() |
Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object) |