コンテキストの作成

コンテキストは、rpc_gss_seccreate() を使用して作成します。この関数では引数として次のものをとります。

• クライアントハンドル（たとえば、clnt_create()によって戻されたもの）

• サーバーの主体名 ( nfs@acme.com)

• セッションのメカニズム (Kerberos V5 など)

• セキュリティサービスタイプ (プライバシなど)

• セッションの QOP

• 使用される場合は、ほとんど不透明（ opaque ）なまま使用される (つまり、プログラマが NULL 値を入れることができる) 2 つの GSS-API パラメータ

この関数は、AUTH 認証ハンドルを返します。次のプログラムでは、Kerberos v5 セキュリテメカニズムと完全性サービスを使用したコンテキストを作成する場合、rpc_gss_seccreate() がどのように使用されるかを示しています。

例 5–10 rpc_gss_seccreate()

 
CLIENT *clnt;						/* クライアントハンドル */
char server_host[] = "foo";
char service_name[] = "nfs@machine.eng.company.com";
char mech[] = "kerberosv5";
 
clnt = clnt_create(server_host, SERVER_PROG, SERV_VERS, "netpath");
clnt->clnt_auth = rpc_gss_seccreate(clnt, service_name, mech,
                          rpc_gss_svc_integrity, NULL, NULL, NULL); 

. . .

次の点に注意してください。

• メカニズムは明示的に宣言してありますが (読みやすくするために)、通常は、rpc_gss_get_mechanisms() を用いて、使用できるメカニズムの表から入手します。

• QOP は、NULL として渡されます。これにより、QOP はこのメカニズムのデフォルトに設定されます。これ以外の場合は、このメカニズムを使用して、rpc_gss_get_mechanisms() を指定したプログラムで有効な値を入手できます。詳細については、マニュアルページの rpc_gss_get_mechanisms(3NSL) を参照してください。

• セキュリティサービスタイプ、rpc_gss_svc_integrity は、RPCSEC_GSS タイプの enum のひとつである rpc_gss_service_t です。rpc_gss_service_t のフォーマットは、次のようになります。

  ---

  typedef enum {
       rpc_gss_svc_default = 0,
       rpc_gss_svc_none = 1,
       rpc_gss_svc_integrity = 2,
       rpc_gss_svc_privacy = 3
  }  rpc_gss_service_t;

  ---

  デフォルトのセキュリティサービスは、完全性をマップするため、プログラマは指定された rpc_gss_svc_default を入手し、同じ結果を獲得することができます。

詳細については、rpc_gss_seccreate(3NSL) のマニュアルページを参照してください。