[lsc-changes] [Ldap Synchronization...] page added: documentation:plugins:nis

[webmaster]

A page in your DokuWiki was added or changed. Here are the details:

Date : 2014/03/03 15:11
Browser : Mozilla/5.0 (X11; Ubuntu; Linux x86_64; rv:27.0) Gecko/20100101 Firefox/27.0
IP-Address : 88.173.78.196
Hostname : mne69-10-88-173-78-196.fbx.proxad.net
Old Revision: none
New Revision: http://lsc-project.org/wiki/documentation/plugins/nis
Edit Summary: created
User : coudot

====== NIS (YP) Source service plugin ======

===== Presentation =====


This source service enables getting data from a RFC 2307 compliant NIS service. You will get a posixAccount complete object :
* uid,
* uidnumber,
* gidnumber,
* gecos,
* loginShell,
* homeDirectory,
* cn,
* and correct objectClass values of course :)

<note>This service is designed as a plugin because it is based upon the Sun/Oracle JNDI provider which is not released under a free license and must be downloaded by final users.</note>

===== Installation =====

Go in the [[..:..:download|download section]], and get the NIS plugin. Then copy the plugin inside LSC lib/ directory.

You also need the JNDI NIS library, that can be downloaded on [[http://java.sun.com/products/jndi/downloads/index.html|Oracle site]] (get the JNDI 1.2.1 service providers). The NIS jar must the be copied in your JRE libraries (${JAVA_HOME}/jre/lib/ext).

===== Configuration =====

==== Connection ====

Create a NIS connection:

<file xml>
<pluginConnection implementationClass="org.lsc.plugins.connectors.nis.generated.NisConnectionType">
<name>nis-src-conn</name>
<url>nis://NIS-SERVER-ADDRESS/lsc-project.org</url>
<username>unused</username>
<password>unused</password>
</pluginConnection>
</file>

<note tip>''username'' and ''password'' are mandatory for a LSC connection, but unused for NIS.</note>

==== Source service ====

Create the source service:
<file xml>
<pluginSourceService implementationClass="org.lsc.plugins.connectors.nis.NisSrcService">
<name>nis-source-service</name>
<connection reference="nis-src-conn" />
<nis:nisSourceServiceSettings>
<name>nis-src-service</name>
<connection reference="nis-src-conn" />
<nis:map>passwd.byname</nis:map>
</nis:nisSourceServiceSettings>
</pluginSourceService>
</file>

Here you can change the NIS map to synchronize groups:
<file xml>
<nis:map>group.byname</nis:map>
</file>

===== Run the connector =====

To run the connector, you need to adjust JAVA_OPTS first:
<code bash>
$ export JAVA_OPTS=-DLSC.PLUGINS.PACKAGEPATH=org.lsc.plugins.connectors.nis.generated
</code>

Then, run the connector in a standard way:
<code bash>
$ bin/lsc -s all -f nis-cfg-dir/
</code>