Authorization.ProtectionRealm プロパティ
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
Message プロパティで認証できる URI (Uniform Resource Identifier) のプレフィックスを取得または設定します。
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()
プロパティ値
String[]
URI プリフィックスを格納する文字列の配列。
例
次のコード例では、 プロパティで認証 Message できる URI のプレフィックスを取得または設定します。
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
注釈
プロパティには ProtectionRealm 、認証に使用できる URI プレフィックスの Message 一覧が含まれています。 WebRequest とその子孫は、URI をこのリストと比較して、 Authorization が特定の URI に対して有効かどうかを判断します。
適用対象
GitHub で Microsoft と共同作業する
このコンテンツのソースは GitHub にあります。そこで、issue や pull request を作成および確認することもできます。 詳細については、共同作成者ガイドを参照してください。
.NET