Configuring the staff service for process choreographer

Why and when to perform this task

Process choreographer uses staff plug-ins to determine who can start a process or claim an activity. Your business processes can also use the staff plug-in services to resolve staff queries. Each type of directory service requires a different staff plug-in. You can register multiple staff plug-ins. The user registry and system plug-ins are already installed and can be used without any configuration. To configure a staff plug-in provider:

Steps for this task

  1. In the administrative console, click Resources > Staff Plugin Provider.
    The system plug-in and the user registry plug-in require no customization and are ready to use. The preconfigured Lightweight Directory Access Protocol (LDAP) staff plug-in configuration assumes that the LDAP server is on the same host as the application server.
  2. To create a new LDAP configuration:
    1. Click the name of the LDAP staff plug-in provider.
    2. Select Staff Plugin Configuration.
    3. Click New.
    4. Click Browse, and select the sample Extensible Style Language (XSL) transformation file to use.
      The standard XSL transformation for LDAP is located:
      • on Windows systems, in install_root\ProcessChoreographer\Staff\LDAPTransformation.xsl
      • On UNIX systems in install_root/ProcessChoreographer/Staff/LDAPTransformation.xsl
      Do not modify this transformation file. If you need to customize the transformations to match the LDAP schema of your organization, modify a copy that has a different file name.
    5. Click Next.
    6. Enter an administrative name for the staff plug-in provider.
    7. Enter a description.
    8. Enter the Java Naming and Directory Interface (JNDI) name for business processes to use in referencing this plug-in, for example, bpe/staff/ldapserver1
    9. Click Apply.
    10. Click Custom Properties.
    11. For each of the required properties and for any optional properties that you want to set, click the name of the property, enter a value, and click OK.
    12. To apply the changes, click Save.
      This table describes each property for the LDAP plug-in.
      LDAP plug-in property Required or optional Comments
      AuthenticationAlias Optional The authentication alias used to connect to LDAP, for example, mycomputer/My LDAP Alias. You must define this alias in the administrative console by clicking Security > JAAS > Configuration JAAS Configuration > J2C Authentication Data. If this alias is not set, anonymous logon to the LDAP server is used.
      AuthenticationType Optional If the AuthenticationType property is not set, the default logon is anonymous authentication. In all other cases, the default is simple authentication.
      BaseDN Required The base distinguished name (DN) for all LDAP search operations, for example, "o=mycompany, c=us"
      ContextFactory Required Sets the Java Naming and Directory Interface (JNDI) context factory, for example, com.sun.jndi.ldap.LdapCtxFactory
      ProviderURL Required This Web address must point to the LDAP JNDI directory server and port. The format must be in normal JNDI syntax, for example, ldap://localhost:389
      SearchScope Required The default search scope for all search operations. Determines how deep to search beneath the baseDN property. Specify one of the following values: objectScope, onelevelScope, or subtreeScope
      additionalParameterName1-5 and additionalParameterValue1-5 Optional Use these name-value pairs to set up to five arbitrary JNDI properties for the connection to the LDAP server.


  3. To activate the plug-in, stop and start the server.
  4. In case of problems, refer to troubleshooting the staff service and staff plug-ins.

Results

Processes can now use the staff support services to resolve staff queries, and to determine which activities can be performed by certain people.

What to do next

Depending on the queries that you want to create and your directory structure, you might need to create your own transformations. For more information about this topic, see about the staff service in process choreographer.

Related concepts
About the staff service in process choreographer
Troubleshooting the staff service and the staff plug-ins
Related reference
Staff service settings
Staff plugin provider collection



Searchable topic ID:   t4staff
Last updated: Jun 21, 2007 8:07:48 PM CDT    WebSphere Business Integration Server Foundation, Version 5.0.2
http://publib.boulder.ibm.com/infocenter/wasinfo/index.jsp?topic=/com.ibm.wasee.doc/info/ee/workflow/tasks/t4staff.html

Library | Support | Terms of Use | Feedback