.\" Automatically generated by Pod::Man 4.10 (Pod::Simple 3.35) .\" .\" Standard preamble: .\" ======================================================================== .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" Set up some character translations and predefined strings. \*(-- will .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left .\" double quote, and \*(R" will give a right double quote. \*(C+ will .\" give a nicer C++. Capital omega is used to do unbreakable dashes and .\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff, .\" nothing in troff, for use with C<>. .tr \(*W- .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' .ie n \{\ . ds -- \(*W- . ds PI pi . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch . ds L" "" . ds R" "" . ds C` "" . ds C' "" 'br\} .el\{\ . ds -- \|\(em\| . ds PI \(*p . ds L" `` . ds R" '' . ds C` . ds C' 'br\} .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" If the F register is >0, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .\" .\" Avoid warning from groff about undefined register 'F'. .de IX .. .nr rF 0 .if \n(.g .if rF .nr rF 1 .if (\n(rF:(\n(.g==0)) \{\ . if \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . if !\nF==2 \{\ . nr % 0 . nr F 2 . \} . \} .\} .rr rF .\" ======================================================================== .\" .IX Title "LWP::Authen::OAuth2 3pm" .TH LWP::Authen::OAuth2 3pm "2019-03-01" "perl v5.28.1" "User Contributed Perl Documentation" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .SH "NAME" LWP::Authen::OAuth2 \- Make requests to OAuth2 APIs. .SH "VERSION" .IX Header "VERSION" Version 0.15 .SH "SYNOPSIS" .IX Header "SYNOPSIS" OAuth 2 is a protocol that lets a \fIuser\fR tell a \fIservice provider\fR that a \&\fIconsumer\fR has permission to use the \fIservice provider\fR's APIs to do things that require access to the \fIuser\fR's account. This module tries to make life easier for someone who wants to write a \fIconsumer\fR in Perl. .PP Specifically it provides convenience methods for all of the requests that are made to the \fIservice provider\fR as part of the permission handshake, and after that will proxy off of LWP::UserAgent to let you send properly authenticated requests to the \s-1API\s0 that you are trying to use. When possible, this will include transparent refresh/retry logic for access tokens expiration. .PP For a full explanation of OAuth 2, common terminology, the requests that get made, and the necessary tasks that this module does not address, please see LWP::Authen::OAuth2::Overview .PP This module will not help with OAuth 1. See the similarly named but unrelated LWP::Authen::OAuth for a module that can help with that. .PP Currently LWP::Authen::OAuth2 provides ready-to-use classes to use OAuth2 with .IP "\(bu" 4 Dwolla .Sp LWP::Authen::OAuth2::ServiceProvider::Dwolla .Sp implemented by Adi Fairbank .IP "\(bu" 4 Google .Sp LWP::Authen::OAuth2::ServiceProvider::Google .IP "\(bu" 4 Line .Sp LWP::Authen::OAuth2::ServiceProvider::Line .Sp implemented by Adam Millerchip .IP "\(bu" 4 Strava .Sp LWP::Authen::OAuth2::ServiceProvider::Strava .Sp implemented by Leon Wright .IP "\(bu" 4 Yahoo .Sp LWP::Authen::OAuth2::ServiceProvider::Yahoo .Sp implemented by Michael Stevens .PP You can also access any other OAuth2 service by setting up a plain \f(CW\*(C`LWP::Authen::OAuth2\*(C'\fR object. If you do, and the service provider might be of interest to other people, please submit a patch so we can include it in this distribution, or release it as a standalone package. .PP Here are examples of simple usage. .PP .Vb 1 \& use LWP::Authen::OAuth2; \& \& # Constructor \& my $oauth2 = LWP::Authen::OAuth2\->new( \& client_id => "Public from service provider", \& client_secret => "s3cr3t fr0m svc prov", \& service_provider => "Google", \& redirect_uri => "https://your.url.com/", \& \& # Optional hook, but recommended. \& save_tokens => \e&save_tokens, \& save_tokens_args => [ $dbh ], \& \& # This is for when you have tokens from last time. \& token_string => $token_string. \& ); \& \& # URL for user to go to to start the process. \& my $url = $oauth2\->authorization_url(); \& \& # The authorization_url sends the user to the service provider to \& # say that you want to be authorized. After the user confirms that \& # request, the service provider sends the user back to you with a \& # code. This might be a CGI parameter, something that the user is \& # supposed to paste to you \- that\*(Aqs between you and the service \& # provider. \& \& # Assuming that you have your code, get your tokens from the service \& # provider. \& $oauth2\->request_tokens(code => $code); \& \& # Get your token as a string you can easily store, pass around, etc. \& # If you have a save_tokens callback, that gets passed this string \& # whenever the tokens change. \& # \& # This string bears a suspicious resemblance to serialized JSON. \& my $token_string = $oauth2\->token_string, \& \& # Access the API. Consult the service_provider\*(Aqs documentation for when \& # to use which type of request. Note that argument processing is the \& # same as in LWP. Thus the parameters array and headers hash are both \& # optional. \& $oauth2\->get($url, %header); \& $oauth2\->post($url, \e@parameters, %header); \& $oauth2\->put($url, %header); \& $oauth2\->delete($url, %header); \& $oauth2\->head($url, %header); \& \& # And if you need more flexibility, you can use LWP::UserAgent\*(Aqs request \& # method \& $oauth2\->request($http_request, $content_file); \& \& # In some flows you can refresh tokens, in others you have to go through \& # the handshake yourself. This method lets you know whether a refresh \& # looks possible. \& $oauth2\->can_refresh_tokens(); \& \& # This method lets you know when it is time to reauthorize so that you \& # can find out in a nicer way than failing an API call. \& $oauth2\->should_refresh(); .Ve .SH "CONSTRUCTOR" .IX Header "CONSTRUCTOR" When you call \f(CW\*(C`LWP::Authen::OAuth2\->new(...)\*(C'\fR, arguments are passed as a key/value list. They are processed in the following phases: .IP "Construct service provider" 4 .IX Item "Construct service provider" .PD 0 .IP "Service provider collects arguments it wants" 4 .IX Item "Service provider collects arguments it wants" .IP "LWP::Authen::OAuth2 overrides defaults from arguments" 4 .IX Item "LWP::Authen::OAuth2 overrides defaults from arguments" .IP "Sanity check" 4 .IX Item "Sanity check" .PD .PP Here are those phases in more detail. .IP "Construct service provider" 4 .IX Item "Construct service provider" There are two ways to construct a service provider. .RS 4 .IP "Prebuilt class" 4 .IX Item "Prebuilt class" To load a prebuilt class you just need one or two arguments. .RS 4 .ie n .IP """service_provider => $Foo,""" 4 .el .IP "\f(CWservice_provider => $Foo,\fR" 4 .IX Item "service_provider => $Foo," In the above construct, \f(CW$Foo\fR identifies the base class for your service provider. The actual class will be the first of the following two classes that can be loaded. Failure to find either is an error. .Sp .Vb 2 \& LWP::Authen::OAuth2::ServiceProvider $Foo \& $Foo .Ve .Sp A list of prebuilt service provider classes is in LWP::Authen::OAuth2::ServiceProvider as well as instructions for making a new one. .ie n .IP """client_type => $name_of_client_type""" 4 .el .IP "\f(CWclient_type => $name_of_client_type\fR" 4 .IX Item "client_type => $name_of_client_type" Some service providers will keep track of your client type (\*(L"webserver\*(R" application, \*(L"installed\*(R" application, etc), and will treat them differently. A base service provider class can choose to accept a \f(CW\*(C`client_type\*(C'\fR parameter to let it know what to expect. .Sp Whether this is done, and the allowable values, are up to the service provider class. .RE .RS 4 .RE .IP "Built on the fly" 4 .IX Item "Built on the fly" The behavior of simple service providers can be described on the fly without needing a prebuilt class. To do that, the following arguments can be filled with arguments from your service provider: .RS 4 .ie n .IP """authorization_endpoint => $auth_url,""" 4 .el .IP "\f(CWauthorization_endpoint => $auth_url,\fR" 4 .IX Item "authorization_endpoint => $auth_url," This is the \s-1URL\s0 which the user is directed to in the authorization request. .ie n .IP """token_endpoint => $token_url,""" 4 .el .IP "\f(CWtoken_endpoint => $token_url,\fR" 4 .IX Item "token_endpoint => $token_url," This is the \s-1URL\s0 which the consumer goes to for tokens. .IP "Various optional fields" 4 .IX Item "Various optional fields" LWP::Authen::OAuth2::ServiceProvider documents many methods that are available to customize the actual requests made, and defaults available. Simple service providers can likely get by without this, but here is a list of those methods that can be specified instead in the constructor: .Sp .Vb 9 \& # Arrayrefs \& required_init \& optional_init \& authorization_required_params \& authorization_optional_params \& request_required_params \& request_optional_params \& refresh_required_params \& refresh_optional_params \& \& # Hashrefs \& authorization_default_params \& request_default_params \& refresh_default_params .Ve .RE .RS 4 .RE .IP "Service provider collects arguments it wants" 4 .IX Item "Service provider collects arguments it wants" In general, arguments passed into the constructor do not have to be passed into individual method calls. Furthermore in order to be able to do the automatic token refresh for you, the constructor must include the arguments that will be required. .Sp By default you are required to pass your \f(CW\*(C`client_id\*(C'\fR and \f(CW\*(C`client_secret\*(C'\fR. And optionally can pass a \f(CW\*(C`redirect_uri\*(C'\fR and \f(CW\*(C`scope\*(C'\fR. (The omission of \&\f(CW\*(C`state\*(C'\fR is a deliberate hint that if you use that field, you should be generating random values on the fly. And not trying to go to some reasonable default.) .Sp However what is required is up to the service provider. .IP "LWP::Authen::OAuth2 overrides defaults from arguments" 4 .IX Item "LWP::Authen::OAuth2 overrides defaults from arguments" The following defaults are available to be overridden in the constructor, or can be overridden later. In the unlikely event that there is a conflict with the service provider's arguments, these will have to be overridden later. .RS 4 .ie n .IP """error_handler => \e&error_handler,""" 4 .el .IP "\f(CWerror_handler => \e&error_handler,\fR" 4 .IX Item "error_handler => &error_handler," Specifies the function that will be called when errors happen. The default is \f(CW\*(C`Carp::croak\*(C'\fR. .ie n .IP """is_strict => $bool,""" 4 .el .IP "\f(CWis_strict => $bool,\fR" 4 .IX Item "is_strict => $bool," Is strict mode on? If it is, then excess parameters to requests that are part of the authorization process will trigger errors. If it is not, then excess arguments are passed to the service provider as is, who according to the specification is supposed to ignore them. .Sp Strict mode is the default. .ie n .IP """early_refresh_time => $seconds,""" 4 .el .IP "\f(CWearly_refresh_time => $seconds,\fR" 4 .IX Item "early_refresh_time => $seconds," How many seconds before the end of estimated access token expiration you will have \f(CW\*(C`should_refresh\*(C'\fR start returning true. .ie n .IP """prerefresh => \e&prerefresh,""" 4 .el .IP "\f(CWprerefresh => \e&prerefresh,\fR" 4 .IX Item "prerefresh => &prerefresh," A handler to be called before attempting to refresh tokens. It is passed the \&\f(CW$oauth2\fR object. If it returns a token string, that will be used to generate tokens instead of going to the service provider. .Sp The purpose of this hook is so that, even if you have multiple processes accessing an \s-1API\s0 simultaneously, only one of them will try to refresh tokens with the service provider. (Service providers may dislike having multiple refresh requests arrive at once from the same consumer for the same user.) .Sp By default this is not provided. .ie n .IP """save_tokens => \e&save_tokens,""" 4 .el .IP "\f(CWsave_tokens => \e&save_tokens,\fR" 4 .IX Item "save_tokens => &save_tokens," Whenever tokens are returned from the service provider, this callback will receive a token string that can be stored and then retrieved in another process that needs to construct a \f(CW$oauth2\fR object. .Sp By default this is not provided. However if you intend to access the \&\s-1API\s0 multiple times from multiple processes, it is recommended. .ie n .IP """save_tokens_args => [ args ],""" 4 .el .IP "\f(CWsave_tokens_args => [ args ],\fR" 4 .IX Item "save_tokens_args => [ args ]," Additional arguments passed to the save_tokens callback function after the token string. This can be used to pass things like database handles or other data to the callback along with the token string. Provide a reference to an array of arguments in the constructure. When the callback is called the arguments are passed to the callback as an array, so in the example below \f(CW$arg1\fR will be \*(L"foo\*(R" and \f(CW$arg2\fR will be \*(L"bar\*(R" .Sp .Vb 4 \& ... \& save_tokens => \e&save_tokens, \& save_tokens_args => [ "foo", "bar" ], \& ... \& \& sub save_tokens { \& my ($token_string, $arg1, $arg2) = @_; \& \& ... \& } .Ve .ie n .IP """token_string => $token_string,""" 4 .el .IP "\f(CWtoken_string => $token_string,\fR" 4 .IX Item "token_string => $token_string," Supply tokens generated in a previous request so that you don't have to ask the service provider for new ones. Some service providers refuse to hand out tokens too quickly, so this can be important. .ie n .IP """user_agent => $ua,""" 4 .el .IP "\f(CWuser_agent => $ua,\fR" 4 .IX Item "user_agent => $ua," What user agent gets used under the hood? Defaults to a new lWP::UserAgent created on the fly. .RE .RS 4 .RE .IP "Sanity check" 4 .IX Item "Sanity check" Any arguments that are left over are assumed to be mistakes and a fatal warning is generated. .RE .RS 4 .RE .SH "METHODS" .IX Header "METHODS" Once you have an object, the following methods may be useful for writing a consumer. .ie n .SS """$oauth2\->authorization_url(%opts)""" .el .SS "\f(CW$oauth2\->authorization_url(%opts)\fP" .IX Subsection "$oauth2->authorization_url(%opts)" Generate a \s-1URL\s0 for the user to go to to request permissions. By default the \&\f(CW\*(C`response_type\*(C'\fR and \f(CW\*(C`client_id\*(C'\fR are defaulted, and all of \f(CW\*(C`redirect_uri\*(C'\fR, \&\f(CW\*(C`state\*(C'\fR and \f(CW\*(C`scope\*(C'\fR are optional but not required. However in practice this all varies by service provider and client type, so look for documentation on that for the actual list that you need. .ie n .SS """$oauth2\->request_tokens(%opts)""" .el .SS "\f(CW$oauth2\->request_tokens(%opts)\fP" .IX Subsection "$oauth2->request_tokens(%opts)" Request tokens from the service provider (if possible). By default the \&\f(CW\*(C`grant_type\*(C'\fR, \f(CW\*(C`client_id\*(C'\fR and \f(CW\*(C`client_secret\*(C'\fR are defaulted, and the \&\f(CW\*(C`scope\*(C'\fR is required. However in practice this all varies by service provider and client type, so look for documentation on that for the actual list that you need. .ie n .SS """$oauth2\->get(...)""" .el .SS "\f(CW$oauth2\->get(...)\fP" .IX Subsection "$oauth2->get(...)" Issue a \f(CW\*(C`get\*(C'\fR request to an OAuth 2 protected \s-1URL,\s0 just like you would using LWP::UserAgent to a normal \s-1URL.\s0 .ie n .SS """$oauth2\->head(...)""" .el .SS "\f(CW$oauth2\->head(...)\fP" .IX Subsection "$oauth2->head(...)" Issue a \f(CW\*(C`head\*(C'\fR request to an OAuth 2 protected \s-1URL,\s0 just like you would using LWP::UserAgent to a normal \s-1URL.\s0 .ie n .SS """$oauth2\->post(...)""" .el .SS "\f(CW$oauth2\->post(...)\fP" .IX Subsection "$oauth2->post(...)" Issue a \f(CW\*(C`post\*(C'\fR request to an OAuth 2 protected \s-1URL,\s0 just like you would using LWP::UserAgent to a normal \s-1URL.\s0 .ie n .SS """$oauth2\->delete(...)""" .el .SS "\f(CW$oauth2\->delete(...)\fP" .IX Subsection "$oauth2->delete(...)" Issue a \f(CW\*(C`delete\*(C'\fR request to an OAuth 2 protected \s-1URL,\s0 similar to the previous examples. (This shortcut is not by default available with LWP::UserAgent.) .ie n .SS """$oauth2\->put(...)""" .el .SS "\f(CW$oauth2\->put(...)\fP" .IX Subsection "$oauth2->put(...)" Issue a \f(CW\*(C`put\*(C'\fR request to an OAuth 2 protected \s-1URL,\s0 similar to the previous examples. (This shortcut is not by default available with LWP::UserAgent.) .ie n .SS """$oauth2\->request(...)""" .el .SS "\f(CW$oauth2\->request(...)\fP" .IX Subsection "$oauth2->request(...)" Issue any \f(CW\*(C`request\*(C'\fR that you could issue with LWP::UserAgent, except that it will be properly signed to go to an OAuth 2 protected \s-1URL.\s0 .ie n .SS """$oauth2\->make_api_call($uri, $params, $headers)""" .el .SS "\f(CW$oauth2\->make_api_call($uri, $params, $headers)\fP" .IX Subsection "$oauth2->make_api_call($uri, $params, $headers)" This is a convenience method which makes a call to an OAuth2 \s-1API\s0 endpoint given by \f(CW$uri\fR, and returns the \s-1JSON\s0 response decoded to a hash. If the \&\f(CW$params\fR hashref arg is set, its contents will be \s-1JSON\s0 encoded and sent as \&\s-1POST\s0 request content; otherwise it will make a \s-1GET\s0 request. Optional \f(CW$headers\fR may be sent which will be passed through to \&\f(CW\*(C`$oauth\->get()\*(C'\fR or \f(CW\*(C`$oauth\->post()\*(C'\fR. .PP If the call succeeds, it will return the response's \s-1JSON\s0 content decoded as hash, or if no response body was returned, a value of 1 to indicate success. On failure returns undef, and error message is available from \&\f(CW\*(C`$oauth2\->api_call_error()\*(C'\fR. .ie n .SS """$oauth2\->api_call_error()""" .el .SS "\f(CW$oauth2\->api_call_error()\fP" .IX Subsection "$oauth2->api_call_error()" If an error occurred in \f(CW\*(C`$oauth2\->make_api_call()\*(C'\fR, this method will return it. The error message comes from \f(CW\*(C`HTTP::Response\->error_as_HTML()\*(C'\fR. .ie n .SS """$oauth2\->api_url_base()""" .el .SS "\f(CW$oauth2\->api_url_base()\fP" .IX Subsection "$oauth2->api_url_base()" Returns the base \s-1URL\s0 of the service provider, which is sometimes useful to be used in the content of OAuth2 \s-1API\s0 calls. .ie n .SS """$oauth2\->can_refresh_tokens""" .el .SS "\f(CW$oauth2\->can_refresh_tokens\fP" .IX Subsection "$oauth2->can_refresh_tokens" Is sufficient information available to try to refresh tokens? .ie n .SS """$oauth2\->should_refresh()""" .el .SS "\f(CW$oauth2\->should_refresh()\fP" .IX Subsection "$oauth2->should_refresh()" Is it time to refresh tokens? .ie n .SS """$oauth2\->set_early_refresh_time($seconds)""" .el .SS "\f(CW$oauth2\->set_early_refresh_time($seconds)\fP" .IX Subsection "$oauth2->set_early_refresh_time($seconds)" Set how many seconds before the end of token expiration the method \&\f(CW\*(C`should_refresh\*(C'\fR will start turning true. Values over half the initial expiration time of access tokens will be ignored to avoid refreshing too often. This defaults to 300. .ie n .SS """$oauth2\->expires_time()""" .el .SS "\f(CW$oauth2\->expires_time()\fP" .IX Subsection "$oauth2->expires_time()" Returns the raw epoch expiration time of the current access token. Typically this is 3600 seconds greater than the time of token creation. .ie n .SS """$oauth2\->set_is_strict($mode)""" .el .SS "\f(CW$oauth2\->set_is_strict($mode)\fP" .IX Subsection "$oauth2->set_is_strict($mode)" Set strict mode on/off. See the discussion of \f(CW\*(C`is_strict\*(C'\fR in the constructor for an explanation of what it does. .ie n .SS """$oauth2\->set_error_handler(\e&error_handler)""" .el .SS "\f(CW$oauth2\->set_error_handler(\e&error_handler)\fP" .IX Subsection "$oauth2->set_error_handler(&error_handler)" Set the error handler. See the discussion of \f(CW\*(C`error_handler\*(C'\fR in the constructor for an explanation of what it does. .ie n .SS """$oauth2\->set_prerefresh(\e&prerefresh)""" .el .SS "\f(CW$oauth2\->set_prerefresh(\e&prerefresh)\fP" .IX Subsection "$oauth2->set_prerefresh(&prerefresh)" Set the prerefresh handler. See the discussion of \f(CW\*(C`prerefresh_handler\*(C'\fR in the constructor for an explanation of what it does. .ie n .SS """$oauth2\->set_save_tokens($ua)""" .el .SS "\f(CW$oauth2\->set_save_tokens($ua)\fP" .IX Subsection "$oauth2->set_save_tokens($ua)" Set the save tokens handler. See the discussion of \f(CW\*(C`save_tokens\*(C'\fR in the constructor for an explanation of what it does. .ie n .SS """$oauth2\->set_user_agent($ua)""" .el .SS "\f(CW$oauth2\->set_user_agent($ua)\fP" .IX Subsection "$oauth2->set_user_agent($ua)" Set the user agent. This should respond to the same methods that a LWP::UserAgent responds to. .ie n .SS """$oauth2\->user_agent()""" .el .SS "\f(CW$oauth2\->user_agent()\fP" .IX Subsection "$oauth2->user_agent()" Get the user agent. The default if none was explicitly set is a new LWP::UserAgent object. .SH "AUTHOR" .IX Header "AUTHOR" Ben Tilly, \f(CW\*(C`\*(C'\fR .PP currently maintained by Thomas Klausner, \f(CW\*(C`\*(C'\fR .SS "Contributors" .IX Subsection "Contributors" .IP "\(bu" 4 Leon Wright .IP "\(bu" 4 Thomas Klausner .IP "\(bu" 4 Alexander Dutton .IP "\(bu" 4 Chris .IP "\(bu" 4 Adi Fairbank .IP "\(bu" 4 Adam Millerchip .SH "BUGS" .IX Header "BUGS" Please report any bugs or feature requests to \&\f(CW\*(C`bug\-lwp\-authen\-oauth2 at rt.cpan.org\*(C'\fR, or through the web interface at . I will be notified, and then you'll automatically be notified of progress on your bug as I make changes. .SH "SUPPORT" .IX Header "SUPPORT" You can find documentation for this module with the perldoc command. .PP .Vb 1 \& perldoc LWP::Authen::OAuth2 .Ve .PP You can also look for information at: .IP "Github (submit patches here)" 4 .IX Item "Github (submit patches here)" .IP "\s-1RT: CPAN\s0's request tracker (report bugs here)" 4 .IX Item "RT: CPAN's request tracker (report bugs here)" .IP "AnnoCPAN: Annotated \s-1CPAN\s0 documentation" 4 .IX Item "AnnoCPAN: Annotated CPAN documentation" .IP "\s-1CPAN\s0 Ratings" 4 .IX Item "CPAN Ratings" .IP "MetaCPAN" 4 .IX Item "MetaCPAN" .SH "ACKNOWLEDGEMENTS" .IX Header "ACKNOWLEDGEMENTS" Thanks to Rent.com for their generous support in letting me develop and release this module. My thanks also to Nick Wellnhofer for Net::Google::Analytics::OAuth2 which was very enlightening while I was trying to figure out the details of how to connect to Google with OAuth2. .PP Thanks to .IP "\(bu" 4 Thomas Klausner for reporting that client type specific parameters were not available when the client type was properly specified .IP "\(bu" 4 Alexander Dutton for making \&\f(CW\*(C`ServiceProvider\*(C'\fR work without requiring subclassing. .IP "\(bu" 4 Leon Wright for adding a Strava Service Provider and various bug fixes .IP "\(bu" 4 Adi Fairbank for adding a Dwolla Service Provider and some other improvements .IP "\(bu" 4 Adam Millerchip for adding a Line Service Provider and some refactoring .IP "\(bu" 4 Michael Stevens for adding a \f(CW\*(C`Yahoo | https://developer.yahoo.com\*(C'\fR Service Provider and some dist cleanup .IP "\(bu" 4 Nick Morrott for fixing some documentation typos .SH "LICENSE AND COPYRIGHT" .IX Header "LICENSE AND COPYRIGHT" Copyright 2013 Rent.com. .PP This program is free software; you can redistribute it and/or modify it under the terms of the the Artistic License (2.0). You may obtain a copy of the full license at: .PP .PP Any use, modification, and distribution of the Standard or Modified Versions is governed by this Artistic License. By using, modifying or distributing the Package, you accept this license. Do not use, modify, or distribute the Package, if you do not accept this license. .PP If your Modified Version has been derived from a Modified Version made by someone other than you, you are nevertheless required to ensure that your Modified Version complies with the requirements of this license. .PP This license does not grant you the right to use any trademark, service mark, tradename, or logo of the Copyright Holder. .PP This license includes the non-exclusive, worldwide, free-of-charge patent license to make, have made, use, offer to sell, sell, import and otherwise transfer the Package with respect to any patent claims licensable by the Copyright Holder that are necessarily infringed by the Package. If you institute patent litigation (including a cross-claim or counterclaim) against any party alleging that the Package constitutes direct or contributory patent infringement, then this Artistic License to you shall terminate on the date that such litigation is filed. .PP Disclaimer of Warranty: \s-1THE PACKAGE IS PROVIDED BY THE COPYRIGHT HOLDER AND CONTRIBUTORS "AS IS\s0' \s-1AND WITHOUT ANY EXPRESS OR IMPLIED WARRANTIES. THE IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, OR\s0 NON-INFRINGEMENT \s-1ARE DISCLAIMED TO THE EXTENT PERMITTED BY YOUR LOCAL LAW. UNLESS REQUIRED BY LAW, NO COPYRIGHT HOLDER OR CONTRIBUTOR WILL BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL DAMAGES ARISING IN ANY WAY OUT OF THE USE OF THE PACKAGE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.\s0