1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38
|
KRB5_ANAME_TO_LOCALNA... BSD Library Functions Manual KRB5_ANAME_TO_LOCALNA...
NNAAMMEE
kkrrbb55__aannaammee__ttoo__llooccaallnnaammee -- converts a principal to a system local name
LLIIBBRRAARRYY
Kerberos 5 Library (libkrb5, -lkrb5)
SSYYNNOOPPSSIISS
##iinncclluuddee <<kkrrbb55..hh>>
_k_r_b_5___b_o_o_l_e_a_n
kkrrbb55__aannaammee__ttoo__llooccaallnnaammee(_k_r_b_5___c_o_n_t_e_x_t _c_o_n_t_e_x_t, _k_r_b_5___c_o_n_s_t___p_r_i_n_c_i_p_a_l _n_a_m_e,
_s_i_z_e___t _l_n_s_i_z_e, _c_h_a_r _*_l_n_a_m_e);
DDEESSCCRRIIPPTTIIOONN
This function takes a principal _n_a_m_e, verifies that it is in the local
realm (using kkrrbb55__ggeett__ddeeffaauulltt__rreeaallmmss()) and then returns the local name
of the principal.
If _n_a_m_e isn't in one of the local realms an error is returned.
If the size (_l_n_s_i_z_e) of the local name (_l_n_a_m_e) is too small, an error is
returned.
kkrrbb55__aannaammee__ttoo__llooccaallnnaammee() should only be use by an application that
implements protocols that don't transport the login name and thus needs
to convert a principal to a local name.
Protocols should be designed so that they authenticate using Kerberos,
send over the login name and then verify the principal that is authenti-
cated is allowed to login and the login name. A way to check if a user
is allowed to login is using the function kkrrbb55__kkuusseerrookk().
SSEEEE AALLSSOO
krb5_get_default_realms(3), krb5_kuserok(3)
HEIMDAL February 18, 2006 HEIMDAL
|