Configuring CICS web services for Kerberos

To configure a provider pipeline to implement Kerberos authentication, you must add a security handler to your pipeline configuration file.

Before you begin

You must configure an external security manager, such as RACF®, to enable support for Kerberos. For more information, see Configuring RACF for Kerberos.

You must identify or create the pipeline configuration file to add the configuration information for Kerberos.

Procedure

  1. Add a <wsse_handler> element to your pipeline. The handler must be included in the <service_handler_list> element. Code the following elements:
    <wsse_handler>  
        <dfhwsse_configuration version="1"> 
        </dfhwsse_configuration>
    </wsse_handler> 

    The <dfhwsse_configuration> element is a container for the other elements in the configuration.

  2. Code an <authentication> element.
    1. Code the trust attribute to specify trust="basic".
    2. Code the mode attribute to specify mode="basic-kerberos".
    3. Optional: Code an empty <suppress/> element. If you do not specify this element, the work runs under the user ID associated with the token.

Results

The CICS® provider pipeline is configured for Kerberos authentication. Inbound web service requests received by the pipeline must include a valid Kerberos token. If they do not, the request is rejected with the appropriate SOAP fault. Depending on pipeline configuration options, the target application runs under the user ID associated with the token.

Example

The following example shows how you might configure the provider pipeline:

<provider_pipeline xmlns="http://www.ibm.com/software/htp/cics/pipeline"> 
    <service>
        <service_handler_list>
            <wsse_handler>
                <dfhwsse_configuration version="1">                                            
                   <authentication trust="basic" mode="basic-kerberos"/>
                </dfhwsse_configuration>
            </wsse_handler>
        </service_handler_list>
        <terminal_handler>
            <cics_soap_1.1_handler/>
        </terminal_handler>
    </service>
    <apphandler>DFHPITP</apphandler>                                                         
</provider_pipeline> 


wsi_kerberos.html | Timestamp icon Last updated: Sunday, 4 June 2017