RPC_HTTP_TRANSPORT_CREDENTIALS_W
構造体サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。
フィールド
| フィールド | 型 | サイズ | x64 | x86 | 説明 | ||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| TransportCredentials | SEC_WINNT_AUTH_IDENTITY_W* | 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 | 許可する認証スキームのIDの配列へのポインター。 | ||||||
| ServerCertificateSubject | WORD* | 8/4 | +32 | +20 | 想定されるサーバー プリンシパル名を含む省略可能な文字列です。プリンシパル名の形式は、RpcCertGeneratePrincipalName で生成されるものと同じです (詳細については「Principal Names」を参照してください)。このメンバーは SSL を使用する場合にのみ使用されます。その場合、サーバー証明書は生成されたプリンシパル名と照合されます。一致しない場合はエラーが返されます。このメンバーにより、クライアントは RPC プロキシを認証できます。 - AuthnSchemeクライアントが使用してもよい認証スキームの配列へのポインターです。配列の各要素には、次の定数のいずれかを指定できます。 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 配列を先頭から末尾まで走査し、サーバーでもサポートされているスキームが見つかれば、その認証スキームが使用されます。 - AuthnScheme.RPC_C_HTTP_AUTHN_SCHEME_BASIC- AuthnScheme.RPC_C_HTTP_AUTHN_SCHEME_DIGEST- AuthnScheme.RPC_C_HTTP_AUTHN_SCHEME_NEGOTIATE- AuthnScheme.RPC_C_HTTP_AUTHN_SCHEME_NTLM- AuthnScheme.RPC_C_HTTP_AUTHN_SCHEME_PASSPORT |
公式ドキュメント
RPC_HTTP_TRANSPORT_CREDENTIALS 構造体は、RPC/HTTP を使用するときに RPC プロキシ サーバーに対して認証を行うための追加の資格情報を定義します。
解説(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_W (x64 40 / x86 24 バイト)
typedef struct RPC_HTTP_TRANSPORT_CREDENTIALS_W {
SEC_WINNT_AUTH_IDENTITY_W* TransportCredentials;
RPC_C_HTTP_FLAGS Flags;
RPC_C_HTTP_AUTHN_TARGET AuthenticationTarget;
DWORD NumberOfAuthnSchemes;
DWORD* AuthnSchemes;
WORD* ServerCertificateSubject;
} RPC_HTTP_TRANSPORT_CREDENTIALS_W;using System;
using System.Runtime.InteropServices;
[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct RPC_HTTP_TRANSPORT_CREDENTIALS_W
{
public IntPtr TransportCredentials;
public uint Flags;
public uint AuthenticationTarget;
public uint NumberOfAuthnSchemes;
public IntPtr AuthnSchemes;
public IntPtr ServerCertificateSubject;
}Imports System.Runtime.InteropServices
<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure RPC_HTTP_TRANSPORT_CREDENTIALS_W
Public TransportCredentials As IntPtr
Public Flags As UInteger
Public AuthenticationTarget As UInteger
Public NumberOfAuthnSchemes As UInteger
Public AuthnSchemes As IntPtr
Public ServerCertificateSubject As IntPtr
End Structureimport ctypes
from ctypes import wintypes
class RPC_HTTP_TRANSPORT_CREDENTIALS_W(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),
]#[repr(C)]
pub struct RPC_HTTP_TRANSPORT_CREDENTIALS_W {
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,
}import "golang.org/x/sys/windows"
type RPC_HTTP_TRANSPORT_CREDENTIALS_W struct {
TransportCredentials uintptr
Flags uint32
AuthenticationTarget uint32
NumberOfAuthnSchemes uint32
AuthnSchemes uintptr
ServerCertificateSubject uintptr
}type
RPC_HTTP_TRANSPORT_CREDENTIALS_W = record
TransportCredentials: Pointer;
Flags: DWORD;
AuthenticationTarget: DWORD;
NumberOfAuthnSchemes: DWORD;
AuthnSchemes: Pointer;
ServerCertificateSubject: Pointer;
end;const RPC_HTTP_TRANSPORT_CREDENTIALS_W = extern struct {
TransportCredentials: ?*anyopaque,
Flags: u32,
AuthenticationTarget: u32,
NumberOfAuthnSchemes: u32,
AuthnSchemes: ?*anyopaque,
ServerCertificateSubject: ?*anyopaque,
};type
RPC_HTTP_TRANSPORT_CREDENTIALS_W {.bycopy.} = object
TransportCredentials: pointer
Flags: uint32
AuthenticationTarget: uint32
NumberOfAuthnSchemes: uint32
AuthnSchemes: pointer
ServerCertificateSubject: pointerstruct RPC_HTTP_TRANSPORT_CREDENTIALS_W
{
void* TransportCredentials;
uint Flags;
uint AuthenticationTarget;
uint NumberOfAuthnSchemes;
void* AuthnSchemes;
void* ServerCertificateSubject;
}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_W サイズ: 24 バイト(x86)
dim st, 6 ; 4byte整数×6(構造体サイズ 24 / 4 切り上げ)
; TransportCredentials : SEC_WINNT_AUTH_IDENTITY_W* (+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 : WORD* (+20, 4byte) st.5 = 値 / 値 = st.5 (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; RPC_HTTP_TRANSPORT_CREDENTIALS_W サイズ: 40 バイト(x64)
dim st, 10 ; 4byte整数×10(構造体サイズ 40 / 4 切り上げ)
; TransportCredentials : SEC_WINNT_AUTH_IDENTITY_W* (+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 : WORD* (+32, 8byte) qpoke st,32,値 / qpeek(st,32) ※IronHSPのみ。3.7/3.8は lpoke st,32,下位 : lpoke st,36,上位
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global RPC_HTTP_TRANSPORT_CREDENTIALS_W
#field intptr TransportCredentials
#field int Flags
#field int AuthenticationTarget
#field int NumberOfAuthnSchemes
#field intptr AuthnSchemes
#field intptr ServerCertificateSubject
#endstruct
stdim st, RPC_HTTP_TRANSPORT_CREDENTIALS_W ; NSTRUCT 変数を確保
st->Flags = 100
mes "Flags=" + st->Flags