> ## Documentation Index
> Fetch the complete documentation index at: https://koreai.mintlify.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Setting Up the Kerberos SPNEGO Authorization Profile

<Badge icon="arrow-left" color="gray">[Back to App Settings](/ai-for-service/app-settings)</Badge>

The Platform offers a Kerberos SPNEGO-based authentication mechanism for enterprise users to securely connect with their internal applications using the Kerberos SPNEGO security protocol.

The Kerberos-SPNEGO authentication process includes multiple steps to establish a secure connection between a client and a server using the SPNEGO negotiation mechanism and the Kerberos authentication protocol. The combination of SPNEGO and Kerberos ensures a secure and efficient authentication process, enabling clients to access sensitive data securely.

The Kerberos SPNEGO auth profile can be configured from the following Platform settings:

* [Service Node](/ai-for-service/automation/dialogs/node-types/service-node#service-node)
* [Configurations > Authorization Profile](/ai-for-service/app-settings/dev-tools/bot-authorization/setting-up-authorization-using-oauth-v2)
* [Generative AI & LLM > Custom LLM Integrations](/ai-for-service/generative-ai-tools/llm-integration#configure-custom-llm-integration)

***

## Configuring Kerberos SPNEGO Authorization

1. Open the AI Agent for which you want to configure the Authorization profile.

2. Select the **Build** tab from the top menu.

3. From the left-side vertical menus, click **Configurations > Authorization Profiles**.

4. Click **New** to open the **New Authorization Mechanism** dialog.

   <img src="https://mintcdn.com/koreai/WXbgclBfTjdUd7vF/ai-for-service/app-settings/dev-tools/bot-authorization/images/basic-auth-img2.png?fit=max&auto=format&n=WXbgclBfTjdUd7vF&q=85&s=3171e6b95db2664dca1f20db7b95c4e0" alt="New Authorization Mechanism - Add" width="1571" height="746" data-path="ai-for-service/app-settings/dev-tools/bot-authorization/images/basic-auth-img2.png" />

5. In the **Authorization Type** drop-down list, select the **Kerberos-SPNEGO** option.

   <img src="https://mintcdn.com/koreai/hij-ASVNsmm-T2OW/ai-for-service/app-settings/dev-tools/bot-authorization/images/kerberos-img2.png?fit=max&auto=format&n=hij-ASVNsmm-T2OW&q=85&s=f432632cc10883610b36c0b6a13d8edf" alt="Authorization Type - Kerberos-SPNEGO" width="959" height="890" data-path="ai-for-service/app-settings/dev-tools/bot-authorization/images/kerberos-img2.png" />

6. In the **Name** field, enter a name for the authorization type.

   <img src="https://mintcdn.com/koreai/hij-ASVNsmm-T2OW/ai-for-service/app-settings/dev-tools/bot-authorization/images/kerberos-img3.png?fit=max&auto=format&n=hij-ASVNsmm-T2OW&q=85&s=b26a8e707879ee97a6fb6f53453c5f30" alt="Authorization Name" width="957" height="880" data-path="ai-for-service/app-settings/dev-tools/bot-authorization/images/kerberos-img3.png" />

7. Define the required Kerberos Authorization fields. For more information, see the [Defining Authorization Fields](#defining-authorization-fields) section.

8. (Optional) Click **+ Add Authorization Field** to add additional fields for Kerberos authorization. For more information, see the [Adding Authorization Fields](#adding-authorization-fields) section.

9. Click **Save Auth**.

   <img src="https://mintcdn.com/koreai/hij-ASVNsmm-T2OW/ai-for-service/app-settings/dev-tools/bot-authorization/images/kerberos-img4.png?fit=max&auto=format&n=hij-ASVNsmm-T2OW&q=85&s=5fff33a9ac715db703595fefeae159d1" alt="Save Auth" width="958" height="890" data-path="ai-for-service/app-settings/dev-tools/bot-authorization/images/kerberos-img4.png" />

***

## Defining Authorization Fields

To configure the Kerberos SPNEGO authorization profile, define the fields described in the following table.

| FIELD NAME              | DESCRIPTION                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | Required or Optional |
| ----------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------- |
| Authorization Type      | Set to Kerberos SPNEGO                                                                                                                                                                                                                                                                                                                                                                                                                                                              |                      |
| Name                    | The name of the authorization profile or service, for example, Kerberos Profile.                                                                                                                                                                                                                                                                                                                                                                                                    | Required             |
| Service Principal URL   | The URL to access the Kerberos service and initiate the authentication process.                                                                                                                                                                                                                                                                                                                                                                                                     | Required             |
| Authorization Check URL | The URL used to obtain end-user authorization for the Platform to access the web application or web service using the access token. The Platform accepts a valid URL with a maximum length of 3000 characters. You can use dynamic fields, path parameter fields, query fields, and so forth, for example: `https://platform.example.com/sap/opu/odata/sap/{{authfield1}}/?$format=json` or `https://{tenant}.service-now.com/api/now/v1/table/incident`                            | Required             |
| Authorization Fields    | The authorization fields for the token bearer.                                                                                                                                                                                                                                                                                                                                                                                                                                      | Optional             |
| Refresh Token URL       | Enter a Refresh Token URL, if required, for cases when the authentication token expires and must be refreshed. The Platform accepts a valid URL with a maximum length of 3000 characters.                                                                                                                                                                                                                                                                                           | Required             |
| Description             | Enter a description for your authorization.                                                                                                                                                                                                                                                                                                                                                                                                                                         | Optional             |
| Authentication Types    | App designers can set this to modify the Kerberos authentication behavior. Choose one of the following: **Mutual** - Default. Ensures that both the client and the server authenticate each other during the Kerberos SPNEGO authentication process. **Delegate** - Also known as delegation or credential delegation. The client can pass its Kerberos credentials to the service, which can then use these credentials to authenticate to other services on behalf of the client. | Required             |

For more information, see [Using Session and Context Variables](/ai-for-service/automation/agent-flows#session-management).

***

## Adding Authorization Fields

Click **+ Add Authorization Field** and enter one or more key/value pairs representing additional authorization input fields.

If the default username and password fields don't meet your authorization input needs, add custom fields as key/value pairs displayed to the end-user. For example, add a PIN code field in addition to the **Username** and **Password** fields.

<img src="https://mintcdn.com/koreai/hij-ASVNsmm-T2OW/ai-for-service/app-settings/dev-tools/bot-authorization/images/kerberos-img5.png?fit=max&auto=format&n=hij-ASVNsmm-T2OW&q=85&s=c5fb69c4288e7260e323df1f813936d5" alt="Authorization fields added" width="955" height="877" data-path="ai-for-service/app-settings/dev-tools/bot-authorization/images/kerberos-img5.png" />

Specify the following fields:

* **Field Type** - The type of the custom field: `Header`, `Payload`, `Query String`, or `Path Param`.
* **Field Key** - The name of the custom field.
* **Value** - The value of the custom field.

Click **Done** to save the **Additional Field**.

***

## Testing the Authorization

After saving the authentication, test your authorization definition on the **Authentication** page by clicking **Test** before continuing to develop the remaining steps of your task.

1. Click the **Test** button in the Kerberos Auth Profile row to begin the authorization test.

   <img src="https://mintcdn.com/koreai/hij-ASVNsmm-T2OW/ai-for-service/app-settings/dev-tools/bot-authorization/images/kerberos-img6.png?fit=max&auto=format&n=hij-ASVNsmm-T2OW&q=85&s=9cd12b680cb5e9a9c0105ed1d72c51d8" alt="Begin the authorization test" width="1328" height="803" data-path="ai-for-service/app-settings/dev-tools/bot-authorization/images/kerberos-img6.png" />

2. In the Test Authorization window, select the Content-Type and Method field values, then click **Test**.

   <img src="https://mintcdn.com/koreai/hij-ASVNsmm-T2OW/ai-for-service/app-settings/dev-tools/bot-authorization/images/kerberos-img7.png?fit=max&auto=format&n=hij-ASVNsmm-T2OW&q=85&s=bfd9b868d8a8f09f53e93afee3f86853" alt="Select the Content-Type and Method field values and click Test" width="596" height="878" data-path="ai-for-service/app-settings/dev-tools/bot-authorization/images/kerberos-img7.png" />

3. When validation completes, the **Test Authorization** dialog closes and the results — either success or failure — are displayed to the right of the **Test Authorization** button. If the authorization fails, the Auth Test Failed message is displayed along with the **Headers** and **Response** tabs.

***
