# IFS Apps 10

## Overview <a href="#overview" id="overview"></a>

The IFS Apps 10 Integration enables seamless connectivity between your platform and IFS Applications 10 (IFS Apps10) to synchronize and manage ERP and enterprise operations data. This integration uses OAuth 2.0 Resource Owner Password Credentials (ROPC) grant via Keycloak for authentication, mirroring the IFS Cloud connector pattern. It supports OpenAPI-based API discovery and full runtime API execution.

### Prerequisites <a href="#prerequisites" id="prerequisites"></a>

Before initiating the integration, ensure the following requirements are met:&#x20;

* An active IFS Apps 10 instance accessible over HTTPS.&#x20;
* Valid IFS Apps 10 user credentials (username and password) with appropriate API access.&#x20;
* The IFS Apps 10 domain URL (e.g., app10techlkp-demo.ifsworld.com).&#x20;
* OAuth 2.0 / Keycloak token endpoint configured and accessible on your IFS Apps 10 instance.&#x20;
* Client ID and Client Secret from your Keycloak configuration.&#x20;
* Access to the Spool platform with Admin role privileges.&#x20;

### Best practices <a href="#best-practices" id="best-practices"></a>

* **Hostname only:** Enter the domain without https\:// prefix or trailing slash.&#x20;
* **Use a service account:** Create a dedicated IFS Apps 10 service account with the minimum required permissions. Avoid using personal credentials.&#x20;
* **Validate post-setup:** Always run Test Connection after saving to confirm OAuth token generation and network connectivity.&#x20;
* **Credential updates:** If the IFS Apps 10 password is rotated, update the integration credentials promptly to prevent disruption.&#x20;
* **Token persistence:** Tokens are stored in the database and reused across API calls. Ensure the database is accessible and the integration service has write permissions.&#x20;

## Setup instructions

{% @arcade/embed flowId="f50F0lwc5Wrfh2M18yez" url="<https://app.arcade.software/share/f50F0lwc5Wrfh2M18yez>" %}

### Initiate integration

{% stepper %}
{% step %}
Log in to the Spool platform using an Admin account.
{% endstep %}

{% step %}
Navigate to Settings → Integrations.
{% endstep %}

{% step %}
Click the "+ Add Integration" button.
{% endstep %}

{% step %}
Search for IFS Apps 10 and select the integration.
{% endstep %}
{% endstepper %}

### Authentication <a href="#step-2-basic-configuration" id="step-2-basic-configuration"></a>

{% hint style="info" %}
IFS Apps 10 uses OAuth 2.0 with the Resource Owner Password Credentials grant type. Credentials are exchanged for a bearer token via the Keycloak OIDC token endpoint.
{% endhint %}

{% stepper %}
{% step %}
Enter the IFS Apps 10 Domain URL (hostname only, without https\:// prefix).
{% endstep %}

{% step %}
Enter the Client ID.
{% endstep %}

{% step %}
Enter the Client Secret.
{% endstep %}

{% step %}
Enter the IFS Apps 10 Username.
{% endstep %}

{% step %}
Enter the IFS Apps 10 Password.
{% endstep %}

{% step %}
Click Connect.
{% endstep %}
{% endstepper %}

### Validation & verification

{% stepper %}
{% step %}
Navigate back to the Integrations list after saving.
{% endstep %}

{% step %}
Click the Test Connection icon for the IFS Apps 10 integration.
{% endstep %}

{% step %}
A success message confirms valid credentials and token generation.
{% endstep %}
{% endstepper %}

### Token management

#### Automatic token refresh

{% stepper %}
{% step %}
The connector handles token refresh automatically.
{% endstep %}

{% step %}
When an API call returns HTTP 401 Unauthorized

1. The connector re-authenticates against the token endpoint using the stored credentials.&#x20;
2. The new token is persisted to the database.&#x20;
3. The original API call is retried with the new token.&#x20;
4. This retry happens transparently — no manual intervention is required.&#x20;
   {% endstep %}
   {% endstepper %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://kb.theloops.io/agenticstudio/integrations/ifs-apps-10.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.