NAME Web::Solid::Auth - A Perl Solid Web Client SYNOPSIS use Web::Solid::Auth; use Web::Solid::Auth::Listener; # Create a new authenticator for a pod my $auth = Web::Solid::Auth->new(webid => $webid); # Or tune a listerner my $auth = Web::Solid::Auth->new( webid => $webid , listener => Web::Solid::Auth::Listener->new( scheme => 'https' host => 'my.server.org' port => '443' , path => '/mycallback' ) ); # Or, in case you have your own callback server my $auth = Web::Solid::Auth->new( webid => $webid, redirect_uri => 'https://my.server.org/mycallback' ); # Generate a url for the user to authenticate my $auth_url = $auth->make_authorization_request; # Listen for the oauth server to return tokens # the built-in listener for feedback from the openid provider # Check the code of Web::Solid::Auth::Listener how to # do this inside your own Plack application $auth->listen; #### # If you already have access_tokens from previous step if ($auth->has_access_token) { # Fetch the Authentication and DPoP HTTP headers for a # request to an authorized resource my $headers = $auth->make_authentication_headers($resource_url,$http_method); #..do you curl..lwp::agent..or what ever with the headers } DESCRIPTION This is a Solid-OIDC implementation of a connection class for the Solid server. Use the bin/solid_auth.pl command as a command line implementation. Check out the example directory for a demo web application. CONFIGURATION webid The Solid Webid to authenticate. cache The location of the cache directory with connection parameters. METHODS has_access_token() Returns a true value when a cache contains an access token for the webid. make_clean() Clear the cache directory. make_authorization_request() Return an authorization URL that the use should open to authenticate this application. make_access_token($code) When on the redirect url you get a code from the authentication server you can use this method to get an access_token for the code. listen() Create a small built-in web server to listen for token responses from the authentication server. get_access_token() Return the cached access_token. SEE ALSO solid_auth.pl INSPIRATION This was very much inspired by the Python solid-flask code by Rai http://agentydragon.com at https://gitlab.com/agentydragon/solid-flask CONTRIBUTORS Patrick Hochstenbach, patrick.hochstenbach at ugent.be COPYRIGHT AND LICENSE This software is copyright (c) 2021 by Patrick Hochstenbach. This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.