Name

gnutls_authz_send_saml_assertion_url — API function

Synopsis

#include <gnutls/gnutls.h>
int gnutls_authz_send_saml_assertion_url( gnutls_session_t   session,
  const char *   url,
  size_t   urllen,
  gnutls_mac_algorithm_t   hash_type,
  const char *   hash);

ARGUMENTS

gnutls_session_t session

is a gnutls_session_t structure.

const char * url

buffer with a URL pointing to a SAML assertion.

size_t urllen

length of buffer.

gnutls_mac_algorithm_t hash_type

type of hash in hash.

const char * hash

buffer with hash of URL target.

DESCRIPTION

Send a URL to a SAML assertion as authorization data, including a hash used to make sure the retrieved data was the intended data. This function may only be called inside a send_callback set by gnutls_authz_enable().

RETURNS

Returns 0 on success, or an error code on failures. If the supplied data was too long (the authorization extension only support 64kb large URLs), GNUTLS_E_INVALID_REQUEST is returned.

REPORTING BUGS

Report bugs to <bug-gnutls@gnu.org>.

SEE ALSO

The full documentation for gnutls is maintained as a Texinfo manual. If the info and gnutls programs are properly installed at your site, the command

info gnutls

should give you access to the complete manual.

COPYRIGHT

Copyright © 2006 Free Software Foundation.

Permission is granted to make and distribute verbatim copies of this manual provided the copyright notice and this permission notice are preserved on all copies.