> For the complete documentation index, see [llms.txt](https://docs.elimity.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.elimity.com/release-notes/v3.42.0.md).

# v3.42.0

We are happy to announce release v3.42.0 of Elimity Insights, released on 29 August 2025.

## Summary

This section summarizes the most important changes in release v3.42.0.

<details>

<summary>New functionality</summary>

* SCIM API management in the UI
* Atlassian Cloud built-in connector
* Gateway-based imports for custom sources

</details>

<details>

<summary>Bug fixes &#x26; improvements</summary>

* Support for immediately copying registration links when creating user accounts
* Minor bug fixes & improvements

</details>

<details>

<summary>Deployment changes</summary>

* Removal of the `ScimPassword` configuration option
* `plv8` extension for PostgreSQL must be available
* New configuration options for gateway authentication

</details>

## New functionality <a href="#h_01h9mxgpqsnkh8tpyx32gwcbsr" id="h_01h9mxgpqsnkh8tpyx32gwcbsr"></a>

### SCIM API management in the UI <a href="#h_01h9mxgpqs7sd6b0ewt9frpxbs" id="h_01h9mxgpqs7sd6b0ewt9frpxbs"></a>

The v3.42.0 release makes it possible for administrators to manage Elimity Insights' SCIM API in the UI. More specifically, they can enable, disable and regenerate tokens for the API in the new 'SCIM API' tab on the 'Advanced settings' page:

<figure><img src="https://2067057569-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7b6iwtH0Lr9Z5pj9MCO2%2Fuploads%2FthgInw6x6mSNW2h732rW%2Fimage.png?alt=media&amp;token=74d68f40-49a4-47d1-8c05-977a10c1273a" alt=""><figcaption></figcaption></figure>

Refer to [our dedicated documentation](/reference-manual/advanced-topics/scim-provisioning.md) for additional information about Elimity Insights' SCIM API.

### Atlassian Cloud built-in connector

Elimity Insights v3.42.0 also includes a built-in connector for Atlassian Cloud, allowing connector admins to import users and groups their Atlassian Cloud organization. As always, [our dedicated documentation](/reference-manual/built-in-connectors/atlassian-cloud.md) contains additional information.

### Gateway-based imports for custom sources

The v3.42.0 release brings significant improvements for importing data into custom sources. Up until now, connector admins had to choose between manual imports, file uploads or import scripts pushing data to Elimity Insights' API. With this feature we offer an alternative to the import scripts that both requires less maintenance and is more user-friendly. More specifically, connector admins can now enable gateway-based imports for custom sources in the new 'CONFIG' tab on the source's detail page:

<figure><img src="https://2067057569-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7b6iwtH0Lr9Z5pj9MCO2%2Fuploads%2FFdnY3Ve0OYerAgNhFffq%2Fimage.png?alt=media&amp;token=ab4f014a-6beb-4353-ad0a-cdc631ac2925" alt=""><figcaption></figcaption></figure>

Refer to [our dedicated documentation page](/reference-manual/advanced-topics/gateway-based-imports.md) for additional information about this feature.

## Bug fixes & improvements

### Support for immediately copying registration links when creating user accounts

From v3.42.0 onwards admins can immediately copy registration links when they (re)send invitation emails for new user accounts:

<figure><img src="https://2067057569-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7b6iwtH0Lr9Z5pj9MCO2%2Fuploads%2F6XMh7eevV0OuCrvmrlRz%2Fimage.png?alt=media&amp;token=310de678-2ede-49d3-a413-aae594727faf" alt=""><figcaption></figcaption></figure>

### Minor bug fixes & improvements <a href="#h_01js1h4hg2ekpaqj0a5kpn1hc0" id="h_01js1h4hg2ekpaqj0a5kpn1hc0"></a>

As always, this new release brings some smaller bug fixes and improvements:

* [The SAP SuccessFactors built-in connector](/reference-manual/built-in-connectors/sap-successfactors.md) includes a new 'status' attribute type.
* Two new endpoints are available for clients authenticating with API tokens: `GET /api/agent/stored-queries;format=json` and `GET /api/agent/scopes`.
* We renamed the 'Azure AD' built-in connector to 'Entra ID', including related documentation.

## Deployment changes

### Removal of the `ScimPassword` configuration option

Since Elimity Insights now supports UI-based management of its SCIM API, the `ScimPassword` configuration value in `secrets.yml` is no longer effective. Migrating to v3.42.0 disables the API, customers using SCIM should re-enable it in the UI, which means Elimity Insights will generate a new token. Please contact your Elimity representative if you want to migrate your original `ScimPassword` value to v3.42.0.

### `plv8` extension for PostgreSQL must be available

From v3.42.0 onwards Elimity Insights uses the `plv8` extension in its database. On-premise customers must make sure this extension is available in their PostgreSQL server:

* Customers using 'Azure Database for PostgreSQL - Flexible Server' should make sure the `plv8` extension is allowed; refer to [the official documentation](https://learn.microsoft.com/en-us/azure/postgresql/extensions/how-to-allow-extensions?tabs=allow-extensions-portal) for additional information.
* For customers using 'Cloud SQL for PostgreSQL' by Google: this extension should just always be available. However, you'll need to (temporarily) grant the `cloudsqlsuperuser` role for the SQL user performing this migration.

Please contact your Elimity representative if you need additional assistance with ensuring `plv8` is available.

### New configuration options for gateway authentication

As mentioned previously, the v3.42.0 release includes a new feature for importing data into custom sources. Server administrators can configure how Elimity Insights should authenticate when contacting gateways to perform imports. The snippet below summarizes every new configuration option (all in `secrets.yml`), please refer to [our dedicated documentation](/reference-manual/advanced-topics/gateway-based-imports.md) for additional information.

```yaml
# EnableGatewayOAuth2
# ----------------------------
#
# Data type: boolean
#
# Status: Optional
#
# Default value: false
#
# Description: Determines whether Elimity Insights should use OAuth2 for authentication to gateways.

# GatewayOAuth2ClientId
# ----------------------------
#
# Data type: string
#
# Status: Required if `EnableGatewayOAuth2` is `true`
#
# Description: OAuth2 client ID to use when retrieving an access token for gateway authentication.

# GatewayOAuth2ClientSecret
# ----------------------------
#
# Data type: string
#
# Status: Required if `EnableGatewayOAuth2` is `true`
#
# Description: OAuth2 client secret to use when retrieving an access token for gateway authentication.

# GatewayOAuth2EndpointParams
# ----------------------------
#
# Data type: record[string]
#
# Status: Optional
#
# Description: Object mapping extra OAuth2 token endpoint parameters to `Expr` programs.

# GatewayOAuth2TokenUrl
# ----------------------------
#
# Data type: string
#
# Status: Required if `EnableGatewayOAuth2` is `true`
#
# Description: OAuth2 token URL to use when retrieving an access token for gateway authentication.
```

## Migration information <a href="#h_01h9mxgpqs599yv2hb64zhwdk9" id="h_01h9mxgpqs599yv2hb64zhwdk9"></a>

To migrate from v3.41.x to v3.42.0, we suggest the following steps:

1. Make a backup of your existing database.
2. Make a backup of your existing installation directory.
3. Migrate your installation by installing the files for v3.42.0, as described below.
4. Migrate your database, as described below.
5. Start the server and validate that it works as before.

### Installing the files for v3.42.0 <a href="#h_01h9mxgpqsdj7y3gp98dbbb8hy" id="h_01h9mxgpqsdj7y3gp98dbbb8hy"></a>

Customers that set up a container-based installation of Elimity Insights can simply bump the server image version. If you're using plain executables, copy the following files from the v3.42.0 release to your current installation folder:

* The appropriate binary of Elimity Insights for your OS:
  * `elimity-insights-linux-x86_64`
  * `elimity-insights-windows-x86_64.exe`
* The appropriate binary of the database migration tool for your OS:
  * `elimity-insights-database-migrate-linux-x86_64`
  * `elimity-insights-database-migrate-windows-x86_64.exe`

### Migrating the database <a href="#h_01jbc65m99c2bwscx5jmhccxey" id="h_01jbc65m99c2bwscx5jmhccxey"></a>

Customers that set up a container-based installation of Elimity Insights should refer to [our dedicated installation documentation](/reference-manual/installation/elimity-insights-server.md#upgrades) for detailed upgrade instructions. If you're using plain executables, the database migration is performed by running one of the following executables depending on your OS:

* `elimity-insights-database-migrate-linux-x86_64`
* `elimity-insights-database-migrate-windows-x86_64.exe`

You can use the command line argument `help` to get help info:

```shell-session
$ ./elimity-insights-database-migrate-linux-x86_64 help
```

You can use the command line argument `target-versions` to display the list of supported target versions:

```shell-session
$ ./elimity-insights-database-migrate-linux-x86_64 target-versions
```

To migrate your database, use a command similar to the following:

```shell-session
$ ./elimity-insights-database-migrate-linux-x86_64 migrate -dsn 'postgresql://<postgres-user>:<postgres-password>@<your-host>:5432/<your-elimity-db-name>' -target-version 'v3.42'
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.elimity.com/release-notes/v3.42.0.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.