lemonldap-ng/doc/pages/documentation/2.0/handlerauthbasic.html


<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
 "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en"
 lang="en" dir="ltr">

<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title></title>
<!-- metadata -->
<meta name="generator" content="Offline" />
<meta name="version" content="Offline 0.1" />
<!-- style sheet links -->
<link rel="stylesheet" media="all" type="text/css" href="../../../css/all.css" />
<link rel="stylesheet" media="screen" type="text/css" href="../../../css/screen.css" />
<link rel="stylesheet" media="print" type="text/css" href="../../../css/print.css" />

</head>
<body>
<div class="dokuwiki export">


<h1><a name="authbasic_handler" id="authbasic_handler">AuthBasic Handler</a></h1>
<div class="level1">

</div>
<!-- SECTION "AuthBasic Handler" [1-33] -->
<h2><a name="presentation" id="presentation">Presentation</a></h2>
<div class="level2">

<p>

The AuthBasic Handler is a special Handler that will us AuthBasic to authenticate to a virtual host, and then play authorizations rules to allow access to the virtual 
host.
</p>

<p>
The Handler will send a <acronym title="World Wide Web">WWW</acronym>-Authenticate header to the client, to request user and password, and then check the credentials using <acronym title="Simple Object Access Protocol">SOAP</acronym> getCookies web service. When session is granted, the Handler will then check the authorizations like the standard Handler.
</p>

<p>
This can be useful to allow an third party application to access a virtual host with users credentials by sending a Basic challenge to it.
</p>

</div>
<!-- SECTION "Presentation" [34-634] -->
<h2><a name="configuration" id="configuration">Configuration</a></h2>
<div class="level2">

</div>
<!-- SECTION "Configuration" [635-661] -->
<h3><a name="virtual_host_in_apache" id="virtual_host_in_apache">Virtual host in Apache</a></h3>
<div class="level3">

<p>

Configure the virtual host like other <a href="../../documentation/2.0/configvhost.html" class="wikilink1" title="documentation:2.0:configvhost">protected virtual host</a> but use AuthBasic Handler instead of default Handler.
</p>
<pre class="code file apache">&lt;<span class="kw3">VirtualHost</span> *:80&gt;
       <span class="kw1">ServerName</span> basic.example.com
&nbsp;
       <span class="co1"># Load AuthBasic Handler</span>
       PerlRequire Lemonldap/NG/Handler/Specific/AuthBasic.pm
       PerlHeaderParserHandler Lemonldap::NG::Handler::Specific::AuthBasic
&nbsp;
       ...
&nbsp;
&lt;/<span class="kw3">VirtualHost</span>&gt;</pre>

<p>
<p><div class="notetip">
If LemonLDAP::NG portal is protected by <acronym title="Secure Sockets Layer">SSL</acronym> with a self-signed certificate, you can add this line to accept it:

</p>
<pre class="code file apache">PerlSetEnv PERL_LWP_SSL_VERIFY_HOSTNAME <span class="nu0">0</span></pre>

<p>


</div></p>
</p>

</div>
<!-- SECTION "Virtual host in Apache" [662-1306] -->
<h3><a name="handler_parameters" id="handler_parameters">Handler parameters</a></h3>
<div class="level3">

<p>

No parameters needed. But you have to allow sessions web services, see <a href="../../documentation/2.0/soapsessionbackend.html" class="wikilink1" title="documentation:2.0:soapsessionbackend">SOAP sessions backend</a>.
</p>

</div>
<!-- SECTION "Handler parameters" [1307-] --></div><!-- closes <div class="dokuwiki export">-->
Update documentation 2012-09-10 12:58:20 +02:00
			`<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"`
			`"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">`
			`<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en"`
			`lang="en" dir="ltr">`

			`<head>`
			`<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />`
			`<title></title>`
			`<!-- metadata -->`
			`<meta name="generator" content="Offline" />`
			`<meta name="version" content="Offline 0.1" />`
			`<!-- style sheet links -->`
			`<link rel="stylesheet" media="all" type="text/css" href="../../../css/all.css" />`
			`<link rel="stylesheet" media="screen" type="text/css" href="../../../css/screen.css" />`
			`<link rel="stylesheet" media="print" type="text/css" href="../../../css/print.css" />`

			`</head>`
			`<body>`
			`<div class="dokuwiki export">`




			`<h1><a name="authbasic_handler" id="authbasic_handler">AuthBasic Handler</a></h1>`
			`<div class="level1">`

			`</div>`
			`<!-- SECTION "AuthBasic Handler" [1-33] -->`
			`<h2><a name="presentation" id="presentation">Presentation</a></h2>`
			`<div class="level2">`

			`<p>`

			`The AuthBasic Handler is a special Handler that will us AuthBasic to authenticate to a virtual host, and then play authorizations rules to allow access to the virtual`
			`host.`
			`</p>`

			`<p>`
			`The Handler will send a <acronym title="World Wide Web">WWW</acronym>-Authenticate header to the client, to request user and password, and then check the credentials using <acronym title="Simple Object Access Protocol">SOAP</acronym> getCookies web service. When session is granted, the Handler will then check the authorizations like the standard Handler.`
			`</p>`

			`<p>`
			`This can be useful to allow an third party application to access a virtual host with users credentials by sending a Basic challenge to it.`
			`</p>`

			`</div>`
			`<!-- SECTION "Presentation" [34-634] -->`
			`<h2><a name="configuration" id="configuration">Configuration</a></h2>`
			`<div class="level2">`

			`</div>`
			`<!-- SECTION "Configuration" [635-661] -->`
			`<h3><a name="virtual_host_in_apache" id="virtual_host_in_apache">Virtual host in Apache</a></h3>`
			`<div class="level3">`

			`<p>`

Update documentation in trunk, use 2.0 2015-05-22 17:11:57 +02:00			`Configure the virtual host like other <a href="../../documentation/2.0/configvhost.html" class="wikilink1" title="documentation:2.0:configvhost">protected virtual host</a> but use AuthBasic Handler instead of default Handler.`
Update documentation 2012-09-10 12:58:20 +02:00			`</p>`
			`<pre class="code file apache"><<span class="kw3">VirtualHost</span> *:80>`
			`<span class="kw1">ServerName</span> basic.example.com`
			` `
			`<span class="co1"># Load AuthBasic Handler</span>`
- updating documentation accordingly with new handler call (My::Packages -> Lemonldap::NG::Handler) in branch 1.4 - regenerating documentation with make documentation (references #630) 2014-05-22 12:51:39 +02:00			`PerlRequire Lemonldap/NG/Handler/Specific/AuthBasic.pm`
			`PerlHeaderParserHandler Lemonldap::NG::Handler::Specific::AuthBasic`
Update documentation 2012-09-10 12:58:20 +02:00			` `
			`...`
			` `
			`</<span class="kw3">VirtualHost</span>></pre>`

Documentation update 2014-12-19 10:03:15 +01:00			`<p>`
			`<p><div class="notetip">`
			`If LemonLDAP::NG portal is protected by <acronym title="Secure Sockets Layer">SSL</acronym> with a self-signed certificate, you can add this line to accept it:`

			`</p>`
			`<pre class="code file apache">PerlSetEnv PERL_LWP_SSL_VERIFY_HOSTNAME <span class="nu0">0</span></pre>`

			`<p>`


			`</div></p>`
			`</p>`

Update documentation 2012-09-10 12:58:20 +02:00			`</div>`
Documentation update 2014-12-19 10:03:15 +01:00			`<!-- SECTION "Virtual host in Apache" [662-1306] -->`
Update documentation 2012-09-10 12:58:20 +02:00			`<h3><a name="handler_parameters" id="handler_parameters">Handler parameters</a></h3>`
			`<div class="level3">`

			`<p>`

Update documentation in trunk, use 2.0 2015-05-22 17:11:57 +02:00			`No parameters needed. But you have to allow sessions web services, see <a href="../../documentation/2.0/soapsessionbackend.html" class="wikilink1" title="documentation:2.0:soapsessionbackend">SOAP sessions backend</a>.`
Update documentation 2012-09-10 12:58:20 +02:00			`</p>`

			`</div>`
Documentation update 2014-12-19 10:03:15 +01:00			`<!-- SECTION "Handler parameters" [1307-] --></div><!-- closes <div class="dokuwiki export">-->`