Turtini

Federation: connect an agency API from an OpenAPI document

A connector lets this instance read from (or, with approval, write to) a system your agency already runs that publishes an OpenAPI 3.0 or 3.1 document.

Import:
1. Open Connectors and paste the OpenAPI document as JSON. YAML must be converted to JSON first.
2. List the hosts this connector may call. Only hosts the document names can be allowlisted, and a call to any other host is refused. Calls use https and never follow a redirect.
3. Supported authentication: mutual TLS, OAuth 2.0 client credentials, or an API key. Documents that use anything else, reference external files, or use templated server addresses are refused.

Mark what comes in:
Every operation you read from needs a mapping that assigns a marking: a fixed marking for everything from that operation, or a field in the response mapped to markings. A record whose marking cannot be resolved is quarantined and never stored. A record marked above your system high is refused and recorded for your spill procedure.

Approve and test:
A second administrator approves the connector before any call. Changing a mapping requires approval again. Dry run shows the exact request and what a sample response would ingest as, without calling anything.

Writes:
Write operations need a second administrator to approve the exact request, and the approval lasts one hour. The request body is never written to the audit log.

On Turtini's cloud, connectors cannot reach private network addresses.