lemonldap-ng/doc/pages/documentation/1.4/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/1.4/configvhost.html" class="wikilink1" title="documentation:1.4:configvhost">protected virtual host</a> but use AuthBaisc 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>

</div>
<!-- SECTION "Virtual host in Apache" [662-1110] -->
<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/1.4/soapsessionbackend.html" class="wikilink1" title="documentation:1.4:soapsessionbackend">SOAP sessions backend</a>.
</p>

</div>
<!-- SECTION "Handler parameters" [1111-] --></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 doc to 1.4 2013-11-02 22:09:55 +01:00			`Configure the virtual host like other <a href="../../documentation/1.4/configvhost.html" class="wikilink1" title="documentation:1.4:configvhost">protected virtual host</a> but use AuthBaisc 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>`

			`</div>`
- 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			`<!-- SECTION "Virtual host in Apache" [662-1110] -->`
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 doc to 1.4 2013-11-02 22:09:55 +01:00			`No parameters needed. But you have to allow sessions web services, see <a href="../../documentation/1.4/soapsessionbackend.html" class="wikilink1" title="documentation:1.4:soapsessionbackend">SOAP sessions backend</a>.`
Update documentation 2012-09-10 12:58:20 +02:00			`</p>`

			`</div>`
- 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			`<!-- SECTION "Handler parameters" [1111-] --></div><!-- closes <div class="dokuwiki export">-->`