Basic authentication

By configuring alinous-config.xml, you can use te Basic Authentication easily.

Sample setting of "alinous-config.xml"
Define zone and relm

About zone tag
About relm tag

Sample setting of "alinous-config.xml"

Here is the sample setting of "alinous-config.xml".

alinous-config.xml


<?xml version="1.0" encoding="utf-8"?>
<alinous-config>
	<system>
		<system-datastore id="pgsrc" />
		<default-datastore id="pgapps" />
	</system>

	<datasources id="pgsrc"
				class="org.alinous.plugin.derby.DerbyDataSource">
		<connect>jdbc:derby://localhost/MyDB;create=true;</connect>
		<user></user>
		<pass></pass>
	</datasources>

	<datasources id="pgapps"
						class="org.alinous.plugin.derby.DerbyDataSource">
		<connect>jdbc:derby://localhost/MyDB;create=true;</connect>
		<user></user>
		<pass></pass>
	</datasources>
	
	<basic-auth>
		<relm>
			<datastore>pgsrc</datastore>
			<table>AUTH_TABLE</table>
			<users>USERS</users>
			<passwords>PASSWORDS</passwords>
			<roles>ROLES</roles>
		</relm>
		
		<zones>
			<zone>
				<area>/admin/</area>
				<roles>admin</roles>
				<!-- <error-page>/admin/error.html</error-page> -->
				
				<form-auth>
					<login>/admin/login.html</login>
					<confirm>/admin/confirm.html</confirm>
				</form-auth>
			</zone>
			
		</zones>

	</basic-auth>   
</alinous-config>

Define zone and relm

In the sample setting, we define the zone and accessible role. The part is below.


<basic-auth>
       <relm>
	   <datastore>pgsrc</datastore>
	   <table>AUTH_TABLE</table>
	   <users>USERS</users>
	   <passwords>PASSWORDS</passwords>
	   <roles>ROLES</roles>
       </relm>
		
       <zones>
	    <zone>
		<area>/admin/</area>
		<roles>admin</roles>
		<!-- <error-page>/admin/error.html</error-page> -->
				
	       <form-auth>
		    <login>/admin/login.html</login>
		    <confirm>/admin/confirm.html</confirm>
	       </form-auth>
	    </zone>
			
       </zones>

</basic-auth>

About zone tag

The "zone" tag has children tags below.

area	The root directory of the zone
roles	Accessible roles. Comma separated.
error-page	Error page
login	Login form. (On using basic authentication, not necessary)
confirm	The page confirming login (On using basic authentication, not necessary)

If you use the Basic Authentication, "login" and "confirm" tag are not nesessary. If you write these, Alinous-Core recognize this zone is for the Form authentication area.

About relm tag

The "relm" tag is specify the relm database table. The relm is set of information about use, password, role to access.

datastore	The database includes relm table
table	Th relm table
users	The colum of user in the relm table
passwords	The colum of password int the relm table
roles	The colum of role int the relm table

If you use the form authentication, this relm tag and the setting is dummy and never used.