Notice: this Wiki will be going read only early in 2024 and edits will no longer be possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.
IdAS Basic Solution
Contents
Overview
This simple deployment combines IdAS (along with the IdAS Registry), the JNDI Context Provider, and an LDAP server to provide an identity store which is then accessed by an application.
The application opens a Context as a subject and then prints the attributes of that subject.
Architecture
Higgins Components
Each of the following Higgins components are required along with their dependencies:
- IdAS API
- IdAS Common
- IdAS Registry
- Redistributable Dependencies
- Configuration XML
- JNDI Context Provider
- Configuration API (Needed by the JNDI Context Provider)
- IdAS SPI (Needed by the JNDI Context Provider)
- Util: IdAS CP (Needed by the JNDI Context Provider)
- Util: IdAS JScript (Needed by the JNDI Context Provider)
- Util: Socket (Needed by the JNDI Context Provider)
External Components
These external components are also required.
- LDAP Server
- This deployment is based on a very simple Java LDAP server
- You may also use another LDAP server such as OpenLDAP
Instructions
Get the Higgins components
If you're using Eclipse, you need to get the deployment project and all dependency projects recursively. The easy way to do this is to import one of these Team Project Sets:
The hard way is to get this deployment's project using one of these:
Then get all the required Higgins components by following the instructions in the Component's table row and on its page (see the list of dependency projects above).
If you're not using Eclipse, you'll need to use cvs to get the code for this deployment as well as all the code for the dependencies. <todo: more instructions here would be nice>
Get, install, configure, and run an LDAP server
The easy way is to download the simple LDAP server mentioned above. If you do that and unpack it, you'll have everything you need, preconfigured. Just run the executable ldaputility.jar. Note that java -jar ldaputility.jar /? produces a help screen.
If you want to use a different LDAP server, that's ok, but it's up to you to install it. For this deployment, there are no special schema requirements, you just need to make sure it can perform a simple bind with name and password.
Edit the configuration file
If you're using the simple Java LDAP server mentioned above, the deployment is preconfigured, you don't need to do anything. Otherwise, you might need to make some changes to the file called IdASConfiguration1.xml in the conf directory. A tutorial on much of what goes into this file can be found at JNDI_CP_Configuration
Setting the host and port
This setting is used to change the host and port:
<Setting Name="Address" Type="xsd:string">ldap://localhost:50389</Setting>
Setting the subject's name and password
Update these settings:
<Setting Name="java.naming.security.principal" Type="xsd:string">cn=admin,o=bandit</Setting> <Setting Name="java.naming.security.credentials" Type="xsd:string">admin</Setting>
Build and run the application
If you're using Eclipse, you should be able to simply run the application using the Run menu.
If you're running from the command line, you need to build this deployment and it's dependencies. <todo: add instructions>. There's a main function in the BasicIdAS class. <todo: put a run target in the build.xml?>