> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.itential.com/itential-platform/2023-2/release-notes/deprecations/ssl-props-deprecated-in-mongoprops/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.itential.com/_mcp/server.

# SSL properties deprecated in MongoProps

> Deprecation notice that SSL security properties in the mongoProps section of properties.json are deprecated in 2023.2 and replaced with TLS properties in 2024.2.

## SSL security properties deprecated in MongoProps \[2023.2]

The `ssl` security properties in the `mongoProps` section of the `properties.json` file are deprecated in 2023.2 and scheduled for removal in 2024.2. They will be replaced with `tls` properties. The `replSet` key will also be removed as it provides no useful function.

| Protocol | Description                                               | Deprecation release | Scheduled removal release | Replacement                                                                    |
| -------- | --------------------------------------------------------- | ------------------- | ------------------------- | ------------------------------------------------------------------------------ |
| SSL      | Used to create a secure, encrypted connection to MongoDB. | 2023.2              | 2024.2                    | [TLS](https://www.mongodb.com/docs/manual/core/security-transport-encryption/) |

### SSL — deprecated

```json
"mongoProps": {
  "ssl": {
    "enabled": true,
    "sslValidate": true,
    "sslCA": "/etc/ssl/keys/mongo_ca_chain.cert",
    "acceptInvalidCerts": false,
    "checkServerIdentity": true
  },
  "replSet": {
    "enabled": true
  }
}
```

### TLS — replacement

```json
"mongoProps": {
  "tls": {
    "enabled": true,
    "tlsCAFile": "/etc/ssl/keys/mongo_ca_chain.cert",
    "tlsAllowInvalidCerts": false
  }
}
```

## What should I do?

Find each `properties.json` file used in your environment and remove all references to the `ssl` properties, replacing them with the `tls` equivalent as shown above.

> Deprecation notice that SSL security properties in the mongoProps section of properties.json are deprecated in 2023.2 and replaced with TLS properties in 2024.2.