Understanding the LDAP Binding Component

Table of Contents

• Using the LDAP Binding Component (main page)
  
• About the LDAP Binding Component
  
• About LDAP
  
• Supported Features in the LDAP Binding Component
  
• Supported LDAP Functions
  
• Searching the LDAP Directory
  
• Security for LDAP Transactions
  
• LDAP BC WSDL Configuration
  
  • Viewing the LDAP WSDL Document
  • Service Level WSDL Elements
  • Binding Level WSDL Elements
• Runtime Configuration
  
• Application Variables
  
• Application Configurations
  

LDAP BC WSDL Configuration

When you use the New WSDL Document Wizard for the LDAP BC, it generates a WSDL document that includes all of the required elements and the configuration information you entered in the wizard. You can use the WSDL Editor to view and modify the configuration you defined. The elements you are most likely to configure are the service level WSDL elements and binding level WSDL elements. The following topics describe working with the WSDL document and the elements specific to the LDAP BC.

• Viewing the LDAP WSDL Document
  
• Service Level WSDL Elements
  
• Binding Level WSDL Elements
  

For an example of how to use the New WSDL Document Wizard for LDAP, see Creating a WSDL Document: Add Operation.

Viewing the LDAP WSDL Document

In the WSDL view of the WSDL Editor, the WSDL file appears as a tree component or a series of columns. The WSDL view has two subviews: tree view and column view. To switch between the subviews, use the buttons in the WSDL Editor toolbar. The main nodes in the WSDL view correspond to the major elements in a WSDL file.

• Types: This node enables you to import XML schemas and to add inline schemas.
  
• Imports: This node enables you to import WSDL files.
  
• Messages: This node enables you to create, edit, and delete messages.
  
• Port Types: This node enables you to create, edit, and delete port types.
  
• Bindings: This node enables you to create, edit, and delete bindings.
  
• Services: This node enables you to create, edit, and delete services.
  
• Extensibility Elements: This node enables you to add the following extensibility elements: partner link types, properties, and property aliases.
  

To Add Extension Attributes

Some of the nodes in the WSDL view allow you to add extension attributes.

1. Right-click the node and choose Add Extension Attribute.
2. Specify the name and namespace in the Add Extension Attribute dialog box.
3. Specify the value from the Properties window after adding the attribute.
4. Right-click the node and choose Remove Attributes to delete the attribute.

Service Level WSDL Elements

The attributes of the service WSDL element configure LDAP directory security information for the LDAP BC. The attributes specify the connectivity to the LDAP directory address element ldap:address. These attributes specify login information, security protocols, authentication type, and so on.

When you create a WSDL file in the NetBeans IDE, the New WSDL Document Wizard generates the address service definition. You can then edit the attributes of the address service. The following table describes the attributes available for this service.

LDAP Address Element Attributes

The following example illustrates the LDAP service element:

<service name="LDAPService"
    <wsdl:port name="LDAPPort" binding="tns:LDAPBinding>
        <ldap:address location="ldap://ldapServer1:389" 
                      principal = "cn=Manager,dc=sun,dc=com" 
                      credential = "admin" 
                      truststorepassword = "trustadmin" 
                      truststoretype = "JKS" 
                      keystore = "C:\security\ldap\keystore.jks"
                      keystorepassword = "keystoreadmin"
                      keystoreusername = "keystore"
                      keystoretype = "JKS"
                      tlssecurity = "NO"
                      ssltype = "Enable SSL"
                      authentication = "Simple"
                      truststore = "C:\security\ldap\trust.jks"
                      protocol = "SSL"
        />
    </wsdl:port>
</service>

Binding Level WSDL Elements

The LDAP Binding Component binding level WSDL elements include the binding, operation, and message extensibility elements.

Binding elements define the file transport-specific information for operations and messages.

LDAP Binding Element

The LDAP binding extensibility element allows the association of a binding to be LDAP protocol specific. When you create a WSDL file for a BPEL project in the NetBeans IDE, the New WSDL Document Wizard generates the LDAP binding definition, which includes a name you specify and a type that is generated by the wizard.

The following example illustrates the LDAP binding element:

<binding name="LDAPBinding" type="tns:LDAPPortType">
    <ldap:binding/>
    ...
</binding>

LDAP Operation Element

The LDAP operation element defines the supported operations. For the LDAP Binding Component the supported operations include the following:

• searchRequest
  
• updateRequest
  
• compareRequest
  
• insertRequest
  
• deleteRequest
  
• addConnectionRequest
  

The following example illustrates the LDAP operation element:

<binding name="LDAPBinding" type="tns:LDAPPortType">
    <ldap:binding/>
    <wsdl:operation name="LDAPSearchOperation">
        <ldap:operation type="searchRequest"/>
        ...

LDAP Output Element

The LDAP output element extends the binding element to specify properties associated with writing output messages. In the NetBeans IDE, select a ldap:output() element to view and modify the output properties. The following table describes the available output properties.

LDAP Output Element Properties

Previous Next

This page (revision-4) was last changed on 24-Jul-09 14:17 PM, -0700 by CarolT.
This page was created on 15-May-09 19:35 PM, -0700 by CarolT.

More info...