名称

gss_delete_sec_context — セキュリティコンテキストを破棄する

書式

#include < gssapi/gssapi.h>

OM_uint32
gss_delete_sec_context( OM_uint32 *minor_status, gss_ctx_id_t *context_handle, gss_buffer_t output_token);

解説

セキュリティコンテキストを削除します。 gss_delete_sec_context() は、output_token を生成する同様に行うことを指示するピア (相手側) の gss_process_context_token() に渡されるとき、指定されたセキュリティコンテキストに関連しているローカルデータ構造を削除します。トークンがメカニズムによって必要とされないなら、GSS-API は、 (提供されるなら) output_token の長さフィールドを 0 に設定するべきです。さらなるセキュリティサービスは、 context_handle によって指定されたコンテキストを使用して取得されません。

確立したセキュリティコンテキストを削除することに加えて、 gss_delete_sec_context() は、また gss_init_sec_context() / gss_accept_sec_context() 呼び出しの不完全なシーケンスに由来する "half-built" (半分構築) のセキュリティコンテキストを削除することができなければなりません。

output_token パラメータは、GSS-API のバージョン 1 との互換性のために保持されています。両方のピアのアプリケーションが、トークンが必要でなく、 gss_delete_sec_context() が単にローカルのコンテキストのデータ構造を削除するべきであることを示す、 output_token パラメータのために値 GSS_C_NO_BUFFER を渡して gss_delete_sec_context() を呼び出すことは、お勧めです。アプリケーションが有効なバッファを gss_delete_sec_context() に渡すなら、メカニズムは、ピアの動作が必要でなく、トークンがアプリケーションによって転送されるべきでないことを示す、長さ 0 のトークンを返すことが奨励されます。

パラメータ

minor_status

メカニズム特有のステータスコード。

context_handle

削除するコンテキストを識別するコンテキストハンドル。コンテキストを削除した後に、GSS-API は、このコンテキストハンドルを GSS_C_NO_CONTEXT に設定します。

output_token

また、コンテキストを削除するようにそれに指示するためにリモートアプリケーションに送信されるトークン。アプリケーションが、ローカルの削除だけを要求する、このパラメータのために GSS_C_NO_BUFFER を指定することはお勧めです。バッファパラメータがアプリケーションによって提供されるなら、メカニズムは、それにトークンを返します。ローカルな削除だけを実装するメカニズムは、このトークンの長さフィールドに、トークンがピアに送信されないことをアプリケーションに示すように 0 に設定するべきです。

戻り値

GSS_S_COMPLETE

成功して終了した

GSS_S_NO_CONTEXT

有効なコンテキストが、提供されませんでした

関連項目

gss_process_context_token(3), gss_init_sec_context(3), gss_accept_sec_context(3)

規格

RFC 2743

Generic Security Service Application Program Interface Version 2, Update 1

RFC 2744

Generic Security Service API Version 2 : C-bindings

歴史

gss_delete_sec_context のマニュアルページは、 FreeBSD 7.0 ではじめて登場しました。

作者

John Wray, Iris Associates

COPYRIGHT

Copyright (C) The Internet Society (2000). All Rights Reserved.

This document and translations of it may be copied and furnished to others, and derivative works that comment on or otherwise explain it or assist in its implementation may be prepared, copied, published and distributed, in whole or in part, without restriction of any kind, provided that the above copyright notice and this paragraph are included on all such copies and derivative works. However, this document itself may not be modified in any way, such as by removing the copyright notice or references to the Internet Society or other Internet organizations, except as needed for the purpose of developing Internet standards in which case the procedures for copyrights defined in the Internet Standards process must be followed, or as required to translate it into languages other than English.

The limited permissions granted above are perpetual and will not be revoked by the Internet Society or its successors or assigns.

This document and the information contained herein is provided on an "AS IS" basis and THE INTERNET SOCIETY AND THE INTERNET ENGINEERING TASK FORCE DISCLAIMS ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE INFORMATION HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.