Java™ 2 Connector (J2C) Authentication Credentials Provider

This topic describes J2C Authentication Credentials Providers that are used within a Service Description.

Purpose of the J2C Credentials Provider

The J2C Authentication Credentials Provider provides a mechanism that allows user name and password credentials to be provided to a Service Transport without being hardcoded within the Service Description. The credentials are defined by the WebSphere® Application Server administrator and associated with an alias that is then used within the Service Description.

When to use the J2C Credentials Provider

Use the J2C Authentication Credentials Provider when a Service Description needs to define a static set of credentials, typically used to access a backend resource or service, and not specific to a particular user starting the service.

How to Configure the J2C Credentials Provider

To use the J2C Authentication Credential Provider, the WebSphere® Application Server administrator must first define a user identity (User ID, Password, and Alias name) within the JAAS – J2C authentication data section of the WebSphere® Application Server administrative console. For an example of the WebSphere® Application Server Network Deployment 8.5.5, see the WebSphere® Application Server documentation.

Using the J2C Credentials Provider in a Service Description

The provider ID for the J2C Credentials Provider to enter in a Service Description is: j2cAlias

Credentials Provider Parameters

Table 1. Available Credentials Provider Parameters
Name	Description	Mandatory	Default
alias	The Alias name of a user identity that contains the credentials that are required for the Service Description.	Yes	N/A

Sample Service Description

<serviceDescription>
   <id>watsonTranslateJ2C</id>
   <defaultLocale>en</defaultLocale>
   <transportId>HTTPServiceTransport</transportId>
   <name xml:lang="en">Watson Translator J2C</name>
   <description xml:lang="en">
 	Translate text using the bluemix Watson Service
   </description>
	<credentials providerId="j2cAlias">
		<property name="alias" value="someNode01/BlueMixTranslateService"/>
	</credentials>
   <inbound>
	   <parameters>
			<parameter>
				<id>text</id>
				<type>STRING</type>
				<name xml:lang="en">Text</name>
				<description xml:lang="en">Text to be translated</description>
				<mandatory>true</mandatory>
			</parameter>
			<parameter>
				<id>model_id</id>
				<type>STRING</type>
				<name xml:lang="en">Model ID</name>
				<description xml:lang="en">Translation to be performed (ex. 'en-fr' to translate from English to French)</description>
				<mandatory>true</mandatory>
			</parameter>
		</parameters>
	<serviceMapping>
	  <constants>
		<constant>
		  <id>request-url</id>
		  <value>https://gateway.watsonplatform.net/language-translation/api/v2/translate</value>
		</constant>
		<constant>
		  <id>request-method</id>
		  <value>GET</value>
		</constant>
	  </constants>

	  <mapping xmlns="">
		<mapping target="transport:request-url" source="constant:request-url"/>
		<mapping target="transport:request-method" source="constant:request-method"/>
		<mapping target="transport:request-query-txt" source="parameter:text"/>
		<mapping target="transport:request-query-model_id" source="parameter:model_id"/>
	  </mapping>
	</serviceMapping>
  </inbound>

   <outbound>
 	<parameters>
 	  <parameter>
 		<id>response-entity</id>
 		<type>STRING</type>
		<name xml:lang="en">Translated Text</name>
 		<description xml:lang="en">Text containing new translation.</description>
 	  </parameter>
 	</parameters>
   </outbound>
</serviceDescription>