---
sourceDocument: Australia Workflow Data Fabric
sourceDocumentLink: https://www.servicenow.com/docs/r/australia/integrate-applications

 Release :

    - australia

ft:locale :

    - en-US

ft:publication_title :

    - Australia Workflow Data Fabric

ft:clusterId :

    - crint

bundleId :

    - crint

workflow :

    - Creator


---

# Set up Ethoca spoke

# Set up Ethoca spoke {#ariaid-title1}

Release version: Australia  
Updated March 12, 2026  
![](https://www.servicenow.com/docs/portal-asset/ico-clock) 3 minutes to read  
Integrate the ServiceNow instance with the Ethoca account using the using the OAuth protocol (version 1.0a) for the Consumer Clairty category and using Basic Auth credentials for the Issuers Alert Management
category to authenticate ServiceNow requests.

## Before you begin

* Request an Integration Hub subscription.
* Activate the Ethoca spoke.
* Role required: admin.
{#set-up-ethoca-spoke__ul_agy_qxd_rlb}

## For the Consumer Clarity category {#ariaid-title2}

Integrate the ServiceNow instance with the Ethoca account in the Consumer Clarity category using the OAuth protocol (version 1.0a) to securely authorize and authenticate ServiceNow requests.  
Follow these steps:

* [Attach a Ethoca certificate](https://www.servicenow.com/docs/ggaJHqAQEXpF0wvs~mhQ9A#configure-ethoka-with-servicenow "Use the certificate generated during the Ethoca account configuration to sign the request and payloads.")
* [Create credential records](https://www.servicenow.com/docs/ggaJHqAQEXpF0wvs~mhQ9A#create-credential-records-for-the-ethoca-spoke "Create a credential record for your Ethoca account. The Ethoca spoke connection and credential alias uses these credentials to authorize actions.")
* [Create connection records](https://www.servicenow.com/docs/ggaJHqAQEXpF0wvs~mhQ9A#configure-ethoka-and-connection-record "Create a connection record for your Ethoca account. The Ethoca spoke connection and credential aliases use these connections to perform actions in Ethoca.")
{#for-consumer-clarity__ul_gcz_yfw_12c}

### Attach a Ethoca certificate {#ariaid-title3}

Use the certificate generated during the Ethoca account configuration to sign the request and payloads.

#### Before you begin

* Valid Ethoca certificate
* Role required: admin
{#configure-ethoka-with-servicenow__ul_k2k_mph_gfaff}

#### Procedure

1. Navigate to AllSystem DefinitionCertificates.
2. Click New.
3. On the form, fill in the fields:  
   {#configure-ethoka-with-servicenow__table_wdd_xjx_zyb__entry__2}

   | Field | Description |
   |-|-|
   | Name | Enter a name to identify the certificate. |
   | Type | Type of the certificate. Select <kbd class="ph userinput">PKCS12 Key Store</kbd>. |
   | Notify on expiration | Select the list of users to be notified when the certificate expires. |
   | Warn in days to expire | Enter the number of days when a notification is sent to users before a certificate expires. |
   | Key store password | Password to access the certificate. Use the destination keystore password specified when creating the certificate. |
   | Active | Option to make the client certificate active. |
   | Short description | Short description of the user client certificate. |
   [Table 1. X.509 Certificate form fields]

   {#configure-ethoka-with-servicenow__table_wdd_xjx_zyb}
4. Click the manage attachments icon (![Manage attachments icon.]()) and attach a Ethoca certificate.
5. Click Validate Stores/Certificates to validate the certificate.
6. Click Submit.
{#configure-ethoka-with-servicenow__steps_y3t_4vf_yyb}

### Create credential records {#ariaid-title4}

Create a credential record for your Ethoca account. The Ethoca spoke connection and credential alias uses these credentials to authorize actions.

#### Before you begin

Role required: admin

#### Procedure

1. Navigate to AllConnections \& CredentialsCredentials.
2. Select New.  
   The system displays this message: What type of Credentials would you like to create?
3. Select Ethoca Credential.  
   A blank Ethoca Credential form displays.
4. Enter these values.  
   {#create-credential-records-for-the-ethoca-spoke__table_fvk_jds_xyb__entry__2}

   | Field | Value required |
   |-|-|
   | Name | Enter any name to uniquely identify the record. For example, <kbd class="ph userinput">Ethoca Credentials</kbd>. |
   | Active | Enable |
   | Key alias | Key alias associated with the Ethoca account. |
   | Keystore password | Password associated with the certificate. |
   | Consumer key | Consumer key that you generated during the Ethoca configuration. |
   | Certificate | Select the newly created Ethoca certificate. |
   | Authentication Algorithm | Custom authentication algorithm for outbound signing requests. Select Ethoca. Note: Users are cautioned against directly modifying the default authentication algorithm. |
   [ ]

   {#create-credential-records-for-the-ethoca-spoke__table_fvk_jds_xyb}
5. Click Submit.
{#create-credential-records-for-the-ethoca-spoke__steps_n1q_ylc_wyb}

### Create connection records {#ariaid-title5}

Create a connection record for your Ethoca account. The Ethoca spoke connection and credential aliases use these connections to perform actions in Ethoca.

#### Before you begin

Role required: admin

#### Procedure

1. Navigate to AllConnections \& CredentialsConnections \& Credentials Aliases.
2. Open for the record for Ethoca.
3. On the Connections tab, click New.
4. On the form, fill these values.  
   {#configure-ethoka-and-connection-record__table_f1b_mkr_ylb__entry__2}

   | Field | Value required |
   |-|-|
   | Connection URL | Base URL to connect to your Ethoca instance. Enter: <kbd class="ph userinput">https://sandbox.api.ethocaweb.com/ethoca </kbd>. |
   | Credential | Credential record that you created for Ethoca. For example, <kbd class="ph userinput">Ethoca Credentials</kbd>. |
   [ ]

   {#configure-ethoka-and-connection-record__table_f1b_mkr_ylb}
5. Right-click the form header and click Save.
{#configure-ethoka-and-connection-record__steps_nbc_jvf_yyb}

## For the Issuer Alerts Management category {#ariaid-title6}

Integrate the ServiceNow instance with the Ethoca account in the Issuer Alerts Management category using Basic Auth credentials to authenticate ServiceNow requests.  
Follow these steps:

* [Create basic auth credentials](https://www.servicenow.com/docs/ggaJHqAQEXpF0wvs~mhQ9A#create-basic-auth-credentials "Create credentials to access a ServiceNow instance.")
* [Create connection records](https://www.servicenow.com/docs/ggaJHqAQEXpF0wvs~mhQ9A#create-connection-records-for-ethoca-alerts "Create a connection record for your Ethoca account. The Ethoca spoke connection and credential aliases use these connections to perform actions in Ethoca Alerts.")
{#for-the-issuer-alerts-management__ul_yrt_bgw_12c}

### Create basic auth credentials {#ariaid-title7}

Create credentials to access a ServiceNow instance.

#### Before you begin

Role required: admin

#### Procedure

1. Navigate to Connections \& CredentialsCredentials.
2. Click New.
3. Select Basic Auth Credentials.
4. On the form, fill in the fields.  
   {#create-basic-auth-credentials__table_kd2_gxl_3rb__entry__2}

   | Field | Description |
   |-|-|
   | Name | Unique name to identify the credential record. For example, <kbd class="ph userinput">Ethoca Alerts Credentials</kbd> |
   | User name | Name to identify the user. |
   | Password | Password to use this credential. |
   | Active | Option to actively use the credential record. Select the option. |
   | Order | The order (sequence) in which the platform tries this credential while it attempts to log in to devices. Default value: <kbd class="ph userinput">100</kbd>. |
   [ ]

   {#create-basic-auth-credentials__table_kd2_gxl_3rb}
5. Select Submit.
{#create-basic-auth-credentials__steps_d4y_wgn_krb}

### Create connection records {#ariaid-title8}

Create a connection record for your Ethoca account. The Ethoca spoke connection and credential aliases use these connections to perform actions in Ethoca Alerts.

#### Before you begin

Role required: admin

#### Procedure

1. Navigate to AllConnections \& CredentialsConnections \& Credentials Aliases.
2. Open for the record for Ethoca Alerts.
3. On the Connections tab, click New.
4. Fill the form.  
   {#create-connection-records-for-ethoca-alerts__table_t4k_12x_zyb__entry__2}

   | Field | Description |
   |-|-|
   | Connection Name | Name of the connection established with the Ethoca instance. The first connection's default name is automatically assigned to match the name specified in the Connections and Credentials form on the Connection \& Credential Aliases page. |
   | Credential | Credential record you that created for Ethoca Alerts. For example, <kbd class="ph userinput">Ethoca Alerts Credentials</kbd>. |
   | Connection URL | Base URL to connect to your Ethoca instance. Enter: <kbd class="ph userinput">https://sandbox.ethocaweb.com/ethoca-rest</kbd>. |
   [Table 2. Configure Connection]

   {#create-connection-records-for-ethoca-alerts__table_t4k_12x_zyb}
5. Right-click the form header and click Save.
{#create-connection-records-for-ethoca-alerts__steps_ix5_wcw_12c}

*[\>]: and then