xref: /freebsd/crypto/krb5/doc/html/_sources/appdev/refs/api/krb5_get_validated_creds.rst.txt (revision 7f2fe78b9dd5f51c821d771b63d2e096f6fd49e9)
1krb5_get_validated_creds -  Get validated credentials from the KDC.
2====================================================================
3
4..
5
6.. c:function:: krb5_error_code krb5_get_validated_creds(krb5_context context, krb5_creds * creds, krb5_principal client, krb5_ccache ccache, const char * in_tkt_service)
7
8..
9
10
11:param:
12
13	          **[in]** **context** - Library context
14
15	          **[out]** **creds** - Validated credentials
16
17	          **[in]** **client** - Client principal name
18
19	          **[in]** **ccache** - Credential cache
20
21	          **[in]** **in_tkt_service** - Server principal string (or NULL)
22
23
24..
25
26
27:retval:
28         -   0   Success
29         -   KRB5_NO_2ND_TKT   Request missing second ticket
30         -   KRB5_NO_TKT_SUPPLIED   Request did not supply a ticket
31         -   KRB5_PRINC_NOMATCH   Requested principal and ticket do not match
32         -   KRB5_KDCREP_MODIFIED   KDC reply did not match expectations
33         -   KRB5_KDCREP_SKEW   Clock skew too great in KDC reply
34
35
36:return:
37         -  Kerberos error codes
38
39..
40
41
42
43
44
45
46
47This function gets a validated credential using a postdated credential from *ccache* . If *in_tkt_service* is specified, it is parsed (with the realm part ignored) and used as the server principal of the credential; otherwise, the ticket-granting service is used.
48
49
50
51If successful, the validated credential is placed in *creds* .
52
53
54
55
56
57
58
59
60
61
62..
63
64
65
66
67
68