Authorization.ProtectionRealm Propiedad
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Obtiene o establece el prefijo de los identificadores URI que pueden autenticarse con la propiedad Message.
public:
property cli::array <System::String ^> ^ ProtectionRealm { cli::array <System::String ^> ^ get(); void set(cli::array <System::String ^> ^ value); };
public string[]? ProtectionRealm { get; set; }
public string[] ProtectionRealm { get; set; }
member this.ProtectionRealm : string[] with get, set
Public Property ProtectionRealm As String()
Valor de propiedad
Matriz de cadenas que contiene prefijos URI.
Ejemplos
En el ejemplo de código siguiente se obtiene o establece el prefijo para los URI que se pueden autenticar con la Message propiedad .
virtual Authorization^ Authenticate( String^ challenge, WebRequest^ request, ICredentials^ credentials )
{
try
{
String^ message;
// Check if Challenge String* was raised by a site which requires 'CloneBasic' authentication.
if ( (challenge == nullptr) || ( !challenge->StartsWith( "CloneBasic" )) )
return nullptr;
NetworkCredential^ myCredentials;
if ( dynamic_cast<CredentialCache^>(credentials) == nullptr )
{
myCredentials = credentials->GetCredential( request->RequestUri, "CloneBasic" );
if ( myCredentials == nullptr )
return nullptr;
}
else
myCredentials = dynamic_cast<NetworkCredential^>(credentials);
// Message encryption scheme :
// a)Concatenate username and password seperated by space;
// b)Apply ASCII encoding to obtain a stream of bytes;
// c)Apply Base64 Encoding to this array of bytes to obtain our encoded authorization message.
message = String::Concat( myCredentials->UserName, " ", myCredentials->Password );
// Apply AsciiEncoding to 'message' String* to obtain it as an array of bytes.
Encoding^ ascii = Encoding::ASCII;
array<Byte>^byteArray = gcnew array<Byte>(ascii->GetByteCount( message ));
byteArray = ascii->GetBytes( message );
// Performing Base64 transformation.
message = Convert::ToBase64String( byteArray );
Authorization^ myAuthorization = gcnew Authorization( String::Concat( "CloneBasic ", message, true ) );
array<String^>^protectionRealm = gcnew array<String^>(1);
protectionRealm[ 0 ] = request->RequestUri->AbsolutePath;
myAuthorization->ProtectionRealm = protectionRealm;
return myAuthorization;
}
catch ( Exception^ e )
{
Console::WriteLine( "The following exception was raised in Authenticate method: {0}", e->Message );
return nullptr;
}
}
public Authorization Authenticate( string challenge,WebRequest request,ICredentials credentials)
{
try
{
string message;
// Check if Challenge string was raised by a site which requires 'CloneBasic' authentication.
if ((challenge == null) || (!challenge.StartsWith("CloneBasic")))
return null;
NetworkCredential myCredentials;
if (credentials is CredentialCache)
{
myCredentials = credentials.GetCredential(request.RequestUri,"CloneBasic");
if (myCredentials == null)
return null;
}
else
{
myCredentials = (NetworkCredential)credentials;
}
// Message encryption scheme :
// a)Concatenate username and password seperated by space;
// b)Apply ASCII encoding to obtain a stream of bytes;
// c)Apply Base64 Encoding to this array of bytes to obtain our encoded authorization message.
message = myCredentials.UserName + " " + myCredentials.Password;
// Apply AsciiEncoding to 'message' string to obtain it as an array of bytes.
Encoding ascii = Encoding.ASCII;
byte[] byteArray = new byte[ascii.GetByteCount(message)];
byteArray = ascii.GetBytes(message);
// Performing Base64 transformation.
message = Convert.ToBase64String(byteArray);
Authorization myAuthorization = new Authorization("CloneBasic " + message,true);
string[] protectionRealm = new string[]{request.RequestUri.AbsolutePath};
myAuthorization.ProtectionRealm = protectionRealm;
return myAuthorization;
}
catch(Exception e)
{
Console.WriteLine("The following exception was raised in Authenticate method:{0}",e.Message);
return null;
}
}
Function Authenticate(ByVal challenge As String, ByVal request As WebRequest, ByVal credentials As ICredentials) As Authorization Implements IAuthenticationModule.Authenticate
Try
Dim message As String
' Check if Challenge string was raised by a site which requires 'CloneBasic' authentication.
If challenge Is Nothing Or Not challenge.StartsWith("CloneBasic") Then
Return Nothing
End If
Dim myCredentials As NetworkCredential
If TypeOf credentials Is CredentialCache Then
myCredentials = credentials.GetCredential(request.RequestUri, "CloneBasic")
If myCredentials Is Nothing Then
Return Nothing
End If
Else
myCredentials = CType(credentials, NetworkCredential)
End If
' Message encryption scheme :
' a)Concatenate username and password seperated by space
' b)Apply ASCII encoding to obtain a stream of bytes
' c)Apply Base64 Encoding to this array of bytes to obtain our encoded authorization message
message = myCredentials.UserName + " " + myCredentials.Password
' Apply AsciiEncoding to 'message' string to obtain it as an array of bytes.
Dim ascii As Encoding = Encoding.ASCII
Dim byteArray(ascii.GetByteCount(message)) As Byte
byteArray = ascii.GetBytes(message)
' Performing Base64 transformation.
message = Convert.ToBase64String(byteArray)
Dim myAuthorization As New Authorization("CloneBasic " + message, True)
Dim protectionRealm() As String = {request.RequestUri.AbsolutePath}
myAuthorization.ProtectionRealm = protectionRealm
Return myAuthorization
Catch e As Exception
Console.WriteLine("The following exception was raised in Authenticate method:{0}", e.Message)
Return Nothing
End Try
End Function 'Authenticate
Comentarios
La ProtectionRealm propiedad contiene una lista de prefijos de URI que la Message propiedad se puede usar para autenticarse. WebRequest y sus descendientes comparan un URI con esta lista para determinar si es Authorization válido para un URI determinado.