{"id":7337,"date":"2022-12-20T19:37:44","date_gmt":"2022-12-20T22:37:44","guid":{"rendered":"http:\/\/lode.uno\/linux-man\/index.php\/2022\/12\/20\/lwpauthenntlm-man3\/"},"modified":"2022-12-20T19:37:44","modified_gmt":"2022-12-20T22:37:44","slug":"lwpauthenntlm-man3","status":"publish","type":"post","link":"https:\/\/lode.uno\/linux-man\/2022\/12\/20\/lwpauthenntlm-man3\/","title":{"rendered":"LWP::Authen::Ntlm (man3)"},"content":{"rendered":"

LWP::Authen::Ntlm<\/h1>\n

NAME<\/a>
SYNOPSIS<\/a>
DESCRIPTION<\/a>
USAGE<\/a>
AVAILABILITY<\/a>
COPYRIGHT<\/a>
SEE ALSO<\/a> <\/p>\n

\n

NAME <\/a> <\/h2>\n

LWP::Authen::Ntlm \u2212 Library for enabling NTLM authentication (Microsoft) in LWP<\/p>\n

SYNOPSIS <\/a> <\/h2>\n

use LWP::UserAgent;
use HTTP::Request::Common;
my $url = ‘http:\/\/www.company.com\/protected_page.html’;
# Set up the ntlm client and then the base64 encoded ntlm handshake message
my $ua = LWP::UserAgent\u2212>new(keep_alive=>1);
$ua\u2212>credentials(‘www.company.com:80’, ”, “MyDomain\\MyUserCode”, ‘MyPassword’);
$request = GET $url;
print “\u2212\u2212Performing request now…\u2212\u2212\u2212\u2212\u2212\u2212\u2212\u2212\u2212\u2212\u2212n”;
$response = $ua\u2212>request($request);
print “\u2212\u2212Done with request\u2212\u2212\u2212\u2212\u2212\u2212\u2212\u2212\u2212\u2212\u2212\u2212\u2212\u2212\u2212\u2212\u2212\u2212\u2212n”;
if ($response\u2212>is_success) {print “It worked!\u2212>” . $response\u2212>code . “n”}
else {print “It didn’t work!\u2212>” . $response\u2212>code . “n”}<\/p>\n

DESCRIPTION <\/a> <\/h2>\n

LWP::Authen::Ntlm allows LWP<\/small> to authenticate against servers that are using the NTLM<\/small> authentication scheme popularized by Microsoft. This type of authentication is common on intranets of Microsoft-centric organizations.<\/p>\n

The module takes advantage of the Authen::NTLM module by Mark Bush. Since there is also another Authen::NTLM module available from CPAN<\/small> by Yee Man Chan with an entirely different interface, it is necessary to ensure that you have the correct NTLM<\/small> module.<\/p>\n

In addition, there have been problems with incompatibilities between different versions of Mime::Base64, which Bush\u2019s Authen::NTLM makes use of. Therefore, it is necessary to ensure that your Mime::Base64 module supports exporting of the encode_base64 and decode_base64 functions.<\/p>\n

USAGE <\/a> <\/h2>\n

The module is used indirectly through LWP,<\/small> rather than including it directly in your code. The LWP<\/small> system will invoke the NTLM<\/small> authentication when it encounters the authentication scheme while attempting to retrieve a URL<\/small> from a server. In order for the NTLM<\/small> authentication to work, you must have a few things set up in your code prior to attempting to retrieve the URL:<\/small><\/p>\n\n\n
<\/td>\n\n

\u2022<\/p>\n<\/td>\n

<\/td>\n\n

Enable persistent HTTP<\/small> connections<\/p>\n<\/td>\n

 <\/td>\n<\/tr>\n<\/table>\n

To do this, pass the “keep_alive=>1” option to the LWP::UserAgent when creating it, like this:<\/p>\n

my $ua = LWP::UserAgent\u2212>new(keep_alive=>1);<\/p>\n\n\n
<\/td>\n\n

\u2022<\/p>\n<\/td>\n

<\/td>\n\n

Set the credentials on the UserAgent object<\/p>\n<\/td>\n

 <\/td>\n<\/tr>\n<\/table>\n

The credentials must be set like this:<\/p>\n

$ua\u2212>credentials(‘www.company.com:80’, ”, “MyDomain\\MyUserCode”, ‘MyPassword’);<\/p>\n

Note that you cannot use the HTTP::Request object\u2019s authorization_basic()<\/b> method to set the credentials. Note, too, that the \u2019www.company.com:80\u2019 portion only sets credentials on the specified port AND<\/small> it is case-sensitive (this is due to the way LWP<\/small> is coded, and has nothing to do with LWP::Authen::Ntlm)<\/p>\n

AVAILABILITY <\/a> <\/h2>\n

General queries regarding LWP<\/small> should be made to the LWP<\/small> Mailing List.<\/p>\n

Questions specific to LWP::Authen::Ntlm can be forwarded to jtillman@bigfoot.com<\/p>\n

COPYRIGHT <\/a> <\/h2>\n

Copyright (c) 2002 James Tillman. All rights reserved. This program is free software; you can redistribute it and\/or modify it under the same terms as Perl itself.<\/p>\n

SEE ALSO <\/a> <\/h2>\n

LWP<\/small> , LWP::UserAgent, lwpcook.<\/p>\n

\n","protected":false},"excerpt":{"rendered":"

LWP::Authen::Ntlm \u2212 Library for enabling NTLM authentication (Microsoft) in LWP <\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[1],"tags":[3655,3007],"class_list":["post-7337","post","type-post","status-publish","format-standard","hentry","category-sin-categoria","tag-lwpauthenntlm","tag-man3"],"gutentor_comment":0,"_links":{"self":[{"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/posts\/7337","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/comments?post=7337"}],"version-history":[{"count":0,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/posts\/7337\/revisions"}],"wp:attachment":[{"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/media?parent=7337"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/categories?post=7337"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/tags?post=7337"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}