RPC_HTTP_TRANSPORT_CREDENTIALS_V2_A
構造体サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。
フィールド
| フィールド | 型 | サイズ | x64 | x86 | 説明 | ||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| TransportCredentials | SEC_WINNT_AUTH_IDENTITY_A* | 8/4 | +0 | +0 | ユーザーのユーザー名、ドメイン、パスワードを格納する SEC_WINNT_AUTH_IDENTITY 構造体へのポインターです。 | ||||||
| Flags | RPC_C_HTTP_FLAGS | 4 | +8 | +4 | ビット単位のOR演算子で組み合わせることができるフラグのセットです。 | ||||||
| AuthenticationTarget | RPC_C_HTTP_AUTHN_TARGET | 4 | +12 | +8 | 認証ターゲットを指定します。 次の値のいずれか、または両方を設定します。
| ||||||
| NumberOfAuthnSchemes | DWORD | 4 | +16 | +12 | AuthnScheme 配列の要素数です。 | ||||||
| AuthnSchemes | DWORD* | 8/4 | +24 | +16 | クライアントが使用可能な認証スキームの配列へのポインターです。配列の各要素には、次の定数のいずれかを指定できます。 RPC_C_HTTP_AUTHN_SCHEME_BASICRPC_C_HTTP_AUTHN_SCHEME_NTLMRPC_C_HTTP_AUTHN_SCHEME_PASSPORTRPC_C_HTTP_AUTHN_SCHEME_DIGESTRPC_C_HTTP_AUTHN_SCHEME_NEGOTIATERPC_C_HTTP_AUTHN_SCHEME_PASSPORT、RPC_C_HTTP_AUTHN_SCHEME_NEGOTIATE、RPC_C_HTTP_AUTHN_SCHEME_DIGEST は定数として定義されていますが、現在はサポートされていません。呼び出し元はこれらを指定しないでください。指定すると RPC_S_CANNOT_SUPPORT エラーになります。各定数は 1 回だけ指定できます。RPC はパフォーマンス上の理由からこの制限を検証しませんが、同じ定数を複数回指定した場合の結果は未定義です。 実際の認証スキームを選択するアルゴリズムは次のとおりです。 RPC_C_HTTP_FLAG_USE_FIRST_AUTH_SCHEME が指定されている場合、最初の認証スキームが選択されます。それがサーバーでサポートされていない場合、接続の確立は失敗します。RPC_C_HTTP_FLAG_USE_FIRST_AUTH_SCHEME が指定されていない場合、RPC クライアントはまず RPC プロキシへの匿名接続を試みます。IIS が認証チャレンジを返した場合、RPC クライアントは、サーバーが優先する認証スキームが AuthnScheme 配列にも含まれていれば、そのスキームを選択します。サーバーが優先するスキームが AuthnScheme 配列に含まれていない場合は、AuthnScheme 配列を先頭から末尾まで走査し、サーバーでもサポートされているスキームが見つかれば、その認証スキームが使用されます。 | ||||||
| ServerCertificateSubject | BYTE* | 8/4 | +32 | +20 | 想定されるサーバー プリンシパル名を含む省略可能な文字列です。プリンシパル名は RpcCertGeneratePrincipalName で生成されるものと同じ形式です (詳細については プリンシパル名 を参照してください)。このメンバーは SSL を使用する場合にのみ使用されます。その場合、サーバー証明書は生成されたプリンシパル名と照合されます。一致しない場合はエラーが返されます。このメンバーによって、クライアントは RPC プロキシを認証できます。 | ||||||
| ProxyCredentials | SEC_WINNT_AUTH_IDENTITY_A* | 8/4 | +40 | +24 | HTTP プロキシ サーバーに対して認証する際に使用する、ユーザーのユーザー名、ドメイン、パスワードを格納する SEC_WINNT_AUTH_IDENTITY 構造体へのポインターです。ProxyCredentials は、AuthenticationTarget に RPC_C_HTTP_AUTHN_TARGET_PROXY が含まれている場合にのみ有効です。 | ||||||
| NumberOfProxyAuthnSchemes | DWORD | 4 | +48 | +28 | HTTP プロキシ サーバーに対して認証する際の ProxyAuthnSchemes 配列の要素数です。NumberOfProxyAuthnSchemes は、AuthenticationTarget に RPC_C_HTTP_AUTHN_TARGET_PROXY が含まれている場合にのみ有効です。 | ||||||
| ProxyAuthnSchemes | DWORD* | 8/4 | +56 | +32 | HTTP プロキシ サーバーに対して認証する際に、クライアントが使用可能な認証スキームの配列へのポインターです。配列の各要素には、次の定数のいずれかを指定できます。ProxyAuthnSchemes は、AuthenticationTarget に RPC_C_HTTP_AUTHN_TARGET_PROXY が含まれている場合にのみ有効です。 RPC_C_HTTP_AUTHN_SCHEME_BASICRPC_C_HTTP_AUTHN_SCHEME_NTLMRPC_C_HTTP_AUTHN_SCHEME_PASSPORTRPC_C_HTTP_AUTHN_SCHEME_DIGESTRPC_C_HTTP_AUTHN_SCHEME_NEGOTIATE |
公式ドキュメント
RPC_HTTP_TRANSPORT_CREDENTIALS_V2 構造体は、RPC/HTTP を使用する際に RPC プロキシ サーバーまたは HTTP プロキシ サーバーに対して認証するための追加の資格情報を定義します。
RPC_HTTP_TRANSPORT_CREDENTIALS_V2 は、HTTP プロキシ サーバーに対する認証を可能にすることで RPC_HTTP_TRANSPORT_CREDENTIALS を拡張したものです。
解説(Remarks)
TransportCredentials メンバーが NULL で、認証スキームが NTLM の場合、現在ログオンしているユーザーの資格情報が使用されます。脆弱な LM ハッシュによってユーザーの資格情報がネットワーク上に露出することを避けるため、ユーザーのログオン資格情報は次の条件の一方または両方が満たされる場合にのみ使用されます。
- 呼び出し元が SSL の使用を要求し、ServerCertificateSubject メンバーを使用した場合。このシナリオでは、脆弱なハッシュが使用される場合でも、転送中と最終的な宛先の両方で資格情報が保護されることが保証されます。
- lncompatibilitylevel キーが 2 以上に設定されている場合。これにより、NTLM セキュリティ プロバイダーは脆弱な LM ハッシュではなく、強力な NT ハッシュのみを送信または応答するようになります。さらに、NTLMv2 を試行するレベル 3 以上の使用が推奨されます。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
各言語での定義
#include <windows.h>
// RPC_HTTP_TRANSPORT_CREDENTIALS_V2_A (x64 64 / x86 36 バイト)
typedef struct RPC_HTTP_TRANSPORT_CREDENTIALS_V2_A {
SEC_WINNT_AUTH_IDENTITY_A* TransportCredentials;
RPC_C_HTTP_FLAGS Flags;
RPC_C_HTTP_AUTHN_TARGET AuthenticationTarget;
DWORD NumberOfAuthnSchemes;
DWORD* AuthnSchemes;
BYTE* ServerCertificateSubject;
SEC_WINNT_AUTH_IDENTITY_A* ProxyCredentials;
DWORD NumberOfProxyAuthnSchemes;
DWORD* ProxyAuthnSchemes;
} RPC_HTTP_TRANSPORT_CREDENTIALS_V2_A;using System;
using System.Runtime.InteropServices;
[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct RPC_HTTP_TRANSPORT_CREDENTIALS_V2_A
{
public IntPtr TransportCredentials;
public uint Flags;
public uint AuthenticationTarget;
public uint NumberOfAuthnSchemes;
public IntPtr AuthnSchemes;
public IntPtr ServerCertificateSubject;
public IntPtr ProxyCredentials;
public uint NumberOfProxyAuthnSchemes;
public IntPtr ProxyAuthnSchemes;
}Imports System.Runtime.InteropServices
<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure RPC_HTTP_TRANSPORT_CREDENTIALS_V2_A
Public TransportCredentials As IntPtr
Public Flags As UInteger
Public AuthenticationTarget As UInteger
Public NumberOfAuthnSchemes As UInteger
Public AuthnSchemes As IntPtr
Public ServerCertificateSubject As IntPtr
Public ProxyCredentials As IntPtr
Public NumberOfProxyAuthnSchemes As UInteger
Public ProxyAuthnSchemes As IntPtr
End Structureimport ctypes
from ctypes import wintypes
class RPC_HTTP_TRANSPORT_CREDENTIALS_V2_A(ctypes.Structure):
_fields_ = [
("TransportCredentials", ctypes.c_void_p),
("Flags", wintypes.DWORD),
("AuthenticationTarget", wintypes.DWORD),
("NumberOfAuthnSchemes", wintypes.DWORD),
("AuthnSchemes", ctypes.c_void_p),
("ServerCertificateSubject", ctypes.c_void_p),
("ProxyCredentials", ctypes.c_void_p),
("NumberOfProxyAuthnSchemes", wintypes.DWORD),
("ProxyAuthnSchemes", ctypes.c_void_p),
]#[repr(C)]
pub struct RPC_HTTP_TRANSPORT_CREDENTIALS_V2_A {
pub TransportCredentials: *mut core::ffi::c_void,
pub Flags: u32,
pub AuthenticationTarget: u32,
pub NumberOfAuthnSchemes: u32,
pub AuthnSchemes: *mut core::ffi::c_void,
pub ServerCertificateSubject: *mut core::ffi::c_void,
pub ProxyCredentials: *mut core::ffi::c_void,
pub NumberOfProxyAuthnSchemes: u32,
pub ProxyAuthnSchemes: *mut core::ffi::c_void,
}import "golang.org/x/sys/windows"
type RPC_HTTP_TRANSPORT_CREDENTIALS_V2_A struct {
TransportCredentials uintptr
Flags uint32
AuthenticationTarget uint32
NumberOfAuthnSchemes uint32
AuthnSchemes uintptr
ServerCertificateSubject uintptr
ProxyCredentials uintptr
NumberOfProxyAuthnSchemes uint32
ProxyAuthnSchemes uintptr
}type
RPC_HTTP_TRANSPORT_CREDENTIALS_V2_A = record
TransportCredentials: Pointer;
Flags: DWORD;
AuthenticationTarget: DWORD;
NumberOfAuthnSchemes: DWORD;
AuthnSchemes: Pointer;
ServerCertificateSubject: Pointer;
ProxyCredentials: Pointer;
NumberOfProxyAuthnSchemes: DWORD;
ProxyAuthnSchemes: Pointer;
end;const RPC_HTTP_TRANSPORT_CREDENTIALS_V2_A = extern struct {
TransportCredentials: ?*anyopaque,
Flags: u32,
AuthenticationTarget: u32,
NumberOfAuthnSchemes: u32,
AuthnSchemes: ?*anyopaque,
ServerCertificateSubject: ?*anyopaque,
ProxyCredentials: ?*anyopaque,
NumberOfProxyAuthnSchemes: u32,
ProxyAuthnSchemes: ?*anyopaque,
};type
RPC_HTTP_TRANSPORT_CREDENTIALS_V2_A {.bycopy.} = object
TransportCredentials: pointer
Flags: uint32
AuthenticationTarget: uint32
NumberOfAuthnSchemes: uint32
AuthnSchemes: pointer
ServerCertificateSubject: pointer
ProxyCredentials: pointer
NumberOfProxyAuthnSchemes: uint32
ProxyAuthnSchemes: pointerstruct RPC_HTTP_TRANSPORT_CREDENTIALS_V2_A
{
void* TransportCredentials;
uint Flags;
uint AuthenticationTarget;
uint NumberOfAuthnSchemes;
void* AuthnSchemes;
void* ServerCertificateSubject;
void* ProxyCredentials;
uint NumberOfProxyAuthnSchemes;
void* ProxyAuthnSchemes;
}HSP用 定義
HSP3.7/3.8 は構造体機能が無いため4byte整数配列(dim)+peek/poke で操作(32/64bitでサイズ・位置が異なる場合はタブで分割)。IronHSP は NSTRUCT(#defstruct/stdim/->)で32/64bit共通。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; RPC_HTTP_TRANSPORT_CREDENTIALS_V2_A サイズ: 36 バイト(x86)
dim st, 9 ; 4byte整数×9(構造体サイズ 36 / 4 切り上げ)
; TransportCredentials : SEC_WINNT_AUTH_IDENTITY_A* (+0, 4byte) varptr(st)+0 を基点に操作(4byte:入れ子/配列)
; Flags : RPC_C_HTTP_FLAGS (+4, 4byte) st.1 = 値 / 値 = st.1 (lpoke/lpeek も可)
; AuthenticationTarget : RPC_C_HTTP_AUTHN_TARGET (+8, 4byte) st.2 = 値 / 値 = st.2 (lpoke/lpeek も可)
; NumberOfAuthnSchemes : DWORD (+12, 4byte) st.3 = 値 / 値 = st.3 (lpoke/lpeek も可)
; AuthnSchemes : DWORD* (+16, 4byte) st.4 = 値 / 値 = st.4 (lpoke/lpeek も可)
; ServerCertificateSubject : BYTE* (+20, 4byte) st.5 = 値 / 値 = st.5 (lpoke/lpeek も可)
; ProxyCredentials : SEC_WINNT_AUTH_IDENTITY_A* (+24, 4byte) varptr(st)+24 を基点に操作(4byte:入れ子/配列)
; NumberOfProxyAuthnSchemes : DWORD (+28, 4byte) st.7 = 値 / 値 = st.7 (lpoke/lpeek も可)
; ProxyAuthnSchemes : DWORD* (+32, 4byte) st.8 = 値 / 値 = st.8 (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; RPC_HTTP_TRANSPORT_CREDENTIALS_V2_A サイズ: 64 バイト(x64)
dim st, 16 ; 4byte整数×16(構造体サイズ 64 / 4 切り上げ)
; TransportCredentials : SEC_WINNT_AUTH_IDENTITY_A* (+0, 8byte) varptr(st)+0 を基点に操作(8byte:入れ子/配列)
; Flags : RPC_C_HTTP_FLAGS (+8, 4byte) st.2 = 値 / 値 = st.2 (lpoke/lpeek も可)
; AuthenticationTarget : RPC_C_HTTP_AUTHN_TARGET (+12, 4byte) st.3 = 値 / 値 = st.3 (lpoke/lpeek も可)
; NumberOfAuthnSchemes : DWORD (+16, 4byte) st.4 = 値 / 値 = st.4 (lpoke/lpeek も可)
; AuthnSchemes : DWORD* (+24, 8byte) qpoke st,24,値 / qpeek(st,24) ※IronHSPのみ。3.7/3.8は lpoke st,24,下位 : lpoke st,28,上位
; ServerCertificateSubject : BYTE* (+32, 8byte) qpoke st,32,値 / qpeek(st,32) ※IronHSPのみ。3.7/3.8は lpoke st,32,下位 : lpoke st,36,上位
; ProxyCredentials : SEC_WINNT_AUTH_IDENTITY_A* (+40, 8byte) varptr(st)+40 を基点に操作(8byte:入れ子/配列)
; NumberOfProxyAuthnSchemes : DWORD (+48, 4byte) st.12 = 値 / 値 = st.12 (lpoke/lpeek も可)
; ProxyAuthnSchemes : DWORD* (+56, 8byte) qpoke st,56,値 / qpeek(st,56) ※IronHSPのみ。3.7/3.8は lpoke st,56,下位 : lpoke st,60,上位
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global RPC_HTTP_TRANSPORT_CREDENTIALS_V2_A
#field intptr TransportCredentials
#field int Flags
#field int AuthenticationTarget
#field int NumberOfAuthnSchemes
#field intptr AuthnSchemes
#field intptr ServerCertificateSubject
#field intptr ProxyCredentials
#field int NumberOfProxyAuthnSchemes
#field intptr ProxyAuthnSchemes
#endstruct
stdim st, RPC_HTTP_TRANSPORT_CREDENTIALS_V2_A ; NSTRUCT 変数を確保
st->Flags = 100
mes "Flags=" + st->Flags