gssdce_register_acceptor_identity(3sec)
Registers a context acceptor's identity
Synopsis
#include <dce/gssapi.h>
OM_uint32 gss_register_acceptor_identity (
OM_uint32 *minor_status,
unsigned_char_t *acceptor_principal_name,
rpc_auth_key_retrieval_fn_t get_key_fn,
void
*arg);
Parameters
Input
acceptor_principal_name
Specifies the principal name to use for the context acceptor.
get_key_fn
Specifies either the DCE default key-retrieval routine or the address of a routine that returns encryption keys.
arg
Specifies an argument to pass to the get_key_fn key acquisition routine. To specify the DCE default, use NULL.
Output
minor_status
Returns a status code from the security mechanism.
Description
The gssdce_register_acceptor_identity( ) routine registers the server principal name as an identity claimed by the context acceptor and informs DCE security
where to find the key table containing the principal's key information.
The gssdce_register_acceptor_identity( ) routine uses the get_key_fn and arg parameters of the rpc_server_register_auth_info( ) routine to find the key for the token for the context acceptor's principal name. The following table lists the values for the parameters and which key tables they point to:
| Retrieval Routine get_key_fn | Key Table arg |
Explanation |
| NULL | NULL | Uses the default DCE retrieval routine to get the key from the DCE key table via the default key table, /krb/v5srvtab. |
| NULL | string=key_table_name | Uses the default DCE retrieval routine to get the key from the a key table whose name you specify using the argument string. |
| routine_address | user_written_routine | Uses a user-written retrieval routine to get the key from a key table specified in the routine. |
For more information on registering a server with DCE, refer to the rpc_server_register_auth_info(3rpc) reference page.
Errors
The following describes a partial list of errors that might be returned. Refer to the OSF DCE Problem Determination Guide for complete descriptions of all error messages.
| GSS_S_COMPLETE | The routine was completed successfully. |
| GSS_S_FAILURE | The routine failed. Check the minor status for details. |
Functions:
rpc_server_register_auth_info(3rpc)