argra****@users*****
argra****@users*****
2010年 10月 21日 (木) 04:56:20 JST
Index: docs/modules/libwww-perl-5.813/LWP/Authen/Ntlm.pod diff -u /dev/null docs/modules/libwww-perl-5.813/LWP/Authen/Ntlm.pod:1.1 --- /dev/null Thu Oct 21 04:56:20 2010 +++ docs/modules/libwww-perl-5.813/LWP/Authen/Ntlm.pod Thu Oct 21 04:56:20 2010 @@ -0,0 +1,214 @@ + +=encoding euc-jp + +=head1 NAME + +=begin original + +LWP::Authen::Ntlm - Library for enabling NTLM authentication (Microsoft) in LWP + +=end original + +LWP::Authen::Ntlm - LWP で (Microsoft) NTLM 認証を有効にするライブラリ + +=head1 SYNOPSIS + + 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 = new LWP::UserAgent(keep_alive=>1); + $ua->credentials('www.company.com:80', '', "MyDomain\\MyUserCode", 'MyPassword'); + + $request = GET $url; + print "--Performing request now...-----------\n"; + $response = $ua->request($request); + print "--Done with request-------------------\n"; + + if ($response->is_success) {print "It worked!->" . $response->code . "\n"} + else {print "It didn't work!->" . $response->code . "\n"} + +=head1 DESCRIPTION + +=begin original + +C<LWP::Authen::Ntlm> allows LWP to authenticate against servers that are using the +NTLM authentication scheme popularized by Microsoft. This type of authentication is +common on intranets of Microsoft-centric organizations. + +=end original + +C<LWP::Authen::Ntlm> allows LWP to authenticate against servers that are using the +NTLM authentication scheme popularized by Microsoft. This type of authentication is +common on intranets of Microsoft-centric organizations. +(TBT) + +=begin original + +The module takes advantage of the Authen::NTLM module by Mark Bush. Since there +is also another Authen::NTLM module available from CPAN by Yee Man Chan with an +entirely different interface, it is necessary to ensure that you have the correct +NTLM module. + +=end original + +The module takes advantage of the Authen::NTLM module by Mark Bush. Since there +is also another Authen::NTLM module available from CPAN by Yee Man Chan with an +entirely different interface, it is necessary to ensure that you have the correct +NTLM module. +(TBT) + +=begin original + +In addition, there have been problems with incompatibilities between different +versions of Mime::Base64, which Bush's 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. + +=end original + +In addition, there have been problems with incompatibilities between different +versions of Mime::Base64, which Bush's 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. +(TBT) + +=head1 USAGE + +=begin original + +The module is used indirectly through LWP, rather than including it directly in your +code. The LWP system will invoke the NTLM authentication when it encounters the +authentication scheme while attempting to retrieve a URL from a server. In order +for the NTLM authentication to work, you must have a few things set up in your +code prior to attempting to retrieve the URL: + +=end original + +The module is used indirectly through LWP, rather than including it directly in your +code. The LWP system will invoke the NTLM authentication when it encounters the +authentication scheme while attempting to retrieve a URL from a server. In order +for the NTLM authentication to work, you must have a few things set up in your +code prior to attempting to retrieve the URL: +(TBT) + +=over 4 + +=item * + +=begin original + +Enable persistent HTTP connections + +=end original + +Enable persistent HTTP connections +(TBT) + +=begin original + +To do this, pass the "keep_alive=>1" option to the LWP::UserAgent when creating it, like this: + +=end original + +To do this, pass the "keep_alive=>1" option to the LWP::UserAgent when creating it, like this: +(TBT) + + my $ua = new LWP::UserAgent(keep_alive=>1); + +=item * + +=begin original + +Set the credentials on the UserAgent object + +=end original + +UserAgent オブジェクトに証明書をセットする + +=begin original + +The credentials must be set like this: + +=end original + +証明書は以下のようなものでなければなりません: + + $ua->credentials('www.company.com:80', '', "MyDomain\\MyUserCode", 'MyPassword'); + +=begin original + +Note that you cannot use the HTTP::Request object's authorization_basic() method to set +the credentials. Note, too, that the 'www.company.com:80' portion only sets credentials +on the specified port AND it is case-sensitive (this is due to the way LWP is coded, and +has nothing to do with LWP::Authen::Ntlm) + +=end original + +Note that you cannot use the HTTP::Request object's authorization_basic() method to set +the credentials. Note, too, that the 'www.company.com:80' portion only sets credentials +on the specified port AND it is case-sensitive (this is due to the way LWP is coded, and +has nothing to do with LWP::Authen::Ntlm) +(TBT) + +=back + +=begin original + +If you run into trouble and need help troubleshooting your problems, try enabling LWP +debugging by putting this line at the top of your code: + +=end original + +If you run into trouble and need help troubleshooting your problems, try enabling LWP +debugging by putting this line at the top of your code: +(TBT) + + use LWP::Debug qw(+); + +=begin original + +You should get copious debugging output, including messages from LWP::Authen::Ntlm itself. + +=end original + +You should get copious debugging output, including messages from LWP::Authen::Ntlm itself. +(TBT) + +=head1 AVAILABILITY + +=begin original + +General queries regarding LWP should be made to the LWP Mailing List. + +=end original + +General queries regarding LWP should be made to the LWP Mailing List. +(TBT) + +=begin original + +Questions specific to LWP::Authen::Ntlm can be forwarded to jtill****@bigfo***** + +=end original + +Questions specific to LWP::Authen::Ntlm can be forwarded to jtill****@bigfo***** +(TBT) + +=head1 COPYRIGHT + +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. + +=head1 SEE ALSO + +L<LWP>, L<LWP::UserAgent>, L<lwpcook>. + +=begin meta + +Translated: Kentaro SHIRAKATA <argra****@ub32*****> (5.813) + +=end meta +
