KERB_RETRIEVE_TKT_REQUEST 구조체(ntsecapi.h)
KERB_RETRIEVE_TKT_REQUEST 구조에는 티켓을 검색하는 데 사용되는 정보가 포함되어 있습니다.
LsaCallAuthenticationPackage에서 사용됩니다. Kerberos 티켓은 인터넷 RFC 4120에 정의되어 있습니다. 자세한 내용은 http://www.ietf.org를 참조하세요.
구문
typedef struct _KERB_RETRIEVE_TKT_REQUEST {
KERB_PROTOCOL_MESSAGE_TYPE MessageType;
LUID LogonId;
UNICODE_STRING TargetName;
ULONG TicketFlags;
ULONG CacheOptions;
LONG EncryptionType;
SecHandle CredentialsHandle;
} KERB_RETRIEVE_TKT_REQUEST, *PKERB_RETRIEVE_TKT_REQUEST;
멤버
MessageType
KERB_PROTOCOL_MESSAGE_TYPE 요청 유형을 나타내는 값입니다. 이 멤버는 KerbRetrieveEncodedTicketMessage로 설정해야 합니다.
LogonId
로그온 세션 식별자를 포함하는 LUID 구조체입니다. 현재 사용자의 로그온 세션에 대해 0일 수 있습니다. 0이 아니면 호출자에게 SeTcbPrivilege 권한 집합이 있어야 합니다. 이 오류가 발생하면 Kerberos 인증 패키지는 LsaCallAuthenticationPackage의 ProtocolStatus 매개 변수를 STATUS_ACCESS_DENIED 설정합니다.
TargetName
대상 서비스의 이름을 포함하는 UNICODE_STRING.
TicketFlags
검색된 티켓에 대한 사용을 지정하는 플래그를 포함합니다. TicketFlags가 0으로 설정되고 캐시에 일치하는 티켓이 있는 경우 플래그 값에 관계없이 해당 티켓이 반환됩니다. 캐시에 일치하는 항목이 없으면 기본 플래그 값이 있는 새 티켓이 요청됩니다.
이 멤버가 0으로 설정되지 않은 경우 반환된 티켓은 캐시되지 않습니다.
CacheOptions
캐시 검색 옵션을 나타냅니다. 캐시를 검색해야 하며 티켓이 없으면 새 티켓을 요청해야 함을 나타내려면 이 멤버를 0으로 설정합니다.
이 멤버가 0으로 설정되지 않은 경우 반환된 티켓은 캐시되지 않습니다.
CacheOptions는 다음 값을 포함할 수 있습니다.
| 값 | 의미 |
|---|---|
|
항상 새 티켓을 요청합니다. 는 캐시를 검색하지 않습니다.
티켓을 가져온 경우 Kerberos 인증 패키지는 LsaCallAuthenticationPackage 함수의 ProtocolStatus 매개 변수에 STATUS_SUCCESS 반환합니다. |
|
LogonId 대신 CredentialsHandle 멤버를 사용하여 로그온 세션을 식별합니다. 자격 증명 핸들은 티켓이 검색되는 클라이언트 자격 증명으로 사용됩니다. 참고 이 옵션은 64비트 Windows에서 실행되는 32비트 Windows 기반 애플리케이션에는 사용할 수 없습니다. |
|
이전에 캐시된 티켓만 반환합니다.
이러한 티켓을 찾을 수 없는 경우 Kerberos 인증 패키지는 LsaCallAuthenticationPackage 함수의 ProtocolStatus 매개 변수에 STATUS_OBJECT_NAME_NOT_FOUND 반환합니다. |
|
티켓을 Kerberos 자격 증명으로 반환합니다. Kerberos 티켓은 인터넷 RFC 4120 에서 KRB_CRED 정의됩니다. 자세한 내용은 http://www.ietf.org를 참조하세요. |
|
구현되지 않았습니다. |
|
현재 캐시에 있는 티켓을 반환합니다. 티켓이 캐시에 없으면 요청된 다음 캐시됩니다. 이 플래그는 KERB_RETRIEVE_TICKET_DONT_USE_CACHE 플래그와 함께 사용하면 안 됩니다.
WINDOWS XP SP1 이하 및 Windows Server 2003: 이 옵션은 사용할 수 없습니다. |
|
정책에서 허용되는 최대 시간으로 새 티켓을 반환합니다. 시세는 나중에 캐시됩니다. 이 플래그를 사용하면 KERB_RETRIEVE_TICKET_USE_CACHE_ONLY 설정되지 않고 KERB_RETRIEVE_TICKET_CACHE_TICKET 설정됨을 의미합니다.
Windows Vista, Windows Server 2008, WINDOWS XP SP1 이하 및 Windows Server 2003: 이 옵션은 사용할 수 없습니다. |
EncryptionType
요청된 티켓에 사용할 암호화 유형을 지정합니다. 이 멤버가 0으로 설정되지 않은 경우 반환된 티켓은 캐시되지 않습니다.
이 멤버는 다음 값 중 하나를 가질 수 있습니다.
| 값 | 의미 |
|---|---|
|
CRC-32 체크섬이 있는 암호 블록 체인 모드에서 DES 암호화를 사용합니다. |
|
MD4 체크섬이 있는 암호 블록 체인 모드에서 DES 암호화를 사용합니다. |
|
MD5 체크섬이 있는 암호 블록 체인 모드에서 DES 암호화를 사용합니다. |
|
암호화를 사용하지 않습니다. |
|
Windows에서 사용하는 해시 기반 MAC(메시지 인증 코드)과 함께 RC4 스트림 암호화를 사용합니다. |
|
MD4 해시 함수와 함께 RC4 스트림 암호화를 사용합니다. |
|
127보다 큰 값은 로컬 값에 대해 예약되어 있으며 예고 없이 변경 될 수 있습니다. |
CredentialsHandle
로그온 세션 식별자 대신 사용되는 SSPI 자격 증명 핸들입니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows XP [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2003 [데스크톱 앱만 해당] |
| 머리글 | ntsecapi.h |