CentraSite Documentation : Runtime Governance with CentraSite : Run-Time Governance Reference : Built-In Run-Time Actions Reference for APIs : Run-Time Actions Reference : NTLM Authentication
NTLM Authentication
This action uses the NTLM authentication to validate incoming requests from clients. Mediator authorizes the NTLM credentials (username and password) against a list of all global consumers available in the Mediator.
If the username/password value in the Authorization header cannot be authenticated as a valid Integration Server user (or if the Authorization header is not present in the request), a 500 SOAP fault is returned, and the client is presented with a security challenge. If the client successfully responds to the challenge, the user is authenticated. If the client does not successfully respond to the challenge, a 401 Unauthorized "WWW-Authenticate: NTLM" (for NTLM authentication) or "WWW-Authenticate: Negotiate" (for Kerberos authentication) is returned in the response header and the invocation is not routed to the policy engine. As a result, no events are recorded for that invocation, and its key performance indicator (KPI) data are not included in the performance metrics.
Note:  
Note that if Mediator is used to access a native API protected by NTLM (which is typically hosted in IIS), then the native API in IIS should be configured to use NTLM as the authentication scheme. If the authentication scheme is configured as “Windows”, then “NTLM” should be in its list.
If none of the authentication actions (HTTP Basic Authentication, NTLM Authentication or OAuth2 Authentication) is configured for a proxy API, Mediator forwards the request to the native API, without attempting to authenticate the request.
Input Parameters
Authenticate Using
String. Specifies the user credentials for authenticating client requests to the native API.
Note:  
If Mediator is used to access a native API protected by NTLM (which is typically hosted in IIS), then the native API in IIS should be configured to use NTLM as the authentication scheme. If the authentication scheme is configured as "Windows", then "NTLM" should be in its list. The "Negotiate" handshake will be supported in the near future. This note applies to all three of the following options for NTLM.
Value
Description
Existing Credentials
Default. Mediator uses the user credentials passed in the request header for an NTLM handshake with the server.
Custom Credentials
Mediator uses the values you specify in the User, Password and Domain fields for an NTLM handshake with the server.
Field
Description
Username
String. Mandatory. Account name of a consumer who is available in the Integration Server on which Mediator is running.
Password
String. Mandatory.A valid password of the consumer.
Domain
String. Optional. Domain used by the server to authenticate the consumer.
Transparent
Mediator supports Kerberos handshake in Transparent mode. The following additional settings are required for Kerberos:
*Configure the client with clientCredentialType set to Windows.
*Set the value of watt.pg.disableNtlmAuthHandler property to true in the extended settings for the Integration Server
*Set the property handleClientErrorCode to true in pg-core.xml as follows:
<bean
id="httpResponseCodeCallback"
class="com.softwareag.pg.axis2.transpo
rts.ISHTTPResponseCodeCallback">
<property name="handleClientErrorCode"
value="true"/>
</bean>
For more information about configuring the extended settings, see webMethods Integration Server Administrator’s Guide.
Copyright © 2005-2015 Software AG, Darmstadt, Germany.

Product LogoContact Support   |   Community   |   Feedback