Authorization.ProtectionRealm 屬性
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
取得或設定可以使用 Message 屬性進行驗證的統一資源識別元 (URI) 前置詞。
public:
property cli::array <System::String ^> ^ ProtectionRealm { cli::array <System::String ^> ^ get(); void set(cli::array <System::String ^> ^ value); };C#
public string[]? ProtectionRealm { get; set; }C#
public string[] ProtectionRealm { get; set; }member this.ProtectionRealm : string[] with get, setPublic Property ProtectionRealm As String()
String[]
包含 URI 前置詞的字串陣列。
下列程式代碼範例會取得或設定可使用 屬性驗證之 URI 的 Message 前置詞。
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;
}
}
C#
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
屬性 ProtectionRealm 包含可用來驗證屬性的 URI 前置詞 Message 清單。 WebRequest 及其子系會比較 URI 與這份清單，以判斷 是否 Authorization 對特定 URI 有效。
| 產品 | 版本 |
|---|---|
| .NET | Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10 |
| .NET Framework | 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
| .NET Standard | 2.0, 2.1 |
