Skip to content
Mutual authentication › Outbound › Web services › API implementation › API implementation and reference
Release: Australia · Updated: 2026-03-12 · Official documentation · View source

Create a protocol profile

You can create a custom HTTPS protocol profile to specify the credentials and certificates used for outbound web services. For example, you can create a custom HTTPS protocol profile to enable mutual authentication.

Before you begin

About this task

Mutual authentication causes the web service provider and consumer to authenticate with each other before communicating. You must configure a REST or SOAP message to support mutual authentication.

  • Outbound REST: Create a REST message using basic authentication.
  • Outbound SOAP: Create a SOAP message using mutual authentication.

Note: Mutual authentication is not available when making outbound web service calls through a MID Server.

Procedure

  1. Navigate to All > System Security > Protocol Profiles.

  2. Click New.

  3. Fill in the fields on the form, as appropriate.

FieldDescription
Protocol

Enter a unique name to identify this HTTPS protocol, such as mauth. The protocol name allows you to differentiate between normal HTTPS connections and HTTPS connections that use this protocol profile. The name you enter becomes the protocol name in the URL. For example, mauth://endpoint.service.comNote:

  • Don't include upper case letters or special characters in the protocol name.
  • You can't create a custom protocol with an existing protocol name such as HTTPS.
Default portEnter the port number for connections that use this protocol.
Check boxSelect the client certificate the protocol uses to authenticate itself with the web service provider. The certificate must have a Type value of Java Key Store or PKCS12 Key Store.

Parent Topic:Outbound web service mutual authentication