Sec_Mutual_Auth

Description

When you access an SAP Adaptive Server Enterprise database in PowerBuilder through Open Client, Sec_Mutual_Auth is one of several parameters that support login authentication for network-based security services. (For other login authentication parameters, see the See Also section.)

Sec_Mutual_Auth controls whether your connection's security mechanism performs mutual authentication. When Sec_Mutual_Auth is set to 1, the server must prove its identity to the client before connecting by sending a credential token containing the server's principal name and proof that this name is authentic.

When Sec_Mutual_Auth is set to 0 (the default), no mutual authentication is performed.

You must specify a value for Sec_Mutual_Auth before connecting to the database in PowerBuilder.

Using third-party security mechanisms

For information about the third-party security mechanisms and operating system platforms that has been tested with Open Client security services, see the Open Client documentation.

Applies to

ASE, SYC SAP Adaptive Server Enterprise

Syntax

Sec_Mutual_Auth=value

Parameter

Description

value

Specifies whether your connection's security mechanism performs mutual authentication. Values are:

  • 0

    (Default) Does not perform mutual authentication. You can also specify 'No' or 'False' to set this value.

  • 1

    Performs mutual authentication. The server must prove its identity to the client before connecting by sending a credential token containing the server's principal name and proof that this name is authentic. You can also specify 'Yes' or 'True' to set this value.


Default value

Sec_Mutual_Auth=0

Usage

Set Release parameter

For this parameter to take effect, you must also set the Release parameter to 11 or higher to specify that your application should use the appropriate version of SAP Sybase Open Client Client-Library (CT-Lib) behavior. See the description of the Release parameter for more information.

Requirements for use

To use Sec_Mutual_Auth or any other parameter supporting Open Client security services, you must meet certain requirements for using security services in your PowerBuilder application. For details, see the section called “Requirements for using Open Client security services” in Connecting to Your Database.

Corresponding CT-Lib connection property

Specifying a value for Sec_Mutual_Auth sets the corresponding SAP Sybase CT-Lib connection property named CS_SEC_MUTUALAUTH.

Examples

To specify that your connection's security mechanism performs mutual authentication:

  • Database profile

    Select the Mutual Authentication check box on the Security page in the Database Profile dialog box.

  • Application

    Type the following in code:

    SQLCA.DBParm="Sec_Mutual_Auth=1;Release=15"

See also

Release

Sec_Channel_Bind

Sec_Cred_Timeout

Sec_Delegation

Sec_Keytab_File

Sec_Mechanism

Sec_Network_Auth

Sec_Server_Principal

Sec_Sess_Timeout