LWP::Authen::Negotiate(3pm)

LWP::Authen::Negotiate3pm

Gssapi based authentication plugin for lwp

Usage

   #! /usr/bin/perl -w
   use strict;
   require LWP::UserAgent;
   # uncomment if you want see what is going wrong messages
   #
   #use LWP::Debug qw(+);
   my $ua = LWP::UserAgent->new;
   my $response = $ua->get('http://testwurst.grolmsnet.lan:8090/geheim/');
   if ($response->is_success) {
      print $response->content;  # or whatever
   }
   else {
       die $response->status_line;
   }

just install LWP::Authen::Negotiate, LWP uses it as authentication plugin. Use your LWP::UserAgent Scripts as usual. Authentication is done transparent based on your GSSAPI installation (MIT Kerberos or Heimdal)

WWW-Negotiate Webservers are IIS or Apache with mod_auth_kerb for example.

Overview

To see what ist going on add

   use LWP::Debug qw(+);

to yor LWP using Scripts.

(e.g. too see what is going wrong with GSSAPI...)

Debugging

To see what ist going on (and going wrong) add

   use LWP::Debug qw(+);

to yor LWP using Scripts.

(e.g. too see what is going wrong with GSSAPI...)

the output will look like this:

   LWP::UserAgent::new: ()
   LWP::UserAgent::request: ()
   LWP::UserAgent::send_request: GET http://testwurst.grolmsnet.lan:8090/geheim/
   LWP::UserAgent::_need_proxy: Not proxied
   LWP::Protocol::http::request: ()
   LWP::Protocol::collect: read 478 bytes
   LWP::UserAgent::request: Simple response: Unauthorized
   LWP::Authen::Negotiate::authenticate: authenticate() called
   LWP::Authen::Negotiate::authenticate: target hostname testwurst.grolmsnet.lan
   LWP::Authen::Negotiate::authenticate: GSSAPI servicename     HTTP/[email protected]
   LWP::Authen::Negotiate::authenticate:  Miscellaneous failure (see text)
   LWP::Authen::Negotiate::authenticate: open(/tmp/krb5cc_1000): file not found

In this case the credentials cache was empty. Run kinit first ;-)

Environment

LWP_AUTHEN_NEGOTIATE_DELEGATE

Define to enable ticket forwarding to webserver.

Releases

9 releases since Debian 5.0 (Lenny); the text changed 4 times.

  1. 5.0
  2. 6.0–7
  3. 8–9
  4. 10
  5. 11–13

Bugs

As default Kerberos 5 is selected as GSSAPI mechanism. a later veriosn will make that configureable.

Author

Achim Grolms, <[email protected]>

http://perlgssapi.sourceforge.net/

Thanks to

Leif Johansson

who has conributed a lot of code from his implementation of the module and send a lot of input, ideas and feedback

Harald Joerg

helped with Kerberos knowledge and does testing on cygwin against IIS and mod_auth_kerb

Christopher Odenbach

does a lot of testing on Linux and Solaris

Dax Kelson

does a lot of testing on Linux

Karsten Kuenne

helped with advice

From liblwp-authen-negotiate-perl 0.08-3 in Debian 13 (Trixie). Parsed by carta from the page's man source.