Sun OpenSSO Enterprise 8.0 Developer's Guide

Creating an Authentication Module Service File

The authentication module's service file is written in XML and imported to OpenSSO Enterprise to allow the management of its attributes using the OpenSSO Enterprise console. The name of the service file follows the format amAuthmodulename.xml (for example, amAuthSafeWord.xml or amAuthLDAP.xml). The file is located in OpenSSO-Deploy-base/WEB-INF/classes. The new service file must conform to the sms.dtd. Use one of the provided authentication module service files as a template. Conversely, you can use the template provided.


Example 1–3 Authentication Module Service File Template


<?xml version="1.0" encoding="UTF-8"?>

<!DOCTYPE ServicesConfiguration
PUBLIC "=//iPlanet//Service Management Services (SMS) 1.0 DTD//EN"
"jar://com/sun/identity/sm/sms.dtd">

<ServicesConfiguration>
  <Service name="iPlanetAMAuthMYMODULEAuthService" version="1.0">
    <Schema
     serviceHierarchy="/DSAMEConfig/authentication/
      iPlanetAMAuthMYMODULEAuthService"
     i18nFileName="mymoduleauth"
     revisionNumber="1"
     i18nKey="iplanet-am-auth-mymoduleauth-service-description">
      <Organization>
                
       <AttributeSchema name="iplanet-am-auth-mymoduleauth-primary-server"
        type="single"
        syntax="string"
        i18nKey="a102">
         <DefaultValues>
             <Value>msg1dev.ec-lille.fr:1389</Value>
         </DefaultValues>
       </AttributeSchema>
       <AttributeSchema name="iplanet-am-auth-mymoduleauth-primary-base-dn"
        type="single"
        syntax="dn"
        i18nKey="a103">
          <DefaultValues>
            <Value>dc=ec-lille,dc=fr</Value>
          </DefaultValues>
       </AttributeSchema>
       <AttributeSchema name="iplanet-am-auth-mymoduleauth-primary-search-base-dn"
         type="single"
         syntax="dn"
         i18nKey="a104">
          <DefaultValues>
             <Value>ou=people,dc=ec-lille,dc=fr</Value>
          </DefaultValues>
       </AttributeSchema>
       <AttributeSchema name="iplanet-am-auth-mymoduleauth-primary-bind-dn"
        type="single"
        syntax="dn"
        i18nKey="a105">
         <DefaultValues>
           <Value>cn=Directory Manager</Value>
         </DefaultValues>
       </AttributeSchema>
       <AttributeSchema name="iplanet-am-auth-mymoduleauth-primary-bind-passwd"
         type="single"
         syntax="password"
         i18nKey="a106">
       </AttributeSchema> 
       <AttributeSchema name="iplanet-am-auth-mymoduleauth-auth-level"
         type="single"
         syntax="number"
         i18nKey="a500">
          <DefaultValues>
             <Value>0</Value>
          </DefaultValues>
         </AttributeSchema>
        </Organization>
      </Schema>
        
      <Configuration>
        <OrganizationConfiguration name="/">		
            <AttributeValuePair>
               <Attribute name=
                "iplanet-am-auth-mymoduleauth-primary-bind-passwd"/>
                  <Value>adminadmin</Value>
            </AttributeValuePair>
        </OrganizationConfiguration>
      </Configuration>
    </Service>
</ServicesConfiguration>